Consolidate docs: one Sphinx project, language subdirectories (Eng/, Zh-TW/, Zh-CN/, API/)

[JE-Chen]

Summary

Cross-language navigation never worked on the public site because only the English source was deployed by RTD; the manual switcher links to ../html-zh-TW/ were 404s. Adopt WebRunner's docs layout instead: one Sphinx project with language subdirectories. All three languages now build into a single deployment, and cross-language navigation goes through normal Sphinx toctrees inside the same project.

New tree

docs/source/
  conf.py · index.rst                      ← slim hero + 4 toctrees
  Eng/{eng_index.rst, architecture.rst, usage/*.rst}
  Zh-TW/{zh_tw_index.rst, architecture.rst, usage/*.rst}
  Zh-CN/{zh_cn_index.rst, architecture.rst, usage/*.rst}
  API/{api_index.rst, *.rst}               ← language-neutral autodoc

What changed

• Top-level docs/source/index.rst — slim WebRunner-style hero (title, tagline, PyPI / GitHub / License bullets, organisation paragraph) followed by four toctrees: English manual, 繁體中文手冊, 简体中文手册, API reference. Each toctree points at one chapter sub-index.
• Four chapter sub-indexes — Eng/eng_index.rst, Zh-TW/zh_tw_index.rst, Zh-CN/zh_cn_index.rst, API/api_index.rst. Each has a .. contents:: directive plus chapter sections, each section toctree'ing to one chapter doc.
• All chapter docs moved under their language subdirectory; architecture.rst is now per-language under each subdir.
• Single API tree under API/ — translated API titles dropped, since the autodoc-generated content was identical across languages and was producing 28 duplicate object description warnings.
• Dropped docs/source.zh-TW/, docs/source.zh-CN/, .readthedocs.zh-TW.yaml, .readthedocs.zh-CN.yaml, the per-language conf.py files, the per-language index.rst files, and the html-zh-TW / html-zh-CN / html-all targets in make.bat / Makefile.
• Cleaned docs/source/conf.py — removed html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "") (single-project setup; canonical URL handling is no longer per-language).

Commits in this PR

• 1e2c700 Consolidate docs into one Sphinx project with language subdirectories

Test plan

• Build clean: rm -rf docs/_build && py -m sphinx -b html docs/source docs/_build/html → build succeeded with no new toctree / autodoc-duplicate warnings (only the 8 pre-existing CJK punctuation warnings inside chapter docs remain).
• Confirm sidebar shows four captions: English manual, 繁體中文手冊, 简体中文手册, API reference.
• Click each language section in the rendered index.html: confirm it lands on the corresponding sub-index, and every chapter link opens a real page.
• After RTD rebuilds the merged main: confirm https://fileautomation.readthedocs.io/en/latest/ shows all four sections, with /Eng/..., /Zh-TW/..., /Zh-CN/..., /API/... all reachable.

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

_{NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud