jeasonstudio / cn-vscode-docs

VScode说明文档翻译

Microsoft Visual Studio Code 中文手册

DEMO：https://jeasonstudio.gitbooks.io/vscode-cn-doc/content/

Visual Studio Code 是微软推出的跨平台编辑器。它采用经典的VS的UI布局，功能强大，扩展性很强。但是 Visual Studio Code 暂时没有中文手册，对于不太熟悉英文的同学会比较吃力。

本项目的初衷是为想使用或者正在使用 Visual Studio Code 的同学提供一个中文手册，方便大家学习使用这个优秀的工具，提高程序开发效率和质量！

翻译流程

第一阶段

先将 Visual Studio Code Docs 的内容按现有的目录结构翻译成中文，其中：

• 文章正文内容均放在 md 目录下，采用 md 格式。
• 文章中所用到的图片资源暂时先放在 images目录下,后续图片资源会统一托管到七牛云存储
• 图片按照文档的 主目录-副目录-编号的格式命名。

文件命名规则

• 文件名为Visual Studio Code Docs 对应文章标题（即下面列出的目录）的翻译名称（原英文名）。所有的空格都用 - 代替，注意单词首字母大写。
• 对于下级子页面文档，将其放在以父级文档名称命名的文件夹下面。

例如：https://code.visualstudio.com/docs/editor/whyvscode 这篇文档，对应 editor 这个文件夹下的 WhyVsCode.md 文件。

第二阶段

根据翻译文档，制作成类似在线手册或者与官方文档类似的网站，方便大家参阅。

参与项目

欢迎你参与翻译本项目，在翻译的过程中，可以锻炼你的英语能力和 Visual Studio Code 的实际应用能力，同时还为他人提供方便，何乐而不为？

一个个 commit 堆积起来就是一个了不起的 repo，欢迎你 Fork 并提交 Pull Request 或者 Issue ，哪怕是改正一个错别字、修正一个病句，我们都会很高兴。

参与方法和步骤如下：

• 登录 https://github.com

• Fork [email protected]:CN-VScode-Docs/CN-VScode-Docs.git 或者点仓库地址CN-VScode-Docs

• 创建您的特性分支 (git checkout -b new-feature)

• 提交您的改动 (git commit -m 'Added some features or fixed a bug or change a text')

• 将您的改动记录提交到远程 git 仓库 (git push origin new-feature)

• 然后到 github 网站的该 git 远程仓库的 new-feature 分支下发起 Pull Request

如果你有任何疑问或者建议、技巧，欢迎提出Issues，大家一起交流。

官方说明文档

• 仓库连接vscode-docs

正在翻译文章+作者

• AllOfIt + Jeason

项目翻译目录

• Overview

• EDITOR

  • Setup
  • The Basics
  • Extension Marketplace
  • Editing Evolved
  • Version Control
  • Debugging
  • Tasks
  • Accessibility
  • Why Vs Code

• CUSTOMIZATION

  • Overview
  • User and Workspace Settings
  • Key Bindings
  • Snippets
  • Colorizer
  • Themes
  • Display Language

• LANGUAGES

  • Overview
  • JavaScript
  • C#
  • C++
  • JSON
  • HTML
  • PHP
  • python
  • Markdown
  • TypeScript
  • CSS, Sass and Less
  • Dockerfile

• RUNTIMES

  • Node.js
  • ASP.NET Core
  • Unity
  • Office

