想要参与翻译的小伙伴,请注意。
参与翻译的提前技能有:GitHub、Git、Markdown、命令行操作、英语(Google翻译也可)
这里推荐一个很不错的开源Git教程:https://github.com/geeeeeeeeek/git-recipes
这里推荐一个不错的Markdown教程:https://www.appinn.com/markdown/
在线编辑器推荐使用这个:https://pandao.github.io/editor.md/
了解github最好的方式是直接看github官方的中文教程。
想要贡献翻译,务必请熟知github的贡献规则,可以参看怎么在GitHub上为开源项目作贡献?。
关于与原作者仓库同步的问题,强烈推荐一篇由Pandas中文文档翻译小组团队成员 @Y-sir 编写的文章:Github上Fork别人的仓库,怎么保持自己的仓库内容和原始仓库同步。
Pandas 中文文档的最新版本使用的是 VuePress 文档生成工具来驱动的。
由于 VuePress 是基于 Nodejs 编写的工具,如果你想让文档在本地运行调试,你首先需要安装 Nodejs 在你的电脑上,非Windows操作系统推荐使用 nvm 来安装 Nodejs ,Windows操作系统的小伙伴可以直接下载最新版本的 Nodejs 的 Windows 安装包 。
请先打开命令行或者终端工具,然后切换到文档所在的目录,然后运行以下功能命令。
这是拿到文档之后的第一步。
这个命令的作用是安装工具的依赖包,这是拿到文档之后第一次必须要运行的命令,且只需要运行一次,之后再翻译无需运行此命令。
$ npm install
想要查看翻译的效果,可以运行下面这个命令。
$ npm run dev
$ npm run build