mirror-web/README.md
2016-11-16 15:05:13 +08:00

47 lines
1.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# TUNA mirrors 主页
## 运行 Demo
本站使用 Jekyll 编写,并使用 babel 编译 ECMAScript6因此必须安装 ruby >= 2.0 和 nodejs.
```
bundle install
jekyll build
```
为正常运行,一些动态数据文件需要下载
```
wget https://mirrors.tuna.tsinghua.edu.cn/static/tunasync.json -O static/tunasync.json
wget https://mirrors.tuna.tsinghua.edu.cn/static/tunet.json -O static/tunet.json
wget https://mirrors.tuna.tsinghua.edu.cn/static/isoinfo.json -O static/isoinfo.json
```
之后 `jekyll serve` 即可运行 demo.
## 贡献文档
### 基本步骤
1. Fork 本项目并 clone
2. 创建分支 `git checkout -b foo-doc`
3.`_posts/help` 中建立文档文件,文件名格式为 `年-月-日-名称.md`
4. 用 markdown 语法编写文档
5. 提交并推送代码
6. 发送 Pull Request
### 写作规范
1. 对于相对不知名的镜像项目,首先用一两句话介绍该项目
2. 写明使用方法, 使用 Github Flavored Markdown 格式
3. 中英文字符间应留一个空格
### 特殊用法
#### 表单选择
例如 <http://mirrors.tuna.tsinghua.edu.cn/help/tensorflow/> 中,通过表单选择操作系统和版本号,建议直接使用 Vue.js