还是 sphinx-quickstart

修改 conf.py

extensions = ['recommonmark']
source_suffix = ['.rst', '.md']

html_sidebars = {
   ['_Sidebar.html']
}
make html

有引用其他页面的页面无法制作..sidebar 也不行..算了,先不折腾这个。。


用 mkdocs 制作下 litedb 的文档看看

mkdocs new litedb

把 v4 中的 md 都复制到 ./litedb/docs 中,sidebar 可以不要

修改 mkdocs.yml

site_name: LiteDB
theme: readthedocs

将 README.md 改成 index.md。。。README.md 不做首页的话,居然还不显示它

mkdocs serve

似乎页面引用还是不行。。似乎只要引用不省略 .md 就行,否则会当成页内引用。。

vscode 中搜索 ](,一个一个添加 .md

不过 github 的 wiki 不能这么搞。大不了每次都添加一遍吧。先返回到上一个版本。。

// 重置当前 HEAD 到制定状态
git log
git reset --hard 66d8bc1 
或
git reset HEAD^   回溯到上一个版本
git reset –hard HEAD~100 回溯 100 个版本

// 强制 push 更新远程分支
git push origin master -f