diff --git a/.readthedocs.yaml b/.readthedocs.yaml index f5ddeac..496e3ff 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -1,11 +1,9 @@ # .readthedocs.yaml -# Read the Docs configuration file for the English ("fileautomation") project. -# Sibling files .readthedocs.zh-TW.yaml and .readthedocs.zh-CN.yaml configure -# the two translation projects. Wire each translation project to its own YAML -# in the RTD project admin (Settings → Default settings → Path), and link the -# three projects via the main project's Translations tab. +# Read the Docs configuration file. The single Sphinx project under +# docs/source/ builds all three languages into one site (subdirectories +# Eng/, Zh-TW/, Zh-CN/, and API/) — cross-language navigation works through +# normal Sphinx toctrees, with no per-language project required. # See https://docs.readthedocs.io/en/stable/config-file/v2.html -# https://docs.readthedocs.io/en/stable/localization.html # Required version: 2 @@ -16,7 +14,7 @@ build: tools: python: "3.11" -# Build the English documentation in docs/source with Sphinx. +# Build the documentation in docs/source/ with Sphinx. sphinx: configuration: docs/source/conf.py diff --git a/.readthedocs.zh-CN.yaml b/.readthedocs.zh-CN.yaml deleted file mode 100644 index 453ae18..0000000 --- a/.readthedocs.zh-CN.yaml +++ /dev/null @@ -1,22 +0,0 @@ -# .readthedocs.zh-CN.yaml -# Read the Docs configuration file for the Simplified Chinese -# ("fileautomation-zh-cn") translation project. Linked from the main -# "fileautomation" project's Translations tab so RTD serves it at -# https://fileautomation.readthedocs.io/zh_CN//. -# See https://docs.readthedocs.io/en/stable/config-file/v2.html -# https://docs.readthedocs.io/en/stable/localization.html - -version: 2 - -build: - os: ubuntu-22.04 - tools: - python: "3.11" - -# Build the Simplified Chinese documentation in docs/source.zh-CN with Sphinx. -sphinx: - configuration: docs/source.zh-CN/conf.py - -python: - install: - - requirements: docs/requirements.txt diff --git a/.readthedocs.zh-TW.yaml b/.readthedocs.zh-TW.yaml deleted file mode 100644 index 3b8e46b..0000000 --- a/.readthedocs.zh-TW.yaml +++ /dev/null @@ -1,22 +0,0 @@ -# .readthedocs.zh-TW.yaml -# Read the Docs configuration file for the Traditional Chinese -# ("fileautomation-zh-tw") translation project. Linked from the main -# "fileautomation" project's Translations tab so RTD serves it at -# https://fileautomation.readthedocs.io/zh_TW//. -# See https://docs.readthedocs.io/en/stable/config-file/v2.html -# https://docs.readthedocs.io/en/stable/localization.html - -version: 2 - -build: - os: ubuntu-22.04 - tools: - python: "3.11" - -# Build the Traditional Chinese documentation in docs/source.zh-TW with Sphinx. -sphinx: - configuration: docs/source.zh-TW/conf.py - -python: - install: - - requirements: docs/requirements.txt diff --git a/docs/Makefile b/docs/Makefile index b304cc6..01e66b5 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -4,7 +4,7 @@ SPHINXBUILD ?= sphinx-build SOURCEDIR = source BUILDDIR = _build -.PHONY: help html clean html-zh-TW html-zh-CN html-all +.PHONY: help html clean help: @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) @@ -12,13 +12,5 @@ help: html: @$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) -html-zh-TW: - @$(SPHINXBUILD) -b html source.zh-TW "$(BUILDDIR)/html-zh-TW" $(SPHINXOPTS) - -html-zh-CN: - @$(SPHINXBUILD) -b html source.zh-CN "$(BUILDDIR)/html-zh-CN" $(SPHINXOPTS) - -html-all: html html-zh-TW html-zh-CN - clean: @$(SPHINXBUILD) -M clean "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) diff --git a/docs/make.bat b/docs/make.bat index cf6d346..45d7073 100644 --- a/docs/make.bat +++ b/docs/make.bat @@ -18,27 +18,9 @@ if errorlevel 9009 ( exit /b 1 ) -if "%1" == "html-zh-TW" goto build-zh-TW -if "%1" == "html-zh-CN" goto build-zh-CN -if "%1" == "html-all" goto build-all - %SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% goto end -:build-zh-TW -%SPHINXBUILD% -b html source.zh-TW %BUILDDIR%\html-zh-TW %SPHINXOPTS% %O% -goto end - -:build-zh-CN -%SPHINXBUILD% -b html source.zh-CN %BUILDDIR%\html-zh-CN %SPHINXOPTS% %O% -goto end - -:build-all -%SPHINXBUILD% -M html %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% -%SPHINXBUILD% -b html source.zh-TW %BUILDDIR%\html-zh-TW %SPHINXOPTS% %O% -%SPHINXBUILD% -b html source.zh-CN %BUILDDIR%\html-zh-CN %SPHINXOPTS% %O% -goto end - :help %SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% diff --git a/docs/source.zh-CN/api/local.rst b/docs/source.zh-CN/api/local.rst deleted file mode 100644 index 9dbf0a2..0000000 --- a/docs/source.zh-CN/api/local.rst +++ /dev/null @@ -1,47 +0,0 @@ -本地操作 -======== - -.. automodule:: automation_file.local.file_ops - :members: - -.. automodule:: automation_file.local.dir_ops - :members: - -.. automodule:: automation_file.local.zip_ops - :members: - -.. automodule:: automation_file.local.sync_ops - :members: - -.. automodule:: automation_file.local.safe_paths - :members: - -.. automodule:: automation_file.local.shell_ops - :members: - -.. automodule:: automation_file.local.tar_ops - :members: - -.. automodule:: automation_file.local.json_edit - :members: - -.. automodule:: automation_file.local.conditional - :members: - -.. automodule:: automation_file.local.archive_ops - :members: - -.. automodule:: automation_file.local.diff_ops - :members: - -.. automodule:: automation_file.local.mime - :members: - -.. automodule:: automation_file.local.templates - :members: - -.. automodule:: automation_file.local.trash - :members: - -.. automodule:: automation_file.local.versioning - :members: diff --git a/docs/source.zh-CN/api/notify.rst b/docs/source.zh-CN/api/notify.rst deleted file mode 100644 index 15b4aa1..0000000 --- a/docs/source.zh-CN/api/notify.rst +++ /dev/null @@ -1,8 +0,0 @@ -通知 -==== - -.. automodule:: automation_file.notify.sinks - :members: - -.. automodule:: automation_file.notify.manager - :members: diff --git a/docs/source.zh-CN/api/progress.rst b/docs/source.zh-CN/api/progress.rst deleted file mode 100644 index e7a9306..0000000 --- a/docs/source.zh-CN/api/progress.rst +++ /dev/null @@ -1,11 +0,0 @@ -进度与取消 -========== - -传输的可选仪表化。对 :func:`~automation_file.download_file`、 -:func:`s3_upload_file` 或 :func:`s3_download_file` 传入 -``progress_name="