diff --git a/.gitignore b/.gitignore index 984adaab8..cc1cd1147 100644 --- a/.gitignore +++ b/.gitignore @@ -6,3 +6,4 @@ _build .DS_Store .vscode/ *.bak +3.x/zh_CN/venv/ diff --git a/3.x/zh_CN/conf.py b/3.x/zh_CN/conf.py index d8020d241..e014e2f3f 100644 --- a/3.x/zh_CN/conf.py +++ b/3.x/zh_CN/conf.py @@ -14,11 +14,12 @@ import sys import os +import jieba #sys.path.insert(0, os.path.abspath('..')) import sphinx_rtd_theme from recommonmark.transform import AutoStructify - +from sphinx.search import SearchEnglish DOC_SOURCES_DIR = os.path.dirname(os.path.abspath(__file__)) PROJECT_ROOT_DIR = os.path.dirname(os.path.dirname(DOC_SOURCES_DIR)) @@ -64,6 +65,15 @@ 'myst_parser' ] +myst_enable_extensions = [ + "linkify", # 自动转换 URL 为链接 + # "replacements", # 支持文本替换 + # "smartquotes", # 美化引号 + # "strikethrough", # 支持删除线 + # "substitution", # 支持替换变量 + # "attrs_block", # 支持 Markdown 块级属性 +] + # Add any paths that contain templates here, relative to this directory. templates_path = ['../_templates'] @@ -234,6 +244,11 @@ #html_search_language = 'en' html_search_language = 'zh' +html_search_options = { + 'search_language': 'zh', # 指定中文 + 'search_mode': 'full_text', # 全文搜索 +} + # A dictionary with options for the search language support, empty by default. # Now only 'ja' uses this config value #html_search_options = {'type': 'default'} diff --git a/requirements.txt b/requirements.txt index 367c31524..b4ca064fb 100644 --- a/requirements.txt +++ b/requirements.txt @@ -13,4 +13,6 @@ git-lfs Jinja2<3.1 myst-parser == 0.13.0 pyyaml - +jieba +linkify-it-py +# markdown-it-py \ No newline at end of file