Step A. 最终效果
Step B. 为什么选择Pydata-Sphinx-Theme主题
- Gallery of sites using this theme — PyData Theme 0.15.4 documentation
Step 1. 创建并激活Conda环境
conda create -n rtd_pydata python==3.10
conda activate rtd_pydata
Step 2. 安装默认的工具包
pip install pydata-sphinx-theme
Step 3. 安装额外的工具包
pip install requirements.txt
sphinxext-rediraffe
sphinx_design
sphinx-copybutton
myst-parser
ablog
jupyter-sphinx
sphinxcontrib-youtube
nbsphinx
sphinx_togglebutton
jupyterlite_sphinx
sphinx_favicon
sohinx_sitemap
linkify-it-py
matplotlib pandas
plotly
xarray
ipyleaflet
Step 4. 创建项目并初始化目录
- 参考:博客搭建|30分钟教你快速搭建一个顔值超高的博客
- 下载:pydata/pydata-sphinx-theme: A clean, three-column Sphinx theme with Bootstrap for the PyData community
- 拷贝并确保下述路径的存在:
Step C. 参考文献
- 博客搭建|30分钟教你快速搭建一个顔值超高的博客
- pydata/pydata-sphinx-theme: A clean, three-column Sphinx theme with Bootstrap for the PyData community