Fisher的随记本

跑

Sun, 10 May 2026 23:13:46 +0800

昨天非常烦躁，不知道干什么，像个笼子里的老鼠坐立难安。我尝试着让自己有点点活力，因为前几天太没有活力了起床的时候就很疲劳。身体的感觉让我想起以前跑步的时候，于是我想久违的去跑个步。

今天下午晚饭时间，稍微吃了点东西，换了衣服去操场跑步。人挺多的，很久不来我都忘了每天都有很多人在这里跑步。想象中跑步就是迈开腿往前冲，像风一样，跑跑跑逃离烦心事，应该会很畅快。但是，有点像白酒之于孩童的欺骗性，这事只是看起来很清爽，想象中很畅快，实际自己体验的时候，是说不上来的疲劳、热痛、辛辣的感觉。

我昨天想的是无所谓速度和距离，只是随心所欲的活动一下，释放释放情绪。可是那种想象中随心所欲的跑恐怕只有头200米是这样的。跑到一千米就开始累的厉害了，后面都是靠意志在跑。

跑步中途我不断在问身体，为什么我跑不动，到底是身体的哪个部分在拒绝继续？我感到疼痛吗？是关节还是肌肉？我喘不上气吗？心跳怎么样？可是直到最后我都没问出来到底是哪个部分以什么形式感到难受。这种感觉只能笼统的表达为“我很难受”，“我很累”。

从生理上考虑，我这样跑步的主要挑战包括：心血管负荷，呼吸负荷，局部肌肉疲劳，代谢压力，以及神经肌肉上的持续动员。我自我感觉心脏和呼吸都没问题，一方面跑的不快，另一方面好像在没有跑步的这段时间里我的体育训练提升了我的心肺能力，呼吸道都没什么粘滞感了。但是具体肌肉氧气够不够各部分组织使用，不太清楚。肌肉疲劳是显著的，注意力稍不集中，大腿就懒得动了，靠小腿提踵跌跌撞撞的跑，再滑坡下去就要停了。臀部的发力感不明显，技术上还是非常生疏。神经压力还是蛮大的，跑到最后三四圈感觉人都要散架了，龇牙咧嘴的面部代偿，还要扇自己耳光来保持兴奋。

其实最后两圈的时候，我心里非常害怕自己会控制不住的停下跑动，怕自己会不会下一分钟就放弃了，就嬉皮笑脸的耍赖，就骗自己何必那么执着。这是第六年，眼看着恐怕还要有第七年，虽然我现在或者说这几年的工作状态都非常糟糕，但我仍不愿意放弃。可形势已经严峻到我开始害怕自己会不会在无意间放弃自己。

这种事正在发生着，比如早上随意的晚起，比如雨天午睡后随意的赖床，比如坐在工位看着桌面，随意的打开了B站、知乎、游戏资讯、Github等无关页面。我正在做一种缓慢细微的自我磨损，一种毫无意义的自我消耗，一种软弱的逃避。这种松懈一方面蚕食我的时间，另一方面又维护了我的意志，让它不至于立刻崩溃。鉴于这种积极作用，以及客观上的可能性，我仍然对自己抱有希望。我向自己祈祷，坚强起来，珍惜时间，一步一步攀上最后的峰。

十圈对我来说不算少。最后，虽然非常难熬，但是还是完成了。冲过线的时候我还是很欣慰的。我的优势正在于此。虽然会很痛苦，虽然很慢，但是我会一直跑，一直做下去，直到完成我的目标。我会遇到很多跑得快的人，但是很少有人比我跑得更持久，这是我在多年跑步时光中确定的规律。希望我的学业也能如此。一定会的。

骑车

Mon, 04 May 2026 23:27:39 +0800

我是在11岁那年才学会骑自行车的。

那时我和妈妈住在县城小学附近的城中村。五年级的我，个头已经快追上我妈妈。为了我周末去辅导班方便，妈妈买了一辆二手自行车，并用它教我骑车。

我记得那辆车很破旧，是一辆常见的轻便自行车，车身整体呈现出棕红色，那是铁锈的颜色。周末我们打算去运动场的砂土跑道上学车。一路上我不愿放开“新车”，可是又不会骑，于是一路推着车，时不时跳一下让车带着我滑行几步。我就这样跟妈妈一路走到了运动场。她拿出了一副提前准备的劳保手套戴上，让我坐上车踩动脚踏，自己则在车后扶着后车架，帮我控制住车不倾倒。一开始我的注意力全在脚下——现在想想很不可思议，初学者得看着自己的脚才能确信自己在正确的踩动。渐渐地我可以抬起头来，但双手还是紧张地绷在车把上。我听到我妈的声音在身后鼓励我，一股稳稳的力量从后车座上传来，支持着我持续前进。

广阔的砂土地上，一个女人戴着白手套抓着少年的自行车后座，弯着腰小步跑着，在她的鼓励下，车子逐渐向前行驶，女人的动作也越发滑稽起来。我不知道这样持续了多久，只记得有一瞬间开始，我的手脚变得协调，也越骑越快。我紧张极了，不知道该做什么，就这样机器般运转了一百多米才突然想到，妈妈怎么跟得上我这样骑？我狼狈地停下了车，回头才发现她已经离我很远，正在笑着对我挥手。我就是从那天开始学会了骑车。

上初中后，学校的距离更远了，我不得不每天都骑车通勤。那时市里正在修路，到处是坑坑洼洼的工地，于是我央求父母给我换一辆带有避震器的自行车。永久车行，红旗牌，运动山地车——这套听起来就让人头大的组合，也是陪我最久，感情最深的一辆车。车身是焊接的钢管，车把也是，车把外端向上伸出两个“角”，这种车也因此被孩子们诨称为“牛角车”，没有变速器，没有碟刹，整车可能有五十斤以上。后来为了提高实用性，加装了个车前筐，不知道是师傅手艺的问题还是零件尺寸不和，那前筐总是摇摇摆摆，最后干脆歪到一边去了，我叫它“歪了脑袋”自行车。

初中时候的周末，我最喜欢做的事就是骑着自行车走街串巷的瞎逛。因为自行车可以随时停车，又足以在合理的时间内横穿整个小城，是再好不过的巡航工具。我骑到一片陌生的街区，然后深入那些平时不会进入的小巷，把这当作一种城市探险。后来似乎流行过一阵这种风潮，我却是早早就体验过了。“歪脑袋”破破烂烂的，我亦踽踽独行，这使得它与我似乎形成一种共鸣。

我上的是一所寄宿制的中学，同学们大多来自周边的村镇，周中住宿舍，周末要么回村要么网吧通宵。而我是班里唯一的走读生，每天都回自己家。这种生活上的隔离使得我的初中格外孤独。可那时的我还没长出太敏感的心，并不意识到感伤，我只是独自一人骑着车经过广场，经过邮局，经过繁忙的街市，经过体育场，经过公园，经过另一所中学，经过每一座桥，经过每一个路边喊我的同学，经过兴趣班的师兄弟，经过朋友家的门前……我那时不知道，他们比风景更易流失，稀薄弥散的记忆颗粒在多年后化为空穴，每当我回忆青春时，就窸窸窣窣地啃啮我的心。

