记本本 on NaCl 在摸鱼

记录一下崩铁的 Fandom 和 BWiki 图片 URL 前字符串

Sat, 30 May 2026 15:25:10 +0800

Fandom

我以前在 Honkai: Star Rail Wiki 找角色的素材图时注意到，每张图片的 URL 格式都很相似。比如姬子跃迁立绘：https://static.wikia.nocookie.net/houkai-star-rail/images/8/8e/Character_Himeko_Splash_Art.png/revision/latest?cb=20230525090036，共同的前缀+1 位字符+2 位字符+文件名+版本控制参数。所有图的文件名格式都很规范，比如 Character_Himeko_Icon.png 是姬子头像，Character_Himeko_Eidolon_6.png 是姬子 6 星魂。

我猜测 imgaes 和文件名之间的两处字符是为了优化缓存和负载均衡之类的，可能是用某种哈希算法根据文件名生成的，但是用于相关函数说不定在 js 里面。我可不懂如何从网页前端扒拉 js 用，于是打算把所有角色各素材的 URL 中那两处特殊的字符单独存下来。存了几个之后发现，1 位字符始终是 2 位字符的第 1 位，于是只存两位字符就行。

前段时间想，不管函数存在哪里，我猜用的还是成熟算法，自己设计算法容易不平衡、不稳定、有漏洞什么的，费力不讨好。于是我尝试生成一下文件名的 MD5，没想到还真是这个。比如 Character_Himeko_Splash_Art.png 的 MD5 开头就是 8e。

于是我把之前好容易全存下来的数据全删了哈哈哈。

BWiki

后来也想用星穹铁道WIKI 的素材，一看图片 URL 傻眼了。比如姬子的半身立绘图：https://patchwiki.biligame.com/images/sr/0/08/3gv4qax2cdksleouchs6vr0y8jgdg6g.png。 sr 后面的两处应该还是与 Fandom 类似的做法，但是文件名像加密了似的，而且文件名的算法还不一样。

想了一想，估计这种文件名的作用和前面两处字符也差不多，而且网页里也得有个原来的字符串的蛛丝马迹。一不做二不休，开 F12 看两眼。找到了疑似原文件名的参数 角色一览-姬子.png。试一试算 MD5，开头是 08，好耶！

那文件名会是什么算法呢？试了试 MD5、SHA-1、SHA-256、SHA-512 都不对，去掉后缀名用 角色一览-姬子 再试一次生成，也不对。想用英文名试试，但是不知道 角色一览 在站里的英文对应什么，就从角色头像试试，但还都不对。

仔细观察一下，URL 文件名所有字母都有，但是算出来的都是 16 进制的字符串，那我转 36 进制试试。依然不对。

那会不会是用文件本身生成的呢？于是用 Dolphin 文件管理器自带的计算文件校验码的功能看了看，SHA-1 转 36 进制的前 10 位对上了！

那后面的部分会是什么呢？用不同算法拼接的吗？把之前步骤里的字符串对照一下，没找到共同子串。

要不问问 AI 叭，于是把现在的情况给 ~~Deepsleep~~ 描述了一下。 ~~深度睡眠~~先生也说可能是拼接的，按它给的方案试了试都不行。又刷新了几次，提到可能是进制转换时没用大整数导致的。了解了一下什么是大整数，然后用代码生成了一下，真成了~

其实整个文件名都是用 SHA-1 生成的，只是之前转码用的不是大整数。把整个字符串看成一个完整的 16 进制整数去转换，而不是按每位字符转换就可以了~（耶

 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


import hashlib

def sha1_to_base36(filepath: str):
 # 读取文件二进制
 with open(filepath, 'rb') as f:
 data = f.read()
 # 计算 SHA-1 十六进制（40位）
 hex_digest = hashlib.sha1(data).hexdigest()
 # 转换为大整数
 big_num = int(hex_digest, 16)
 # 转换为 36 进制
 chars = '0123456789abcdefghijklmnopqrstuvwxyz'
 if big_num == 0:
 return '0'*31
 result = []
 while big_num > 0:
 big_num, rem = divmod(big_num, 36)
 result.append(chars[rem])
 base36 = ''.join(reversed(result))
 # 前面补0至31位
 return base36.rjust(31, '0')

# 测试
filepath = 'path/to/file'
print(sha1_to_base36(filepath))

我的 Arch Linux + Niri + Noctalia 安装

Tue, 23 Apr 2024 15:00:00 +0800

我的环境：机械革命 S1 Pro，i5-8265u，NVIDIA MX250，双硬盘双系统

