此仓库包含 single-spa中文文档 的文档及源码,并由官方实时同步。
- Git
- Node: install version 8.4 or greater
- Yarn: See Yarn website for installation instructions
- A fork of the repo (for any contributions)
- A clone of the single-spa.js.org repo on your local machine
cd single-spa.js.org
to go into the project rootyarn
to install the website's npm dependencies
cd website
然后yarn start
开启本地热更新服务。 (powered by Docusaurus)open http://localhost:3000
打开浏览器查看效果。
如果你想帮助翻译single-spa.js.org
? 请参考下列步骤。
- 请 fork 这个仓库
- 在
single-spa.js.org
仓库的任何目录下执行git checkout master
- 执行
git pull origin master
确保你的代码是最新的。 - 执行
git checkout -b the-name-of-my-branch
创建一个新的分支 (起一个合适的分支名字来替换the-name-of-my-branch
)
- 保存翻译的文件并在浏览器查看效果
- 在
website/src
的修改将会自动更新 - 修改
docs
下的markdown文件也会自动更新 siteConfig.js
和sideBards.json
不会自动更新
词汇表(Glossary)
文档翻译的过程中,经常出现的词会总结在词汇表中。如 mount,bootstrap,application等。
- 如果可以, 测试所有最新版本的常用浏览器的任何视觉变化,包括桌面浏览器和移动浏览器。
git add . && git commit -m "My message"
(在My message
出填入提交信息, 比如修改页面顶部logo
) to 暂存和提交代码git push my-fork-name the-name-of-my-branch
- 去自己 fork 仓库下查找新提交的
my-fork-name
分支,发起Pull Request。 - 如果方便,请把改动截图一并提交。