再后来骑车就是上大学的时候了。那正是刚经过野蛮生长的年代，城市寸土寸金用地紧张，大学的校园布局亦崎岖绵延。我的宿舍距离教学楼有三里地，每天早晨赶去上课的自行车大军像是上世纪工厂大院的上班人潮。我自己购买的第一辆车是杂牌的山地车，配置和价位都向那台旧车看齐。那时候大家的车子好像都不怎么好，生活区的两个出口各有一个修车铺，每天都相当热闹的样子。我还记得南边小屋的修车大爷在门口挂了个收款码，收款账户的名字是“拿破轮”。拿破轮提供空压机充气，相当方便，打一次气只需付给他1角钱。

过了段时间，忘记是丢了车还是卖了二手，我又换了一辆车。这次是在闲鱼买的二手车，卖家距离我只有一站地铁。27速可折叠山地车，带前后减震器。不过那车子非常旧，也没有锁，车上的配件型号和颜色杂乱搭配，车身也被漆成了奇怪的彩色涂鸦。我后来一直怀疑那人是个偷车贼，在闲鱼上不断地出货各种乱七八糟的二手自行车。不过这不影响我敝帚自珍。我搞了两罐喷漆，将前后挡泥板重新喷涂成纯黑色。又用了一个下午把当时社团的logo剪到镂空纸板上，再喷涂到车架上。虽然车上的配件看起来还是又杂又旧，但整车已经被打上了独特印记，这使得每次骑行又充满了新的乐趣。

之后我搬到了另一个校区，实验室距离宿舍没那么远了，我也打算利用通勤时间多步行几分钟，以充作繁忙工作中的锻炼。直到几年之后，我与另几个同学一起约好去几公里外的健身房每天健身，这让我考虑重新购置一台可靠的代步工具。我买了一辆某热门爆款车，那时一辆入门级的山地车，27速机械碟刹，带锁前叉硬后车架。我用几个星期为它选配了多个配件，最后几乎将车把上的空间占满了。这台车比我之前的杂牌车要好得多，我想起十二岁那年借骑表弟的山地车的感觉，跟这台很像。只不过追上他的生活方式多用了我一个纪的时间。

码表默认检修提示里程是200km，这是我骑了一个月后发现它一直在闪才明白的配置。我简单计算了一下，每天必要的通勤和出行就差不多要骑十公里，更不用说周末还偶尔有额外的骑行。周末用它绕行大学城，又让我回忆起中学时城市探险的时光。可是总觉得有些不同的心境。那时的我在小城自由的舒展自己，可现在骑着车，总感觉是有个目的：要么在前进，要么在逃离。

在漫长的抑郁中，我常常回想起一幅画面，那是闪着蓝光的“歪脑袋”与烈日下的我。汗水顺着脖子留下来，喉咙被灰尘刺得发痒，少年停车驻足，眼前是升出热浪的水泥地，远处是朦朦胧胧的树和砖墙。我于是骑车离开我熟悉的街道，不知多少次漫无目的的游荡在日落后的岛上。有人告诉我，学校是不老不死的怪物。我看着那些刚下课的学生骑车从教学区返回生活区，感觉夜风像时间一样划过我的肩膀。时间似乎只在我身上汹涌的流逝了。

我沿着江边公路用尽全力踩着单车。昏暗的路灯下，是不变的长路和风。攀上一条漫长的坡后一路冲下，风打在我的脸上，让我恍惚了一下，我又回到了起点？我才意识到这本就是条环路。我心底突然颤抖了一下，似乎我的人生也是如此。我愤怒而悲伤的站在街口。原来不做选择也是一种选择，我选择了最熟悉的选择，最先出现的选择，最无可避免的选择。

我回家了。我需要一个足够安全的地方修养自己，让头脑冷静下来。梧桐树的新叶翠绿，干燥的阳光亘古未变。这不是个多么美丽的地方，那也不是段多么无暇的回忆。但好在这里确实让我感到足够安全。

我独自走在街上，看到河边有家自行车店，便进门问了问是否有我的那款车。店主摇了摇头，但又轻盈的走到展台边，为我介绍了同系列的另外两台车，告诉我说喜欢不妨试试。我推出车子，想起第一次在自行车店买车时的样子。那天父母带着我去店里，也是可以在店前的路上骑行试车，路边是梧桐树和熙熙攘攘的车流，一如今天。我骑行到路尽头，让湿润的眼睛放松了一下，就调头回到店里。

有一个瞬间我真打算在这里买下它，不过，可惜或幸运的是，我不能永远逃避现实。

没多久我就走了。确切的说，回来的路上我就在策划返程。我还有事要做，不论是作为什么身份。疗愈可能是必要的，但终归只能是个插曲。

自行车的传动很有意思。当你正向用力时，脚踏会忠实的将动力传递到车轮上，而当你倒蹬时，花鼓会吵闹着拒绝做出反应。锁在车上的人要想不摔伤只有一个选择，就是不断的向前进。

往前走，别回头。往前走。别回头。

// 原文作于2025年5月

幻想

Tue, 21 Apr 2026 20:25:00 +0800

幻想占据了过多的生活内容。甚至在使用幻想逃避现实之前，我就已经将幻想看作现实了。

幻想是似是而非的梦，有时候人们用美丽的名字称呼它，梦想，理想，远方。早该警惕，时髦的理想主义作了外壳，掩护幼稚的幻想主义落地。

幻想的毒害在于对世界想当然的片面理解。不遵从唯物主义世界观，将世界和社会运行的规则片面的贴合到个体的行动和选择上。它大幅简化客观规律，忽视实际生产生活中会面临的现实情况和问题，更不关心现实问题的解决方法。它是似是而非的梦境。幻想令人的头脑与躯体解离，被两股力量牵扯，以至撕裂。

幻想会因为现实受挫而更具吸引力。沉浸于幻想的思维方式，人对现实世界的观察和学习就会不足，进而在处理现实问题时更可能失败。这种失败激发人的战逃反应，在无意识中缩回默认的舒适区，进一步加深幻想依赖。正如任何一种逃避现实的方式，幻想的氛围令人成瘾，破坏人的社会性，最终导向认知失调精神分裂的漩涡。

同时，随着人年龄的增长，现实问题会越来越紧迫。儿童是被赦免于幻想的，童心童言关于生活现实的奇妙反应被视为大脑和心智发育过程中的积极的阶段性现象，无所畏惧的好奇心也被认为是人类珍贵的探索能量。人本应该在十几岁终止这种状态，在肉体和大脑基本发育的青春期，人应该开始承担现实任务，停止幻想。可是当代的孩子们被~~保护的太好了，每天都被~~浸泡在人造的课本和考纲环境中，种子破不出铜墙铁壁，于是世界观只能依附于幻想而建立。

