Merge pull request #596 from Hi-Windom/huge_merge

Huge merge

.gitattributes

@@ -3,4 +3,5 @@ app/stage/** linguist-vendored
 app/src/asset/pdf/** linguist-vendored
 *.yml linguist-language=shell
 *.bat linguist-language=shell
-*.json linguist-language=shell
+*.json linguist-language=shell
+*.mdx linguist-language=astro

.github/README.md

@@ -15,35 +15,48 @@
 <a href="../README_zh_CN.md">思源（SiYuan）</a> | <a href="README_Sillot.md">汐洛（Sillot）</a>
 </p>
 
+## 📚 文档
+
+<p align="center">
+<h2>正常访问<a href="https://sillot.db.sc.cn/"> https://sillot.db.sc.cn/ </a></h2>
+<h2>代理访问<a href="https://sillot-docs.db.sc.cn/"> https://sillot-docs.db.sc.cn/ </a></h2>
+</p>
+
 <p align="center">
-<br><br><br><br><br>
+<br><br>
 <img alt="split" src="./split.png"/>
+<br><br><br>
 </p>
 
-## 浏览器兼容性
+## 🔭 Roadmap
 
-<img src="../screenshots/sillot/es2022.png"/>
+<p align="center">
+<h2><a href="https://github.com/orgs/Hi-Windom/projects/2/views/2">汐洛路线图（Sillot Roadmap）</a></h2>
+<h2><a href="https://github.com/orgs/Hi-Windom/projects/3/views/2">汐洛安卓路线图（Sillot Android Roadmap）</a></h2>
+<h2><a href="https://github.com/orgs/Hi-Windom/projects/4/views/2">汐洛社区路线图（Sillot Community Roadmap）</a></h2>
+</p>
 
 <p align="center">
-<br><br><br><br><br>
+<br><br>
 <img alt="split" src="./split.png"/>
+<br><br><br>
 </p>
 
-## 🛠️ Contributors
+## 🌐 兼容性
 
-<a href="https://github.com/Hi-Windom/Sillot/graphs/contributors">
-   <img src="https://contrib.rocks/image?repo=Hi-Windom/Sillot" />
-</a>
+<span>
+<img src="https://img.shields.io/badge/Chromium 94+-black?logo=Google Chrome&logoColor=white" title="Chromium 94+" height="31"/><img src="https://img.shields.io/badge/Windows 10+-black?logo=Windows 11" title="Windows 10+" height="31"/><img src="https://img.shields.io/badge/Android 11+-black?logo=android" title="Android 11+" height="31"/>
+</span>
+<img src="../screenshots/sillot/es2022.png"/>
 
 <p align="center">
-<br><br><br><br><br>
+<br><br>
 <img alt="split" src="./split.png"/>
+<br><br><br>
 </p>
 
-## 🔭 Roadmap
+## 🛠️ 贡献者
 
-<p align="center">
-<h2><a href="https://github.com/orgs/Hi-Windom/projects/2/views/2">汐洛路线图（Sillot Roadmap）</a></h2>
-<h2><a href="https://github.com/orgs/Hi-Windom/projects/3/views/2">汐洛安卓路线图（Sillot Android Roadmap）</a></h2>
-<h2><a href="https://github.com/orgs/Hi-Windom/projects/4/views/2">汐洛社区路线图（Sillot Community Roadmap）</a></h2>
-</p>
+<a href="https://github.com/Hi-Windom/Sillot/graphs/contributors">
+   <img src="https://contrib.rocks/image?repo=Hi-Windom/Sillot" />
+</a>

docs/starlight/astro.config.mjs

@@ -1,24 +1,59 @@
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
+import starlightLinksValidator from 'starlight-links-validator'
 
 // https://astro.build/config
 export default defineConfig({
+  site: 'https://sillot.db.sc.cn',
+  prefetch: true, // REF https://docs.astro.build/zh-cn/guides/prefetch/
+  plugins: [
+    starlightLinksValidator({
+      errorOnFallbackPages: false, // 未翻译的页面不会报错
+      errorOnRelativeLinks: false,
+    }),
+  ],
 	integrations: [
+    // [src/content/docs/] 将由 starlight 负责样式，[src/pages/] 则不受影响，在自定义页面中使用 Starlight 布局，请使用 <StarlightPage /> 组件包装页面内容。
+    // REF https://starlight.astro.build/zh-cn/guides/pages/
 		starlight({
-			title: '🦢 Sillot Docs',
+			title: 'Sillot Docs 🦢',
+      logo: {
+        src: './src/assets/icon.svg',
+      },
 			social: {
 				github: 'https://github.com/Hi-Windom/Sillot',
 			},
-			sidebar: [
+      editLink: {
+        baseUrl: 'https://github.com/Hi-Windom/Sillot/edit/master/docs/starlight',
+      },
+      lastUpdated: true,
+      defaultLocale: 'root', // 可选
+      locales: {
+        root: {
+          label: '简体中文',
+          lang: 'zh-CN', // lang 是 root 语言必须的
+        },
+        // 英文文档在 `src/content/docs/en/` 中。
+        en: {
+          label: 'English',
+          lang: 'en',
+        },
+        ja: { label: '日本語', lang: 'ja' },
+        de: { label: 'Deutsch', lang: 'de' },
+        es: { label: 'Español', lang: 'es' },
+        fr: { label: 'Français', lang: 'fr' },
+        it: { label: 'Italiano', lang: 'it' },
+        ko: { label: '한국어', lang: 'ko' },
+        ru: { label: 'Русский', lang: 'ru' },
+      },
+			sidebar: [ // REF https://starlight.astro.build/zh-cn/guides/sidebar/
 				{
 					label: 'Guides',
-					items: [
-						// Each item here is one entry in the navigation menu.
-						{ label: 'Example Guide', link: '/guides/example/' },
-					],
+					autogenerate: { directory: '/guides' },
 				},
 				{
 					label: 'Reference',
+          collapsed: true, // 默认折叠分组
 					autogenerate: { directory: 'reference' },
 				},
         {
@@ -28,4 +63,7 @@ export default defineConfig({
 			],
 		}),
 	],
+  components: {
+    FeedbackComponent: "./src/components/FeedbackComponent.astro"
+  }
 });

docs/starlight/package.json

@@ -14,7 +14,12 @@
     "@astrojs/starlight": "^0.21.2",
     "@vercel/speed-insights": "^1.0.10",
     "astro": "^4.3.5",
+    "astro-feelback": "^0.3.4",
     "sharp": "^0.32.5",
+    "starlight-links-validator": "^0.6.0",
     "typescript": "^5.4.3"
+  },
+  "devDependencies": {
+    "sass": "^1.72.0"
   }
 }