使用Sphinx搭建本地(window)文档并把它部署到网上(github)-布置主题并发布(2)

修改主题

1. 选择
   https://sphinx-themes.org/
   https://pypi.org/project/yummy-sphinx-theme/

2. 添加

   pip install yummy_sphinx_theme
   

3. 修改config.py文件,文件自带

   html_theme = "yummy_sphinx_theme"
   

   

4. 页面
   

发布

1. 先去github建个仓库

2. 然后把仓库和上面创建的test连接起来
   2.1 git remote add origin git@github.com:xxx/Sphinx-wiki.git
   2.2 把代码都上传,直接git push会报错，按提示执行对应语句就好
   （记得是git push --set-upstream origin master）

   git add *
   git commit -m "all"
   git push xxxxxx
   

3. github->Sphinx-wiki->setting->source->master branch/docs folder
   3.1 本地创建docs文件夹，把 build里面资源复制到docs,代码上传
   3.2如果你的项目一级目录里面有index.html就不用选择docs这个选项，直接第一个选项就行，可以参考link->对应页面

   make clean
   make html
   touch docs/.nojekyll
   cp -r build/html/* docs/
   

   3.2打开网页
   https://tianqigeng.github.io/Sphinx-wiki/

视频

上一篇
使用Sphinx搭建本地(window)文档并把它部署到网上(github)-本地搭建(1)
下一篇
使用Sphinx搭建本地(window)文档并把它部署到网上(github)-使用live server本地查看修改(3)