小孩数学学得好不见得是好事。问出“数学有什么用的”人，不一定是反智主义，也可能是现实主义。质问数学的人难道不知道读书记账的作用？难道没见过机械和电器的运作？他们问的是数学之于其所关心的世界有什么用。那么也许数学确实没什么用，因为每个人关心的世界是不同的。这种独特的语言大部分情况下被用于与非人的对象对话。而从关心人的一生的主要进程上来说，数学确实没用，最多只是个精巧的工具。

反过来说，必须警惕不质问数学的人的世界观。这些孩子是否连自己关心的世界都没有构建？那些未曾质疑数学有用性的我，实际上太匮乏现实主义的视角。对我来说，能够在课本和题目里以某种方式畅游就足够开心，更不用说有老师和同学陪我玩这场游戏，无形而巨大的教育体系还会奖励更好的成绩。The whole system is fucking fooling everyone。很久之后我开始关心具体的人和生活，并且发现痛苦丝毫不因此减少，不过那是另一个故事。

影视也是幻想。电影结束后的怅然若失，是幻想世界消散时的不甘。偏爱剧情片，偏爱西幻冒险故事，偏爱穿越小说，因为这些世界都是从人的幻想中构建的，正如我用自己的幻想构建自己生长的世界。

音乐是幻想，艺术、文学都是幻想。歌单的统计已经显示，我喜爱的音乐多是关于相关的幻想作品创作的，甚至是幻想的人物用合成的声音创作的。流行音乐一大半在讲爱情，讲晦涩隐喻的欲望和内心戏，除了作为青春期孩子的调味剂再无用处。喜欢插画，喜欢收集立绘，喜欢阅读文字冒险一般的剧本，喜欢为旋律中幻想角色的倾诉而感动，以及偷情一样看粪作轻小说和穿越网文。流行的文化固然低俗，精致的艺术同样虚无。被现实按在地上的时候，呼吸着夹杂尘土的空气的时候，才会发现艺术是多么奢侈的东西，只有幻想中的人才能假装它唾手可得。

日式文化的幻想风格散播尤甚。大行其道的二次元文化整个都是幻想的世界。番剧动画和游戏往往承载的是幻想的生活方式，时空穿越、架空世界、超能力、动物拟人、软色情、超现实情感关系、虚构历史，数不胜数。依附于此的音乐，日式逻辑的小说，绘画叙事，统统超出了门外三米的世界运行法则。这只存在于大脑皮层的文化模式，是一张巨大的异世界之网，令人沉浸，令人沉溺。

游戏，当然，沟槽的游戏也是幻想。游戏延续了音乐、绘画和电影的骚气，以第九艺术的身份参与构建了不少可歌可泣的美学。但随着硬件普及，独特的成瘾性大下沉时代，流行文化按惯例摧毁一切艺术。最先进的芯片和算法被用于调教人类的感官和内分泌，拿起键鼠/手柄/手机就开始赛博自慰。逃避既可耻又没用，而游戏是如此方便的避难所，幻想一个虚构世界成了最下流的逃避方式。

过去是接近真实的幻觉。去过和没去过的地方，哪里更远？想了很久之后我才知道是过去更远，因为过去是不可达的，而未来总还有机会。回忆昨天与幻想未来都是虚度当下的好方法，但是回忆的毒性要更大一些。不论昨天是杀了人，还是在会议室放了个屁，纠正它们的难度是完全相等的——也就是不可能。

有时候并不打算“纠正”什么，回忆不一定总带着后悔、遗憾这种词吧，也可能是纯粹的怀念和欣赏。可是美化未曾选择的道路，或者美化曾经涉足的道路，本质上是同一件事。所向往的是那个存在于过去的，一切都尚未发生的时候。过去的事总是美好的，不是因为它美好，而是因为它是过去。站在当场经历和站在此刻回忆，两相对比，那件事还是那件事，唯一增加的是“存在于过去”这个属性。

最幽默的是，因为过去之事的美学价值在于“过去”，所以即使它本身是痛苦的，也不影响追忆之人对它的享受。我有一次抱怨那些旧日记，时间已经拉长到未曾设想的距离后，其中的所思竟然还是不断重复的痛苦。可是如果不是因为痛苦，谁又会有时间写日记呢。记下来的东西不是沉淀的时间，而是一种关于痛苦的重采样，至少也是关于情绪强度的重采样。而情绪，是生命最重和最轻的幻想。

记忆是一种跨越时空的毒品。沉浸于其中让人虚度，让人忘记流动性，以静态的方式，幻想拥有整个宇宙。

……

失去的可能自我

Fri, 17 Apr 2026 22:48:01 +0800

失去的可能自我（Lost possible selves）指的是对失去人生其他可能性的悲伤。我忘记最早是在哪看到这个词，不过鉴于它是个舶来的心理学词汇，可能是在十年前的 Know Yourself 的文章里看到的吧。

现实常常被描述为可能性的坍缩。不光是文学家，物理学家也是这么说的。在万千可能的状态中，个体像一个拉链，不断将广阔的未来闭锁到确定的一条曲线上，一条歪歪扭扭的、代表了人至今为止的一生的曲线。而在光锥之外那辽阔的领域里，无数个可能的自我被不断排除，再也没有于这个宇宙露面的可能。

我确实选择了一条路，生活每一秒都在督促我做出决策，所以我来不及每一步都认真考虑。我很抱歉，我为那些被我抛弃的、未曾涉足的路感到悲伤。

伴随着悲伤而来的还有恐慌。我明明去年还手握这么多可能性，怎么今年就不得不变成这样的人？人在出生时拥抱的是整个世界，可走到尽头再回首，自己的路就那么窄窄一条，路上人烟稀少，曲折不明。

在某个时刻——一般来说，是在这个人不得不成长，不得不发现自己终将死去的那一年——我终于决定分化。我决定将自己限制到某个可能的未来上，而不是炫耀自己拥有几百种选择。我必须杀死几乎所有的可能的自我，以得到一个真实的自我。只有未做出选择的人才拥有选择，与其陶醉于有所选择的幻像，不如持有一个主动的决断。

我应该为这种屠杀而感到骄傲。因为我之所以为人，就是因为其为自己的未来做出了决定，并为此负责。绝对的自由带了了绝对的责任，绝对的负责让人拥有真正的自由。

拓展阅读：克尔凯郭尔（1813-1855）存在主义之父，在《非此即彼》中区分了“审美阶段”（沉迷于可能性、体验、多样性）和“伦理阶段”（做出承诺、承担责任）。他认为“真理是主观的”，他大量使用假名、反讽、文学叙事、悖论来写作，从而“迫使读者自己做出选择”。

【从零开始的博客生活 - 4】排版效果展示

Sat, 11 Apr 2026 04:00:00 +0000

演示文章

使用 hugo new content post/example/index.md 命令创建了这篇文章。

📝 备注

样式微调是一个持续的过程，如果你在本文中看到未曾在本系列博文中仔细描述的改进，那么以本文为最新实现。

代码

