Hugo-papermod主题的优化记录

在上一篇文章中曾经说到把博客从WordPress转到了Hugo,经过这几天的使用,发现还是很不错的,用起来也比较方便。但是,在使用PaperMod主题的时候,也是遇到了一些问题,本文就遇到的问题作一个记录。目前,主题的代码高亮功能还是没有搞定,不过也是影响不大,先放一放也无所谓。

首页不显示文章

把WordPress导出的md文件导入的Hugo的psots目录后,在使用代码创建新文件时候

hugo new posts/***.md

发现新建的md文件,生成网页后不会在首页显示。但是在栏目里是会有的。后来的在@阿甘博客博客的提醒下,使用导出的md文件的文档属性标头,成功的显示了。但是,每次在生成文章md的时候,都需要手动的更改,不是太方便。后来,在看某篇文章的时候得到启发,修改archetypes/default.md,把默认的代码删除,改成:

---title: "{{ replace .Name "-" " " | title }}" author: 老刘 date: {{ .Date }}url: /optics-weekly-issue-8/categories:  - 齐物论---

然后,再创建md文件后,只需要修改一下url里的值就OK了。

增加评论功能

这个主要是copy了阿甘博客的方法。 在artalk的官方文档中找到Artalk.cssArtalk.js文件的cdn地址然后下载到本地,在hugo项目根目录的/static文件夹下面新建一个叫 artalk的文件夹,然后把前述两个静态文件放进这个文件夹

创建模板文件 /主题目录/layouts/partials/comment/artalk.html,文件内容如下:

<link href="/artalk/Artalk.css" rel="stylesheet"><script src="/artalk/Artalk.js"></script> <!-- Artalk --><div id="Comments"></div> <script>  Artalk.init({     el:        '#Comments',     pageKey:   '{{ .Permalink }}',     pageTitle: '{{ .Title }}',     server:    '{{ $.Site.Params.artalk.server }}',     site:      '{{ $.Site.Params.artalk.site }}',     // ...你的其他配置   }) </script>

文章页模板 /主题目录/layouts/_default/single.html 合适的位置添加:

<div class="article-comments">  {{- partial "comment/artalk" . -}}</div>

具体位置为single.html文件的{{- if (.Param “comments”) }}判断体中,完整的代码如下:

{{- if (.Param "comments") }}  <div class="article-comments">  {{- partial "comment/artalk" . -}}</div>  {{- end }}

然后在 Hugo 配置文件中添加如下内容:

params:  artalk:    server: 'https://artalk.sharpgan.com'    site: '图南博客'

至于artalk的部署方法,可以用docker来部署,官方有详细的方法

不加载CSS和JS

这个问题有点玄学,很多教程给出的答案都是去Cloudflare里修改,使优化不压缩js和CSS,但是在我这里没有效果。看了错误的提示好像是SHA-256完整性的检查不通过,浏览器阻塞了。 一般的解决办法是: 是要么关闭 SRI,要么取消 Cloudflare 的「Auto Minify」。 Cloudflare 关闭的方法:速度 - 优化 - Auto Minify。 在 Hugo 中关闭的方法:

params:  assets:    disableFingerprinting: true

但是,在我这里怎么搞都没有用。 后来看到一个哥们的博客,网址我忘掉了,通过修改一个值,搞定了。 在 themes\PaperMod\layouts\partials 文件夹下找到一个 head.html 文件,发现里面确实有 integrity\="{{ \$stylesheet.Data.Integrity }}" 这么一句代码,把它改为 integrity\="" 然后重新发布

代码高亮

这个我参考了阿甘和其他的一些文章,但是都没有成功,有时候有一点颜色,有时候一丢丢颜色也没有。我感觉可能是和物品修改了上面的那个head.html有关系。 然而,我的猜测是错误❌的,加上那个代码也没有用。然后我回复用官方的一个dome,发现是可以显示代码高亮的,仔细查看了我的配置文件和官方的配置文件的差别,发现是在设置代码高亮的那个地方,有一个选项不能是true,不然就不显示,太玄学了。 具体代码:

highlight: # anchorLineNos: true noClasses: false # anchorLineNos: true #codeFences: true #guessSyntax: true lineNos: true style: monokai

Read more

十五年后:一个家庭的沉沦与命运的回音

十五年后:一个家庭的沉沦与命运的回音

十五年前,我写下《郁闷,这个世界还有这样无耻之人》这篇文章时,内心翻滚的不是小事的愤怒,而是对底线被践踏的失望。邻居从我家拉电线充电,还一副理所当然的样子,最后竟连我家的充电器都“借用”。甚至因为我给他写了纸条,还想打我。当时我说:“这个世界还有这样无耻之人”,只是没想到,十五年后再听到他们家的消息,竟是一出更荒诞的悲剧。 那家的男人已经去世。留下两个老婆争房产,最后还是他儿子获得了这套回迁房。他的儿子大学毕业了,却像一艘没有舵的船,一路磕磕绊绊: 交房一年来,看他儿子在业主群里抱怨,被电梯夹了不止一次,骑车进地下室摔过多回,车轮卡在道缝中,正常走路还能摔个仰八叉。毕业后没有工作,前不久小区换物业的时候,经介绍在小区做监控员,不服从管理员的管理(其实也是小事,人家让他把桌子上保持整洁,他就是不听,弄的乱七八糟的),和物业经理骂了一架,被辞退。邻里原想通融一二,以他母亲那无理取闹的性格,当然是又去物业把物业经理骂了一顿,结果也就那样了。 前几天偶尔和一个邻居聊起他家的情况,那个邻居说,他要打你那不是基本操作嘛,人早年曾在派出所拿刀扎他自己母亲,打你都是轻的😅。如今看来,

By 老刘
天上有雨,未落人间——说说《需卦》

天上有雨,未落人间——说说《需卦》

《易经》六十四卦中,《需卦》排在第五。 前面几卦,乾坤是天地之本,屯是起步之难,蒙是启蒙之初,到了第五卦——《需》——天地间万象已动,人也有所思、有所欲,但偏偏,这一步还不能迈出去。 需,有孚,光亨,贞吉,利涉大川。 等,不是停,是蓄。 卦象:天上有云,水未落 需卦的卦象是:上坎(☵,水)下乾(☰,天)。 水在天上,正是积雨之象。我们站在地上,仰望天空,望着那片厚厚的云,知道它迟早会落雨,但此时此刻,还未滴下哪怕一丝甘露。 这就叫“需”。 你知道目标在前,力量也已在身,但时机未到,不能躁进。 用现在的话说就是:“你已经准备好了,但世界还没准备好接住你。” 这不是消极,而是一种审时度势的智慧。

By 老刘
小米SU7又出事了,我们到底该怪谁?

小米SU7又出事了,我们到底该怪谁?

6月11日晚上,郑州街头,一辆小米SU7失控连撞十几辆车——电动车、小轿车都没躲过,车头几乎报废,现场一度混乱不堪。更早之前,安徽那起SU7高速起火致三人死亡的事故也还没从大家脑海中淡去。 姑且不说到底是不是智能驾驶的原因, 也有很多它的粉丝说比亚迪出事多少多少,归根到底还都是电车的问题,那么电车怎么老出事? 是车太猛?人太嫩?还是对“智能驾驶”理解太美好? 动力太猛,新手真心顶不住 先说车。SU7有多猛?顶配版零百加速2秒多,马力直接干到1000匹以上,这种性能放在燃油车里,那就是超跑级别。 但问题是,买它的大多是年轻人,很多是人生第一辆车,甚至有的刚拿驾照没多久。这种“猛兽”配“新司机”的组合,说实话,确实危险系数高。一脚电门下去,车先冲出去了,人还没反应过来。 郑州这次的女司机,就是刚提车不久。车一失控,根本刹不住。不是她不会开,而是这车给新手的容错空间实在太小了。 智能驾驶不是“放手驾驶” 再说智能驾驶。小米宣传的NOA、

By 老刘
站在新高考的起点:对两年后女儿的期许

站在新高考的起点:对两年后女儿的期许

2025年的高考今天落幕,这是“3+1+2”模式全面实施的第一年。从改革到首考,从认知到实践,这不仅是对学生能力的测量,更是一种教育方向的宣示。 作为家长,我对这次高考有三点深刻感受: 一、语文卷:不再“刷题”,更考“立志与思辨” 今年全国卷一作文聚焦“民族魂”,从老舍、艾青、穆旦的文字中引导学生理解爱国情怀的不同方式 。考题不仅强调情感共鸣,也要求结构逻辑清晰,表达真诚、语言自然流畅 。 这道作文开放而不空洞:任何有生活、有思考的学生,都能找到表达路径;但能够精准逻辑、有独立见解,并融入素材,便是真高分。 这使我明白,真正的语文能力,不在于套路,而在于“你是谁”——有温度、有思想、有立场。 二、历史题:文言与史料,强调跨学科理解 今年历史全国卷大量使用文言史料,并引导学生依据不同角度进行对比、评析与判断

By 老刘