Commit 19f073a95688023761246ab4eea15aca3174534f
1 parent
bc4c2a19
Refine Chinese wiki language toggle
Showing
908 changed files
with
949 additions
and
906 deletions
Too many changes to show.
To preserve performance only 100 of 908 files are displayed.
README.md
| @@ -2,6 +2,8 @@ | @@ -2,6 +2,8 @@ | ||
| 2 | 2 | ||
| 3 | This repository contains both language versions of the xly ERP framework wiki. | 3 | This repository contains both language versions of the xly ERP framework wiki. |
| 4 | 4 | ||
| 5 | +The Simplified Chinese documentation is translated from the English version. If the two versions conflict, the English documentation is authoritative. | ||
| 6 | + | ||
| 5 | ```text | 7 | ```text |
| 6 | xly-wiki/ | 8 | xly-wiki/ |
| 7 | ├── en/ English MkDocs project | 9 | ├── en/ English MkDocs project |
| @@ -32,4 +34,14 @@ Run either language directly: | @@ -32,4 +34,14 @@ Run either language directly: | ||
| 32 | .venv/bin/mkdocs serve -f zh/mkdocs.yml | 34 | .venv/bin/mkdocs serve -f zh/mkdocs.yml |
| 33 | ``` | 35 | ``` |
| 34 | 36 | ||
| 37 | +To test the language switcher, build both languages and serve the shared output root: | ||
| 38 | + | ||
| 39 | +```bash | ||
| 40 | +.venv/bin/mkdocs build -f en/mkdocs.yml | ||
| 41 | +.venv/bin/mkdocs build -f zh/mkdocs.yml | ||
| 42 | +python3 -m http.server 8000 -d site | ||
| 43 | +``` | ||
| 44 | + | ||
| 45 | +Then open `http://127.0.0.1:8000/en/` or `http://127.0.0.1:8000/zh/`. | ||
| 46 | + | ||
| 35 | For static hosting, publish the shared `site/` directory. | 47 | For static hosting, publish the shared `site/` directory. |
en/mkdocs.yml
| @@ -8,6 +8,7 @@ site_dir: ../site/en | @@ -8,6 +8,7 @@ site_dir: ../site/en | ||
| 8 | 8 | ||
| 9 | theme: | 9 | theme: |
| 10 | name: material | 10 | name: material |
| 11 | + custom_dir: ../overrides | ||
| 11 | language: en | 12 | language: en |
| 12 | features: | 13 | features: |
| 13 | - navigation.instant | 14 | - navigation.instant |
| @@ -115,6 +116,13 @@ nav: | @@ -115,6 +116,13 @@ nav: | ||
| 115 | - 7. Contributing: contributing.md | 116 | - 7. Contributing: contributing.md |
| 116 | 117 | ||
| 117 | extra: | 118 | extra: |
| 119 | + alternate: | ||
| 120 | + - name: English | ||
| 121 | + link: /en/ | ||
| 122 | + lang: en | ||
| 123 | + - name: 简体中文 | ||
| 124 | + link: /zh/ | ||
| 125 | + lang: zh | ||
| 118 | generator: false | 126 | generator: false |
| 119 | 127 | ||
| 120 | # Build strict mode is OFF for now (lots of empty stubs would otherwise fail). | 128 | # Build strict mode is OFF for now (lots of empty stubs would otherwise fail). |
overrides/partials/alternate.html
0 → 100644
| 1 | +{# Render language switching as a single direct toggle instead of a dropdown. #} | ||
| 2 | +{% set current = config.theme.language %} | ||
| 3 | +{% set icon = config.theme.icon.alternate or "material/translate" %} | ||
| 4 | +{% for alt in config.extra.alternate %} | ||
| 5 | + {% if alt.lang != current %} | ||
| 6 | + {% set path = page.url if page and page.url else "" %} | ||
| 7 | + <div class="md-header__option"> | ||
| 8 | + <a href="{{ alt.link ~ path }}" hreflang="{{ alt.lang }}" class="md-header__button md-icon" aria-label="Switch to {{ alt.name }}" title="Switch to {{ alt.name }}"> | ||
| 9 | + {% include ".icons/" ~ icon ~ ".svg" %} | ||
| 10 | + </a> | ||
| 11 | + </div> | ||
| 12 | + {% endif %} | ||
| 13 | +{% endfor %} |
zh/README.md
| @@ -5,6 +5,8 @@ | @@ -5,6 +5,8 @@ | ||
| 5 | 使用 [MkDocs Material](https://squidfunk.github.io/mkdocs-material/) 构建。 | 5 | 使用 [MkDocs Material](https://squidfunk.github.io/mkdocs-material/) 构建。 |
| 6 | Markdown 源文件在 `docs/` 下;静态 HTML 生成到 `../site/zh/`(已被 git 忽略)。 | 6 | Markdown 源文件在 `docs/` 下;静态 HTML 生成到 `../site/zh/`(已被 git 忽略)。 |
| 7 | 7 | ||
| 8 | +中文文档由英文版翻译得到;如果中英文内容冲突,以英文版为准。 | ||
| 9 | + | ||
| 8 | ## 内容结构 | 10 | ## 内容结构 |
| 9 | 11 | ||
| 10 | ```text | 12 | ```text |
| @@ -12,7 +14,7 @@ xly-wiki/zh/ | @@ -12,7 +14,7 @@ xly-wiki/zh/ | ||
| 12 | ├── docs/ ← markdown 源文件,编辑这里 | 14 | ├── docs/ ← markdown 源文件,编辑这里 |
| 13 | │ ├── index.md | 15 | │ ├── index.md |
| 14 | │ ├── concepts/ (心智模型) | 16 | │ ├── concepts/ (心智模型) |
| 15 | -│ ├── slices/ (端到端纵向切片) | 17 | +│ ├── slices/ (端到端垂直切片) |
| 16 | │ ├── reference/builder/ (面向 PM / 实施的操作说明) | 18 | │ ├── reference/builder/ (面向 PM / 实施的操作说明) |
| 17 | │ ├── reference/maintainer/ (面向 Java 开发的内部机制) | 19 | │ ├── reference/maintainer/ (面向 Java 开发的内部机制) |
| 18 | │ ├── auto-catalog/ ← 机器生成,不手工编辑 | 20 | │ ├── auto-catalog/ ← 机器生成,不手工编辑 |
zh/docs/auto-catalog/index.md
| @@ -6,7 +6,7 @@ | @@ -6,7 +6,7 @@ | ||
| 6 | 本章由 `scripts/gen_catalog.py` 重新生成;脚本通过 `~/.my.cnf` | 6 | 本章由 `scripts/gen_catalog.py` 重新生成;脚本通过 `~/.my.cnf` |
| 7 | 直接查询实时数据库。**不要手工编辑本章下的页面**,下一次重新生成时会被覆盖。 | 7 | 直接查询实时数据库。**不要手工编辑本章下的页面**,下一次重新生成时会被覆盖。 |
| 8 | 人工编写的说明应放在 [参考](../reference/builder/index.md) | 8 | 人工编写的说明应放在 [参考](../reference/builder/index.md) |
| 9 | -或 [纵向切片](../slices/index.md) 中,并从这里交叉链接过去。 | 9 | +或 [垂直切片](../slices/index.md) 中,并从这里交叉链接过去。 |
| 10 | 10 | ||
| 11 | - [数据表](tables/index.md) — 901 张基础表。 | 11 | - [数据表](tables/index.md) — 901 张基础表。 |
| 12 | - [视图](views/index.md) — 311 个视图。 | 12 | - [视图](views/index.md) — 311 个视图。 |
zh/docs/auto-catalog/tables/93wuliao.md
zh/docs/auto-catalog/tables/aaa.md
zh/docs/auto-catalog/tables/abc.md
zh/docs/auto-catalog/tables/accchecking.md
zh/docs/auto-catalog/tables/accdepart.md
zh/docs/auto-catalog/tables/accdepartdepartment.md
zh/docs/auto-catalog/tables/accexpenseentrybusinessmaster.md
zh/docs/auto-catalog/tables/accexpenseentrybusinessslave.md
zh/docs/auto-catalog/tables/accexpenseentrydepartmentmaster.md
zh/docs/auto-catalog/tables/accexpenseentrydepartmentslave.md
zh/docs/auto-catalog/tables/accexpenseentryworkcenterslave.md
zh/docs/auto-catalog/tables/accjobslave.md
zh/docs/auto-catalog/tables/accjobslavesum.md
zh/docs/auto-catalog/tables/accmaterialsinitmaster.md
zh/docs/auto-catalog/tables/accmaterialsinitslave.md
zh/docs/auto-catalog/tables/accmaterialsstore.md
zh/docs/auto-catalog/tables/accopsoutsideinstoremaster.md
zh/docs/auto-catalog/tables/accordercostanalysis.md
zh/docs/auto-catalog/tables/accordercostanalysisoperation.md
zh/docs/auto-catalog/tables/accordercostanmainalysis.md
zh/docs/auto-catalog/tables/accoutsidecheckingslave.md
zh/docs/auto-catalog/tables/accoutsideproductstore.md
zh/docs/auto-catalog/tables/accproductdoingmaster.md
zh/docs/auto-catalog/tables/accproductdoingslave.md
zh/docs/auto-catalog/tables/accproductinitmaster.md
zh/docs/auto-catalog/tables/accproductinitslave.md
zh/docs/auto-catalog/tables/accproductinstoreslave.md
zh/docs/auto-catalog/tables/accproductionmaterialsslave.md
zh/docs/auto-catalog/tables/accproductstore.md
zh/docs/auto-catalog/tables/accpurchaseinstoremaster.md
zh/docs/auto-catalog/tables/accworkcenter.md
zh/docs/auto-catalog/tables/accworkcenterworkcenter.md
zh/docs/auto-catalog/tables/accyfcyproductstore.md
zh/docs/auto-catalog/tables/accyfproductstore.md
zh/docs/auto-catalog/tables/act_evt_log.md
zh/docs/auto-catalog/tables/act_ge_bytearray.md
zh/docs/auto-catalog/tables/act_ge_property.md
zh/docs/auto-catalog/tables/act_hi_actinst.md
zh/docs/auto-catalog/tables/act_hi_attachment.md
zh/docs/auto-catalog/tables/act_hi_comment.md
zh/docs/auto-catalog/tables/act_hi_detail.md
zh/docs/auto-catalog/tables/act_hi_identitylink.md
zh/docs/auto-catalog/tables/act_hi_procinst.md
zh/docs/auto-catalog/tables/act_hi_taskinst.md
zh/docs/auto-catalog/tables/act_hi_varinst.md
zh/docs/auto-catalog/tables/act_procdef_info.md
zh/docs/auto-catalog/tables/act_re_deployment.md
zh/docs/auto-catalog/tables/act_re_model.md
zh/docs/auto-catalog/tables/act_re_procdef.md
zh/docs/auto-catalog/tables/act_ru_deadletter_job.md
zh/docs/auto-catalog/tables/act_ru_event_subscr.md
zh/docs/auto-catalog/tables/act_ru_execution.md
zh/docs/auto-catalog/tables/act_ru_identitylink.md
zh/docs/auto-catalog/tables/act_ru_job.md
zh/docs/auto-catalog/tables/act_ru_suspended_job.md
zh/docs/auto-catalog/tables/act_ru_task.md
zh/docs/auto-catalog/tables/act_ru_timer_job.md
zh/docs/auto-catalog/tables/act_ru_variable.md
zh/docs/auto-catalog/tables/advancecostcheckmaster.md
zh/docs/auto-catalog/tables/advancecostcheckslave.md
zh/docs/auto-catalog/tables/agvinstructmaster.md
zh/docs/auto-catalog/tables/agvinstructslave.md
zh/docs/auto-catalog/tables/agvpalletno.md
zh/docs/auto-catalog/tables/agvpalletnoitem.md
zh/docs/auto-catalog/tables/ai_agent.md
zh/docs/auto-catalog/tables/ai_global_agent_question_sql.md
zh/docs/auto-catalog/tables/ai_milvus_vector_record.md
zh/docs/auto-catalog/tables/ai_sql_error_history.md
zh/docs/auto-catalog/tables/ai_tool.md
zh/docs/auto-catalog/tables/ai_tool_detail_params.md
zh/docs/auto-catalog/tables/ai_user_agent_question.md
zh/docs/auto-catalog/tables/alltb.md
zh/docs/auto-catalog/tables/bba.md
zh/docs/auto-catalog/tables/biz_flow.md
zh/docs/auto-catalog/tables/biz_todo_copyto.md
zh/docs/auto-catalog/tables/biz_todo_item.md
zh/docs/auto-catalog/tables/budgetadjustmentcheckmaster.md
zh/docs/auto-catalog/tables/budgetadjustmentcheckslave.md
zh/docs/auto-catalog/tables/cahcashierinit.md
zh/docs/auto-catalog/tables/cahcostchangemaster.md
zh/docs/auto-catalog/tables/cahcostchangeslave.md
zh/docs/auto-catalog/tables/cahcustomerinit.md
zh/docs/auto-catalog/tables/cahfinancialadjust.md
zh/docs/auto-catalog/tables/cahfinancialadjustslave.md
zh/docs/auto-catalog/tables/cahfinancialtransfer.md
zh/docs/auto-catalog/tables/cahpaymentables.md
zh/docs/auto-catalog/tables/cahpaymentmaster.md
zh/docs/auto-catalog/tables/cahpaymentnewmaster.md
zh/docs/auto-catalog/tables/cahpaymentslave.md
zh/docs/auto-catalog/tables/cahpaymentsumslave.md
zh/docs/auto-catalog/tables/cahreceiptmaster.md
zh/docs/auto-catalog/tables/cahreceiptnewmaster.md
zh/docs/auto-catalog/tables/cahreceiptslave.md
zh/docs/auto-catalog/tables/cahreceiptsumslave.md