行内代码：Python 的列表推导式 x2 = [x**2 for x in range(10)] 可以快速生成平方数列。

块级代码：大幅改善了样式和功能性

增加顶部工具栏，语言显示和复制按钮常驻
行号等附属元素不可选中，避免错误复制
调整代码块样式为更经典的居中圆角卡片

1
2
3
4
5
6
7


def fibonacci(n):
 a, b = 0, 1
 for _ in range(n):
 a, b = b, a + b
 return a

print(fibonacci(10)) # 55

不同语言不同高亮

1
2
3


[markup.highlight]
 noClasses = false
 lineNos = true

公式

行内公式：质能方程 $E = mc^2$，欧拉公式 $e^{i\pi} + 1 = 0$。

块级公式：

$$ \int_{-\infty}^{\infty} e^{-x^2} \, dx = \sqrt{\pi} $$

带编号的公式：

$$ \mathbf{A} = \begin{bmatrix} a_{11} & a_{12} \\ a_{21} & a_{22} \end{bmatrix}, \quad \det(\mathbf{A}) = a_{11}a_{22} - a_{12}a_{21} \tag{1.2} $$

引用

改进了引用的样式，使用更经典的居中卡片

任何足够先进的技术，都与魔法无异。

—— 亚瑟·C·克拉克

💡 提示

带标识的引用，这里是TIP

引用/脚注：

其实这玩意¹也叫引用，为了区分，也常常叫脚注(footnote)。

这个引用当然也可以在markdown的所谓的引文片段²中使用。

修改了引用的样式，使得数字都带有中括号。文末的列表也调整了字号和颜色，采用更经典的视觉形态，以便与正文区分。

表格

语法	说明	示例
`斜体`	斜体文本	italic
`粗体`	粗体文本	bold
`代码`	行内代码	`code`
$公式$	行内公式	$x^2$

插图

Hugo Stack 的插图允许行内和块级两种形式。行内的效果往往不好，除非是将小图作为语素的特殊情况，否则不推荐使用。

块级图片必须有上下两行空行：

1
2
3


(空行)
![块级图片自带题注](合成_2026-1_1.png)
(空行)

默认样式将图片宽度设置为100%，高度自动缩放，以适应页面宽度。这往往导致图片过大，视图窒息。

我这里将图片高度设置为50vh，宽度自适应，比较符合一般网络阅读的习惯。

另外点击图片可以放大预览，这是Stack默认就有的功能。

效果展示：

分割线

分割线优化：细=高级懂不懂啊？+变大变高更显著。

总高度增加到 3em
线条宽度降低为 1px，长度增加到 70%

分割线下方的内容。

多级标题

三级标题

注意到右侧显示了本文的目录。

四级标题

正文内容。

五级标题

正文内容。

[EOF]

这是一个脚注示例。 ↩︎
引文片段也就是用> 开头的段落。 ↩︎

【从零开始的博客生活 - 3】Hugo&Stack用户此生必做的自定义修改

Sat, 11 Apr 2026 03:00:00 +0000

很好，少年，选择了Hugo和Stack主题，你就成功了一半，而行百里者半九十。剩下的就是不断的调整细节，优化功能和样式。这里给出了一份我认为的最佳实践，跟着做，你就成功了。

1. 行内公式 $...$ 格式与默认数学渲染

Stack 主题的数学公式渲染基于 Hugo 的 Goldmark passthrough 机制。默认配置：

支持块级公式：\[...\] 和 $$...$$
支持行内公式：$...$
默认每篇文章需在 front matter 中手动添加 math: true 才能渲染公式

$E = mc^2$ 这种单美元符号写法是 LaTeX 社区最普遍的行内公式格式。更重要的是它只有一个符号输入更快捷。

修改 hugo.toml以支持单美元符号写法：

1
2
3
4
5
6


[markup.goldmark.extensions.passthrough.delimiters]
 block = [["\\[", "\\]"], ["$$", "$$"]]
 inline = [["\\(", "\\)"], ["$", "$"]]

[params.article]
 math = true

调整后三种行内公式写法都能正确渲染：

写法	示例	渲染效果
`$...$`	`$E = mc^2$`	$E = mc^2$
$...$	$E = mc^2$	$E = mc^2$
`\[...\]`	`\[E = mc^2\]`	\[E = mc^2\]
`$$...$$`	`$$E = mc^2$$`	$$E = mc^2$$

同时我们通过params.article给所有文章默认开启了数学渲染。如果某篇文章不需要，可以单独关闭（不会有人这么无聊吧）：

1
2
3
4


---
title: "纯文本文章"
math: false
---

⚠️ 警告

单美元符号可能误匹配普通文本中的货币符号（如"售价 $5"）。技术博客中这个问题很少出现

开启后所有页面都会加载 KaTeX 资源（CSS + JS），对纯文本文章有非常非常轻微性能影响

2. 精简页脚版权行

Stack 主题默认页脚太单调，必须改一改。

这涉及到修改主题的footer模板。但是我们无论何时都尽可能不去动./theme/下的文件，而是利用 Hugo 的机制进行覆盖。

Hugo 的模板查找顺序是项目目录优先于主题目录，直接创建 layouts/_partials/footer/footer.html：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


{{- $ThemeVersion := "4.0.0" -}}
<footer class="site-footer">
 <section class="copyright">
 &copy;
 {{ if and (.Site.Params.footer.since) (ne .Site.Params.footer.since (int (now.Format "2006"))) }}
 {{ .Site.Params.footer.since }} -
 {{ end }}
 {{ now.Format "2006" }} {{ default .Site.Title .Site.Copyright }} - Powered by
 <a href="https://gohugo.io/" target="_blank" rel="noopener"><b>Hugo</b></a> &amp;
 <a href="https://github.com/CaiJimmy/hugo-theme-stack" target="_blank" rel="noopener" data-version="{{ $ThemeVersion }}"><b>Stack</b></a>
 </section>
 ...
</footer>

调整后效果：

© 2026 日常 - Powered by Hugo & Stack

3. 访客统计与 ICP 备案

Stack 主题默认没有站点访客统计功能，也没有国内网站常见的 ICP 备案号展示位置。

1. 修改页脚模板 layouts/_partials/footer/footer.html：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


{{- $ThemeVersion := "4.0.0" -}}
<footer class="site-footer">
 ...

 <section class="powerby">
 <span id="busuanzi_container_site_uv" style="display:none">
 Waiting for No.<span id="busuanzi_value_site_uv"></span>
 </span>
 {{ with .Site.Params.footer.icp }}
 <br/>
 <a href="https://beian.miit.gov.cn" target="_blank" rel="noopener" class="footer-icp">{{ . }}</a>
 {{ end }}
 </section>
</footer>

<script async src="//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>

2. 添加配置 在 hugo.toml 中：

1
2
3


[params.footer]
 since = 2026
 icp = "粤ICP备xxxxxxxx号-1"

3. 添加 ICP 样式 在 assets/scss/custom.scss 中：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