由于 Arch Linux 滚动更新，本指南有时效性，请注意本文修改日期。见官方的安装指南。当下， Archinstall 已经预装在安装镜像中了，但我不太喜欢预定配置，所以手动安装。我的环境是 UEFI 启动的 amd64 系统，能装 Windows 10 的电脑基本都能满足这一点。详见 Verify the boot mode

安装前

下载安装镜像，用 Ventory 把没有重要数据的小 U 盘制作成安装盘，然后把安装镜像复制进 U 盘的存储空间。 Linux 下烧录教程请移步 Linux 下制作 U 盘安装镜像
关闭 BIOS 中的安全启动
关闭 Windows 的快速启动功能（忘了是否有影响了，不过关了也放心）

💡 提示

最好在虚拟机里尝试安装一次再操作物理机，稳妥永不过时。

安装镜像的系统中自带 vim、nano 等文本编辑器，后者用法简单，百度一下就会了。

进入 U 盘的安装系统

U 盘插入电脑后开机，按功能键进入启动菜单（Boot Menu），如 F7 或 F12 等（不同电脑牌子或主板不同），选择 U 盘对应启动项。不清楚就百度搜索自己的电脑型号如何进入启动菜单。

如果字太小，setfont ter-132b 临时换个大的终端字体。

联网

网线连接一般自动配置好了。如果从 WiFi 连接，用 iwctl 。然后 ping baidu.com 测试联网，如果大约每秒都出现一行新结果，表明网络畅通。

磁盘分区与格式化

⚠️ 警告

千万不要装错硬盘！ 防止不小心格式化其他盘，本文以 sdX 代称。

使用 lsblk 命令得知硬盘的「名字」。

硬盘分区的「名字」举例：

/dev/sdc3：硬盘 /dev/sdc 上的第 3 个分区
/dev/nvme2n5p3：硬盘 /dev/nvme2n5 上的第 3 个分区

我的方案	建议大小	作用	文件系统	分区	挂载点位
1 GiB	1 GiB	引导分区	fat32	/dev/sdX1	/efi
剩余所有空间	剩余所有空间	根分区	btrfs	/dev/sdX2	/

使用 fdisk /dev/sdX 命令进入交互式分区。

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


g # 创建 GPT 分区表
n # 新建分区 1
[Enter] # 默认分区号
[Enter] # 默认起始扇区
+1G # 大小 1 GiB
t # 修改类型
1 # 选择分区 1（或直接回车）
1 # 设为 EFI System 分区
n # 新建分区 2
[Enter] # 默认分区号
[Enter] # 默认起始扇区
[Enter] # 默认剩余全部空间
t # 修改类型
2 # 选择分区 2
23 # 设为 Linux root (x86-64) 分区
w # 写入并退出

然后用 fdisk -l /dev/sdX 检查分区结果。

格式化分区：

1
2


mkfs.fat -F 32 /dev/sdX1
mkfs.btrfs -f /dev/sdX2

创建 Btrfs 子卷：

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


mount /dev/sdX2 /mnt

# @ 作为未来系统的根
btrfs subvolume create /mnt/@

# @home 承载用户数据
btrfs subvolume create /mnt/@home

# @log 存放日志，做快照时排除它，避免回滚丢失关键日志
btrfs subvolume create /mnt/@log

# @cache 中储存大多数是 var/cache/pacman/pkg 存放 pacman 下载的包缓存，做快照时排除它，节省空间
btrfs subvolume create /mnt/@cache

# @tmp 存放重启也能保留的临时文件，做快照时排除它，节省空间
btrfs subvolume create /mnt/@cache

# @snapshots 专门存放快照，避免嵌套在 @ 中导致快照混乱
btrfs subvolume create /mnt/@snapshots

umount /mnt

现在按照设计好的布局挂载，特别注意挂载选项 noatime,compress=zstd 对性能和空间非常有益。

⚠️ 警告

如果需要预留给虚拟机用的子卷，记得在参数中关闭 CoW。

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


# 挂载根子卷
mount -o noatime,compress=zstd,subvol=@ /dev/sdX2 /mnt

# 创建并挂载其他目录
mkdir -p /mnt/{efi,home,var/log,var/cache,var/tmp,.snapshots}

# 挂载 EFI 分区
mount /dev/sdX1 /mnt/efi

# 挂载其余子卷
mount -o noatime,compress=zstd,subvol=@home /dev/sdX2 /mnt/home
mount -o noatime,compress=zstd,subvol=@log /dev/sdX2 /mnt/var/log
mount -o noatime,compress=zstd,subvol=@cache /dev/sdX2 /mnt/var/cache
mount -o noatime,compress=zstd,subvol=@tmp /dev/sdX2 /mnt/var/tmp
mount -o noatime,compress=zstd,subvol=@snapshots /dev/sdX2 /mnt/.snapshots

