椒盐豆豉

如何给 Hugo 博客添加热力图

January 4, 2024
重启电脑
code | hugo | blog | project | tutorial

之前一直想给博客添加一个 GitHub/豆瓣风格的热力图。纯靠 GitHub commit history 的话因为有工作和 side project 的 commit,以及一篇文章可能会有多个 commit 改错字,并不能很好地体现博客实际的产量。但由于对用代码画图以及 hugo 语法不熟悉以及我太懒Hugo 文档写得太烂,外加搜了几分钟没找到现成好用的插件,就一直拖延掉了。这次终于着手改出来一个跟自己想要版本很接近的东西,希望对想加类似热力图的博主有帮助。(静态博客果然会不可避免地走上装修博主的道路吗……)

...


静态博客半年记

December 1, 2023
重启电脑 | 关我屁事
blog | hugo

半年前,我把从快 20 年前开始用的 Wordpress blog 迁移到了 github pages 上开始用 hugo 做静态博客。从小学开始写博客在 blogcn 上入了坑,后来三年前新建现在这个博客时候也就按习惯继续用了,其实建站时候未做太多横向对比。三年用下来发现 20 年前用托管站时候不曾想过,现在自建站要处理的问题良多,遂动了迁移静态博客的念头。外加本来就是程序员,技术门槛几乎不存在,也用不到除了博客和评论外的其它 CMS 或电商功能,用 Wordpress + VPS 花钱找罪受,遂在日本出行最后几天体验 digital nomad 生活的时候一鼓作气把博客给迁移了。

现在刚好半年,回头看可是说这大概是我写博客史上最庆幸和后悔没早做的决定,所以迫不及待没等到一年就来写这个总结。本文就来回顾一下这半年中平台变化给我的博客本身和写博客习惯带来的改变,以及半年来我的博客都写了些什么。

...


Add random post picker to Hugo without json index

September 20, 2023
重启电脑 | English
code | project | tutorial | hugo | blog

I want to add a random article picker to my blog as another way to discover past posts, aside from categories and tags on the right side and making it easier on mobile.

I couldn’t find a simple enough solution that suits my needs after brief Googling. The options I found were either to randomize at build time, which means the article doesn’t change with each click or refresh, or to generate a JSON index, which I had trouble with probably because my lack of understanding of Hugo.

I thought such a simple feature should be achievable with just JS + HTML, so I decided to write my own. Performance shouldn’t be an issue for a blog with a few tens to thousands of articles. Here’s a solution I came up with for reference.

...


给 Hugo 博客添加随机文章入口

September 20, 2023
重启电脑
code | project | tutorial | hugo | blog

我想给自己的博客加一个随机文章入口,作为页面右边的分类和 tag 之外的另一个发掘文章入口,移动端也更容易。在网上一搜,Google 第一页没有看到太显眼的简单适合我博客的答案:要么是最简单的 build time randomize,不能每次点击/刷新都出新文章;要么要生成 json 索引,对 hugo 语言和 config 不是很熟悉的我折腾了一下没搞出来,遂放弃。

想说这么简单个功能不至于不能纯拿 JS + html 写吧,博客少则几十多则几千的随机数性能应该也不成问题,随自己折腾出来个方案供大家参考。

...


如何建立写博客的习惯

August 27, 2023
重启电脑
tutorial | blog

前两天写的博客安利文《2023 年了你为什么需要写博客》反响出乎我预期,短短一周一跃成为我博客迁移三个月以来最受欢迎的文章。但”想写“和”开始写“从来都不是“成功”写博客的最大难点。有受到博客安利写了几篇之后就逐渐断更的,也有我上迁移时候提到的那种建站狂魔倒腾完站就不发内容了的。有点像是健身,好处很明显,门槛也很低,但真正能长期坚持并最终成为生活习惯的一部分的人,才能真正受益。一开始建立习惯的过程或许需要一定意志力,但当习惯形成之后,乐趣和收获是可以同步进行的。

这篇文章我来试图回顾一下写博客的近二十年里哪些事情帮助我不知不觉中把博客变成了自然而然一个爱好而不是需要逼自己“坚持”的任务。开始之前几点说明:

  • 不是每个人都适合或需要写博客,虽然觉得这是不言自明不需要 justify or defend 的观点但是还是提前说明一下
  • 我(至少现在)不写技术博客也不写情感博客,这两类挺常见的博客题材不一定适合本文和我的所有博客安利文
...


2023 年了你为什么需要写博客

August 17, 2023
重启电脑
brain dump | blog | patreon

大概是 2020 年底,在墙内社交平台辗转近二十年之后,我又重回了自建独立博客这条路的时候开始在长毛象上提 make blogging great again/博客伟大复兴这个有些自嘲意味的口号(毕竟无论中文还是英文语境里这俩句式都有不怎么招待见的政治意味)。这些年多多少少也试图安利一些友人写博客,最近换到静态博客也零散写了两篇建站倒腾,不过都收效甚微。毕竟,像小学语文老师反复强调的,光讲苹果真好吃苹果有益健康,不提具体什么口感怎么个有益健康法的是烂作文。

博客圈里中文英文的反反复复有太多人写过“为什么要写博客”这个命题了,但网上不缺信息只缺发现渠道,如果恰好在这个天时地利人和的时机看到这篇文章的人里有千分之一能拾起这个习惯并且有所收获,那也值了。

今天我们就来老生常谈,从我的角度又写一遍你为什么需要写博客。

...


又双叒叕一篇小白个人博客选什么工具或平台

June 11, 2023
重启电脑
tutorial | patreon | wordpress | hugo | blog

之前忘记在哪看到一篇建站教程 ,给了类似这么一张图,实在找不到原文/图了,大意翻译一下:

其实就是自嘲了一下博客圈都喜欢捣腾建站啦 refactor 啦什么的,建站教程/折腾日志写得越欢的实际后续博客文章数量越少。

(后来象友评论补充了我想找的那张原图在这里

本写了二十年博客的话痨今天就来打破一下 stereotype,建完站之后的因为新鲜劲和 performance improvement 倒是已经井喷了三篇文章了。

趁着前两天刚捣腾过一次建站还记忆犹新,也来老生常谈又双叒叕写一篇面向小白的“个人博客选什么工具或平台“的建站文。

本文其实是我 6 月 Patreon 博客选题投票 trending 胜出选项,没想到吧因为新博客表达欲过于旺盛已经学会抢答了(highly unlikely 但是万一最后另一个选项胜出大不了两篇都写),以前不拖到当月结束就不错了。7 月博客投票提前释出敬请投票!

  • 我就是不想 grow —— 一份码农生涯躺平挣扎记录
  • 电驭游宅好伴侣,Aer 背包全家桶体验
  • 纯远程工作讨厌做饭厨渣如何糊弄吃饭问题

TLDR #

本文受众是纯小白,有一定技术基础的相信可以根据自己需求选择。简化起见在此只讨论几种最常见的建博客方式:Github Pages,Wordpress 自建站,免费第三方托管(Medium, wordpress.com,telegra.ph 等),Notion(其实也是第三方托管的一种),付费第三方托管(wordpress.com, squarespace 等)。

私以为纯博客的话只有如下两种选择 make sense:

  • 刚开始/还没开始写博客,想培养写作习惯,不会/不想花时间在学习 git 和一些 command line 基本操作:Notion
  • 有写作习惯,或熟悉 git 和 command line 基本操作的人:无脑选静态生成(其中 github pages 是最流行且免费的托管平台)
...