翻译细节注意事项（格式、词汇等）

[Leibnizhu]

格式细节

良好的格式可以保证翻译之后的页面被正确显示

1. 如果一段文字以超链接开头，请保证链接前没有空格，如：

//正确
msgstr "https://github.com/quarkusio/....../RedisClient.java[`RedisClient`] "
//错误
msgstr "  https://github.com/quarkusio/....../RedisClient.java[`RedisClient`] "

2. 当要翻译的文本中出现被反引号包裹的单词时， 如 `Java` ，请保证 `Java` 的前后都有一个空格，如:

//正确
msgstr "Clone the Git repository: `git clone {quickstarts-clone-url}` and ... 
//错误
msgstr "Clone the Git repository:`git clone {quickstarts-clone-url}`and ...

3. 当要翻译的文本中出现以 `` 包裹 且为开头的首单词时，如下左侧 `v 之前的空格可省略:

msgstr "`vertx`, which provides access to the underlying managed Vert.x"

4. 当要翻译的文本中出现 link: 或 xref: 等对外部文档的引用时，如果已存在机器翻译的 link: 或 xref: 请优先在机器翻译给出的基础上进行更改，以下是翻译时可能出现情况的参考示例:

示例1:
// 原文
msgid "https://vertx.io[Vert.x] is a ...
// 此处 link: 为机器翻译预先给出
msgstr "link:https://vertx.io[Vert.x] 是一个 ... 

//示例2:
//原文
msgid "It's an introductory guide.  The xref:vertx-reference.adoc[Vert.x reference guide]
// 此处 link: 为机器翻译预先给出
msgstr "这是一项介绍性的指南。 link:vertx-reference.html[Vert.x参考指南]

//示例3:
//原文
msgid "xref:spring-data-jpa.adoc[Quarkus - Extension for Spring Data JPA]"
// 此处 机器翻译并未预先给出, 因此保持原 xref: 字符 
msgstr "xref:spring-data-jpa.adoc[Quarkus - Spring Data JPA 扩展]"

5. 翻译时标点符号的注意事项:

有待补充...

高频词汇表

(可结合CTRL + F 搜索进行使用)
在实际翻译时 应当结合句意进行翻译

英文词汇	中文翻译
guide	指南
roughly	大约
prerequisites	先决条件
architecture	架构
solution	解决方案
bootstrapping	引导启动
explains	解释
native	本地
base	基础
example	示例
snippets	代码段
profiles	环境配置
expressions	表达式
external	外部
specification	规范
image	镜像
extension	扩展
instructions	说明
field	字段
package	打包

写在最后

注意事项将不定期进行更新 不足之处恳请各位指正。
欢迎大家在留言区讨论。

[zhfeng]

Thanks @Leibnizhu for raising this issue and I think it should be moved to Dicussions which I just enabled it. Cheers!

[virtualss]

格式细节

良好的格式可以保证翻译之后的页面被正确显示

1. 如果要翻译的文本以超链接开头，请保证链接前没有空格，如：

//正确
msgstr "https://github.com/quarkusio/....../RedisClient.java[`RedisClient`] "
//错误
msgstr "  https://github.com/quarkusio/....../RedisClient.java[`RedisClient`] "

2. 当要翻译的文本中出现被反引号包裹的单词时， 如 `Java` 请保证 `Java` 的前后都有一个空格，如:

//正确
msgstr "Clone the Git repository: `git clone {quickstarts-clone-url}` and ... 
//错误
msgstr "Clone the Git repository:`git clone {quickstarts-clone-url}`and ...

3. 当要翻译的文本中出现以 `` 包裹 且为开头的首单词时，如下左侧 `v 之前的空格可省略:

msgstr "`vertx`, which provides access to the underlying managed Vert.x"

4. 当要翻译的文本中出现 link: 或 xref: 等对外部文档的引用时，如果已存在机器翻译的link:或xref: 请优先在机器翻译给出的基础上进行更改，以下是翻译时可能出现情况的参考示例:

示例1:
// 原文
msgid "https://vertx.io[Vert.x] is a ...
// 此处 link: 为机器翻译预先给出
msgstr "link:https://vertx.io[Vert.x] 是一个 ... 

//示例2:
//原文
msgid "It's an introductory guide.  The xref:vertx-reference.adoc[Vert.x reference guide]
// 此处 link: 为机器翻译预先给出
msgstr "这是一项介绍性的指南。 link:vertx-reference.html[Vert.x参考指南]

//示例3:
//原文
msgid "xref:spring-data-jpa.adoc[Quarkus - Extension for Spring Data JPA]"
// 此处 机器翻译并未预先给出, 因此保持原 xref: 字符 
msgstr "xref:spring-data-jpa.adoc[Quarkus - Spring Data JPA 扩展]"

5. 翻译时标点符号的注意事项:

   有待补充...

---

高频词汇表

(可结合CTRL + F 搜索进行使用)

在实际翻译时 应当结合句意进行翻译

英文词汇	中文翻译(参考)
guide	指南
roughly	大约
prerequisites	先决条件
architecture	架构
solution	解决方案
bootstrapping	引导启动
explains	解释
native	本地
base	基础
example	示例
snippets	代码段
profiles	环境配置
expressions	表达式
external	外部
specification	规范
image	镜像
extension	扩展
instructions	说明
field	字段
package	打包

写在最后

注意事项将不定期进行更新 不足之处恳请各位指正。

欢迎大家在 Discussions 进行留言讨论。

[Leibnizhu]

已更新到主贴

[Leibnizhu]

thx

[zhfeng]

恩，我们整理一下，有人用过github的wiki功能吗？

[virtualss]

尚未，或许可以参考一下 [https://docs.github.com/cn/communities/documenting-your-project-with-wikis/about-wikis](关于 wikis)

[WillemJiang]

Github wiki可以直接使用markdown格式，可以把上面的内容贴过去。

[zhfeng]

好的，那我试试看。你也来翻译几篇吧 :)

[zhfeng]

https://github.com/quarkusio/cn.quarkus.io/wiki/%E7%BF%BB%E8%AF%91%E7%BB%86%E8%8A%82%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9