Trans

打造Service Mesh领域最全的中文资料库。

本仓库接受英文翻译与中文原创文章。

通过提交Issue的方式提交最新资料地址，翻译完成的文档归档到本仓库中。文档翻译完成后会显示在ServiceMesher社区门户网站和微信公众号中。

如何参与

参与该项目包括两种方式：

1. 通过提交Issue的方式提交文章线索
2. 参与文章翻译提交PR

提交 Issue

提交Issue，不一定需要翻译该文档，也可以是提交一个文章线索，在Issue模板中填写：

• 原文链接：原始出处URL
• 原文发布时间
• 译文链接（如果已翻译完成可以直接填写URL，若未翻译，可以提交PR创建新的文件）
• 作者：原文作者信息
• 译者：译者信息
• 类型：见Issue模板，选择文章对应的类型

注意：Issue标题请使用英文原文的标题，将所有字母小写

提交PR

提交PR 就需要提交对应Issue的译文文档，使用Markdown格式。

文档要求

文档格式为Markdown，尽量保留原文格式，可以根据中文阅读习惯适度调整，中英文之间、中文和数字之间不用加空格。

命名规则

文件使用英文命名，单词之间使用 - 连接，所有字母均为小写，例如 the-path-to-service-mesh.md。

目录结构

新的文档根据提交 PR 的时间在对应的目录中创建。如2018年5月30日提交的PR需要在 201805 目录中创建新的文档，即所有文档是按照月来归档的。

weekly目录保存Service Mesh周刊。

关于图片

图片使用微博图床，需要有新浪微博账户即可使用，它有以下特点：

• 上传的图片不会出现在你的个人相册中
• 可以选择上传原图和缩略图
• 支持HTTPS
• 本身是开源的

可以选择安装本地应用，也可以使用Chrome插件来上传。

推荐工具

编辑器

本仓库中的所有文章都是用Markdown格式编写，虽然Markdown是纯文本格式，可以使用任何编辑器编辑，设置是Vi也可以，但是工欲善其事，必先利其器，下面给大家推荐几款好用的Markdown编辑器。

Typora⭑⭑⭑⭑⭑

Typora是一款十分简洁的所见即所得的Markdown编辑器，支持多种操作系统，该软件虽然小巧但十分强大，足以满足您的所有需求。

Visual Studio Code⭑⭑⭑⭑

如果您习惯使用VS Code的话可以选择在其中安装Markdown插件。

图床工具

我们推荐以下新浪微博图床，该图床免费，没有存储大小限制，甚至不需要登陆微博账号。可以上传原图（所有图片会被转换成JPG格式）、GIF动图。

下面给大家推荐几款支持新浪微博图床的软件。

iPic⭑⭑⭑⭑⭑

Mac用户可以直接到App Store中搜索iPic就可以免费下载和使用了，与Typora结合使用更佳。安装了iPic后可以在typora中直接上传Markdown中引用的本地图片的新浪微博图床。

PicGo⭑⭑⭑⭑

下载PicGo。PicGo是一款开源的微博图床工具，使用起来十分简便。可以通过设置微博的用户名密码方式登录，也可以通过设置 Cookie 来登录。

如果选择使用 Cookie 来认证，需要打开 https://weibo.com/minipublish 页面，在 Chrome 中打开调试模式，然后选择【网络】标签页，刷新页面，看到有对 minipublish 的请求，在 Headers 里找到 Cookie，复制它的值填写到 PicGo 的微博设置中即可。

因为需要设置Cookie而且Cookie每隔一段时间就会过期，需要重新设置，所以PicGo用起来比较麻烦。

Chrome 插件⭑⭑⭑

在 Chrome store 中搜索 “微博图床” 就可以安装了，在 Chrome 浏览器中登陆新浪微博后就可以使用该插件上传图片了。

ServiceMesher—Service Mesh爱好者社区