diff --git a/doc/docs/.vitepress/config.mts b/doc/docs/.vitepress/config.mts index 872791c..d5d8ef9 100644 --- a/doc/docs/.vitepress/config.mts +++ b/doc/docs/.vitepress/config.mts @@ -64,6 +64,7 @@ const sidebarText = { functionStubs: "Funktions-Stubs", usingClause: "Die Using-Klausel; Kontrolle destruktiver Zuweisung", yuescriptLibrary: "Die YueScript-Bibliothek", + mascot: "Maskottchen – Xiaoyu", licenseMit: "Lizenz: MIT", }, en: { @@ -99,6 +100,7 @@ const sidebarText = { functionStubs: "Function Stubs", usingClause: "The Using Clause; Controlling Destructive Assignment", yuescriptLibrary: "The YueScript Library", + mascot: "Mascot - Xiaoyu", licenseMit: "License: MIT", }, idId: { @@ -134,6 +136,7 @@ const sidebarText = { functionStubs: "Fungsi Sementara", usingClause: "Klausa Using; Mengontrol Penugasan Destruktif", yuescriptLibrary: "Pustaka YueScript", + mascot: "Maskot – Xiaoyu", licenseMit: "Lisensi: MIT", }, ptBr: { @@ -169,6 +172,7 @@ const sidebarText = { functionStubs: "Stubs de função", usingClause: "Cláusula using; controlando atribuição destrutiva", yuescriptLibrary: "A biblioteca do YueScript", + mascot: "Mascote – Xiaoyu", licenseMit: "Licença: MIT", }, zh: { @@ -204,6 +208,7 @@ const sidebarText = { functionStubs: "函数存根", usingClause: "使用 using 语句：防止破坏性赋值", yuescriptLibrary: "月之脚本语言库", + mascot: "吉祥物 – 小玉", licenseMit: "MIT 许可证", }, } as const; @@ -219,7 +224,7 @@ type SidebarGroupText = { dataStructures: string; objects: string; advancedFeatures: string; - reference: string; + extras: string; }; const sidebarGroups: Record = { @@ -232,7 +237,7 @@ const sidebarGroups: Record = { dataStructures: "Datenstrukturen", objects: "Objekte", advancedFeatures: "Erweiterte Funktionen", - reference: "Referenz", + extras: "Extras", }, en: { gettingStarted: "Getting Started", @@ -243,7 +248,7 @@ const sidebarGroups: Record = { dataStructures: "Data Structures", objects: "Objects", advancedFeatures: "Advanced Features", - reference: "Reference", + extras: "Extras", }, idId: { gettingStarted: "Memulai", @@ -254,7 +259,7 @@ const sidebarGroups: Record = { dataStructures: "Struktur Data", objects: "Objek", advancedFeatures: "Fitur Lanjutan", - reference: "Referensi", + extras: "Ekstra", }, ptBr: { gettingStarted: "Primeiros passos", @@ -265,7 +270,7 @@ const sidebarGroups: Record = { dataStructures: "Estruturas de dados", objects: "Objetos", advancedFeatures: "Recursos avançados", - reference: "Referência", + extras: "Extras", }, zh: { gettingStarted: "起步", @@ -276,7 +281,7 @@ const sidebarGroups: Record = { dataStructures: "数据结构", objects: "面向对象", advancedFeatures: "高级特性", - reference: "参考", + extras: "其他", }, }; @@ -414,16 +419,17 @@ function createSidebar(basePath: string, locale: SidebarLocale) { }, { text: text.do, link: `${basePath}/advanced/do` }, { text: text.try, link: `${basePath}/advanced/try` }, + { + text: text.yuescriptLibrary, + link: `${basePath}/advanced/the-yuescript-library`, + }, ], }, { - text: group.reference, + text: group.extras, collapsed: true, items: [ - { - text: text.yuescriptLibrary, - link: `${basePath}/reference/the-yuescript-library`, - }, + { text: text.mascot, link: `${basePath}/reference/mascot` }, { text: text.licenseMit, link: `${basePath}/reference/license-mit` }, ], }, @@ -450,7 +456,10 @@ export default defineConfig({ }, ], ["meta", { property: "og:type", content: "website" }], - ["meta", { property: "og:image", content: withBase("/image/yuescript.png") }], + [ + "meta", + { property: "og:image", content: withBase("/image/yuescript.png") }, + ], [ "meta", { diff --git a/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png new file mode 100644 index 0000000..5bab134 Binary files /dev/null and b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png differ diff --git a/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip new file mode 100644 index 0000000..e84ff36 Binary files /dev/null and b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip differ diff --git a/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png new file mode 100644 index 0000000..fdf8475 Binary files /dev/null and b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png differ diff --git a/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png new file mode 100644 index 0000000..90e4f47 Binary files /dev/null and b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png differ diff --git a/doc/docs/.vitepress/theme/components/prism-manual.js b/doc/docs/.vitepress/theme/components/prism-manual.js index 8f73abd..076dcf3 100644 --- a/doc/docs/.vitepress/theme/components/prism-manual.js +++ b/doc/docs/.vitepress/theme/components/prism-manual.js @@ -4,4 +4,3 @@ if (typeof window !== "undefined") { window.Prism = window.Prism || {}; window.Prism.manual = true; } - diff --git a/doc/docs/.vitepress/theme/custom.css b/doc/docs/.vitepress/theme/custom.css index 4050784..7e3a04b 100644 --- a/doc/docs/.vitepress/theme/custom.css +++ b/doc/docs/.vitepress/theme/custom.css @@ -40,16 +40,36 @@ --vp-c-text-2: #4a5568; } -/* Hero image - enlarge container to fit 450px image without overflow */ +/* Hero image - adjust container to fit mascot artwork without overflow */ @media (min-width: 960px) { .VPHero .image-container { - width: 450px !important; + width: 420px !important; + } + + .VPHero .image-src { + margin-top: 2.7rem !important; + padding-bottom: 2.7rem !important; } } -.VPHero :deep(.image-src) { - max-width: 450px; - max-height: 450px; +@media (max-width: 960px) { + .VPHero .image-src { + margin-top: 1rem !important; + padding-bottom: 3.2rem !important; + } +} + +@media (max-width: 639px) { + .VPHero .image-src { + margin-top: 3.2rem !important; + padding-bottom: 7.4rem !important; + } +} + +.VPHero .image-src { + max-width: 420px; + max-height: 360px; + object-fit: contain; } /* --- DARK MODE THEME (Midnight Blue) --- */ @@ -221,4 +241,4 @@ h6, /* Slight adjustment to code block background to fit the midnight theme */ .dark .vp-code-group .tabs label { background-color: #1a1f2e; -} \ No newline at end of file +} diff --git a/doc/docs/de/doc/reference/the-yuescript-library.md b/doc/docs/de/doc/advanced/the-yuescript-library.md similarity index 100% rename from doc/docs/de/doc/reference/the-yuescript-library.md rename to doc/docs/de/doc/advanced/the-yuescript-library.md diff --git a/doc/docs/de/doc/reference/mascot.md b/doc/docs/de/doc/reference/mascot.md new file mode 100644 index 0000000..ad0e982 --- /dev/null +++ b/doc/docs/de/doc/reference/mascot.md @@ -0,0 +1,39 @@ +# Maskottchen – Xiaoyu + +## Über + +Xiaoyu das Cyber-Kaninchen + +Xiaoyu (小玉, „kleines Jade") ist ein Cyber-Kaninchen und das offizielle Maskottchen des YueScript-Projekts. Man findet sie meistens auf einer Mondsichel sitzend, an ihrem Laptop tüftelnd – natürlich YueScript schreibend. + +Ihr vollständiger Titel ist Xiaoyu das Cyber-Kaninchen (机兔小玉), und sie verkörpert alles, was YueScript sein möchte: elegant, ausdrucksstark und ein kleines bisschen verspielt. + +Xiaoyu wurde von **[Tyson Tan](https://tysontan.com)** entworfen und illustriert, der sie großzügigerweise kostenlos für das Projekt erstellt hat – wofür wir unglaublich dankbar sind. + +## Bilder + +Hochauflösende Kunstwerke stehen unten zum Download bereit. Klicken Sie auf ein Bild, um es in voller Größe zu öffnen. + +### Vollständiges Kunstwerk + + + Xiaoyu — vollständiges Kunstwerk mit Hintergrund + + +

Vollständiges PNG herunterladen

+ +### Transparenter Hintergrund + + + Xiaoyu — transparenter Hintergrund + + +

Transparentes PNG herunterladen

+ +### Gezippte .kra-Datei + +

Gezippte .kra-Datei herunterladen

+ +## Lizenz + +Xiaoyu ist unter der [MIT-Lizenz](https://opensource.org/licenses/MIT) und der Creative-Commons-Lizenz [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) doppelt lizenziert. diff --git a/doc/docs/doc/reference/the-yuescript-library.md b/doc/docs/doc/advanced/the-yuescript-library.md similarity index 100% rename from doc/docs/doc/reference/the-yuescript-library.md rename to doc/docs/doc/advanced/the-yuescript-library.md diff --git a/doc/docs/doc/reference/mascot.md b/doc/docs/doc/reference/mascot.md new file mode 100644 index 0000000..028d17f --- /dev/null +++ b/doc/docs/doc/reference/mascot.md @@ -0,0 +1,39 @@ +# Mascot - Xiaoyu + +## About + +Xiaoyu the Cyber Rabbit + +Xiaoyu (小玉, "little jade") is a cyber rabbit and the official mascot of the YueScript project. She can usually be found perched atop a crescent moon, tinkering away on her laptop - writing YueScript, naturally. + +Her full title is Xiaoyu the Cyber Rabbit (机兔小玉), and she embodies everything YueScript strives to be: elegant, expressive, and a little bit playful. + +Xiaoyu was designed and illustrated by **[Tyson Tan](https://tysontan.com)**, who generously created her for the project free of charge - something we're incredibly grateful for. + +## Images + +Full‑resolution artwork is available for download below. Click any image to open it at full size. + +### Full Artwork + + + Xiaoyu — full artwork with background + + +

Download full-size PNG

+ +### Transparent Background + + + Xiaoyu — transparent background + + +

Download transparent PNG

+ +### Zipped .kra File + +

Download zipped .kra file

+ +## License + +Xiaoyu is dual‑licensed under the [MIT License](https://opensource.org/licenses/MIT) and the Creative Commons [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). diff --git a/doc/docs/id-id/doc/reference/the-yuescript-library.md b/doc/docs/id-id/doc/advanced/the-yuescript-library.md similarity index 100% rename from doc/docs/id-id/doc/reference/the-yuescript-library.md rename to doc/docs/id-id/doc/advanced/the-yuescript-library.md diff --git a/doc/docs/id-id/doc/reference/mascot.md b/doc/docs/id-id/doc/reference/mascot.md new file mode 100644 index 0000000..1b16706 --- /dev/null +++ b/doc/docs/id-id/doc/reference/mascot.md @@ -0,0 +1,39 @@ +# Maskot – Xiaoyu + +## Tentang + +Xiaoyu si Kelinci Siber + +Xiaoyu (小玉, "giok kecil") adalah seekor kelinci siber dan maskot resmi proyek YueScript. Ia biasanya ditemukan bertengger di atas bulan sabit, mengutak-atik laptopnya – menulis YueScript, tentu saja. + +Gelar lengkapnya adalah Xiaoyu si Kelinci Siber (机兔小玉), dan ia mewujudkan segala hal yang dicita-citakan YueScript: elegan, ekspresif, dan sedikit menyenangkan. + +Xiaoyu dirancang dan diilustrasikan oleh **[Tyson Tan](https://tysontan.com)**, yang dengan murah hati menciptakannya untuk proyek ini secara gratis – sesuatu yang sangat kami syukuri. + +## Gambar + +Karya seni resolusi penuh tersedia untuk diunduh di bawah ini. Klik gambar mana saja untuk membukanya dalam ukuran penuh. + +### Karya Seni Lengkap + + + Xiaoyu — karya seni lengkap dengan latar belakang + + +

Unduh PNG ukuran penuh

+ +### Latar Belakang Transparan + + + Xiaoyu — latar belakang transparan + + +

Unduh PNG transparan

+ +### File .kra Terkompresi + +

Unduh file .kra terkompresi

+ +## Lisensi + +Xiaoyu dilisensikan ganda di bawah [Lisensi MIT](https://opensource.org/licenses/MIT) dan Creative Commons [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). diff --git a/doc/docs/index.md b/doc/docs/index.md index 016b688..7d34f11 100644 --- a/doc/docs/index.md +++ b/doc/docs/index.md @@ -4,7 +4,7 @@ hero: name: YueScript tagline: A language that compiles to Lua image: - src: /image/yuescript.svg + src: /image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png alt: YueScript actions: - theme: brand diff --git a/doc/docs/pt-br/doc/reference/the-yuescript-library.md b/doc/docs/pt-br/doc/advanced/the-yuescript-library.md similarity index 100% rename from doc/docs/pt-br/doc/reference/the-yuescript-library.md rename to doc/docs/pt-br/doc/advanced/the-yuescript-library.md diff --git a/doc/docs/pt-br/doc/reference/mascot.md b/doc/docs/pt-br/doc/reference/mascot.md new file mode 100644 index 0000000..e2ff951 --- /dev/null +++ b/doc/docs/pt-br/doc/reference/mascot.md @@ -0,0 +1,39 @@ +# Mascote – Xiaoyu + +## Sobre + +Xiaoyu, a Coelha Cibernética + +Xiaoyu (小玉, "pequeno jade") é uma coelha cibernética e a mascote oficial do projeto YueScript. Ela geralmente pode ser encontrada empoleirada em uma lua crescente, mexendo em seu laptop – escrevendo YueScript, naturalmente. + +Seu título completo é Xiaoyu, a Coelha Cibernética (机兔小玉), e ela incorpora tudo o que o YueScript aspira ser: elegante, expressivo e um pouquinho divertido. + +Xiaoyu foi projetada e ilustrada por **[Tyson Tan](https://tysontan.com)**, que generosamente a criou para o projeto de forma gratuita – algo pelo qual somos incrivelmente gratos. + +## Imagens + +Artes em resolução completa estão disponíveis para download abaixo. Clique em qualquer imagem para abri-la em tamanho real. + +### Arte Completa + + + Xiaoyu — arte completa com fundo + + +

Baixar PNG em tamanho real

+ +### Fundo Transparente + + + Xiaoyu — fundo transparente + + +

Baixar PNG transparente

+ +### Arquivo .kra Compactado + +

Baixar arquivo .kra compactado

+ +## Licença + +Xiaoyu é duplamente licenciada sob a [Licença MIT](https://opensource.org/licenses/MIT) e a Creative Commons [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). diff --git a/doc/docs/zh/doc/reference/the-yuescript-library.md b/doc/docs/zh/doc/advanced/the-yuescript-library.md similarity index 100% rename from doc/docs/zh/doc/reference/the-yuescript-library.md rename to doc/docs/zh/doc/advanced/the-yuescript-library.md diff --git a/doc/docs/zh/doc/reference/mascot.md b/doc/docs/zh/doc/reference/mascot.md new file mode 100644 index 0000000..cc6c80e --- /dev/null +++ b/doc/docs/zh/doc/reference/mascot.md @@ -0,0 +1,39 @@ +# 吉祥物 – 小玉 + +## 简介 + +机兔小玉 + +小玉（Xiaoyu，意为"小小的玉"）是一只赛博兔，也是 YueScript 项目的官方吉祥物。她通常栖息在一弯新月之上，在笔记本电脑上忙碌着——当然是在写 YueScript。 + +她的全称是机兔小玉，体现了 YueScript 所追求的一切：优雅、富有表现力，还带着一点俏皮。 + +小玉由 **[Tyson Tan](https://tysontan.com)** 设计和绘制，他慷慨地免费为本项目创作了她——我们对此深表感激。 + +## 图片 + +以下提供全分辨率画作供下载。点击任意图片可查看原始尺寸。 + +### 完整画作 + + + 小玉 — 含背景的完整画作 + + +

下载完整 PNG

+ +### 透明背景 + + + 小玉 — 透明背景 + + +

下载透明背景 PNG

+ +### .kra 压缩文件 + +

下载 .kra 压缩文件

+ +## 许可证 + +小玉采用 [MIT 许可证](https://opensource.org/licenses/MIT) 和知识共享 [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) 双重许可。