跳转至

好玩

部署 PicX 图床到 Vercel

由于 PicX 自 v3.0 起,不再支持自由选择仓库和分支,统一使用内置的仓库和分支。所以出于自定义的仓库和分支使用需求,这里主要对 PicX v2.0 进行 Vercel 自定义部署。

Mkdocs material 使用自定义 slug 和 url

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

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 的一个主题配置,更加简洁美观,更新和维护也更加及时和频繁,且社区也更加活跃。