MkDocs 主题 awesome-pages 使用
很长一段时间都在使用 mkdocs_include_dir_to_nav 这个插件来自动包含目录下的所有 md 文件,但随着新需求的出现 —— 如何给某一个指定的子目录使用 reverse_sort_file
,即升序排列展示子目录相应的 markdown 内容。这才开始接触到 MkDocs Awesome Pages Plugin 这个插件。
很长一段时间都在使用 mkdocs_include_dir_to_nav 这个插件来自动包含目录下的所有 md 文件,但随着新需求的出现 —— 如何给某一个指定的子目录使用 reverse_sort_file
,即升序排列展示子目录相应的 markdown 内容。这才开始接触到 MkDocs Awesome Pages Plugin 这个插件。
本来没想着写年终总结 —— 主要是最近对于码字没太多的欲望,但翻到了 2021/2022 的一些年终记录,也看了不少其他网友博主 2023 年的总结,所以对自己说,还是写一写吧。
2023 年对个人来说是变动的一年,这个变动主要体现在工作上。反观生活,除去家庭的一些琐事基本上也就是波澜不惊的一个状态。
Matrix 是一个开源、开放、轻量级、去中心化的即时聊天通讯协议,它是包括 deepin、Mozilla、Fedora、KDE、Archlinux、Debian 等开源社区均在广泛使用的即时聊天协议。
很多时候阅读别人的博客(站点),总能发现一些好玩的人和事物。2023 年被椒盐豆豉的一篇《2023 年了你为什么需要写博客》所吸引,尤其是 “博客是赛博空间的另一个你,也能反过来定义你” 这一句,写出了很多心声。
从2023年7月起我所有可公开的文档都保存在了 GitHub Discussions 上,作为博客、IED 编辑器,以及评论使用,GitHub Discussions 是完全没问题的。
MkDocs 是一个快速、简单、华丽的静态网站生成器,适用于构建项目文档。文档源文件以 Markdown 编写,并使用一个 YAML 文件来进行配置。Material for MkDocs 是 MkDocs 的一个主题配置,更加简洁美观,更新和维护也更加及时和频繁,且社区也更加活跃。
Material for MkDocs 从 9.2.0 开始内置博客插件,内置博客插件添加了对从帖子文件夹构建博客的支持,这些帖子带有日期和其他结构化数据注释。
这个方法最开始是在 Linlin Yan (颜林林) 的 GitHub Pages 上第一次看到。后来,随着自己也用上了,就开始有了更深一些的认识。
关于写作原本的想法,只是想写点自己在学习、工作、生活上的一些心得和体会,把一些知识点记录下来。
留言的初衷是,希望自己写下来的东西能够有人一起探讨。哪怕你把我的观点批评得一无是处也可以,哪怕你说我的句子狗屁不通也没关系,只要有评判,我相信总有一天我会变得更好。