安装基础系统与配置

用 Reflector 设置镜像源：

1

reflector --country China --latest 20 --protocol https --sort rate --save /etc/pacman.d/mirrorlist

如果是 AMD CPU 把 intel-ucode 换成 amd-ucode。

1
2
3
4
5


pacstrap -K /mnt base base-devel linux linux-firmware btrfs-progs neovim \
 networkmanager grub efibootmgr intel-ucode \
 zsh grml-zsh-config zsh-autosuggestions zsh-completions zsh-syntax-highlighting
genfstab -U /mnt >> /mnt/etc/fstab
arch-chroot /mnt

此时将进入硬盘内的系统。

时区与本地化：

1
2


ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
hwclock --systohc

编辑 /etc/locale.gen，找到 en_US.UTF-8 UTF-8 和 zh_CN.UTF-8 UTF-8，取消行首注释。

1
2


locale-gen
echo "LANG=en_US.UTF-8" > /etc/locale.conf

网络与用户：

1
2
3
4
5
6
7
8
9


# 给你的电脑起个名
echo "电脑名" > /etc/hostname

# 设置 root 密码
passwd

# 添加普通用户，我这里指定使用 zsh 作为默认终端
useradd -m -G wheel -s /bin/zsh 用户名
passwd 用户名

赋予 wheel 用户组管理员权限，nvim 换成你用的编辑器名字。

1

EDITOR=nvim visudo

找到 # %wheel ALL=(ALL:ALL) ALL，删掉开头的 #，保存退出。有几行比较像，别找错了。

配置 GRUB ：

如果需要多系统引导，安装 os-prober 并修改 /etc/default/grub，删除下面这行开头的 #：

1

# GRUB_DISABLE_OS_PROBER=false

1
2


grub-install --target=x86_64-efi --efi-directory=/efi --bootloader-id=Arch
grub-mkconfig -o /boot/grub/grub.cfg

系统优化

配置 Zram 。比起传统的硬盘交换空间，Zram 在内存中动态压缩，速度极快。

1

pacman -S zram-generator

创建配置文件 /etc/systemd/zram-generator.conf，内容如下：

1
2
3


[zram0]
zram-size = min(ram / 2, 8192) # 取内存一半或 8 GiB 的较小值
compression-algorithm = zstd

下次重启后会自动生效。

固态硬盘开启 TRIM 定时器 ，机械硬盘请忽略。

1

systemctl enable fstrim.timer

Intel CPU 安装 Thermald ，防止过热降频。

1
2


pacman -S thermald
systemctl enable thermald

笔记本电脑安装 TLP ，节省电量。屏蔽 systemd-rfkill.service 服务和 systemd-rfkill.socket 套接字避免冲突。

1
2
3


pacman -S tlp tlp-rdw
systemctl enable tlp.service
systemctl mask systemd-rfkill.service systemd-rfkill.socket

Pacman 与包管理优化

虽然设置了软件包缓存 @pkg 子卷，但它不会自动清理。用以下命令设置定时自动清理。

1
2


sudo pacman -S pacman-contrib
sudo systemctl enable paccache.timer

还可以用钩子在安装的时候自动清理，详细配置参考 Pacman#清理包缓存。

内核参数微调。减少磁盘写入、提升网络和内存响应。

创建 /etc/sysctl.d/99-custom.conf 添加以下内容：

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


# 减少交换倾向，尽量多用物理内存，和 Zram 配合
vm.swappiness=80

# 在内存压力大时，更激进地使用 Zram
vm.watermark_boost_factor=0
vm.watermark_scale_factor=125

# 网络吞吐量优化
net.core.default_qdisc=fq
net.ipv4.tcp_congestion_control=bbr

# 减少文件系统日志写入，提升性能，尤其是 Btrfs
vm.dirty_ratio=10
vm.dirty_background_ratio=5

（可选） Powertop 主要用来查看哪些设备耗电高，并不会在后台持续修改系统设置。

1

pacman -S powertop

TLP 和 Thermald 可以共存：它们的职责不同。一个主攻省电策略，一个主防 CPU 过热，一起用没有问题。
TLP 和 Powertop 存在冲突风险：它们本身不冲突，但功能会「打架」。

Powertop 有一个 --auto-tune 功能，运行后会立刻将许多内核参数调到最省电状态。如果此时 TLP 也在运行，TLP 会按自己的配置文件把设置改回来，两者会反复覆盖相同的设置，导致行为不可预测。

如果日常使用 TLP，就不要使用 powertop --auto-tune 来自动优化，更不要把它设成开机自启。只把 Powertop 当诊断工具用就好。用 TLP 负责日常的自动化省电，用 Thermald 负责控制温度。 Powertop 只在你需要排查耗电原因时手动运行。

