拾光笔记

Hugo PaperMod 移动端导航栏改造：汉堡菜单与悬浮面板

Thu, 03 Sep 2026 21:00:00 +0800

博客用的是 Hugo 的 PaperMod 主题，默认的导航栏在手机上是横向滚动的：菜单项一多就溢出屏幕，想看后面的得用手指拖着划，很难受。我希望把它改成常见的「点一下汉堡按钮弹出菜单」的形式，顺手还要让导航栏吸顶、点空白处能收回。这篇记录一下完整的改法。

Hugo PaperMod 自定义 404 页面与系列导航

Tue, 01 Sep 2026 20:00:00 +0800

PaperMod 主题自带的 404 页面只有一句纯文字，很简陋；右侧侧边栏的「系列」卡片此前也只放了系列名链接，不显示系列里的其他文章。这次给博客补上自定义 404 页面，并把系列内导航做进右侧系列卡片里。本文记录实现过程。

Caddy替换Nginx反向代理指南

Tue, 25 Aug 2026 10:00:00 +0800

适用环境：CentOS Stream 9 / Rocky Linux 9

难度：中等

一、为什么要换

Nginx + Certbot（Let’s Encrypt）是经典组合，但日常维护有两个痛点：

证书每 90 天要续期，虽然 Certbot 有定时任务，但偶尔还是会因为网络、配置问题失败，需要人工处理。
配置相对繁琐：server 块、ssl 证书路径、http 跳 https 的 301、gzip 等都要手写。

Caddy 的核心卖点是自动 HTTPS：

Hugo PaperMod 文章分类/系列/标签右侧侧边栏

Sat, 22 Aug 2026 19:00:00 +0800

想把文章的标签放到网页右侧，做法是仿照 PaperMod 已有的左侧目录（TOC）侧边栏机制，在后面又加上了分类和系列，做成三个独立卡片，随页面滚动固定不动。本文记录实现过程和踩的坑。

giscus 评论区跟随 PaperMod 主题明暗切换

Sat, 22 Aug 2026 18:00:00 +0800

折腾评论区的时候发现一个事：站点的评论区不会跟随主题变色，一直白底。查阅资料发现giscus官方配置中的data-theme="preferred_color_scheme"表示跟随系统变色，我把系统颜色从浅色改成深色后，评论区就变成了深色，但是我希望评论区跟随主题变色，所以需要做一些调整。

首页打字机特效手机端文字显示不全的修复

Sat, 22 Aug 2026 09:00:00 +0800

最近发现手机端访问首页时，标题「半知半解，且过且学！」的打字机特效走完之后，文字右侧被截断、显示不全，而桌面端一切正常。本文记录排查过程与修复方案。

Vscode自定义设置

Fri, 21 Aug 2026 23:44:27 +0800

Vscode禁止自动添加import

避免pylance自动添加import，打开设置，搜索autoimportcompletions，取消勾选即可。

禁用自动格式化

我设置了全局格式化并且安装了prettier插件，但是某些格式的文件不需要格式化，比如markdown文件，所以需要禁用这些文件的自动格式化。

Linux使用技巧

Fri, 21 Aug 2026 23:38:10 +0800

重启plasmashell

kquitapp5 plasmashell && kstart plasmashell

Firewalld的基本使用

Fri, 21 Aug 2026 23:19:21 +0800

firewalld的基本使用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 启动
systemctl start firewalld

# 查看状态
systemctl status firewalld

# 停止
systemctl disable firewalld

# 禁用
systemctl stop firewalld

配置firewalld-cmd

 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


# 查看版本
firewall-cmd --version

# 查看帮助
firewall-cmd --help

# 显示状态
firewall-cmd --state

# 查看所有打开的端口
firewall-cmd --zone=public --list-ports

# 更新防火墙规则
firewall-cmd --reload

# 查看区域信息
firewall-cmd --get-active-zones

# 查看指定接口所属区域
firewall-cmd --get-zone-of-interface=eth0

# 拒绝所有包
firewall-cmd --panic-on

# 取消拒绝状态
firewall-cmd --panic-off

# 查看是否拒绝
firewall-cmd --query-panic

开启端口

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 添加
firewall-cmd --zone=public --add-port=80/tcp --permanent （--permanent永久生效，没有此参数重启后失效）

# 重新载入
firewall-cmd --reload

# 查看
firewall-cmd --zone= public --query-port=80/tcp

# 删除
firewall-cmd --zone= public --remove-port=80/tcp --permanent

Selenium报错解决

Fri, 21 Aug 2026 23:14:21 +0800

selenium报错：urllib3.exceptions.ProxySchemeUnknown: Proxy URL had no scheme, should start with http:// or https://

最近用Python+selenium做了一个自动化工具，但由于本地开启了全局代理，在发起请求的时候返回了上面的报错，经过一番研究，终于解决了这个问题。

Python Install Manager 使用手册

Fri, 21 Aug 2026 21:57:19 +0800

一、安装

访问官网下载安装包，双击安装即可。
安装完成后重启终端，运行py --help检查是否可用
首次使用建议运行py install --configure，这会引导你开启 App Execution Aliases（系统设置 → 应用执行别名）。

Hugo PaperMod 自定义

Tue, 11 Aug 2026 20:13:53 +0800

这一部分主要是跟着问道凌虚的《Hugo折腾记》来做的（注：该站点目前已无法访问，链接仅作出处记录）。

下面是我自行修改的配置

1 侧边目录及阅读进度条

侧边目录最初参考了在PaperMod中引入侧边目录和阅读进度显示，基本没有修改。后来把目录内容换成了Hugo内置的.TableOfContents（由Hugo直接生成嵌套<ul>），模板只保留外框和滚动高亮；阅读进度条则挂在「回到顶部」按钮上。下面记录最终的做法。

1.1 配置（hugo.yaml）

目录收录的标题层级交给Hugo内置目录控制，保持h1~h6全收（我站内有文章用#当章节标题）：

Blog免密push

Sun, 09 Aug 2026 15:22:00 +0800

一、本地生成ssh_key

1

ssh-keygen -t ed25519 -C "yourname"

一路回车，不设置 passphrase（如果设置了密码短语，push 时还是要输一次，不能算完全免密）。

生成后密钥文件在：

1
2
3


C:\Users\你的用户名\.ssh\id_ed25519 # 私钥，千万别泄露

C:\Users\你的用户名\.ssh\id_ed25519.pub # 公钥，我们要用它

查看公钥内容：

Hugo+Nginx+Git部署博客指南

Sun, 12 Jul 2026 18:23:25 +0800

适用环境：Ubuntu / Debian / CentOS

服务器配置：2核2G 及以上

难度：中等

💡 提示：如果不想用 Nginx，或想省去证书续期的麻烦，可以参考本站的《Caddy替换Nginx反向代理指南》——它同样适用于本文搭建的 Git 自动部署流程，只是把托管环节换成 Caddy。

关于我

Sun, 07 Jun 2026 00:00:00 +0800

一个热衷于折腾技术与记录生活的普通人。