VSCode
+MarkDown
+七牛云图床
+Git
+Github
(Pages
,Actions
,Discussions
)
推荐主题:Material for MkDocs
# 直接安装
pip install mkdocs
# 安装 Material for MkDocs 主题时会附带安装 Mkdocs
pip install mkdocs-material
# 安装插件
pip install mkdocs-glightbox # 放大图片
pip install mkdocs-awesome-pages-plugin # 定义目录顺序
pip install mkdocs-git-revision-date-localized-plugin # 文章底部显示更新时间
# 初始化
mkdocs new .
# 目录结构
'
├─ docs/
│ └─ index.md
└─ mkdocs.yml
'
# 最小配置
'
theme:
name: material
custom_dir: overrides # 扩展主题
'
mkdocs --help
# 启动本地服务预览
mkdocs serve
# 手动将 docs 目录中的 md 构建成 html 等静态文件
mkdocs build
# 自动构建并推送到 gh-deploy 分支
# mkdocs gh-deploy
定制化修改主题:https://squidfunk.github.io/mkdocs-material/customization/#extending-the-theme
---
comments: true 开启评论
---
密钥管理:https://portal.qiniu.com/user/key
更换证书,修改 HTTPS 配置:https://portal.qiniu.com/cdn/domain
- 从剪切板上传:
cmd
+opt
+u
- 从文件夹上传:
cmd
+opt
+e
- 输入路径上传:
cmd
+opt
+o
VSCode 安装 PicGo 插件,配置七牛云密钥