维护说明

本页面向维护者介绍 Wiki 的上传与本地部署方式。返回关于 Wiki。

腾讯文档维护

觉得 GitHub 有难度、只是想顺手补条信息？可以直接编辑《青岛大学 Wiki 校园指南》腾讯文档（登录后按左侧目录树对应板块修改即可），管理员会定期把社区在腾讯文档里补充的新内容同步回本站。这是零门槛的维护方式，推荐给不熟悉 Git 的朋友。

步骤：

注意事项：

文件请用简洁贴切的中文名，如 青岛大学本科新生指南.pdf
体积较大的文件（如几十 MB 的压缩包、视频）不建议直接放进仓库，可先上传到网盘（百度网盘、阿里云盘）或 GitHub Releases，再在主页放下载链接：
```
[资料名称](下载链接)
```
涉及个人隐私的信息（姓名、学号、身份证号等）请先脱敏再上传

步骤：

图片统一放在 docs/pics/ 目录下，并按板块放入对应的子文件夹：

注意事项：

本 Wiki 以「Markdown 文件 + 配置文件」的方式搭建，维护非常简单：

新增 / 修改内容：直接在 docs/ 目录下新建或编辑 .md 文件即可，无需编写任何代码
更新导航：新页面建好后，只需在根目录的 mkdocs.yml 的 nav 中加一行，例如：
```
- 新板块:
  - 新页面: new/page.md
```
本地部署：安装依赖后执行 mkdocs serve 即可本地预览，具体步骤见下方「本地部署」

维护原则：页面只存文字和链接，数据尽量放外部存储，这样 Wiki 会始终保持轻量、易维护。

想在本机预览或修改 Wiki，需要先安装依赖（需已安装 Python）：

pip install mkdocs-material mkdocs-git-revision-date-localized-plugin mkdocs-git-committers-plugin

然后在项目根目录启动本地预览：

mkdocs serve

浏览器打开 http://127.0.0.1:8000 即可预览，修改文件后页面会自动刷新。

提示