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 老刘
小米SU7又出事了,我们到底该怪谁?

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

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

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

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

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

By 老刘
荔枝路远,道在人心——从《易经》看李善德的一生

荔枝路远,道在人心——从《易经》看李善德的一生

马伯庸的小说《长安的荔枝》及其改编剧集,看似讲述一场跨越千里的荔枝运输奇旅,实则以小人物的遭遇折射盛唐末期政治、社会、文化的真实图景。主人公李善德,这位从九品小吏,在完成“运荔枝”这一看似荒诞实则关乎权力的任务中,演绎出一部小人物在大时代中如何“知命”、“尽性”、“归真”的命运史。 本文尝试以《易经》的视角,借其卦象与哲思,还原李善德的命运轨迹与精神转化。 一、《屯卦》:困中求进,命运起始 卦辞:“屯,元亨,利贞。勿用有攸往。利建侯。” “屯”象征万物初生,动荡未定。李善德身为地方文吏,无权无势,却在极为不利的局势中被委以“千里送荔枝”之命——这是危也是机。他组建了一支临时小队,历经风雨山川、盗贼瘴气,表面是传荔枝,实则是在夹缝中求生存。这正是“屯”卦中的“利建侯”

By 老刘