常见问题

这是什么？

这是 803 的作业记录项目，用来为忘记作业的人提供参考。

这也是一个 Sphinx 文档项目，但并非用于部署文档。

* 怎么做的？

这个项目被存储在 The GitHub Repository 上，使用了 Read the Docs tutorial 模板。

网页主要由 Sphinx 文档生成工具 渲染，而整个项目由 Read the Docs 托管。感兴趣的话可以参考 Sphinx 项目部署文档 。

* 为什么选择在线上发布？

线上的功能更丰富。

这就很像一个类似的问题“真的不是大材小用吗？”。

每次打开怎么都那么慢？

大多数情况下不是我的问题。也可能是，因为我不是 Read the Docs 的付费用户，在公共资源访问高峰时一般打开较慢；不过据我所知，这可能和你连接的网络、你的设备（例如，用 803的破电脑 时），以及使用的浏览器有关。

另外， Cloudflare 的安全验证可能也要花费很多时间（这个是自带的）。

移动端该怎么找到以前的作业内容？

看到左上角的“菜单”图标了吗？点击它就能看到一个搜索框。无论你正在哪个页面浏览，这都会启用 全局搜索。

展开右下角的“ReadtheDocs”菜单也可以找到搜索框(Search docs)。

好像要输入至少3个字符才会自动调用搜索。

真的不是大材小用吗？

可能是的。

但使用 Sphinx 部署文档还是有优点的。这里的文档编辑功能很好用。支持 粗体 ， 斜体 ， 字面值 ，超链接，交叉引用，以及 ---

代码块

.. 这可以生成一张表格

+--------+------+------------+
|文档类型|线上  |线下        |
+========+======+============+
|优点    |灵活  |随处可写    |
+--------+------+------------+
|缺点    |要联网|形式单一    |
|        |      |可见范围有限|
+--------+------+------------+

，还有 ---

提示

提示信息...

以及，如 * 怎么做的？ 所述，每次源文件修改并上传到 GitHub 后，文档会自动生成。这意味着，无论你在什么地方，只要面前有一台可以联网的设备（并且拥有像我这样的管理员权限），就可以通过 Commit （提交）请求更新文档。

后续维护怎么样？

按照计划，这个项目将持续维护～😊