添加中文文档

docs/conf.py

@@ -87,7 +87,9 @@
 # -- Internationalization ----------------------------------------------------
 
 # specifying the natural language populates some key tags
-language = "en"
+language = "zh_CN"
+locale_dirs = ['../locales/']  # po files will be created in this directory
+gettext_compact = False  # optional: avoid file concatenation in sub directories.
 
 # -- Ablog options -----------------------------------------------------------
 

locales/zh_CN/LC_MESSAGES/api/index.po

@@ -0,0 +1,33 @@
+# Translations template for PROJECT.
+# Copyright (C) 2024 ORGANIZATION
+# This file is distributed under the same license as the PROJECT project.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PROJECT VERSION\n"
+"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
+"POT-Creation-Date: 2024-12-20 16:26+0800\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <[email protected]>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.16.0\n"
+
+#: ../../api/index.rst:2
+msgid "API Reference"
+msgstr ""
+
+#: ../../api/index.rst:4
+msgid "This page contains auto-generated API reference documentation [#f1]_."
+msgstr ""
+
+#: ../../api/index.rst:11
+msgid ""
+"Created with `sphinx-autoapi <https://github.com/readthedocs/sphinx-"
+"autoapi>`_"
+msgstr ""
+

locales/zh_CN/LC_MESSAGES/api/pydata_sphinx_theme/edit_this_page/index.po

@@ -0,0 +1,60 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2019, PyData Community
+# This file is distributed under the same license as the PyData Theme
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PyData Theme \n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2024-12-20 16:23+0800\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language: zh_CN\n"
+"Language-Team: zh_CN <[email protected]>\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.16.0\n"
+
+#: ../../api/pydata_sphinx_theme/edit_this_page/index.rst:2
+msgid "pydata_sphinx_theme.edit_this_page"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/edit_this_page/index.rst:8
+msgid ""
+"Create an \"edit this page\" url compatible with bitbucket, gitlab and "
+"github."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/edit_this_page/index.rst:15
+msgid "Functions"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/edit_this_page/index.rst:21:<autosummary>:1
+msgid ""
+":py:obj:`setup_edit_url "
+"<pydata_sphinx_theme.edit_this_page.setup_edit_url>`\\ \\(app\\, "
+"pagename\\, templatename\\, context\\, ...\\)"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/edit_this_page/index.rst:28
+#: ../../api/pydata_sphinx_theme/edit_this_page/index.rst:21:<autosummary>:1
+msgid "Add a function that jinja can access for returning the edit URL of a page."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/edit_this_page/index.rst:23
+msgid "Module Contents"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/edit_this_page/index.rst
+msgid "参数"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/edit_this_page/index.rst
+msgid "返回类型"
+msgstr ""
+

locales/zh_CN/LC_MESSAGES/api/pydata_sphinx_theme/index.po

@@ -0,0 +1,111 @@
+# Translations template for PROJECT.
+# Copyright (C) 2024 ORGANIZATION
+# This file is distributed under the same license as the PROJECT project.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PROJECT VERSION\n"
+"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
+"POT-Creation-Date: 2024-12-20 16:26+0800\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <[email protected]>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.16.0\n"
+
+#: ../../api/pydata_sphinx_theme/index.rst:2
+msgid "pydata_sphinx_theme"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:9
+msgid "Bootstrap-based sphinx theme from the PyData community."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:31
+msgid "Submodules"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:46
+msgid "Attributes"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:52:<autosummary>:1
+msgid ":py:obj:`__version__ <pydata_sphinx_theme.__version__>`\\"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:54
+msgid "Functions"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:63:<autosummary>:1
+msgid ""
+":py:obj:`_fix_canonical_url <pydata_sphinx_theme._fix_canonical_url>`\\ "
+"\\(app\\, pagename\\, templatename\\, ...\\)"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:70
+#: ../../api/pydata_sphinx_theme/index.rst:63:<autosummary>:1
+msgid "Fix the canonical URL when using the dirhtml builder."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:63:<autosummary>:1
+msgid ":py:obj:`setup <pydata_sphinx_theme.setup>`\\ \\(app\\)"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:99
+#: ../../api/pydata_sphinx_theme/index.rst:63:<autosummary>:1
+msgid "Setup the Sphinx application."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:63:<autosummary>:1
+msgid ""
+":py:obj:`update_and_remove_templates "
+"<pydata_sphinx_theme.update_and_remove_templates>`\\ \\(app\\, "
+"pagename\\, ...\\)"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:122
+#: ../../api/pydata_sphinx_theme/index.rst:63:<autosummary>:1
+msgid "Update template names and assets for page build."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:63:<autosummary>:1
+msgid ":py:obj:`update_config <pydata_sphinx_theme.update_config>`\\ \\(app\\)"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:145
+#: ../../api/pydata_sphinx_theme/index.rst:63:<autosummary>:1
+msgid "Update config with new default values and handle deprecated keys."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:65
+msgid "Package Contents"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:72
+msgid ""
+"Sphinx builds a canonical URL if ``html_baseurl`` config is set. However,"
+" it builds a URL ending with \".html\" when using the dirhtml builder, "
+"which is incorrect. Detect this and generate the correct URL for each "
+"page."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst:76
+msgid ""
+"Workaround for https://github.com/sphinx-doc/sphinx/issues/9730; can be "
+"removed when that is fixed, released, and available in our minimum "
+"supported Sphinx version."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst
+msgid "参数"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/index.rst
+msgid "返回类型"
+msgstr ""
+

locales/zh_CN/LC_MESSAGES/api/pydata_sphinx_theme/logo/index.po

@@ -0,0 +1,90 @@
+# Translations template for PROJECT.
+# Copyright (C) 2024 ORGANIZATION
+# This file is distributed under the same license as the PROJECT project.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PROJECT VERSION\n"
+"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
+"POT-Creation-Date: 2024-12-20 16:26+0800\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <[email protected]>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.16.0\n"
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:2
+msgid "pydata_sphinx_theme.logo"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:8
+msgid "customize events for logo management."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:10
+msgid ""
+"we use one event to copy over custom logo images to _static and another "
+"even to link them in the html context"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:18
+msgid "Functions"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:25:<autosummary>:1
+msgid ""
+":py:obj:`copy_logo_images <pydata_sphinx_theme.logo.copy_logo_images>`\\ "
+"\\(app\\[\\, exception\\]\\)"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:32
+#: ../../api/pydata_sphinx_theme/logo/index.rst:25:<autosummary>:1
+msgid "Copy logo image to the _static directory."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:25:<autosummary>:1
+msgid ""
+":py:obj:`setup_logo_path <pydata_sphinx_theme.logo.setup_logo_path>`\\ "
+"\\(app\\, pagename\\, templatename\\, context\\, ...\\)"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:57
+#: ../../api/pydata_sphinx_theme/logo/index.rst:25:<autosummary>:1
+msgid "Set up relative paths to logos in our HTML templates."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:27
+msgid "Module Contents"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:34
+msgid ""
+"If logo image paths are given, copy them to the `_static` folder. Then we"
+" can link to them directly in an html_page_context event."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst
+msgid "参数"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst
+msgid "返回类型"
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:59
+msgid ""
+"In Sphinx, the context[\"logo\"] is a path to the `html_logo` image now "
+"in the output `_static` folder."
+msgstr ""
+
+#: ../../api/pydata_sphinx_theme/logo/index.rst:62
+msgid ""
+"If logo[\"image_light\"] and logo[\"image_dark\"] are given, we must "
+"modify them to follow the same pattern. They have already been copied to "
+"the output folder in the `update_config` event."
+msgstr ""
+