添加部署相关

补全信息
2025-11-08 05:42:10 +08:00 · 2025-11-08 05:01:27 +08:00
17 changed files with 254 additions and 10 deletions
--- a/.dockerignore
+++ b/.dockerignore
@ -0,0 +1,15 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+site/
+.cache/
+
+# Virtual environments
+.venv
+
+# deploy scripts
+/deploy
--- a/.drone.yml
+++ b/.drone.yml
@ -0,0 +1,54 @@
+kind: pipeline
+type: docker
+name: 构建静态站点
+
+trigger:
+  event:
+    - push
+  branch:
+    - master
+
+steps:
+  - name: 构建 Docker 镜像
+    image: plugins/docker:latest
+    privileged: true
+    settings:
+      username: kagami-ci
+      password:
+        from_secret: KAGAMI-CI-PASSWORD
+      repo: gitea.service.jazzwhom.top/mttu-developers/docs
+      registry: gitea.service.jazzwhom.top
+      tags:
+        - latest
+        - latest-${DRONE_COMMIT_SHA}
+      dockerfile: Dockerfile
+    volumes:
+      - name: docker-socket
+        path: /var/run/docker.sock
+  - name: 部署到服务器
+    image: plugins/ansible:3
+    settings:
+      playbook: deploy/deploy.ansible.yml
+      inventory: deploy/inventory.ini
+      primary_key:
+        from_secret: CI-DEPLOY-KEY
+      user:
+        from_secret: CI-DEPLOY-USER
+      limit:
+        from_secret: CI-DEPLOY-SERVER
+  - name: 发送构建结果到 ntfy
+    image: parrazam/drone-ntfy
+    when:
+      status: [success, failure]
+    settings:
+      url: https://ntfy.service.jazzwhom.top
+      topic: drone_ci
+      tags:
+        - drone-ci
+      token:
+        from_secret: NTFY_TOKEN
+
+volumes:
+  - name: docker-socket
+    host:
+      path: /var/run/docker.sock
--- a/18
+++ b/18
@ -0,0 +1,18 @@
+FROM astral/uv:python3.12-bookworm-slim AS builder
+
+RUN apt-get update && \
+    apt-get install -y git --no-install-recommends && \
+    rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+COPY pyproject.toml .
+COPY uv.lock .
+
+RUN uv sync --locked
+
+COPY . .
+RUN uv run mkdocs build
+
+FROM nginx:alpine
+COPY --from=builder /app/site /usr/share/nginx/html
--- a/README.md
+++ b/README.md
@ -12,12 +12,6 @@ source ./.venv/bin/activate.fish  # 如果你在 fish
 uv install
 ```

-如果你不用 fish，或者觉得直接安装所有东西也没事：
-
-```bash
-pip install mkdocs watchfiles
-```
-
 ### Dev

 运行一个 Dev 服务器以查看效果
--- a/deploy/deploy.ansible.yml
+++ b/deploy/deploy.ansible.yml
@ -0,0 +1,17 @@
+---
+- name: 部署最新版文档
+  hosts: jazzwhom_server
+  gather_facts: no
+  vars:
+    app_path: /opt/mttu-doc
+
+  tasks:
+    - name: 上传文件
+      ansible.builtin.copy:
+        src: docker-compose.yml
+        dest: "{{ app_path }}/docker-compose.yml"
+    - name: 启动服务
+      community.docker.docker_compose_v2:
+        project_src: "{{ app_path }}"
+        state: present
+        pull: yes
--- a/deploy/docker-compose.yml
+++ b/deploy/docker-compose.yml
@ -0,0 +1,4 @@
+services:
+  mttu-doc-web:
+    image: gitea.service.jazzwhom.top/mttu-developers/docs:latest
+    restart: unless-stopped
--- a/deploy/inventory.ini
+++ b/deploy/inventory.ini
@ -0,0 +1,3 @@
+[jazzwhom_server]
+# Placeholder target only...
+deploy_target_host ansible_host=127.0.0.1 ansible_user=placeholder
--- a/docs/links/imgs/mttu-cyjl-qrcode.jpg
+++ b/docs/links/imgs/mttu-cyjl-qrcode.jpg
--- a/docs/links/mttu-cyjl.md
+++ b/docs/links/mttu-cyjl.md
@ -0,0 +1,5 @@
+# MTTU 成语接龙社
+
+其实只是 [此方 BOT](../projects/konabot.md) 的刷屏群而已。对于一些比较刷屏的功能（例如坏枪写的成语接龙、坏枪写的炸空调等），请在这个群聊使用。该群同时有 WZQ 的 testpilot 机器人的功能测试。
+
+![成语接龙社的链接](./imgs/mttu-cyjl-qrcode.jpg){ width="300" }
--- a/docs/links/mttu-matrix.md
+++ b/docs/links/mttu-matrix.md
@ -0,0 +1,26 @@
+# MTTU Matrix 校区
+
+[Matrix](https://matrix.org/) 是一个开源的去中心化聊天协议，可以允许你在不使用大厂软件的情况下进行聊天，而且所有的聊天都是去中心化的，还有可选使用的端到端加密功能。
+
+MTTU Matrix 校区则是由 passthem 建立的 Matrix 校区。你可以通过任何支持 Matrix 协议的端到端加密应用访问该校区。
+
+主要讨论内容：Unix / 自部署 / DIY / 开发 / 技术向内容
+
+## 下载软件
+
+要加入 MTTU 的 Matrix 群聊，你需要有一个支持 Matrix 协议的聊天软件，下面是一些推荐：
+
+- [Element](https://element.io/download)：Windows/Linux/Mac/Android/iOS/[网页端](https://app.element.io/)
+- [Cinny](https://cinny.in/)：[网页端](https://app.cinny.in/)
+- [ThunderBird](https://www.thunderbird.net/zh-CN/)：你能理解吗，这是一个邮件客户端，但是它居然支持 Matrix 协议。。。
+- [FluffyChat](https://fluffy.chat/en/)：Linux(Snap/Flatpak)/Andriod/iOS/Web
+
+## 注册账号
+
+你当然可以选择注册 `matrix.org` 账号，但是这个账号将不能在国内正常工作。为了方便大家使用，我部署了一个 [Conduit](https://conduit.rs/) 实例，你可以在这上面注册账号。具体流程是，在你的 Matrix 客户端，注册账号时，选择的服务器是 `matrix.passthem.top`。对于 `Registeration Token` 即 `注册密令`（不是密码，是类似邀请码一样的东西），请在群公告中寻找。
+
+## 加入校区群聊
+
+你可以加入校区群聊：[https://matrix.to/#/#mttu-tech:matrix.passthem.top](https://matrix.to/#/#mttu-tech:matrix.passthem.top)
+
+如果遇到不能加入的情况，可以私信我，我邀请你进入。
--- a/docs/links/pt-oopz.md
+++ b/docs/links/pt-oopz.md
@ -0,0 +1,5 @@
+# 小帕游戏屋
+
+一个专门用来游戏连麦的 Oopz 群聊。在群里打游戏时会用到。
+
+邀请链接：[https://oopz.cn/i/ig6QZE](https://oopz.cn/i/ig6QZE)
--- a/docs/links/ralmon-discord.md
+++ b/docs/links/ralmon-discord.md
@ -0,0 +1,12 @@
+# Ralmon 每日计数器
+
+Ralmon 的计数器「自习室」，大家会在这里直播连麦写作业。模拟的是 Chromeme 的连麦做作品的氛围，大家会在里面有氛围地学习 / 做作品。
+
+## 食用教程
+
+语音频道分为 `开始计数器` 和 `暂停计数器`，分别代表学习 / 专注专区和闲聊专区。
+
+## 链接
+
+[https://discord.gg/wv499GKC](https://discord.gg/wv499GKC)
+
--- a/docs/projects/konabot.md
+++ b/docs/projects/konabot.md
@ -1,6 +1,6 @@
 # 此方 Bot

-此方 Bot (QQ: 3928110595) 是一个主要活动于 MTTU，并且被引入了多个群聊的多功能 QQ 机器人。
+此方 Bot (QQ: 3928110595) 是一个主要活动于 MTTU，并且被引入了多个群聊的多功能 QQ 机器人。这个 Bot 欢迎大家进行自由开发，也欢迎所有刚开始学习 Python 的朋友使用这个项目练习。如果需要代码的编辑权限，请联系我以获得账号密码。

 ## 我有一些功能需要私聊

--- a/docs/projects/okiba.md
+++ b/docs/projects/okiba.md
@ -0,0 +1,22 @@
+# 小帕置放场
+
+小帕置放场可承担代投业务，也可以上传任何好玩的梗视频。对于代转载业务，我不会帮你下载视频，请你提前下载好以后发送给我。
+
+同时可承担代发动态业务，如果需要代发动态（或者设置定时、发布投票等），可以直接跟我说。
+
+## 投稿信息准备
+
+如果需要投稿置放场视频，请准备好以下内容：
+
+- 视频本身
+- 标题
+- Tag
+- 简介
+- 封面
+- 是否匿名
+
+## 统一的投稿活动
+
+### 2026 元旦投稿祭
+
+详细请阅读群文档 `置放场素材` 文件夹内的 PDF 文件。
--- a/mkdocs.yml
+++ b/mkdocs.yml
@ -31,9 +31,14 @@ markdown_extensions:
  - md_in_html
 plugins:
  - search
+  - git-revision-date-localized:
+      enable_creation_date: true
+site_url: https://mttu.passthem.top
 theme:
  name: material
  language: zh
+  icon:
+    repo: fontawesome/brands/git-alt
  features:
    - navigation.instant
    - navigation.instant.progress
@ -42,22 +47,26 @@ theme:
    - navigation.tabs.sticky
    - search.suggest
    - search.highlight
+    - content.action.edit
    - navigation.footer
  palette:
    - media: "(prefers-color-scheme)"
      primary: teal
      toggle:
        icon: material/brightness-auto
-        name: Switch to light mode
+        name: 切换到亮色模式
    - media: "(prefers-color-scheme: light)"
      primary: teal
      scheme: default
      toggle:
        icon: material/brightness-7
-        name: Switch to dark mode
+        name: 切换到暗色模式
    - media: "(prefers-color-scheme: dark)"
      primary: teal
      scheme: slate
      toggle:
        icon: material/brightness-4
-        name: Switch to system preference
+        name: 切换到系统偏好模式
+repo_url: https://gitea.service.jazzwhom.top/mttu-developers/mttu-docs
+repo_name: mttu-developers/mttu-docs
+edit_uri: _edit/master/docs/
--- a/pyproject.toml
+++ b/pyproject.toml
@ -6,6 +6,7 @@ readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
    "mkdocs>=1.6.1",
+    "mkdocs-git-revision-date-localized-plugin>=1.5.0",
    "mkdocs-material>=9.6.23",
 ]

--- a/uv.lock
+++ b/uv.lock
@ -8,6 +8,7 @@ version = "0.1.0"
 source = { virtual = "." }
 dependencies = [
    { name = "mkdocs" },
+    { name = "mkdocs-git-revision-date-localized-plugin" },
    { name = "mkdocs-material" },
 ]

@ -19,6 +20,7 @@ dev = [
 [package.metadata]
 requires-dist = [
    { name = "mkdocs", specifier = ">=1.6.1" },
+    { name = "mkdocs-git-revision-date-localized-plugin", specifier = ">=1.5.0" },
    { name = "mkdocs-material", specifier = ">=9.6.23" },
 ]

@ -161,6 +163,30 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/f7/ec/67fbef5d497f86283db54c22eec6f6140243aae73265799baaaa19cd17fb/ghp_import-2.1.0-py3-none-any.whl", hash = "sha256:8337dd7b50877f163d4c0289bc1f1c7f127550241988d568c1db512c4324a619", size = 11034, upload-time = "2022-05-02T15:47:14.552Z" },
 ]

+[[package]]
+name = "gitdb"
+version = "4.0.12"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "smmap" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/63b0fc47eb32792c7ba1fe1b694daec9a63620db1e313033d18140c2320a/gitdb-4.0.12.tar.gz", hash = "sha256:5ef71f855d191a3326fcfbc0d5da835f26b13fbcba60c32c21091c349ffdb571", size = 394684, upload-time = "2025-01-02T07:20:46.413Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a0/61/5c78b91c3143ed5c14207f463aecfc8f9dbb5092fb2869baf37c273b2705/gitdb-4.0.12-py3-none-any.whl", hash = "sha256:67073e15955400952c6565cc3e707c554a4eea2e428946f7a4c162fab9bd9bcf", size = 62794, upload-time = "2025-01-02T07:20:43.624Z" },
+]
+
+[[package]]
+name = "gitpython"
+version = "3.1.45"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "gitdb" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/9a/c8/dd58967d119baab745caec2f9d853297cec1989ec1d63f677d3880632b88/gitpython-3.1.45.tar.gz", hash = "sha256:85b0ee964ceddf211c41b9f27a49086010a190fd8132a24e21f362a4b36a791c", size = 215076, upload-time = "2025-07-24T03:45:54.871Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/01/61/d4b89fec821f72385526e1b9d9a3a0385dda4a72b206d28049e2c7cd39b8/gitpython-3.1.45-py3-none-any.whl", hash = "sha256:8908cb2e02fb3b93b7eb0f2827125cb699869470432cc885f019b8fd0fccff77", size = 208168, upload-time = "2025-07-24T03:45:52.517Z" },
+]
+
 [[package]]
 name = "idna"
 version = "3.11"
@ -301,6 +327,21 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/9f/d4/029f984e8d3f3b6b726bd33cafc473b75e9e44c0f7e80a5b29abc466bdea/mkdocs_get_deps-0.2.0-py3-none-any.whl", hash = "sha256:2bf11d0b133e77a0dd036abeeb06dec8775e46efa526dc70667d8863eefc6134", size = 9521, upload-time = "2023-11-20T17:51:08.587Z" },
 ]

+[[package]]
+name = "mkdocs-git-revision-date-localized-plugin"
+version = "1.5.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "babel" },
+    { name = "gitpython" },
+    { name = "mkdocs" },
+    { name = "tzdata", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0f/c5/1d3c4e6ddae6230b89d09105cb79de711655e3ebd6745f7a92efea0f5160/mkdocs_git_revision_date_localized_plugin-1.5.0.tar.gz", hash = "sha256:17345ccfdf69a1905dc96fb1070dce82d03a1eb6b0d48f958081a7589ce3c248", size = 460697, upload-time = "2025-10-31T16:11:34.44Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/bc/51/fe0e3fdb16f6eed65c9459d12bae6a4e1f0bb4e2228cb037e7907b002678/mkdocs_git_revision_date_localized_plugin-1.5.0-py3-none-any.whl", hash = "sha256:933f9e35a8c135b113f21bb57610d82e9b7bcc71dd34fb06a029053c97e99656", size = 26153, upload-time = "2025-10-31T16:11:32.987Z" },
+]
+
 [[package]]
 name = "mkdocs-material"
 version = "9.6.23"
@ -484,6 +525,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" },
 ]

+[[package]]
+name = "smmap"
+version = "5.0.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/44/cd/a040c4b3119bbe532e5b0732286f805445375489fceaec1f48306068ee3b/smmap-5.0.2.tar.gz", hash = "sha256:26ea65a03958fa0c8a1c7e8c7a58fdc77221b8910f6be2131affade476898ad5", size = 22329, upload-time = "2025-01-02T07:14:40.909Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/be/d09147ad1ec7934636ad912901c5fd7667e1c858e19d355237db0d0cd5e4/smmap-5.0.2-py3-none-any.whl", hash = "sha256:b30115f0def7d7531d22a0fb6502488d879e75b260a9db4d0819cfb25403af5e", size = 24303, upload-time = "2025-01-02T07:14:38.724Z" },
+]
+
 [[package]]
 name = "sniffio"
 version = "1.3.1"
@ -502,6 +552,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
 ]

+[[package]]
+name = "tzdata"
+version = "2025.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/95/32/1a225d6164441be760d75c2c42e2780dc0873fe382da3e98a2e1e48361e5/tzdata-2025.2.tar.gz", hash = "sha256:b60a638fcc0daffadf82fe0f57e53d06bdec2f36c4df66280ae79bce6bd6f2b9", size = 196380, upload-time = "2025-03-23T13:54:43.652Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5c/23/c7abc0ca0a1526a0774eca151daeb8de62ec457e77262b66b359c3c7679e/tzdata-2025.2-py2.py3-none-any.whl", hash = "sha256:1a403fada01ff9221ca8044d701868fa132215d84beb92242d9acd2147f667a8", size = 347839, upload-time = "2025-03-23T13:54:41.845Z" },
+]
+
 [[package]]
 name = "urllib3"
 version = "2.5.0"
Author	SHA1	Message	Date
passthem	dbaacaa582	添加部署相关 Some checks failed continuous-integration/drone/push Build is failing Details	2025-11-08 05:42:10 +08:00
passthem	d85723c44c	补全信息	2025-11-08 05:01:27 +08:00