.footer-icp {
 color: var(--body-text-color);
 opacity: 0.5;
 font-size: 1.1rem;
 text-decoration: none;
 font-weight: normal;
}

.footer-icp:hover {
 text-decoration: none;
}

调整后效果

页脚显示访客统计（不蒜子服务，脚本加载成功后自动显示）
显示 ICP 备案号，小号灰色字体，不喧宾夺主

💡 提示

不蒜子是第三方免费服务，几乎是统计访问量的最简单解决方案，很推荐。

4. 禁用目录列表自动编号

Hugo 的 markup.tableOfContents 默认使用有序列表 <ol>，浏览器会自动给目录项添加编号。

如果文章标题本身带有编号（如 “1. 引言”），目录就会产生重复编号：

1
2
3


1. 1. 引言
 1.1 1.1 背景
2. 2. 正文

我们修改 hugo.toml，将ordered设置为false：

1
2
3
4


[markup.tableOfContents]
 endLevel = 4
 ordered = false
 startLevel = 2

调整后目录变为无序列表，干净地显示 “1. 引言” 而非 “1. 1. 引言”。

5. 调整目录行间距

目录项的默认行间距较大。目录过长时会占用过多垂直空间，视觉不够紧凑。

在 assets/scss/custom.scss 中添加：

1
2
3
4


.toc-nav li {
 margin-top: var(--spacing-xs) !important;
 margin-bottom: var(--spacing-xs) !important;
}

目录行间距变小，更加紧凑，显示更多内容。

调整前	调整后

6. 调整代码块样式

代码块样式存在两个问题：

代码块有上下内边距，导致代码区域显得过于宽松
代码块缺乏边框，与正文区分不够明显

我们在 assets/scss/custom.scss 中添加：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


/* 代码块：取消上下padding，增加浅灰边框 */
.article-content .highlight {
 padding: 0 var(--card-padding);
 border: solid 2px #eeeeee;
}

/* 复制代码按钮同步调整位置，上偏移设为0 */
.copyCodeButton {
 top: 0 !important;
}

调整后

代码块上下内边距归零，更加紧凑
浅灰边框（#eeeeee）使代码块与正文有清晰的视觉分隔

后续又增加了顶部工具栏、元件、位置居中卡片等。这就不得不操作assets/ts/main.ts这样的代码文件了。不过效果总之就是非常好看。

7. 样式微调

正文和页面有以下问题

1.5em 的间距过大，显得松散
各处硬编码，无法统一调整
引用块字号与正文相同，缺乏层次感
菜单图标与文字之间存在过大的间距
分割线默认100px，大多数情况下过短

这些复杂样式问题涉及静态 CSS与动态配置的结合。首先核心原理：

Hugo 模板的变量注入：SCSS 文件不会被 Hugo 当作模板执行，无法直接使用 .Site.Params 读取配置。因此需要在 HTML 模板中通过 <style> 标签注入 CSS 变量。
文件作用：
- layouts/_partials/head/custom.html：Hugo 会在每个页面头部引入此模板。我们在这里注入 CSS 变量，读取 hugo.toml 中的 paraSpacing 参数。这里实际上具有一般html元素的地位，因此是个可以进行任何注入（js，css，css变量，DOM节点）的操作点位。
- assets/scss/custom.scss：传统的样式覆盖文件，使用 CSS 变量而非硬编码值。

工作流程：

1
2
3
4
5


hugo.toml 参数 
 ↓
layouts/_partials/head/custom.html 注入 CSS 变量
 ↓
assets/scss/custom.scss 使用变量覆盖主题样式

调整方案

可以看到主题中多个元素的纵向 margin 硬编码为 1.5em：

article-content > p（正文段落）
article-content blockquote（引用块）
article-content .gallery（图片画廊）
article-content table（表格）

我们将这些改为引用 hugo.toml 中的 paraSpacing 参数：

1
2


[params]
 paraSpacing = "1em"

创建变量注入模板，这一步很关键，我们实际上是在向最终html页面直接注入代码。新建 layouts/_partials/head/custom.html：

1
2
3
4
5
6
7


<style>
 :root {
 --para-spacing: {{ .Site.Params.paraSpacing | default "1em" }};
 --quote-font-size: 0.875em;
 --menu-icon-separation: 15px;
 }
</style>

这个文件会被主题自动引入到每个页面的 <head> 中，将 Hugo 配置转换为 CSS 变量。

变量说明：

--para-spacing：控制段落、引用块等元素的纵向间距
--quote-font-size：控制引用块字号（默认 0.875em，比正文略小）
--menu-icon-separation：控制侧边栏菜单图标与文字的间距（主题默认 40px，改为 15px 更紧凑）

然后使用变量覆盖样式，在 assets/scss/custom.scss 中：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31


/* 注意：CSS变量 --para-spacing 和 --quote-font-size 在 layouts/_partials/head/custom.html 中定义 */

/* 正文段落间距 */
.article-content > p {
 margin-top: var(--para-spacing) !important;
 margin-bottom: var(--para-spacing) !important;
}

/* 引用块：间距+字号 */
.article-content blockquote {
 margin-top: var(--para-spacing) !important;
 margin-bottom: var(--para-spacing) !important;
 font-size: var(--quote-font-size);
}

/* 画廊间距 */
.article-content .gallery {
 margin-top: var(--para-spacing) !important;
 margin-bottom: var(--para-spacing) !important;
}

/* 表格间距 */
.article-content table {
 margin-top: var(--para-spacing) !important;
 margin-bottom: var(--para-spacing) !important;
}

/* 分割线宽度 */
.article-content hr {
 width: 70%;
}

调整后效果：

四处元素的纵向 margin 统一由 paraSpacing 参数控制，默认 1em，视觉更紧凑
引用块字号缩小为 0.875em，与正文形成层次对比
侧边栏菜单图标与文字间距从默认 40px 减小到 15px，更加紧凑
后续如需调整间距，只需修改 hugo.toml 中一个参数，无需改动多处 CSS
分割线宽度调整为 70%，相比于默认的 100px 更加适中

8. 修改文章模板 frontmatter 格式

hugo new content 命令使用 archetypes/default.md 作为模板创建新文章。Stack 主题默认生成的 frontmatter 使用 TOML 格式：

1
2
3
4
5


+++
date = '2026-04-11T12:00:00+08:00'
draft = true
title = 'My New Post'
+++

存在的问题

TOML 格式使用 +++ 分隔符，与社区更常用的 YAML 格式（---）不一致
draft = true 导致每篇新文章默认都是草稿状态，需要手动改为 false 才会发布

修改 archetypes/default.md：

1
2
3
4
5


---
date: '{{ .Date }}'
draft: false
title: '{{ replace .File.ContentBaseName "-" " " | title }}'
---

调整后新创建的文章使用 YAML 格式，且默认不是草稿：

1
2
3
4
5


---
date: '2026-04-11T12:00:00+08:00'
draft: false
title: 'My New Post'
---

最后提醒一下，使用

1

hugo new content /post/20260510_articletitle/index.md

