# xly ERP 框架 Wiki

本仓库包含 xly ERP 框架 Wiki 的两个语言版本。

简体中文文档由英文版翻译得到；如果中英文内容冲突，以英文版为准。

```text
xly-wiki/
├── en/      英文 MkDocs 项目
├── zh/      简体中文 MkDocs 项目
└── site/    共享生成输出，已被 git 忽略
```

## 构建

```bash
.venv/bin/mkdocs build -f en/mkdocs.yml
.venv/bin/mkdocs build -f zh/mkdocs.yml
```

输出目录：

```text
site/en/
site/zh/
```

## 本地预览

单独预览任一语言：

```bash
.venv/bin/mkdocs serve -f en/mkdocs.yml
.venv/bin/mkdocs serve -f zh/mkdocs.yml
```

要测试语言切换按钮，需要先构建两种语言，并从共享输出目录启动静态服务：

```bash
.venv/bin/mkdocs build -f en/mkdocs.yml
.venv/bin/mkdocs build -f zh/mkdocs.yml
python3 -m http.server 8000 -d site
```

然后打开 `http://127.0.0.1:8000/zh/` 或 `http://127.0.0.1:8000/en/`。

静态托管时发布共享的 `site/` 目录。

---

# xly ERP Framework Wiki

This repository contains both language versions of the xly ERP framework wiki.

The Simplified Chinese documentation is translated from the English version. If the two versions conflict, the English documentation is authoritative.

```text
xly-wiki/
├── en/      English MkDocs project
├── zh/      Simplified Chinese MkDocs project
└── site/    shared generated output, ignored by git
```

## Build

```bash
.venv/bin/mkdocs build -f en/mkdocs.yml
.venv/bin/mkdocs build -f zh/mkdocs.yml
```

This writes:

```text
site/en/
site/zh/
```

## Serve Locally

Run either language directly:

```bash
.venv/bin/mkdocs serve -f en/mkdocs.yml
.venv/bin/mkdocs serve -f zh/mkdocs.yml
```

To test the language switcher, build both languages and serve the shared output root:

```bash
.venv/bin/mkdocs build -f en/mkdocs.yml
.venv/bin/mkdocs build -f zh/mkdocs.yml
python3 -m http.server 8000 -d site
```

Then open `http://127.0.0.1:8000/zh/` or `http://127.0.0.1:8000/en/`.

For static hosting, publish the shared `site/` directory.