CQU Mirrors 主页

该项目已进入冻结状态，除非安全问题否则处于慢速维护状态

对于最新使用请访问镜像站前端项目

本主页是在 TUNA 镜像主页 的基础上做了一些个性化配置。感谢 TUNA。

运行 Demo

直接编译

本站使用 Jekyll 编写，并使用 babel 编译 ECMAScript6，因此必须安装 ruby >= 2.7 和 nodejs.

bundle install
jekyll build

注意： 由于 jekyll 和 ruby 3.0 存在兼容性问题，且 ruby 本身要求对系统目录的完全访问，因此，推荐使用 docker 配置开发环境。推荐非 docker 开发本地配置环境方法如下：

# 以下方法仅针对 Linux
# cd into project dir
# 1. To avoid permission deny on ruby needs to write to /usr/lib
sudo bundle install

# 2. To avoid jeklly build error. See: https://github.com/jekyll/jekyll/issues/8523#issuecomment-751409319
sudo bundle add webrick

# 3. To avoid esbundle from building failed
bundle exec jekyll serve --trace --watch # serve on localhost

bundle exec jekyll build # build static site

如果你在 bundle install 中感觉到速度异常慢（即使更换了仓库），这是预期现象，换什么网络什么硬件都很慢。

Build In Docker

cd mirror-web
docker build -t builden -f Dockerfile.build .
docker run -it -v /path/to/mirror-web/:/data builden

为正常运行，一些动态数据文件需要下载

wget https://mirrors.cqu.edu.cn/static/tunasync.json -O static/tunasync.json
wget https://mirrors.cqu.edu.cn/static/tunet.json -O static/tunet.json
wget https://mirrors.cqu.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. 中英文字符间应留一个空格