240707-Sphinx配置Pydata-Sphinx-Theme

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

• 1.
• 2.

Step 2. 安装默认的工具包

登录后复制

pip install pydata-sphinx-theme

• 1.

Step 3. 安装额外的工具包

pip install requirements.txt

登录后复制

numpydoc
sphinx-autopsy
sphinxext-rediraffe
sphinx_design
sphinx-copybutton 
myst-parser 
ablog 
jupyter-sphinx 
sphinxcontrib-youtube 
nbsphinx 
sphinx_togglebutton 
jupyterlite_sphinx 
sphinx_favicon 
sphinx_sitemap 
linkify-it-py 
matplotlib pandas 
plotly 
xarray 
ipyleaflet

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.

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

原创作者: guokliu 转载于: https://blog.51cto.com/guokliu/11467115