feat(docs): 更新文档配置并优化构建设置

- 将版本号从 0.1.0 更新为 1.0
- 重构路径配置以使用统一的仓库根目录变量
- 调整模板路径指向父级 templates 目录
- 调整静态文件路径指向父级 static 目录
- 添加 Python 官方文档的 intersphinx 链接映射
- 重新配置 autodoc 扩展选项以改善文档生成质量
- 启用 autosectionlabel 扩展以支持跨文档章节引用
- 禁用继承文档字符串以避免重复显示方法定义

Author: xieyuen

docs/source/conf.py

@@ -13,10 +13,11 @@
 project = 'MCDR-Plugins'
 copyright = f'{datetime.datetime.now().year}, xieyuen'
 author = 'xieyuen'
-release = '0.1.0'
+release = '1.0.0'
 
-src = Path(__file__).parent.parent.parent / "src"
-dependencies = Path(__file__).parent.parent.parent / "dependencies"
+repo_root = Path(__file__).parent.parent.parent
+src = repo_root / "src"
+dependencies = repo_root / "dependencies"
 
 for directory in src.iterdir():
     sys.path.append(str(directory))
@@ -52,7 +53,7 @@
     'sphinxcontrib.asciinema'
 ]
 
-templates_path = ['_templates']
+templates_path = ['../templates']
 exclude_patterns = []
 
 language = 'zh_CN'
@@ -61,23 +62,27 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 html_theme = 'sphinx_rtd_theme'
-html_static_path = ['_static']
+html_static_path = ['../static']
 html_css_files = ['custom.css']
 
 # -- extension configuations -------------------------------------------------
 
 # 常用的外部文档链接映射
 intersphinx_mapping = {
     'mcdreforged': ('https://docs.mcdreforged.com/zh-cn/latest/', None),
+    'python': ('https://docs.python.org/3', None),
 }
-autodoc_default_options = {
-    'members': True,           # 显示所有成员
-    'member-order': 'bysource', # 按源代码顺序
-    'special-members': '__init__',  # 显示特殊方法
-    'undoc-members': True,      # 显示没有文档的成员
-    'show-inheritance': True,   # 显示继承关系
-}
-# napoleon_use_ivar = True  # 使用 :ivar: 而不是生成独立的属性文档
+
+# -- Options for sphinx.ext.autodoc -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html
+autodoc_member_order = 'bysource'
+autodoc_inherit_docstrings = False  # so overridden methods won't pop up
+
+
+# -- Options for sphinx.ext.autosectionlabel -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/extensions/autosectionlabel.html
+autosectionlabel_prefix_document = True
+
 
 # 删除线样式
 rst_prolog = """