来创建文章是个不错的方案。后缀是md不是html别写顺手了。

修改文件汇总

文件路径	修改内容
`hugo.toml`	增加 $...$ 行内公式、禁用目录编号、全局开启数学渲染、添加 `paraSpacing` 参数和 ICP 备案号配置
`archetypes/default.md`	frontmatter 格式改为 YAML，draft 默认 false
`layouts/_partials/footer/footer.html`	精简页脚版权信息，添加不蒜子访客统计和 ICP 备案号展示
`layouts/_partials/head/custom.html`	新建，注入 CSS 变量 `--para-spacing` 和 `--quote-font-size`
`assets/scss/custom.scss`	添加 ICP 样式、目录行间距、代码块样式（边框+复制按钮位置）、段落/元素间距、引用块字号的覆盖样式

后续又做了些修改，不一而足。也许有天会开源这些自定义修改吧。

【从零开始的博客生活 - 2】让博客看起来像Stack的demo一样具有完善的功能

Sat, 11 Apr 2026 02:00:00 +0000

Hugo 的 Stack 主题功能丰富，但官方 Demo 采用了目录式配置（config/_default/ 下拆分 6 个 TOML 文件），对新手来说拼凑出完整配置并不容易。本文记录了从近乎空白的 hugo.toml 出发，一步步配置出完整 Stack 博客的过程，目标是让读者照做即可获得同样的效果。

最终效果：左侧边栏显示头像和社交链接图标，顶部菜单包含主页/关于/归档/搜索/链接五个入口，首页右侧有搜索/归档/分类/标签云小部件，文章页支持数学公式渲染和自动目录。

1. 安装 Hugo 和 Stack 主题

之前的文章里讲过了，大概就是：

1
2
3
4


hugo new site myBlog
cd myBlog
git init
git submodule add https://github.com/CaiJimmy/hugo-theme-stack themes/hugo-theme-stack

添加 .gitignore：

1
2
3


public/
resources/
.hugo_build.lock

在 hugo.toml 中声明主题：

1

theme = "hugo-theme-stack"

2. 理解 Stack 的菜单机制

这是配置中最容易踩坑的地方：Stack 的左侧菜单项不是在 hugo.toml 中定义的，而是通过各内容页面的 front matter menu.main 字段声明的。

也就是说，你需要在 content/ 下创建对应的页面文件，每个页面的 front matter 中指定菜单名称、权重和图标，Hugo 会自动收集这些信息生成菜单。

3. hugo.toml 完整配置

以下是完整的 hugo.toml，每一段都有注释说明作用：

 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101


baseURL = "https://example.org/"
languageCode = "zh-cn"
title = "你的博客标题"
theme = "hugo-theme-stack"
defaultContentLanguage = "zh"
hasCJKLanguage = true

# 分页：每页显示文章数
[pagination]
 pagerSize = 5

# 文章 URL 格式
[permalinks]
 post = "/p/:slug/"
 page = "/:slug/"

# 中文语言配置
[languages.zh]
 languageName = "简体中文"
 title = "你的博客标题"
 weight = 1
 [languages.zh.params.sidebar]
 subtitle = "你的副标题"

# Markdown 渲染配置
[markup]
 [markup.goldmark]
 [markup.goldmark.extensions]
 # 数学公式 passthrough：让 $$...$$ 和 \(...\) 原样传递给前端渲染
 [markup.goldmark.extensions.passthrough]
 enable = true
 [markup.goldmark.extensions.passthrough.delimiters]
 block = [["\\[", "\\]"], ["$$", "$$"]]
 inline = [["\\(", "\\)"]]
 # 允许原始 HTML（部分 shortcode 需要）
 [markup.goldmark.renderer]
 unsafe = true
 # 文章目录：从 h2 到 h4，有序列表
 [markup.tableOfContents]
 endLevel = 4
 ordered = true
 startLevel = 2
 # 代码高亮
 [markup.highlight]
 noClasses = false
 codeFences = true
 guessSyntax = true
 lineNos = true
 lineNumbersInTable = true
 tabWidth = 4

# 主题参数
[params]
 mainSections = ["post"] # 首页展示的文章分类
 rssFullContent = true
 favicon = "img/avatar.png" # 站点图标，路径相对于 assets/

 [params.footer]
 since = 2026 # 建站年份

 # 侧边栏：头像、副标题、emoji
 [params.sidebar]
 emoji = "✏️" # 头像下方显示的 emoji ，可置空。有谁知道这玩意到底有什么用？
 subtitle = "你的副标题"
 avatar = "img/avatar.png" # 头像，路径相对于 assets/

 # 文章许可协议
 [params.article]
 [params.article.license]
 enabled = true
 default = "Licensed under [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)"

 # 小部件：首页和文章页分别显示什么
 [params.widgets]
 homepage = [
 { type = "search" },
 { type = "archives", params = { limit = 5 } },
 { type = "categories", params = { limit = 10 } },
 { type = "tag-cloud", params = { limit = 10 } },
 ]
 page = [{ type = "toc" }] # 文章页显示目录

 # 评论（暂不启用）
 [params.comments]
 enabled = false

# 社交链接图标（显示在侧边栏头像下方）
[[menus.social]]
 identifier = "github"
 name = "GitHub"
 url = "https://github.com/你的用户名"
 [menus.social.params]
 icon = "brand-github"

# 可继续添加更多社交链接，例如：
# [[menus.social]]
# identifier = "twitter"
# name = "Twitter"
# url = "https://twitter.com/你的用户名"
# [menus.social.params]
# icon = "brand-twitter"

关键配置解读

配置项	作用	注意点
`params.sidebar.avatar`	侧边栏头像	图片放在 `assets/img/` 下
`menus.social`	社交链接图标	图标名来自 Tabler Icons，前缀 `brand-`
`markup.goldmark.extensions.passthrough`	数学公式	让 `$$...$$` 和 `$...$` 不被 Markdown 引擎转义
`markup.tableOfContents`	目录范围	h2 到 h4 是比较合理的层级
`params.widgets`	首页/文章页小部件	首页放搜索/归档/分类/标签云，文章页放 TOC

4. 创建内容页面

每个页面的 front matter 中 menu.main 定义了它在左侧菜单中的显示。weight 越小越靠前，icon 对应 Tabler Icons 图标名。

本节很长，但好消息是本节也很水。

4.1 首页 — `content/_index.md`

1
2
3
4
5
6
7
8


---
menu:
 main:
 name: 主页
 weight: -100
 params:
 icon: home
---

4.2 关于 — `content/page/about/index.md`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


---
title: 关于
description: 关于本站及其作者
menu:
 main:
 weight: -90
 params:
 icon: user
---

## 关于本站

在这里写你的介绍。

4.3 归档 — `content/page/archives/index.md`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


---
title: 归档
layout: "archives"
slug: "archives"
menu:
 main:
 weight: -70
 params:
 icon: archives
---

注意 layout: "archives" 是 Stack 主题提供的特殊布局，会自动按时间线展示所有文章。

