我为什么自己写了一个博客
二〇二〇年一月,我写下第一篇《我为什么自己写了一个博客》。当时理由很具体:在别人平台上写的东西,说没就没。
六年过去,那个域名还在,打开还是瞬间。中间这个站推倒重来过好几回,踩的坑够写一本错题本。这篇把那些事按时间记下来——既是给站点的流水账,也算对那篇旧文的补注。
起点:被两个平台弄丢的东西
最开始没想过自己弄。就想找个地方,把随手写的东西和拍的照片放一起,别丢就行。
先用的公众号。发一篇要排版,一段一段调,图片还得先传上去。弄到一半就没了兴致。
后来换了个在线日记的网站,写了几个月。某天打开,发现它改版了,以前写的东西散在各处。
翻了半天才找着,还有几篇干脆没了。那次之后才想:要不自己弄一个,至少东西放在我自己这儿。
第一晚,只为了把字挪到中间
我不会写代码。一开始连 html 是什么都不知道,只知道记事本里写点字、存成 .html 能打开。就从这个开始试。
我以为就是让字显示出来。结果光是把字挪到页面中间,就弄了一整晚。
那晚学会了「控制台」这个词。按 F12 出来一堆红字,我看不懂,只能一行一行删,看删掉哪句它就不红了。
两点多,字终于到了中间。一行黑字,白底,没有任何样式。我盯着看了半天,截图发给一个朋友。
我说「你看,这是我做的」。他回了个「哦」。现在想想有点好笑,但那一刻是真的高兴。
后来一点点加。加了个能点的链接,点不开,因为路径写错了。加了张图,不显示,因为文件名里带了空格。
加了个背景色,整页字全没了——我把字也设成了白色。这些现在说起来都是小事,当时每一个都能卡我半天。
手写还是框架:一个记事本起步的人
我也下载过现成的框架。装完打开,一堆配置文件,里面全是不认识的词。想改个标题都找不到在哪儿,就又删了。
原因很直白:看不懂。与其花时间弄懂别人写的规则,不如守着自己这几页。笨是笨,但大概知道哪块是干嘛的。
还有一个原因:这站很小,打开很快。网不好时打开别人的站要转半天,打开自己这个基本是瞬间。
再一个,是我有点怕「平台」这两个字。你在别人平台上写,规则是别人定的。今天给你推荐,明天限你的流。
后天它整个没了,你的东西跟着没了。不是说文它们坏,只是不想把攒了几年的东西,寄托在一个我控制不了的地方。
这种「自己弄」的笨办法,网上不少人走过。一位程序员在稀土掘金写「搭站三天,折腾主题三周,写第一篇文章花了三个月」。
他说这是他第四次搭博客,前三次分别栽在没服务器钱、忘密码、改到一半框架大版本更新。
他列了张选型表:WordPress 生态强但要服务器,Hexo 静态免费快但主题难改,Hugo 构建快但 Go 模板反人类,最后选了内容优先的 Astro。
另一位从二〇一七年开始的九年草根站长,emlog、ZBlog、Typecho、WordPress 全下载实测过。换主机代理商跑路,资源站因违规被关,坑几乎踩遍。
还有人算过账:找团队建站花掉三千多,自己搭只花八十九,域名加轻量服务器加后来才知道免费的 SSL,「踩的坑比代码还多」。
对照下来,我这种记事本起步的,算笨里最笨的一档。但它有个好处:哪天想改,我知道改的是哪一行。
第一次挂到网上:网址会打不开的恐惧
第一次把文件传上去,我盯着那个网址刷了好几遍。刷新一次,心里紧一下,怕它打不开。后来它真的打开了,虽然只有我一个人看。
域名是我挑了半天的。想要短一点、好记一点,又不想太正经。最后定下来的那个,念出来有点像在跟谁说话。
上线走的是 Cloudflare Pages,代码走 GitHub。后来才摸清:仓库有两个分支,一个管音频 CDN 的源,一个才是生产分支,推一次两个一起走。
还有个容易吓人的点:任何带 .html 的地址,都会被服务器跳到不带 .html 的干净路径。
所以判断有没有部署成功,不能查 /post.html——它会返回空,看着像没部署,其实只是跳走了。要查根页,或者带参数的文章地址。
内容的三层:本地、覆盖与云端
早几年,文章写死在一个叫 data.js 的文件里,本地几篇,打开就能读。后来有了后台,又有了云端数据库,文章改存到线上。
这就引出内容的三层结构。最底下是本地兜底文件,中间是后台导出的覆盖配置,最上面是云端那一份,优先级最高,会盖掉下面两层。
这个顺序带来一条规矩:改文案必须动两处。静态文件里的是默认值、是兜底;线上真正显示的,是云端那一份。只改文件,页面不会变。根子不在缓存,在覆盖的先后。
还有一处更隐蔽:渲染层读文章列表,靠的是数组引用。往里灌数据,必须原地清空再一条条推进去,不能直接换一个新数组,否则渲染层还拿着旧的那份,页面纹丝不动。
这类「看着改了其实没改」的错,比明晃晃的报错更磨人。它不报错,只是沉默地不变。
那次路由的坑:点了主页却回不去
有一天我点主页上的一篇文章卡,地址栏的网址变了,页面却还停在列表里。要手动刷新一下,才真正进得去。
另一个现象更怪:进一篇文章,第一眼是一种版式,刷新一遍,又变成另一种。像是两个不同的站。
根子在两套路由打架。这个站是个单页应用,路由逻辑写在一段叫 main.js 的脚本里。
文章页本身又是个独立页面,靠地址里的参数取内容。单页应用拦下了点击,却没正确切视图;独立页的脚本又慢半拍。
修法是改那两段路由函数:独立页面里直接放行,不抢点击;点文章时改用整页加载,而不是在单页里硬切。
再补一个兜底,万一视图错位就整页跳走,不让三栏布局乱掉。改完验证,根路径和文章地址都引用了新版本的脚本,文章地址返回正常。
这类 bug 不致命,但每次遇到都像鞋里进了颗石子,不拿出来就一直硌。
版本号与一年缓存:改了等于没改
全站只认一个版本号,它串在十二个页面文件里,一共五十八处。样式表和脚本文件被设了一年的缓存,而且标成不可变。
文件名不变,浏览器就永远读旧的,只能靠换版本号来换地址。所以改了样式或脚本却不换号,浏览器读的是旧缓存,等于没改。
曾经手改漏过,出现过样式表和脚本版本号对不上的混搭。后来一律用脚本升号,不再手工动。
改完判断有没有上线,也是查根页的版本号,不能查文章页——那里会跳转,容易误判。
几次再编:把站点推倒重来
「再编」是常事。第一版大概是二〇二〇年刚搭站那会儿,白底黑字,丑,但能看。后来加毛玻璃、磨砂卡片,换上淡紫的冷色,顺手做了暗色——那是第二版,好看了,却发现问题。
深色大图会透进卡片,卡片的颜色被背后的插画决定,怎么调都调不对。第三回动手,专门解决正文排版,时间应该在二〇二一年前后:改成单页切换,歌不再断;正文排版也独立成层。
那一层管字号、行高、标题、引文、表格、代码、图片说明,还按几个分类给不同的皮肤气质:读书首字下沉用衬线,技术更紧凑,电影引文居中,文史加字距,日常更松,杂记居中。
第四回是因为几条反馈:字小且发虚、播放器糊成一团黑、卡片线框有毛边。这一阵大概是二〇二四到二〇二五年,深色模式也在这时重做过,不再是浅色翻过来。
查下去才发现,中文小字发虚,根子不在字号,在字重——Windows 上细字重加抗锯齿,必然发虚。把字重抬一档,比加大一号字更管用。
播放器那团黑,是三个坑叠在一起:图标颜色写死成接近背景的深色,亮度差太小一起消失;进度条和轨道同色,看不出进度;音量轨道也是卡片色。
改法是让控件走主题强调色,中性色往纸色而不是透明里混。再往后,又补了三层视觉系统,目录也做成浮在旁边的小标签——这是二〇二六年前后的事。
中间还有些零碎的推倒重来:二〇二二年把标签砍到七个,背景图跟着节气换;二〇二一年把播放器做成唱片机的样子。每一回都不是推翻重来,是只加一层,出问题把那一层整节删掉就能回退。
附:站点几次再编的演进对照
第一版 主要改动:白底黑字,手写几页,解决的问题:能打开、能放东西,丑但能用;第二版 主要改动:毛玻璃、磨砂卡片,解决的问题:好看,但深色图会透进卡片;第三版(阅读页排版层) 主要改动:正文排版独立成层,六套分类皮肤,解决的问题:字号、行高、引文、表格、代码统一。
第四版(可读性层) 主要改动:抬字重、重做播放器、收卡片毛边,解决的问题:字小发虚、播放器一团黑、线框毛边;第五版(视觉系统) 主要改动:视觉系统三层,卡片底衬,解决的问题:卡片颜色被背景决定、深浅不适配。
视频卡与引用源:两道自己立下的规矩
站里有些文章带视频。最早想直接嵌播放器,后来发现不行:B 站播放器在嵌入框里会自动播放出声,几篇文章的播放器一起加载,页面很重。
改成「点击才加载」的卡片:外层一个带视频号的方块,十六比九,深色底,中间一个播放圆环,下面写着「点击播放」。只有点了,才现加载播放器,而且不带自动播放。
因为正文是整段塞进页面的,内联脚本不会执行,所以加载逻辑只能写在那块方块的点击属性里,不能写成一段独立脚本。
引用源也有规矩:必须实测能打开。有些源在这台机器上稳,有些永远连不上。查不到出处的,宁可不引——编造一条引用,比不引严重得多。
还有一条:普通人的昵称一律省去,只留话本身。公众人物该署名的照署,因为他们本来就要为那句话负责。
偏门的发现:几个差点漏掉的事实
折腾这些年,有几个偏门事实,是差点漏掉才发现的。
第一,云端每次改文章,都会把文章编号重算一遍,手写的好记编号保不住。所以对外报链接,一律用系统生成的编号,不用手写的好看编号。
第二,检查脚本也会骗人。有一版检查工具报「全部通过」,实际是一篇目录都没生成——它压根没检查到任何东西,却安静地通过了。后来立了条规矩:任何逐项检查的脚本,先确认它到底查了多少项。
第三,这台机器把一批域名指回了本机,导致直连代码仓库走不通。一度以为是网络问题,其实是本机配置在拦。环境坑不是网络坑,找错方向会白费半天。
第四,还是字重那件事:中文小字不清楚,多半出在字重上。这条值得单独记,因为它反直觉。
它治好了我一点「发出去就想要反馈」的毛病
以前发在平台上,发完会一直刷,看有没有人点赞,有没有人评论。数据不好会难受半天。
自己这个站没有那些。写完就是写完了,没有人给你打分。刚开始不习惯,后来反而轻松了。
我写东西是为了把一件事想清楚,不是为了那几十个赞。它不需要讨好谁。
写在这个站第六年
回到最开始那个问题:为什么自己写一个博客。
六年里它变过很多次样子。丑过,花过,现在还算干净。有一点没变:东西一直在我自己这儿。
改到现在,还有很多地方不满意。手机上有些地方挤,有的字颜色调了半天还是觉得不好看,有些功能做了一半就搁那儿了。
但它是我的。哪天想删哪块就删哪块,不用问谁,也不用等谁审核。半夜想到一个点子,爬起来改两行,第二天打开就能看见。
域名快到期的时候我会想,要不要续。每次都想,续吧,也不贵。就当是给自己租了一个小房间,放点不想丢的东西。
说不上来为什么还一直写。它不火,没什么人看,也不会给我带来什么。但哪天我想写,它都还在那儿。这就够了。
参考
- 我搭了个博客,然后花了 3 个月才写下了文章(稀土掘金) · 平台记录
- 这是我的来时路(高先生笔记) · 平台记录
- 找团队建站花了我3280元,我自己搭只花了89块(老Q的自动化之路) · 平台记录
- Cloudflare Pages 文档 · 指南