完善一些文档语法风格 (#94)

* 完善一些文档语法风格

* 补充修改

Author: northword

src/.vuepress/config.ts

@@ -15,6 +15,13 @@ export default defineUserConfig({
   },
 
   theme,
+
+  markdown: {
+    headers: {
+      level: [2, 3, 4, 5],
+    },
+  },
+
   plugins: [
     searchProPlugin({
       // 索引全部内容

src/.vuepress/sidebar/index.ts

@@ -16,13 +16,7 @@ export const zhSidebar = sidebar({
       icon: "build",
       prefix: "contributing",
       collapsible: true,
-      children: [
-        "contributing",
-        "markdown",
-        "markdown-demo",
-        "vscode-dev",
-        "build",
-      ],
+      children: ["contributing", "markdown", "vscode-dev", "build"],
     },
   ],
 });

src/.vuepress/theme.ts

@@ -19,7 +19,9 @@ export default hopeTheme({
   docsDir: "src",
 
   hotReload: true,
+
   sidebarSorter: ["readme", "order", "filename", "title"],
+  headerDepth: 4,
 
   locales: {
     "/": {
@@ -57,7 +59,7 @@ export default hopeTheme({
     mdEnhance: {
       align: true,
       attrs: true,
-      chart: true,
+      // chart: true,
       checkLinks: {
         // 仅在开发模式下检查链接
         status: "always",
@@ -68,14 +70,14 @@ export default hopeTheme({
           "/playground.html",
         ],
       },
-      codetabs: true,
+      // codetabs: true,
       // demo: true,
       // echarts: true,
       figure: true,
-      flowchart: true,
-      gfm: true,
+      // flowchart: true,
+      // gfm: true,
       imgLazyload: true,
-      imgSize: true,
+      // imgSize: true,
       include: true,
       katex: true,
       mark: true,

src/contributing/contributing.md

@@ -2,7 +2,7 @@
 title: 贡献指南
 icon: build
 date: 2023-07-20 23:05:53
-updated: 2023-07-21 11:56:02
+updated: 2023-11-23 22:56:02
 ---
 
 # 贡献指南
@@ -28,9 +28,11 @@ Zotero 中文文档接受多种形式的贡献，请阅读这一份指南，以
 
 ## 提交 / 参与议题 / 讨论
 
-:::note
+读者可以在前述的几种途径参与讨论。
 
-读者需要一个 GitHub 账户才能提交发起或参与 ISSUE 讨论。
+::: note
+
+读者需要一个 GitHub 账户才能提交发起或参与讨论。
 
 :::
 
@@ -40,13 +42,7 @@ Zotero 中文文档接受多种形式的贡献，请阅读这一份指南，以
 
 若需要对文档做大量修改，可在经过讨论后，选择 [线下修改](build.md)。
 
-:::note
-
-若不熟悉 Markdown 标记语言，可以参考 [Markdown 语法指南](markdown.md)。
-
-:::
-
-:::note
+::: note
 
 文档源码开源托管在 [GitHub](https://github.com/) 上，因此读者需要一个 GitHub 账户才能提交 PR。