4.4 搜索 — `content/page/search/index.md`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


---
title: 搜索
slug: "search"
layout: "search"
outputs:
 - html
 - json
menu:
 main:
 weight: -60
 params:
 icon: search
---

outputs: [html, json] 是搜索功能的必要配置，Stack 主题的搜索依赖 JSON 索引。

4.5 链接 — `content/page/links/index.md`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


---
title: 链接
description: 友情链接
menu:
 main:
 weight: -50
 params:
 icon: link
links:
 - title: GitHub
 description: 全球最大的软件开发平台
 website: https://github.com
 image: https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png

comments: false
---

在这里可以添加友情链接。在 front matter 的 `links` 字段中配置即可。

links 字段是 Stack 主题的友情链接功能，每项包含 title、description、website、image。

5. 放置头像

将头像图片放到 assets/img/avatar.png，与配置中 params.sidebar.avatar = "img/avatar.png" 对应。

Hugo 会自动从 assets/ 目录查找资源文件，所以配置路径是相对于 assets/ 的。

6. 数学公式渲染

配置分两层：

hugo.toml 中的 passthrough（已在上面配置）：让 Markdown 引擎不处理 $$...$$ 和 $...$，原样输出到 HTML
文章 front matter 中启用：每篇需要数学公式的文章，在 front matter 中添加 math: true

示例文章 front matter：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


---
title: "一篇数学文章"
math: true
---

行内公式 $E = mc^2$，块级公式：

$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

Stack 主题会在检测到 math: true 时自动加载 KaTeX 渲染引擎。

7. 文章目录

已经在 hugo.toml 中配置了：

markup.tableOfContents：定义 TOC 的标题层级范围（h2-h4）
params.widgets.page = [{type = "toc"}]：文章页右侧自动显示 TOC 小部件

无需在文章 front matter 中额外配置，所有文章都会自动显示目录。

8. 菜单图标

左侧菜单图标和社交链接图标使用 Tabler Icons。图标被Stack放在 assets/img/icons/ 目录下，可以直接使用。也可以去Tabler官网下载SVG图标放到自己的图标文件夹里(./assets/icons)使用。

比如说，非常离谱，默认是没有mail图标的，你得自己下一个才方便在主页放一个自己的邮箱按钮。

9. 最终目录结构

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


myBlog/
├── hugo.toml
├── assets/
│ ├── img/
│ │ └── avatar.png
│ └── icons/
│ └── mail.svg
├── content/
│ ├── _index.md
│ ├── page/
│ │ ├── about/index.md
│ │ ├── archives/index.md
│ │ ├── search/index.md
│ │ └── links/index.md
│ └── post/
│ └── ... (你的文章)
└── themes/
 └── hugo-theme-stack/ (git 子模块)

10. 预览

1

hugo server

打开 http://localhost:1313 即可查看效果。确认无误后，用 hugo 命令生成静态文件到 public/ 目录。

【从零开始的博客生活 - 1】Hugo 初见与 Stack 主题

Sat, 11 Apr 2026 01:00:00 +0000

0. 技术选型

考虑使用静态网站生成器hugo，因为CMS实在是太重了，反正都要在电脑上写作，写作端干脆采用更灵活的方案，例如vscode或者总是被推荐的typora，思源笔记等。而博客前端则主要考察发布过程是否方便，主题样式是否合眼，文档和讨论的支持是否丰富。

在考察过程中发现 EdgeOne Page 静态托管支持 Hugo ，也就是说不用采用经典的依附于 GitHub Action 和 GitHub Pages 的方案，可以直接在 EdgeOne Page 上 CI/CD ，并提供给国内用户访问，这一点就很方便。

Hugo主题站还算丰富，看到一个 Stack 主题很符合我的需求。Hugo 和 Stack 都有丰富的生态讨论环境，Stack 还有中文文档（虽然看下来发现非常简陋机翻），所以就这样吧。

不过上手了才发现坑还是巨多。不明白为什么这么一个成熟的应用领域还这么不完善。

1. 下载安装

Hugo 是一个静态站点生成器，虽然最终构建通常由 CI/CD 执行，但本地安装便于预览和调试，通常也是必要的。

1. 下载Hugo

从 Hugo Releases 下载对应版本的压缩包，例如hugo_extended_0.160.1_windows-amd64.zip
解压后将 hugo.exe 所在目录添加到系统 PATH，例如 E:\Program Files\hugo
并没有"安装"过程

终端选择

Hugo 官方推荐使用 Bash 或 PowerShell 7+，不建议使用 CMD 或 Windows PowerShell 5.x。

💡 冷知识：PowerShell 7 有官方立绘

若要在 VS Code 的集成终端中使用 PowerShell 7，可在用户配置中添加以下配置：

1
2
3
4
5
6


"terminal.integrated.profiles.windows": {
 "PowerShell 7": {
 "path": "pwsh.exe",
 "icon": "terminal-powershell"
 }
}

📝 顺带一提打开用户配置的方法是

ctrl + shift + P

输入 open user settings json

2. 创建站点

执行以下命令初始化博客：

1
2
3


hugo new site my-site # 创建站点骨架
cd my-site
git init # 初始化 Git 仓库

注意： 执行命令的位置不重要，关键是 my-site 目录所在的位置才是真正的项目根目录。

创建完成后，项目目录会生成基础文件结构，其中 ./hugo.toml 是核心配置文件。

创建一个.gitignore文件先把构建产出等乱七八糟的东西屏蔽掉，内容如下：

1
2
3


public/
resources/
.hugo_build.lock

2. 安装主题

Hugo所谓的主题其实不仅是一套样式这么简单，实际上Hugo只是个基座，主题则承载了渲染和配置等大量工作，因此是重要的组成部分。

从 Hugo 主题商店选择心仪的主题，在项目根目录下使用 PowerShell 通过 Git Submodule 安装：

1

git submodule add https://github.com/CaiJimmy/hugo-theme-stack.git themes/hugo-theme-stack

💡 提示

记住我们这里使用的是 git子模块方式配置的主题，这会影响后续的某些操作

比如说从远端拉取本项目时你将必须同时进行git submodule update --init --recursive以同步拉取子模块

然后在 ./hugo.toml 中启用主题：

1

theme = "hugo-theme-stack"

直接从主题官方仓库拉取的好处是可以接收主题作者的后续更新。我们一般不会直接修改theme中的文件，对现实效果的自定义将通过Hugo的“覆盖”机制进行。

2. 创建第一篇内容

创建内容和创建第一篇内容的区别就在于，第一次时总是有这样那样的配置需要搞一搞，以后就慢慢顺了。说起来还挺烦的。

使用 hugo new content post/first/index.md 创建第一篇内容。注意 Stack 主题要求文章放在 post 而不是 posts 目录下，不要写错。

Frontmatter 是文章的元数据，不过没有流行的中文翻译，姑且叫他前置设置吧。一般包括标题、日期、标签等。例如本文的配置：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


