画风设定集

[7sDream]

每个想为本项目出力的人，这里是你的第二站

本 Issue 用于讨论翻译风格及标准，如一些有争议的词的翻译，需要使用 markdown 格式等等。

我先列几条吧，可以讨论，

• 翻译风格
  • 总则：能翻译的地方尽量都翻译。
  • 某些不应直接用中文替代的地方（例如：变量名、类名、模块名、包名、软件名，文档名等）请保留原文。
  • 有两种用途（既是程序内的 symbol，又充当语素）的词语需要翻译成中文，并在后面用括号标注原文。例子：“Please create a Question class.” 应该被翻译成：“请创建一个问题（Question）类”。
• 特定词语翻译约定
  • Model --> 模型。
  • app --> 应用。
• 文档格式
  • 尽量使用中文符号，隔词逗号换成顿号，英文括号换成中文括号。
  • 夹在中文之间的英文与中文之间需插入一个空格；若英文前后是符号，则与符号相邻处不用空格。
  • 如果原文列表项末尾有句点，则翻译后列表项末尾需要有句号。
  • 原文档中代码上表示文件名的 banner 转换为代码块中的首行注释。
  • 原文中红色的链接需要体现，绿色链接视情况而定（因为太多了）。
• Markdown 约定
  • 链接均使用[text](url)的格式，已翻译的文档使用[text（zh）](xxx.md)形式，未翻译的文档使用[text（en）](url)形式。
  • 原文的粗体、代码、斜体等 style 均需在 Markdown 中体现。
  • 原文的笔记部分在 Markdown 中体现为引用。
  • h1 - h6（也即 md 中的多个 # 符号）前后无需添加水平线（即 md 中的---）。
  • 用于段落标题一个或多个连续的 # 后面应该有一个空格。
  • 代码块与上下文之间要空且只一行，并使用正确的代码类型标注。
  • 不要大量使用无意义的空行。
  • 原文文档中的图片储存在docs/img/目录下，引用采用![text](img/xxx.png)的形式。其中 text 需要认真填写，可使用原文档中的提示。

以上不是规定，都是需要讨论的东西，请踊跃发表意见。