CTRL + D 退出 chroot 环境并重启

1
2


umount -R /mnt
reboot

重启后安装其他软件

配置 Arch Linux CN 仓库和 AUR：

参考清华源帮助在 /etc/pacman.conf 末尾加上

1
2


[archlinuxcn]
Server = https://mirrors.tuna.tsinghua.edu.cn/archlinuxcn/$arch

之后安装 archlinuxcn-keyring 包导入 GPG key。

1

sudo pacman -Sy archlinuxcn-keyring

AUR helper 推荐 paru

1

sudo pacman -Sy paru

平时编译 AUR 包时可以多线程，添加环境变量：MAKEFLAGS="-j$(nproc)"，这样 makepkg 会自动用满所有核心。

显卡驱动（Intel + NVIDIA）。 NVIDIA 已经停止支持我的 MX250 了，因此我安装另一个版本。如果你的 NVIDIA 显卡还在支持范围，直接安装 nvidia。

1
2


paru -S mesa vulkan-intel intel-media-driver libva-utils \
 linux-headers nvidia-580xx-dkms nvidia-prime

以后可以用 prime-run 程序名 来指定用 N 卡运行。 nvidia-580xx-dkms 将以 DKMS 形式安装，需要 linux-headers。

ly：比较简单的登录管理器，也可以用 sddm 等好看的代替
niri：可滚动平铺的 Wayland 合成器
- swaybg：壁纸工具，不止用于 Sway
- xwayland-satellite：在 XWayland 运行 X11 程序
- xdg-desktop-portal-gtk：XDG 桌面后端（应该可以随着安装依赖直接装上）
- xdg-desktop-portal-gnome：Niri 用它截屏（应该也可以跟着安装依赖装上）
noctalia-shell：完整的桌面 shell，代替 waybar、fuzzel、mako 等
- cliphist：剪切板
- wlsunset：夜间模式支持
- python-pywalfox：给 Firefox 提供主题同步
foot：比较简单的 Wayland 终端模拟器，也可以用 kitty 等
Yazi：终端文件管理器，更习惯 GUI 可以用 dolphin 等
- fd：文件搜索
- resvg：SVG 预览
- 7zip：压缩包支持
fcitx5-rime 和 rime-ice-pinyin-git：雾凇拼音，基于 Rime 输入法，Fcitx5 框架
- fcitx5-nord：一个主题
npm：lazyvim 的部分插件需要
ntfs-3g：用于支持 NTFS 文件系统
terminus-font：终端字体，在没加载图形界面时可用，如运行 setfont ter-132b
noto-fonts-cjk：Noto 中文字体
noto-fonts-emoji：Noto emoji 字体
man-db 和 man-pages-zh_cn：系统帮助文档
tree：查看文件夹的树形结构的终端小工具
pipewire-audio、pipewire-alsa、pipewire-pulse：多媒体框架，如果没声音就装上
firefox firefox-i18n-zh-cn：火狐和中文包
chromium：~~咕鸽浏览器~~
loupe：比较简单的图片查看器
gthumb：功能多点的图片查看器
mpv：音视频播放器
wps-office-cn：WPS 个人版
- wps-office-mime-cn：MIME 格式支持
- wps-office-mui-zh-cn：中文语言包
github-cli：Github 的命令行界面客户端，浏览器打不开 Github 时可以作为备选方案。

安装时说不定会遇到几个选择，以下几个是我的推荐，其它的可以自行决定：

jack 后端：选择 jack2
pipewire 后端：选择 wireplumber
终端字体：我觉得 noto-fonts 好看
nerd 字体：个人选择 ttf-nerd-fonts-symbols

系统配置

字体

添加单独的字体文件，要复制到 ~/.local/share/fonts 里，然后运行命令 fc-cache 增量更新字体缓存。也可 fc-cache -fv 强制重新生成所有缓存并显示过程。更多内容见字体

用户的全局字体设置在 /.config/fontconfig/fonts.conf，比如指定默认的无衬线体（sans-serif）、衬线体（serif）、等宽字体（monospace）。更多内容见 Fontconfig 配置

环境变量

系统级别的全局环境变量一般配置在 /etc/environment 就行。 /etc/profile 和 /etc/profile.d/ 的作用如有需要自行学习。各 shell 自己的全局环境变量见各自的配置，如 Bash 配置文件和 Zsh 启动/关闭文件。

