diff --git a/README.md b/README.md index c8d5991..c3380c9 100644 --- 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 服务器以查看效果 diff --git a/docs/links/imgs/mttu-cyjl-qrcode.jpg b/docs/links/imgs/mttu-cyjl-qrcode.jpg new file mode 100644 index 0000000..8aa663e Binary files /dev/null and b/docs/links/imgs/mttu-cyjl-qrcode.jpg differ diff --git a/docs/links/mttu-cyjl.md b/docs/links/mttu-cyjl.md new file mode 100644 index 0000000..3bdb0f7 --- /dev/null +++ b/docs/links/mttu-cyjl.md @@ -0,0 +1,5 @@ +# MTTU 成语接龙社 + +其实只是 [此方 BOT](../projects/konabot.md) 的刷屏群而已。对于一些比较刷屏的功能(例如坏枪写的成语接龙、坏枪写的炸空调等),请在这个群聊使用。该群同时有 WZQ 的 testpilot 机器人的功能测试。 + +![成语接龙社的链接](./imgs/mttu-cyjl-qrcode.jpg){ width="300" } diff --git a/docs/links/mttu-matrix.md b/docs/links/mttu-matrix.md index e69de29..7b5f61f 100644 --- 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) + +如果遇到不能加入的情况,可以私信我,我邀请你进入。 diff --git a/docs/links/pt-oopz.md b/docs/links/pt-oopz.md new file mode 100644 index 0000000..d2534ed --- /dev/null +++ b/docs/links/pt-oopz.md @@ -0,0 +1,5 @@ +# 小帕游戏屋 + +一个专门用来游戏连麦的 Oopz 群聊。在群里打游戏时会用到。 + +邀请链接:[https://oopz.cn/i/ig6QZE](https://oopz.cn/i/ig6QZE) diff --git a/docs/links/ralmon-discord.md b/docs/links/ralmon-discord.md new file mode 100644 index 0000000..b39bf3e --- /dev/null +++ b/docs/links/ralmon-discord.md @@ -0,0 +1,12 @@ +# Ralmon 每日计数器 + +Ralmon 的计数器「自习室」,大家会在这里直播连麦写作业。模拟的是 Chromeme 的连麦做作品的氛围,大家会在里面有氛围地学习 / 做作品。 + +## 食用教程 + +语音频道分为 `开始计数器` 和 `暂停计数器`,分别代表学习 / 专注专区和闲聊专区。 + +## 链接 + +[https://discord.gg/wv499GKC](https://discord.gg/wv499GKC) + diff --git a/docs/projects/konabot.md b/docs/projects/konabot.md index 7dc3cba..fa95646 100644 --- 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 的朋友使用这个项目练习。如果需要代码的编辑权限,请联系我以获得账号密码。 ## 我有一些功能需要私聊 diff --git a/docs/projects/okiba.md b/docs/projects/okiba.md index e69de29..053e16a 100644 --- a/docs/projects/okiba.md +++ b/docs/projects/okiba.md @@ -0,0 +1,22 @@ +# 小帕置放场 + +小帕置放场可承担代投业务,也可以上传任何好玩的梗视频。对于代转载业务,我不会帮你下载视频,请你提前下载好以后发送给我。 + +同时可承担代发动态业务,如果需要代发动态(或者设置定时、发布投票等),可以直接跟我说。 + +## 投稿信息准备 + +如果需要投稿置放场视频,请准备好以下内容: + +- 视频本身 +- 标题 +- Tag +- 简介 +- 封面 +- 是否匿名 + +## 统一的投稿活动 + +### 2026 元旦投稿祭 + +详细请阅读群文档 `置放场素材` 文件夹内的 PDF 文件。 diff --git a/mkdocs.yml b/mkdocs.yml index 9a53482..947058b 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -31,9 +31,13 @@ markdown_extensions: - md_in_html plugins: - search + - git-revision-date-localized: + enable_creation_date: true theme: name: material language: zh + icon: + repo: fontawesome/brands/git-alt features: - navigation.instant - navigation.instant.progress @@ -42,6 +46,7 @@ theme: - navigation.tabs.sticky - search.suggest - search.highlight + - content.action.edit - navigation.footer palette: - media: "(prefers-color-scheme)" @@ -61,3 +66,6 @@ theme: toggle: icon: material/brightness-4 name: Switch to system preference +repo_url: https://gitea.service.jazzwhom.top/mttu-developers/mttu-docs +repo_name: mttu-developers/mttu-docs +edit_uri: _edit/master/docs/ diff --git a/pyproject.toml b/pyproject.toml index 5654d7c..546f7a4 100644 --- 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", ] diff --git a/uv.lock b/uv.lock index 172623a..db05cd3 100644 --- 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"