The hard ways

最好的博客工具

使用 Markdown 来作为博客的原始格式已经成为共识,随之而来出现了很多的静态站点生成工具,再搭配 Github Pages,没有比这样的组合更好的方式了

于是问题聚焦在静态站点生成工具的选择上,比较出名的有:

如果你愿意花时间的话,可以找出若干这样的工具

但呈现在你眼前的这个站点,则是经由 gadget 生成

gadget 是我精心制作的静态站点生成工具,它的功能包括:

  • 即时预览
  • 自定义主题
  • 默认 SSG(Static Site Generation)
  • Sitemap
  • DocSearch
  • ...

这些功能开箱即用,不需要配置。不像是 dumi 还得手动开启 SSG 和 Sitemap

在编写 gadget 之前、完成 gadget 之后,甚至一个小时之前,我都产生过切换到其他开源工具的邪恶想法。这中间我也尝试了不下于 5、6 个工具,但最后发现还是 gadget 更顺手

其实制作 gadget 这样的工具毫无难点,无非一些小工具的堆砌:

所有诸如 docusaurus 这样的开源工具,不论出名与否、无出其右

使用 gadget 我可以制作自己满意的主题,使用 OneDark Pro 来作为代码高亮的着色方案,甚至调整 gadget 内部的功能,只要我愿意,我可以随时调整每一个角落,把它们设置成我喜欢的样子

就在刚刚,我给它加上了 DocSearch

我暂时并没补充 gadget 文档的打算,因为我可以像阅读文档一样阅读它的代码。我并非在说 gadget 的代码有多好,只是我编写了它的每一行每一个缩进罢了

我当然也不想向你推荐 gadget,因为它很可能并不适合你。但我想你既然能够看到这篇博客,想必是你我之前存在奇妙的缘分,是时候考虑实现一个自己的 gadget 来写博客了

    Made with gadget