systemd 的用户环境变量在 ~/.config/environment.d/*.conf。更详细的可参考 systemd 环境变量。

详细内容见 ArchWiki 中环境变量。

Foot 配置

/etc/locale.conf 的 LANG=en_US.UTF-8 可能会覆盖 ~/.config/environment.d/ 中语言的环境变量，导致 man 不是中文。可以在 ~/.config/foot/foot.ini 配置 [environment]。

除此之外，字体类似这么写：

1

font=Maple Mono NF CN:size=12, Noto Color Emoji:size=12

Zsh 配置

安装了 grml-zsh-config 之后会自动加载它的配置。 zsh 自带的初始化步骤挺好的，虽然是全英文，但是可以找 AI 帮忙翻译并出出主意。我的配置文件如下（补全功能还没捣鼓 Zsh 自带的高级配置，回头再搞）：

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


# Lines configured by zsh-newuser-install
HISTFILE=~/.zsh_history
HISTSIZE=1000
SAVEHIST=1000
setopt autocd extendedglob nomatch notify
unsetopt beep
bindkey -v
# End of lines configured by zsh-newuser-install
# The following lines were added by compinstall
zstyle :compinstall filename '/home/nacl/.zshrc'

autoload -Uz compinit
compinit
# End of lines added by compinstall

source /usr/share/zsh/plugins/zsh-autosuggestions/zsh-autosuggestions.zsh
source /usr/share/zsh/plugins/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh

autoload -Uz promptinit
promptinit
prompt grml

Yazi 配置

添加 git 和 vcs-file 两个插件：

1
2


ya pkg add yazi-rs/plugins:git
ya pkg add yazi-rs/plugins:vcs-files

倘若 Yazi 无法打开 WPS 文档、无法默认调用想要的软件打开图片。需要添加格式关联，在 ~/.config/yazi/yazi.toml 写入 opener 和 open 的 rules即可。这是我根据官方的默认配置写的：

 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


[opener]
loupe = [
 { run = "loupe %s", desc = "Open with Loupe", orphan = true, for = "unix" },
]
wps-office = [
 { run = "env QT_FONT_DPI=128 wps %s", desc = "WPS", orphan = true },
]
[open]
rules = [
	# 根据文件名匹配：匹配所有 .doc, .docx, .xls, .xlsx, .ppt, .pptx 文件
	{ url = "*.{doc,docx,xls,xlsx,ppt,pptx}", use = "wps-office" },
	# Folder
	{ url = "*/", use = [ "edit", "open", "reveal" ] },
	# Text
	{ mime = "text/*", use = [ "edit", "reveal" ] },
	# Image
	{ mime = "image/*", use = [ "loupe", "open", "reveal" ] },
	# Media
	{ mime = "{audio,video}/*", use = [ "play", "reveal" ] },
	# Code
	{ mime = "application/{json,ndjson,javascript,wine-extension-ini}", use = [ "edit", "reveal" ] },
	# Archive
	{ mime = "application/{zip,rar,7z*,tar,gzip,xz,zstd,bzip*,lzma,compress,archive,cpio,arj,xar,ms-cab*}", use = [ "extract", "reveal" ] },
	# Empty file
	{ mime = "inode/empty", use = [ "edit", "reveal" ] },
	# Virtual file system
	{ mime = "vfs/{absent,stale}", use = "download" },
	# Fallback
	{ url = "*", use = [ "open", "reveal" ] },
]

GRUB 中文

如果想让 GRUB 的菜单什么的也设为中文，可以重新生成一下。

1

grub-mkconfig -o /boot/grub/grub.cfg

困难备注

WPS

WPS 的整合版本体、表格或演示无法用启动器打开，可能是本体设为了整合版+系统没……怎么说呢……没联系起来（？）导致的。先开一次 WPS，比如命令行直接运行 wps，然后随便开一个文档，新建也行，会弹出设为默认软件的选项。此时点同意，就会在 .config/mimeapps.conf 添加格式的关联。

博客备忘

Sun, 14 Jul 2024 23:00:00 +0800

格式约定

正文

由于 Markdown 中单独一个换行符不会作为段落分隔的标志，每句话单独一行我觉得不错，所以我会尽量这样组织 .md 文件。（只要没忘了

中西文混排

为了阅读体验，在中西文混排时，单词与汉字之间添加间隔。若单词前后是标点符号，因标点符号已经起到间隔作用，故不需添加。

当单词或字母扮演着汉字字词的角色，例如「把这张图片P好了」，不添加间隔也可以接受，但整体上应保持风格一致。

我尚未学会如何通过 css 或其他代码方案，在中西文间添加间隔，故行文时手动添加空格作为折衷方案。

标点符号

参考标点符号用法，但引号使用直角引号，如：「吸血鬼讨厌大蒜，因为他们喜欢『不辣的』」。转载引用时，若原文不太规范，但希望保留原文格式时，可能不进行修改。

标题以竖线分隔类别时左右添加间隔，如「东方 | 钱包空空的博丽灵梦」。