• EXTENSIONS

  • Overview
  • Example - Hello World
  • Example - Word Count
  • Example - Language Server
  • Example - Debuggers
  • Principles and Patterns
  • Running and Debugging Your Extension
  • Installing Extensions
  • Testing Extension
  • [Our Approach](https://code.visualstudio.com/docs/extensions/our-approach)

• EXTENSIBILITY REFERENCE

  • Overview
  • Extension Manifest
  • Contribution Points
  • Activation Events
  • API vscode namespace
  • API Complex Commands
  • API Debugging

• TOOLS

  • Publishing Tool
  • Extension Generator
  • Samples

（翻译完成的，请使用删除线将对应划去,像下面这样）

*  ~~[Overview](https://code.visualstudio.com/docs)~~

贡献者（按参与时间排序）

• Jeason
• swizard
• heshenghuan
• Alexi.F
• jinyutao
• yuxuefeng
• chenxinlong
• Cherry Mill Wong
• bjrxyz
• avaicode
• Fallenwood
• ickall
• Albert C.
• Saier
• iskcal
• No.20
• Sophia Woo
• distantmars
• mrkou47
• ichengde
• bee0060
• nanci

（Fork 之后自行添加到最后）

开源协议

• MIT

cn-vscode-docs's Issues

关于翻译的状态

目前在demo中看到有几种翻译的形式（状态？）， 有些是已经变成纯英语，有些是中英并存。
而中英并存的有些是中文在前英文在后（如这里），有些反之(这个)， 请问这些是等待审核的翻译吗？

如果有翻译的中间状态，是不是统一一下形式比较好？ 例如都是中文在前，英文在后。 而且建议在某些地方给出中间状态的标记，例如在左侧菜单里，小节名字后加个括号。

同时，建议在项目根readme上定义好翻译的各个不同状态，如果有人想拿某个小节开始翻译，也可以在小节列表中进行标记，例如加上自己的名字等等。

总结来说，我是建议做一个状态管理， 定义各个状态， 说明不同状态的特征（开始状态、如何进入下一状态等等），然后做一个章节列表，为所有小节标记上状态，不标记的默认为‘未开始翻译’

关于 Getting Started with Python in VS Code 章节的翻译计划

似乎有段时间没有更新了，不知道是否有人认领了 Getting Started with Python in VS Code 章节，我正开始在本地翻译（完成后提交），如果有人已经做了这个工作，at我一下，谢谢。

建议加上原文链接地址

我看到有些翻译对应的官方文档已经更新，但这里翻译的文档没有跟着更新；还有些不太容易找到对应的官方文档。
所以建议加上原文链接地址，方便对照和将来更新。
谢谢

vscode 扩展Api文档没有人翻译了吗？？？

好像就差这块了，现在想学习这块，英语不好看起来很费力，希望能翻译下。谢谢。

似乎发现另一个翻译项目

http://i5ting.github.io/vsc/
似乎发现另一个翻译项目，不过这个人好像是搞收费培训

关于更新日志的翻译

要不要顺带着翻译了，或者再开一个repo

发现有些还没翻译的项目已经被划掉了

例如,c++

我们是不是可以把文件的路径跟英文版统一？

这样文章中的图片及路径就可以直接复用英文版里的了？

请问此文档是否还继续维护？

此翻译项目已停止？

翻译工作是否仍在继续进行，感觉已经停滞了？想着翻译其中的一部分。

关于翻译任务分配，可以借鉴docschina 的方式，很赞

docschina/webpack.js.org#17

麻烦问下快速入门是有人正在翻译还是不需要翻译这章了呢?

正在翻译的页面有哪些？由谁翻译？

这些好像大伙都没在README里写上啊，现在人多了一些就怕干了重复的工作啊

应该弄一个Organization账号

然后就可以有多个人共同管理了，要不然全发Pull request太乱了吧 @jeasonstudio

github最近经常连不上了，你们呢？

command line基本上push不了，desktop现在经常不行。

Weekly Digest (7 May, 2019 - 14 May, 2019)

Here's the Weekly Digest for jeasonstudio/CN-VScode-Docs:

---

ISSUES

Last week, no issues were created.

---

PULL REQUESTS

Last week, no pull requests were created, updated or merged.

---

COMMITS

Last week there were no commits.

---

CONTRIBUTORS

Last week there were no contributors.

---

STARGAZERS

Last week there were 13 stagazers.
⭐ zhenggenwang
⭐ wangjunjia
⭐ acphart
⭐ wangtengCN
⭐ jiangzhibo
⭐ QZQ-oops
⭐ zhonglin3612
⭐ 594097023
⭐ mepursuer
⭐ xiaoqufengdi
⭐ ApollonBar
⭐ glddiv
⭐ HZongLin
You all are the stars! 🌟

---

RELEASES

Last week there were no releases.

---

That's all for last week, please 👀 Watch and ⭐ Star the repository jeasonstudio/CN-VScode-Docs to receive next weekly updates. 😃

You can also view all Weekly Digests by clicking here.

Your Weekly Digest bot. 📆