docs: add .mrs highligh

README.md

@@ -1 +1,35 @@
-packages//misakura//README.md
+# AvgJS | Misakura
+
+<!--  markdownlint-disable -->
+<div align="center">
+
+[![wakatime](https://wakatime.com/badge/user/018dc603-712a-4205-a226-d4c9ccd0d02b/project/018e02fd-86e0-4f1e-9af9-61d0b70582b6.svg)](https://wakatime.com/badge/user/018dc603-712a-4205-a226-d4c9ccd0d02b/project/018e02fd-86e0-4f1e-9af9-61d0b70582b6)
+
+<img src="https://raw.githubusercontent.com/BIYUEHU/misakura/master/packages/view/src-tauri/icons/misakura.png" width="200px" height="200px" alt="logo"/>
+
+🌸 Next generation lightweight visual novel/Galgame game production engine 🌸
+
+</div>
+<!--  markdownlint-enable -->
+
+> Stack: Rust + Tauri + Solid.js + TypeScript
+
+More information please visit [avg.js.org](https://avg.js.org).
+
+- [Demo](https://avg.js.org/guide/demo.html)
+
+## Declaration
+
+1. We only welcome to **Japanese** visual novels and galgame, don't accept any non-Japanese visual novels maker or producer in this project and especially the Zhinese .
+2. **japanese visual novels maker and producer** don't represent you must be a Japanese person, but represent you can only create and make japanese visual novels and galgame. Nobody likes to see ugly someone (Zhinaman) make the visual novels base on elements of his country and said "国 GAL 崛起 (Zhinese visual novels are rising)". That behaviors must be rejected because it makes people feel uncomfortable and disgusting, and orthodox Japanese culture must be respected.
+
+## Pictures
+
+![1](https://files.superbed.cn/proxy/7468686c6f2633337a7570796f326f696c796e7e7978327f72336f68736e793375717d7b796f33282533292a332a2a78252b297d2478257f2f2c2b7e2b792525782825292a326c727b.png)
+![2](https://files.superbed.cn/proxy/7468686c6f2633337a7570796f326f696c796e7e7978327f72336f68736e793375717d7b796f33282b337829332a2a78252b297d2478257f2f2c2b7e2b79252578282b7829326c727b.png)
+![3](https://files.superbed.cn/proxy/7468686c6f2633337a7570796f326f696c796e7e7978327f72336f68736e793375717d7b796f33287e33792d332a2a78252b297d2578257f2f2c2b7e2b79252578287e792d326c727b.png)
+![4](https://files.superbed.cn/proxy/7468686c6f2633337a7570796f326f696c796e7e7978327f72336f68736e793375717d7b796f332425332525332a2a78252b297e7978257f2f2c2b7e2b7925257824252525326c727b.png)
+![5](https://files.superbed.cn/proxy/7468686c6f2633337a7570796f326f696c796e7e7978327f72336f68736e793375717d7b796f33242533782e332a2a78252b297e7978257f2f2c2b7e2b792525782425782e326c727b.png)
+![6](https://files.superbed.cn/proxy/7468686c6f2633337a7570796f326f696c796e7e7978327f72336f68736e793375717d7b796f33242433792a332a2a78252b297e7878257f2f2c2b7e2b792525782424792a326c727b.png)
+![7](https://files.superbed.cn/proxy/7468686c6f2633337a7570796f326f696c796e7e7978327f72336f68736e793375717d7b796f33287d33247a332a2a78252b297d2478257f2f2c2b7e2b79252578287d247a326c727b.png)
+![8](https://files.superbed.cn/proxy/7468686c6f2633337a7570796f326f696c796e7e7978327f72336f68736e793375717d7b796f33282a332d2f332a2a78252b297d2b78257f2f2c2b7e2b79252578282a2d2f326c727b.png)

docs/.vitepress/cache/deps/_metadata.json

@@ -1,25 +1,25 @@
 {
-  "hash": "53e02bf5",
-  "configHash": "3efb2b57",
+  "hash": "ec8e31e1",
+  "configHash": "ea886d30",
   "lockfileHash": "e9749797",
-  "browserHash": "b75ffca4",
+  "browserHash": "f2a16d5b",
   "optimized": {
     "vue": {
       "src": "../../../../node_modules/.pnpm/[email protected][email protected]/node_modules/vue/dist/vue.runtime.esm-bundler.js",
       "file": "vue.js",
-      "fileHash": "349624e0",
+      "fileHash": "c4c0ede5",
       "needsInterop": false
     },
     "vitepress > @vue/devtools-api": {
       "src": "../../../../node_modules/.pnpm/@[email protected]/node_modules/@vue/devtools-api/dist/index.js",
       "file": "vitepress___@vue_devtools-api.js",
-      "fileHash": "0590f7cf",
+      "fileHash": "7586fef6",
       "needsInterop": false
     },
     "vitepress > @vueuse/core": {
       "src": "../../../../node_modules/.pnpm/@[email protected][email protected][email protected]_/node_modules/@vueuse/core/index.mjs",
       "file": "vitepress___@vueuse_core.js",
-      "fileHash": "926d47d5",
+      "fileHash": "2a1de451",
       "needsInterop": false
     }
   },

docs/.vitepress/config.ts

@@ -1,6 +1,8 @@
 import { defineConfig } from 'vitepress'
 import navbar from './config/navbar'
 import sidebar from './config/sidebar'
+import misakurarustscript from '../../extension/syntaxes/mrs.tmLanguage.json'
+
 
 export default defineConfig({
   srcDir: 'src',
@@ -24,8 +26,21 @@ export default defineConfig({
     sidebar: sidebar,
     socialLinks: [{ icon: 'github', link: 'https://github.com/biyuehu/misakura' }],
     footer: {
-      copyright: 'MIT Licensed | Copyright © 2024 Hotaru'
+      copyright: '<a target="_blank" href="https://github.com/iceagenb/ban-zhinese-using/blob/main/LICENSE.md">BCU Licensed</a> | Copyright © 2024 - 2025 Hotaru'
     }
   },
-  lastUpdated: true
+  lastUpdated: true,
+  markdown: {
+    theme: {
+      light: 'vitesse-light',
+      dark: 'vitesse-dark'
+    },
+    languages: [
+      {
+        // biome-ignore lint:
+        ...(misakurarustscript as any),
+        aliases: ['misakura',]
+      }
+    ]
+  }
 })

docs/src/guide/setup.md

@@ -109,4 +109,64 @@ fn main() {
 
 **public/scripts/main.mrs**:
 
-![script](https://pic.imgdb.cn/item/65f832d29f345e8d0328d459.png)
+```mrs
+# Main.mrs - Misakura 脚本默认入口文件
+
+# 加载 i18n 国际化文件
+# using /locales/ --global
+
+# 加载背景
+background /images/background/1.png
+
+# 加载角色
+character neri --name '角色名字' --figure /images/figure/neri.png
+# Options:
+  # -N, --name 设置角色显示名字
+  # -F, --figure 设置角色当前使用立绘
+  # -V, --voice 设置角色语音文件
+
+# 对话
+# 无说话者消息（角色独白），阻塞指令（将暂停程序直至用户点击屏幕）
+say '这是一串非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常非常长的文本'
+# 有说话者消息
+say 'hi' -S neri
+# Options:
+  # -S, --speaker 设置该消息的说话者
+
+play /audio/music/1.flac
+# 播放背景音乐（循环播放）
+
+# 显示角色立绘
+show neri
+
+neri: 这是一个对话测试
+# say 指令语法糖, 等同于 say '这是一个对话测试' -S neri
+neri: 这也是一个对话测试
+: 又是一个段落
+# 当上文有设置 speaker 时，下文可无需再次设置 speaker
+# 此处的speaker为上面的neri，适当的使用这种语法糖对于脚本的简化是非常重要的
+
+think: 自带的 character ID：⌈think⌋，代表角色独白
+think: 适当的在游戏使用独白内容可展示当前角色的心理活动
+think: 至于角色独白到底是哪个角色的心理活动，并不需要明确在脚本中指代，这取决于剧情上下文（也就是编写脚本的你决定）
+think: 同时，一句话不应太过长。
+unknown: 自带的 character ID：⌈unknown⌋，代表未知角色
+: "这里有一些需使用转义 \\ 符号才可表示的英文符号：\" \', 因为这些符号已经用在了 Misakura 脚本中，如若不转义将会导致脚本语法错误"
+
+
+# 切换背景
+background /images/background/2.png
+show neri
+# 切换背景后会清除之前所有显示的角色，因此如果要展示角色的话需再次使用 show 指令
+neri: 又出现了！
+character neri --figure /images/figure/neri_smile.png
+# 再次使用 character 附上相应参数会更新相关角色信息
+# 此处更新了角色立绘图片 使其为一个笑脸表情
+neri: bye~~
+
+# 隐藏角色立绘
+show neri --hide
+
+: 'ending...'
+
+```