Markdown

超链接单独占一行。一方面便于 Markdown 中单独修改；另一方面，换行时会插入软换行符，在生成时会按西文板式自动添加空格，阅读体验较好。

1
2
3


点击
[此处](https://www.baidu.com/)
跳转百度

站内的超链接也可以用 永久链接 [Link A]({{% ref "/books/book-1" %}})。和 相对永久链接 [Link A]({{% relref "/books/book-1" %}}) 。由于会在编译时检测，当站内跳转的 URL 不存在时会报错，起到检查的作用。官网文档说它们需要用 {{% %}} 格式。

当引用块和列表嵌套时，列表行之间空不空行是不同的。

不加空行：列表项紧凑，行间距小，像条目清单

1
2


> * 第一行
> * 第二行

会生成一个 <ul> 列表，每个 <li> 之间没有额外的间距。这是最常见的写法，适合普通引用列表。

加空行：列表项松散，条目之间有明显空隙，更像几个要点的分段描述

1
2
3


> * 第一行
>
> * 第二行

CommonMark 规定，列表中如果有一个列表项之间有空行隔开，这个列表就变成「松散列表」（loose list）。每个 <li> 的内容会被包裹在 <p> 标签里，从而产生额外的段落间距。

front matter

书写 toml 格式的 front matter 时，优先写单引号。如 title = '博客备忘'

各 front matter 没有什么书写的先后顺序，但为了格式统一，我在自己的博客这么约定：

标题：title
描述：summary 和 description
时间：date 和 lastmod
分类：categories 和 tags
URL 一类的：slug、externalUrl 之类的
其他，自行安排

分类、标签等关键词的顺序：

有层次关系的关键词，先写大类，如：植物、绿萝。
先写主干关键词，再写附加关键词，如记录熨衣服的文章：生活、笔记。

html

格式规范参考前端 HTML-CSS 规范、 HTML(5) 代码规范。嵌入 html 时，自闭合元素的尾部不添加斜线。如空行，写作 <br> 而不是 <br />。

功能备忘

Markdown Alert

📝 备注

突出显示用户应考虑的信息，即便是粗略浏览时。

📝 自定义标题

您还可以为笔记警告提供自定义标题。

💡 提示

帮助用户更成功的可选信息。

📌 重要

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

⚠️ 警告

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

🚨 注意

操作的潜在负面后果。

emoji

如 👋 写作：:wave:。参考 Emojis 。

附一个 emoji 代码查询网站 webfx ，一个直接复制 emoji 的网站 emoji 大全。

脚注

芝士就是力量
— 法国就是培根¹

1
2


> 芝士就是力量<br>
> — <cite>法国就是培根[^quote]</cite>

Here’s a simple footnote,² and here’s a longer one.³

1
2
3
4
5
6
7


Here's a simple footnote,[^1] and here's a longer one.[^bignote]

 Indent paragraphs to include them in the footnote.

 `{ my code }`

 Add as many paragraphs as you like.

插入 gif

Hugo 不支持以 Markdown 插入图片的格式插入 gif，但 Markdown 渲染基于 html，可利用 html 插入图片的方式：

1

<img src="路径">

图标 & 矢量图

一些资源网站： tabler 、 favicon 、 fontawesome

对于 SVG 矢量图，fill="currentColor" 能跟随深色主题反色。语法参考 SVG 基本语法

Stack front matter

description string 单页和列表页

页面的描述。

image string 单页和列表页

页面的特色图片。

comments bool 单页

显示或隐藏页面的评论部分。

license string|bool 单页

页面的许可证。如果设置为 false，许可证部分将被隐藏。默认值：.Site.Params.article.license.default

math bool 单页

启用或禁用 KaTeX 渲染。

toc bool 单页

显示或隐藏页面的目录。仅在页面至少包含一个标题时才会显示。默认值：.Site.Params.article.toc

style map[string]string 列表页

出现在文章页面中的分类术语徽章的附加 CSS 样式。

目前仅支持 background（徽章背景）和 color（文字颜色）。

keywords []string

页面的关键词。对 SEO 很有用。

readingTime bool

显示或隐藏页面的阅读时间。默认值：.Site.Params.article.readingTime

从列表中隐藏页面

1
2


[build]
 list = "always" # Change to "never" to hide the page from the list

配置文件

根目录的 /hugo.toml，Hugo 先加载此文件，后加载 config 文件夹的配置，冲突项会被后者覆盖。

1

hasCJKLanguage = true # Hugo 的功能，采用 CJK 方案估算阅读时长

1
2
3
4
5
6
7


# config/_default/markup.toml
[goldmark]
[goldmark.extensions.cjk]
 enable = true #1
 eastAsianLineBreaks = false #2
 eastAsianLineBreaksStyle = 'css3draft' #3
 escapedSpace = true #4

为 Markdown 渲染引擎 Goldmark 启用 CJK 板式。见 Hugo 官网配置文档和 goldmark 仓库关于 CJK extension 的文档
亚洲书写习惯中，软换行不自动添加空格。我不启用该功能，因为我正文没有软换行的需求，无需避免该问题，且配合我自己的某些书写习惯，如插入超链接，便于渲染排版。
Goldmark 针对 CJK 换行有两种风格，Hugo 默认采用 simple，我采用更复杂的 css3draft。
设置粗体时遇到标点符号会格式异常，可利用斜杠+空格分隔区域：所谓「实践出真知」就是如此，写为 所谓\ **「实践出真知」**\ 就是如此。不过如果只是为了强调引号内的文字，不需要加粗引号本身。

Hugo

hugo new posts/test/index.md：根据 archetypes 文件夹中的模板创建文件

Hugo 代码高亮 shortcode 官网文档

点击查看，小心剧透

你知道的太多了

1
2
3


{{< details summary="点击查看，小心剧透" >}}
你知道的太多了
{{< /details >}}

使用 Stack 主题的 shortcode 嵌入 B 站视频：

1

{{< bilibili VIDEO_ID PART_NUMBER >}}

方括号里是脚注，不论写什么内容，渲染时都会依序显示为序号 ↩︎
This is the first footnote. ↩︎
Here’s one with multiple paragraphs and code.

Indent paragraphs to include them in the footnote.

{ my code }

Add as many paragraphs as you like. ↩︎

在 Hugo 博客中嵌入 B 站视频

Tue, 06 Feb 2024 21:50:24 +0800

📝 备注

如今所用的 Stack 主题终于已经支持了 bilibili shortcode，本记录留作纪念吧~

参数

顺序	参数	含义
1	`id`	视频 BV 号，如：`BV1aM4y1R77W`
2	`sec`	精准空降秒数，如：`50`、`125`
3	`auto`	默认不自动播放：`false` 或 `0`，自动播放：`true` 或 `1`
4	`muted`	默认不静音：`false` 或 `0` ，静音：`true` 或 `1`
5	`danmaku`	默认加载弹幕：`true` 或 `1`，禁用弹幕：`false` 或 `0`

语法举例

按位置传参

1
2


< bili BV1DV4y157RD >
< bili BV1bY411b7k9 244 true true true >

按参数名传参

1
2
3
4
5
6


< bili id=BV1Yv4y1o7dw auto=true >

折行写也行
< bili id=BV1fY4y1F7GL
 sec=61 auto=false
 muted=false danmaku=true >

代码

创建 /layout/shortcodes/bili.html，文件名字即 shortcode 调用时的名字。

输入以下内容：

 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


<!-- 语法规则举例说明
 1. 按位置传参
 < bili BV1DV4y157RD >
 < bili BV1bY411b7k9 244 true true true >
 2. 按参数名传参
 < bili id=BV1Yv4y1o7dw auto=true >
 折行写也行
 < bili id=BV1fY4y1F7GL 
 sec=61 auto=false 
 muted=false danmaku=true >
-->

<!-- 接收参数 -->
{{ $id := (.Get "id") | default (.Get 0) }}
{{ $sec := (.Get "sec") | default (.Get 1) }}
{{ $auto := (.Get "auto") | default (.Get 2) }}
{{ $muted := (.Get "muted") | default (.Get 3) }}

<!-- 不能用 default，因为传入 false 或 0 后会被忽略 -->
{{ $danmaku := (.Get 4) }}
{{ if .IsNamedParams }}
 {{ $danmaku = (.Get "danmaku") }}
{{ end }}

<!-- BV 号 -->
{{ $params := slice "bvid" $id }}

<!-- 给定精准空降秒数 -->
{{ if gt $sec 0 }}
 {{ $params = $params | append "t" $sec }}
{{ end }}

<!-- 禁止自动播放，除非传入 true 或 1 -->
{{ if ne $auto true 1 }}
 {{ $params = $params | append "autoplay" "false" }}
{{ end }}

<!-- 传入 true 或 1 时静音 -->
{{ if $muted | in (slice true 1) }}
 {{ $params = $params | append "muted" "true" }}
{{ end }}

<!-- 传入 false 或 0 时不加载弹幕 -->
{{ if $danmaku | in (slice false 0) }}
 {{ $params = $params | append "danmaku" "false" }}
{{ end }}

<!-- 嵌入 bilibili 播放框，百分比参数可自定义 -->
<div style="margin: 10px 0 20px 0;">
 <div style="position:relative; padding-bottom:75%; width:100%; height:0">
 <iframe src="//player.bilibili.com/player.html?{{ (querify $params) | safeURL }}"
 scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"
 style="position:absolute; height: 100%; width: 100%;">
 </iframe>
 </div>
</div>

注意

鉴于当前 B 站以 BV 视频号取代旧视频号形式，我估计本代码不兼容远古视频。

若想兼容，链接的 bvid 部分，需把参数名中 b 改成 a。（防止本博客带有敏感信息，我不打出来了）。

代码优化思路：根据传入的视频 id 开头是 B 还是 A 来单独处理。也可提取视频 id 开头字母存入变量，直接作为参数传入链接进行拼接。

参考

Linux 下制作 U 盘安装镜像

Mon, 05 Feb 2024 16:18:10 +0800

💡 提示

ArchWiki 有一篇页面， USB flash installation medium ，详细讨论了用 U 盘制作 Arch Linux 安装盘的各种方法，涵盖多平台和多种途径，推荐一阅。

目前最好用的应该算是 Ventoy，推荐这个。这个不算是烧录，是用自带的引导系统进入存在 U 盘的镜像，比较省事。

Windows 系统烧录 U 盘镜像建议使用 Rufus。

KDE 桌面环境烧录 U 盘镜像可使用 isoimagewriter。

查看 U 盘的设备信息

首先使用 lsblk 查看 U 盘的设备信息。

例如返回的结果可能类似这样：

1
2
3
4
5
6


NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS
sda 8:0 0 476.9G 0 disk
├─sda1 8:1 0 512M 0 part /boot
├─sda2 8:2 0 8G 0 part [SWAP]
└─sda3 8:3 0 468.4G 0 part /
sdb 8:16 1 7.4G 0 disk

当前尚未挂载 U 盘，因此 MOUNTPOINTS 处没有显示挂载位置。
我的 U 盘大小为 8 GiB，因此我推断出，此时 U 盘的「名字」是 /dev/sdb。
- （方法虽然不太「优雅」，但是好用）

烧录 U 盘

假设镜像文件路径为：~/archlinux-2024.02.01-x86_64.iso

将镜像烧录到 U 盘：

1

cp ~/archlinux-2024.02.01-x86_64.iso /dev/sdb

Python 生成高强度密码

Sun, 03 Dec 2023 17:18:53 +0800

选择更安全的密码可以帮你看出怎样的密码是个好密码，不过有些平台可用 两步验证（2FA） 代替密码更安全。

secrets 模块

例如，生成长度为八个字符的字母数字密码：

1
2
3
4


import string
import secrets
alphabet = string.ascii_letters + string.digits
password = ''.join(secrets.choice(alphabet) for i in range(8))

例如，生成长度为十个字符的字母数字密码，包含至少一个小写字母，至少一个大写字母以及至少三个数字：

1
2
3
4
5
6
7
8
9


import string
import secrets
alphabet = string.ascii_letters + string.digits
while True:
 password = ''.join(secrets.choice(alphabet) for i in range(10))
 if (any(c.islower() for c in password)
 and any(c.isupper() for c in password)
 and sum(c.isdigit() for c in password) >= 3):
 break

加入特殊字符

string 模块提供一些预设字符串常量，如：

string.punctuation：!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~

但是有些网站无法使用所有的标点符号，那么这里可以自定义为：

?!@#$%^&*_-+=[]<>;:,.

自用代码

以下代码应该不用注释你也能看懂，中文的信息密度值得信赖。

 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


import secrets
import string

字母数字 = string.digits + string.ascii_letters
字符 = 字母数字 + r"?!@#$%^&*_-+=[]<>;:,."
字符plus = 字母数字 + string.punctuation


def main(): # 哪个好看选哪个
 # print(生成密码(字符))
 # print(生成密码(字符))
 # print(生成密码(字符))
 print(生成密码())
 print(生成密码())
 print(生成密码())


def 抽取(字符池, 长度):
 密码 = "".join(secrets.choice(字符池) for i in range(长度))
 return 密码


def 检查(密码, 字符池, 数量):
 if sum(c in 字符池 for c in 密码) >= 数量:
 return True
 else:
 return False


def 生成密码(字符池=字符plus, 长度=12, 数字数=1, 小写数=1, 大写数=1, 特殊字符数=1):
 while True:
 密码 = 抽取(字符池, 长度)
 if (
 检查(密码, string.digits, 数字数)
 and 检查(密码, string.ascii_lowercase, 小写数)
 and 检查(密码, string.ascii_uppercase, 大写数)
 and 检查(密码, string.punctuation, 特殊字符数)
 ):
 break
 return 密码


if __name__ == "__main__":
 main()