mirrorhelp
mirrorhelp copied to clipboard
ustclug
Documents about how to use repos on mirrors.ustc.edu.cn.
2021 年 12 月，CloudFlare 部分客户端软件 GPG 私钥遭到泄露，其后发布的[一篇博客](https://blog.cloudflare.com/dont-use-apt-key/)指出： > the impact of an improperly secured private key can have consequences that extend beyond the scope of one third-party repository. 简而言之，`apt-key` 加入的...
https://developer.github.com/v3/repos/statistics/ 中有如下 API `GET /repos/:owner/:repo/stats/contributors` 可以写一个 sphinx 扩展来自动更新贡献者的名单。
原因： * 观感比较凌乱 * help页面收录的显然是镜像使用帮助。没必要重复写出。  
刚刚提了个 [PR](#39)，增加了 EPEL 和 MariaDB 的帮助文档。由于没接触过 [Sphinx](http://www.sphinx-doc.org) 和 [reStructureText](http://docutils.sourceforge.net/rst.html) ，很是费了一番功夫。 希望提供一份贡献者指南，以帮助初学者快速入门，并保证文档风格的统一。 建议包含以下内容： - [x] 如何在本地预览文档（环境要求，安装依赖） - [ ] 如何添加一个新文档（文件位置、名称，添加后要相应修改哪些地方） - [ ] 帮助文档的结构（需包含那些部分） - [ ] 统一风格，比如 - [ ]...
镜像分类
目前[LUG wiki](https://lug.ustc.edu.cn/wiki/mirrors/help)上分类为： * 反向代理 * 桌面环境镜像 * 语言镜像 * 软件镜像 * Git 仓库镜像 * 发行版镜像 1. 考虑到桌面环境镜像只有KDE和gnome两个仓库，建议取消这个大类，建议并入”软件仓库“。 2. “反向代理”与修饰语（如“语言”，“发行版”）不是同一类属性，不宜放在同一个分类层级下。如：crates.io既属于反向代理，也属于语言镜像，无法做单一划分。建议取消“反向代理”分类。另一个原因是，用户在找帮助时，并不清楚这个仓库是完整镜像还是反向代理，因此“反向代理”分类对用户查找仓库而言并没有什么帮助。 3. 建议删除“git仓库镜像”分类，理由与取消“反向代理”类似。“git”描述的是仓库的管理工具，而“发行版“，”语言“ 描述的是仓库的内容。不宜放在一起描述。 分类方法一： - **发行版及软件包镜像**：debian, debian-cd, ubuntu, centos, AOSP... -...
使用命令行替换rpmfusion镜像源： ```shell sudo sed -e 's|^metalink=|#metalink=|g' \ -e 's|^#baseurl=http://download1.rpmfusion.org|baseurl=https://mirrors.ustc.edu.cn/rpmfusion|g' \ -i.bak \ /etc/yum.repos.d/rpmfusion*.repo ```
https://github.com/mirrorz-org/mirrorz-docs 一部分帮助页可以使用 mirrorz-docs 的来生成，可能需要手写生成器以及一些用于页面交互的 JS。