---
date: 2026-04-11 01:00:00
draft: false
title: "【从零开始的博客生活 - 1】Hugo 初见与 Stack 主题"
description: "今天起成立了"
tags: ["Hugo", "Stack"]
categories: ["技术", "博客"]
image: "蓝毒.jpg"
math: true
---

你可能会发现自己的配置头与本文的不太一样。这是因为我后续又调整了 hugo new 的行为，默认采用yaml格式配置头。

说一下几个字段：

draft：是否为草稿。默认值为 true。主要作用是让你别误发布了尚处于草稿阶段的文章。但是没卵用，因为Hugo根本没有内容管理能力，任何一个对数据安全稍有负责心的作者都应该使用笔记软件或其他东西来确保自己的草稿不意外丢失，等进入 Hugo 构建阶段了基本就是要发布了。
math：是否开启数学公式支持。这是通过 Stack 主题提供的 $\rm K^AT_EX$ 能力来实现的。其实也可以通过配置渲染穿透和MathJax来实现，不过现在这样看起来也够用就暂时不再折腾了。Katex比MathJax轻量级且快。推荐全局开启，文章头就不用写了。
description：文章的描述，同时会写在文章标题下方，在文章页和文章列表页显示，实际上类似副标题的地位。
tags：文章的标签，用于分类和搜索。除了主页分类，tags还会被写入文章页面的 <head> 中，对SEO有帮助。

Markdown 语法就不说了。可以看demo里提供的一个示例文章，很详细。

完事就使用 hugo server 查看效果，默认会渲染到 http://localhost:1313 。这个渲染是即时的，类似于 npm run dev ，可以在调整了文章内容或配置后立即看到效果。按照官方的说法，“这个过程相当快，你应当察觉不到页面被重渲染了”。

3. 你说的这个 demo ，它在哪啊？

在.\themes\hugo-theme-stack\demo\

Stack 主题有一个 demo 目录，里面包含了一些示例文章，同时也是重要的参考文档。有个 themes\hugo-theme-stack\demo\run.sh 告诉我们这样启动它：

1

hugo server --gc --themesDir=../..

但是这是不行的，因为在 themes\hugo-theme-stack\demo\config_default\hugo.toml Line 11 中有个错误：

1
2


[[module.imports]]
 path = "github.com/CaiJimmy/hugo-theme-stack/v3"

这个设置指明通过 Hugo Module 来引入主题，但是我们的主题是通过 Git Submodule 安装的，所以这里需要改为：

1

theme = "hugo-theme-stack"

然后再在.\themes\hugo-theme-stack\demo\启动命令行输入hugo server --gc --themesDir=../..就可以预览了。

4. 为什么Stack这么麻烦

最近很多人都在问为什么Stack这么麻烦，小编也非常好奇。实际上小编也不知道为什么一个6.3k多星的项目会这么麻烦，可能还是没太明白它的设计原则。

Markdown 语法指南

Sun, 25 Jan 2026 00:00:00 +0000

这篇文章提供了可以在 Hugo 内容文件中使用的基本 Markdown 语法示例，同时也展示了 Hugo 主题中基本 HTML 元素是否应用了 CSS 装饰。

标题 (Headings)

以下 HTML <h1>—<h6> 元素代表了六个级别的章节标题。<h1> 是最高级别，而 <h6> 是最低级别。

H3

H4

H5

H6

段落 (Paragraph)

Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.

Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.

引用 (Blockquotes)

引用元素代表从另一个来源引用的内容，可以选择带有引用说明（必须在 footer 或 cite 元素内），也可以选择带有行内更改（如注释和缩写）。

不带出处的引用

Tiam, ad mint andaepu dandae nostion secatur sequo quae. 注意：你可以在引用中使用 Markdown 语法。

带有出处的引用

不要通过共享内存来通信，而要通过通信来共享内存。
— Rob Pike¹

带提示的引用

📝 备注

突出显示用户在快速浏览时也应注意的信息。

💡 提示

可选信息，帮助用户更顺利地完成任务。

📌 重要

用户成功所必需的关键信息。

⚠️ 警告

由于潜在风险而需要用户立即关注的关键内容。

🚨 注意

某个操作可能带来的负面后果。

📝 自定义标题

如果你想使用自定义标题，可以在方括号后面添加标题文本，如上所示。

表格 (Tables)

表格虽然不是 Markdown 核心规范的一部分，但 Hugo 出箱即用地支持它们。

姓名	年龄
Bob	27
Alice	23

表格内的行内 Markdown

斜体	加粗	代码
italics	bold	`code`

A	B	C	D	E	F
Lorem ipsum dolor sit amet, consectetur adipiscing elit.	Phasellus ultricies, sapien non euismod aliquam, dui ligula tincidunt odio, at accumsan nulla sapien eget ex.	Proin eleifend dictum ipsum, non euismod ipsum pulvinar et. Vivamus sollicitudin, quam in pulvinar aliquam, metus elit pretium purus	Proin sit amet velit nec enim imperdiet vehicula.	Ut bibendum vestibulum quam, eu egestas turpis gravida nec	Sed scelerisque nec turpis vel viverra. Vivamus vitae pretium sapien

代码块 (Code Blocks)

使用反引号的代码块

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


<!doctype html>
<html lang="en">
<head>
 <meta charset="utf-8">
 <title>Example HTML5 Document</title>
</head>
<body>
 <p>Test</p>
 <p>Test LOooooooooooooooooooooooooooooooooooooooooooo123123123123ooooog</p>
</body>
</html>

使用四个空格缩进的代码块

<!doctype html>
<html lang="en">
<head>
 <meta charset="utf-8">
 <title>Example HTML5 Document</title>
</head>
<body>
 <p>Test LOoooooooooog</p>
</body>
</html>

Diff 代码块

1
2
3
4
5


[dependencies.bevy]
git = "https://github.com/bevyengine/bevy"
rev = "11f52b8c72fc3a568e8bb4a4cd1f3eb025ac2e13"
- features = ["dynamic"]
+ features = ["jpeg", "dynamic"]

单行代码块

1

<p>A paragraph</p>

列表类型 (List Types)

有序列表

第一项
第二项
第三项

无序列表

列表项
另一项
还有一项

嵌套列表

水果
- 苹果
- 橘子
- 香蕉
乳制品
- 牛奶
- 奶酪

其他元素 — abbr, sub, sup, kbd, mark

GIF 是一种位图图像格式。

H₂O

Xⁿ + Yⁿ = Zⁿ

按 CTRL + ALT + Delete 结束会话。

大多数蝾螈是夜行性的，捕食昆虫、蠕虫和其他小型生物。

以上引用摘自 Rob Pike 在 2015 年 11 月 18 日 Gopherfest 期间的演讲。 ↩︎

写法	示例	渲染效果
`\(...\)`	`\(E = mc^2\)`	\(E = mc^2\)
$...$	$E = mc^2$	$E = mc^2$
`\[...\]`	`\[E = mc^2\]`	\[E = mc^2\]
`$$...$$`	`$$E = mc^2$$`	$$E = mc^2$$