跳转至

好玩

MkDocs 的 Nav 导航结构与目录自定义调整插件使用

很长一段时间都在使用 mkdocs_include_dir_to_nav 这个插件来自动包含目录下的所有 md 文件,但随着新需求的出现 —— 如何给某一个指定的子目录使用 reverse_sort_file,即升序排列展示子目录相应的 markdown 内容。这才开始接触到 MkDocs Awesome Pages Plugin 这个插件。

值得注意的是,MkDocs Awesome Pages Plugin 在 2025-02-17 发布的 v3.0.0 正式变更成了 mkdocs-awesome-nav

MkDocs Material 安装部署和使用

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

基于 GitHub Discussions 的博客与站点

GitHub Discussions 是一个可以在每个 GitHub 仓库上启用的论坛。它使开发者能够轻松地讨论新功能,从社区获得反馈,创建投票,发布公告等。这里搜集了一些基于 GitHub Discussions 的博客与站点,以供参考。