feat(create-rstack): add i18n documentation template

Author: chenjiahan

packages/create-rstack/README.md

@@ -38,6 +38,7 @@ npx create-rstack -d my-project -t app-vanilla-ts
 - `lib-solid-js` - JavaScript Solid library
 - `lib-solid-ts` - TypeScript Solid library
 - `doc-basic` - Basic documentation site
+- `doc-i18n` - Multilingual documentation site
 
 ## Documentation
 

packages/create-rstack/src/index.ts

@@ -44,7 +44,26 @@ const getTemplateName = async ({ template }: Argv): Promise<string> => {
   );
 
   if (projectType === 'doc') {
-    return 'doc-basic';
+    const documentationType = checkCancel<string>(
+      await select({
+        message: 'Choose documentation language setup',
+        initialValue: 'basic',
+        options: [
+          {
+            value: 'basic',
+            label: 'Single language',
+            hint: 'docs',
+          },
+          {
+            value: 'i18n',
+            label: 'Multilingual',
+            hint: 'docs/en, docs/zh',
+          },
+        ],
+      }),
+    );
+
+    return `doc-${documentationType}`;
   }
 
   const templateType = checkCancel<string>(
@@ -101,6 +120,7 @@ await create({
     'lib-solid-js',
     'lib-solid-ts',
     'doc-basic',
+    'doc-i18n',
   ],
   builtinTools: [],
   getTemplateName,

packages/create-rstack/template-doc-i18n/AGENTS.md

@@ -0,0 +1,13 @@
+# AGENTS.md
+
+## Commands
+
+- `{{ packageManager }} run dev` - Start the documentation development server
+- `{{ packageManager }} run build` - Build the documentation site for production
+- `{{ packageManager }} run preview` - Preview the production build locally
+
+## Docs
+
+- Rstack: https://rstack.rs/llms.txt
+- Rspress: https://rspress.rs/llms.txt
+- Rsbuild: https://rsbuild.rs/llms.txt

packages/create-rstack/template-doc-i18n/README.md

@@ -0,0 +1,34 @@
+# Rstack multilingual documentation site
+
+## Setup
+
+Install the dependencies:
+
+```bash
+{{ packageManager }} install
+```
+
+## Get started
+
+Start the development server:
+
+```bash
+{{ packageManager }} run dev
+```
+
+Build the website for production:
+
+```bash
+{{ packageManager }} run build
+```
+
+Preview the production build locally:
+
+```bash
+{{ packageManager }} run preview
+```
+
+## Learn more
+
+- [Rstack documentation](https://rstack.rs)
+- [Rspress documentation](https://rspress.rs)

packages/create-rstack/template-doc-i18n/docs/en/_nav.json

@@ -0,0 +1,16 @@
+[
+  {
+    "text": "Guide",
+    "link": "/guide/start/introduction",
+    "activeMatch": "/guide/"
+  },
+  {
+    "text": "API",
+    "link": "/api/",
+    "activeMatch": "/api/"
+  },
+  {
+    "text": "Rspress",
+    "link": "https://rspress.rs/"
+  }
+]

packages/create-rstack/template-doc-i18n/docs/en/api/_meta.json

@@ -0,0 +1 @@
+["index", "commands"]

packages/create-rstack/template-doc-i18n/docs/en/api/commands.mdx

@@ -0,0 +1,25 @@
+# Commands
+
+## dev
+
+Start the local development server:
+
+```bash
+rs doc
+```
+
+## build
+
+Build the documentation site for production:
+
+```bash
+rs doc build
+```
+
+## preview
+
+Preview the production build locally:
+
+```bash
+rs doc preview
+```

packages/create-rstack/template-doc-i18n/docs/en/api/index.mdx

@@ -0,0 +1,6 @@
+---
+title: API Overview
+overview: true
+---
+
+This is an API Overview page which outlines all the available APIs.

packages/create-rstack/template-doc-i18n/docs/en/guide/_meta.json

@@ -0,0 +1,7 @@
+[
+  {
+    "type": "dir-section-header",
+    "name": "start",
+    "label": "Getting Started"
+  }
+]

packages/create-rstack/template-doc-i18n/docs/en/guide/start/_meta.json

@@ -0,0 +1 @@
+["introduction"]