博客备忘 · 月遇从云

格式约定
#

空白行

写作 <br> 而不是 <br /> 或 <BR>。

超链接

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

个性化 css，见
[进阶自定义](https://blowfish.page/zh-cn/docs/advanced-customisation/)
一文。

效果如下：

个性化 css，见进阶自定义一文。

中西文混排

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

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

尚未学会如何通过自定义 css 实现上述目的，故行文时手动添加空格作为折衷方案。

功能备忘
#

嵌入 B 站视频
#

见在 hugo 博客中嵌入 B 站视频。

{{< bili BV1Kj411g7Lu >}}
{{< bili id=BV1aM4y1R77W sec=61 auto=false danmaku=false >}}

代码高亮
#

见 Highlight 。

自定义行内高亮的简码 a = 5 用法：{{< hl python >}}a = 5{{< /hl >}}。

高级效果如下：

1package main
2
3import "fmt"
4
5func main() {
6    for i := 0; i < 3; i++ {
7        fmt.Println("Value of i:", i)
8    }
9}

markdown
#

~删除~ <del>删除</del> <s>删除</s>

<abbr title="注释内容">光标悬浮在此并停留几秒</abbr>

字<sub>下标</sub><sup>上标</sup>

<kbd>键盘按钮</kbd>

<mark>记号笔效果</mark>

效果如下：

删除删除删除

光标悬浮在此并停留几秒

字_下标^上标

键盘按钮

记号笔效果

emoji
#

👋 :wave:

参见 emoji - blowfish 、 Emojis - Hugo ，一个比较好用的emoji 查询网站 emoji-cheat-sheet - WebFX

脚注
#

<cite>「阿波卡利斯如是说」[^此处是脚注，会依序显示为数字]</cite>
[^此处是脚注，会依序显示为数字]: [《崩坏3》动画短片「阿波卡利斯如是说」](https://www.bilibili.com/video/BV1bY411b7k9)
，2022-01-21。

效果如下（点击角标可跳转至文末注释）：

「阿波卡利斯如是说」¹

插入 gif
#

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

<img src="路径">

矢量图
#

反色

从 fontawesome 下载的矢量图在 blowfish 深色模式下无法反色，而 blowfish 内置的矢量图可以。

我发现可以反色的 svg 文件用文本编辑器打开后，靠近开头的 <path /> 中多了 fill="currentColor" ，如以下内容所示：

<path fill="currentColor" d="..."/>

将自己下载的 svg 对应修改即可。

换色

把 fill 的值改成 RGB 格式能改颜色，指定 height 和 width 能表示尺寸。例如「2xl尺寸的蓝色圆角方块」：

文本内容如下：

<svg xmlns="http://www.w3.org/2000/svg" height="32" width="28" viewBox="0 0 448 512"><!--!Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2024 Fonticons, Inc.--><path fill="#74C0FC" d="M0 96C0 60.7 28.7 32 64 32H384c35.3 0 64 28.7 64 64V416c0 35.3-28.7 64-64 64H64c-35.3 0-64-28.7-64-64V96z"/></svg>

配置文件
#

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

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

/config/_default/markup.toml

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

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