跳转至

好玩

Mkdocs material 使用自定义 slug 和 url

Mkdocs material 默认使用目录+文件名作为 post 展示的 URL,如果目录名/文件名太长的话,你的 URL 就会显得非常长。尤其是当你从浏览器地址栏中复制某一篇文档的链接时候,如果你的 URL 同时包含了中文,URL 转码后会导致你复制后粘贴的链接变得更加长。

MkDocs Material 安装部署和使用

MkDocs 是一个快速、简单、华丽的静态网站生成器,适用于构建项目文档。文档源文件以 Markdown 编写,并使用一个 YAML 文件来进行配置。Material for MkDocsMkDocs 的一个主题配置,更加简洁美观,更新和维护也更加及时和频繁,且社区也更加活跃。