使用mkdocs重构文档

Author: ZYKsslm

.gitattributes

@@ -0,0 +1,17 @@
+name: ci
+on:
+  push:
+    branches:
+      - main
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v4
+        with:
+          python-version: 3.x
+      - run: pip install mkdocs-material
+      - run: mkdocs gh-deploy --force

.github/workflows/ci.yml

@@ -1,7 +1,3 @@
 # Ren'Py：从入门到入坟
 
-**推荐在[文档网站](https://zyksslm.github.io/RenPy-Tutorial/doc/目录.html)中浏览。**
-
-***
-
-[目录](doc/目录.md)
+**[《Ren'Py：从入门到入坟》中文文档](https://zyksslm.github.io/RenPy-Tutorial)**

README.md

@@ -1,5 +1,3 @@
-{% raw %}
-
 # 你好，Ren'Py。
 
 > 合抱之木，生于毫末；百丈之台，起于垒土；千里之行，始于足下。——《老子》
@@ -51,13 +49,11 @@ Ren'Py几乎支持所有视觉小说所应该具有的功能，包括分支故
 | 图像          | `WEBP`                   |                           |
 | 图像          | BMP                      |                           |
 | 图像          | GIF                      | 不支持动图                 |
-|                                                                      |
 | 音频          | OPUS                     |                            |
 | 音频          | `OGG`                    |                            |
 | 音频          | FLAC                     |                            |
 | 音频          | `WAV`                    |                            |
 | 音频          | `MP3`                    |                            |
-|                                                                       |
 | 视频（容器）   | `WEBM`                   | 支持VP9、VP8编解码器        |
 | 视频（容器）   | `OGG`                    | 支持Theora编解码器          |
 | 视频（容器）   | MKV                      | 支持多种编解码器            |
@@ -277,5 +273,3 @@ label start:
 
 
 那么，在进行完所有的前置准备后，我们就要开始正式学习Ren'Py语法了。
-
-{% endraw %}

_config.yaml

@@ -1,5 +1,3 @@
-{% raw %}
-
 # 变量
 
 ## 变量定义
@@ -251,5 +249,3 @@ label start:
 # 导入alice存储区中的love变量
 from store.Alice import love
 ```
-
-{% endraw %}

_includes/head.html

@@ -1,5 +1,3 @@
-{% raw %}
-
 # 在开始之前
 
 ## 说明
@@ -31,5 +29,3 @@ E-mail：`[email protected]`
 ZYKsslm
 
 2025/01/14
-
-{% endraw %}

doc/目录.md renamed to docs/index.md

@@ -1,5 +1,3 @@
-{% raw %}
-
 # 对话
 
 文本剧情是视觉小说类游戏的根本，一切游戏形式都要建立在对话之上。Ren'Py为我们提供了简便快捷的say语句来方便演示对话。
@@ -356,5 +354,3 @@ label start:
     "？可恶"
     return
 ```
-
-{% endraw %}

doc/resources/images/default_ide.jpg renamed to docs/resources/images/default_ide.jpg

@@ -1,5 +1,3 @@
-{% raw %}
-
 # 脚本标签
 
 Ren'Py中所有的游戏流程代码都会分别写进数个脚本标签中。脚本标签类似于Python中的函数，用于跳转或调用。
@@ -178,5 +176,3 @@ label .local_label:
 ```
 
 在上面的代码中，有 `start` 和 `globel_label` 全局脚本标签，其分别关联了一个 `.local_label` 局部脚本标签。
-
-{% endraw %}

doc/resources/images/launcher.png renamed to docs/resources/images/launcher.png

@@ -0,0 +1,27 @@
+site_name: Ren'Py：从入门到入坟
+site_url: https://ZYKsslm.github.io/RenPy-Tutorial
+repo_url: https://github.com/ZYKsslm/RenPy-Tutorial
+theme:
+  name: material
+  language: zh
+nav:
+  - 在开始之前: 在开始之前.md
+  - 你好，Ren'Py。: 你好，Ren'Py。.md
+  - 变量: 变量.md
+  - 脚本标签: 脚本标签.md
+  - 对话: 对话.md
+markdown_extensions:
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+extra_javascript:
+  - https://cdn.jsdelivr.net/npm/[email protected]/components/prism-core.min.js
+  - https://cdn.jsdelivr.net/npm/[email protected]/components/prism-python.min.js
+  - https://cdn.jsdelivr.net/npm/[email protected]/plugins/autoloader/prism-autoloader.min.js
+  - https://cdn.jsdelivr.net/npm/[email protected]/plugins/line-numbers/prism-line-numbers.min.js
+  - https://cdn.jsdelivr.net/npm/[email protected]/plugins/copy-to-clipboard/prism-copy-to-clipboard.min.js
+extra_css:
+  - https://cdn.jsdelivr.net/npm/[email protected]/themes/prism-okaidia.min.css
+  - https://cdn.jsdelivr.net/npm/[email protected]/plugins/line-numbers/prism-line-numbers.min.css
+