对于我来说，答案很简单：拥有一个完全属于自己的数字花园。 在这里，我拥有对内容的 100% 控制权，没有算法推荐的裹挟，没有格式排版的限制，更重要的是，博客本身的设计、架构、自动化脚本的演进过程，就是一个极佳的程序员技术沙盒。

今天，我想把这个博客从搭建、优化、重构至今的完整历程和技术选型细节记录下来。

一、 核心技术栈：为什么选择 Hugo Extended

在建站之初，我对比了 Hexo、Gatsby、Astro 以及 Hugo。最终我选择了 Hugo Extended。

• 速度的绝对降维打击：Hugo 是用 Go 编写的，构建速度往往以毫秒计。对于一个需要频繁预览和调整的个人博客来说，保存即渲染的即时反馈体验极为畅快。
• SCSS 的原生处理能力：由于我选用了功能非常丰富的 DoIt 主题，它需要动态处理大量的样式表。Hugo 的 Extended 版本 内置了对 SCSS 和编译管道的支持，我可以非常轻松地在 assets/css/_override.scss 中覆盖主题变量（例如我将全站的非代码字体覆盖为了 LXGW Bright 霞鹜文楷，而无需修改主题子模块的代码）。

二、 博客整体运行架构示意图

为了让大家有一个直观的宏观认识，我将整个博客的“本地写作、本地脚本安检、代码托管、云端 CI/CD 构建、CDN 分发及图床/评论闭环”的工作流，绘制成如下拓扑图。本博客主题原生支持 Mermaid，无需任何多余配置即可直接渲染：

graph TD
    subgraph Local ["1. 本地写作与开发 - WSL / Windows"]
        A["Zed 编辑器"] -->|"1. 新建并编写博文"| B("Markdown 源文件")
        B -->|"2. 本地热预览"| C["Hugo 本地 Server"]
        C -->|"3. 浏览器实时调试 localhost:1313"| D(("本地预览"))
    end

    subgraph Deploy ["2. 自动化部署 - 双端脚本"]
        B -->|"4. 一键部署指令 deploy.sh / deploy.ps1"| E{"五重安全雷达检测"}
        E -->|"未拉取主题"| F["自愈子模块"]
        E -->|"落后远程"| G["拦截并提示 git pull"]
        E -->|"草稿检测"| H["显示 draft: true 列表并警告"]
        E -->|"检测通过"| I["暂存并生成本地 Backup 提交"]
        I -->|"5. 安全推送 Git Push"| J["GitHub 源码私有仓库"]
    end

    subgraph Cloud ["3. 云端构建与 CDN 分发"]
        J -->|"6. Webhook 自动触发"| K["Cloudflare Pages 构建管道"]
        K -->|"7. 拉取子模块并运行 Hugo Build"| L["全量静态 HTML/CSS/JS"]
        L -->|"8. 部署至全球边缘网络"| M["Cloudflare CDN 边缘节点"]
    end

    subgraph User ["4. 读者端访问与交互"]
        N(("读者浏览器")) -->|"9. 访问你的域名"| M
        N -->|"10. 匿名请求无 Referrer 图片"| O["Cloudflare Workers 图床"]
        N -->|"11. 读写文章评论"| P["Utterances 评论 / GitHub Issues"]
    end

三、 博客基建的三个“痛点”与折腾方案

独立博客好看不好用，往往是因为“图片难存、双语难翻、评论难搭”。为了解决这三个痛点，我逐步搭建了属于自己的解决方案。

1. 干净的双语文章管理：从后缀制到目录制

我的博客是一套中英文双语系统（中文默认，英文为辅）。

最初，我使用的是 Hugo 默认的“文件名后缀模式”：

content/posts/my-post.md     # 中文文章
content/posts/my-post.en.md  # 英文文章

当文章数量少时还好，一旦变多，两类语言的文件就会在同一个文件夹下乱成一团，且编辑器的侧边栏看起来杂乱无章。

为了彻底重构为 “基于目录的多语言管理模式” (Content Directory Multilingual)，我把中英文文章物理隔离到独立的语言目录下：

• 将中文文章全部隔离到 content/zh/posts/
• 将英文文章全部隔离到 content/en/posts/

并在 hugo.toml 中做了如下的完整映射配置（已脱敏）：

# hugo.toml
defaultContentLanguage = "zh-cn"

[languages]
  [languages.zh-cn]
    contentDir = "content/zh"  # 中文内容源目录
    weight = 1
    title = "我的个人博客"
    locale = "zh-CN"
    label = "简体中文"
    hasCJKLanguage = true       # 开启中日韩字数精确统计

  [languages.en]
    contentDir = "content/en"  # 英文内容源目录
    weight = 2
    title = "My Blog"
    locale = "en"
    label = "English"
    hasCJKLanguage = false

现在，中英文文章的文件名完全相同（比如都叫 my-post.md），Hugo 会自动通过同名相对路径在渲染时把它们关联为互为翻译。我的工作区瞬间变得极度清爽！

2. 图片图床：自建 Cloudflare Workers 防 403

为了随处写作且保证图片能在全球范围内高速、稳定地访问，我没有选择把图片存在博客 Git 仓库里（会拖慢 clone 速度），而是使用了自建的 blog-images.your-domain.workers.dev（基于 Cloudflare Workers 代理的对象存储图床）。

防盗链与本地预览 403 问题的终极解决方案： 由于很多第三方图床会识别 Referer。当你在本地 http://localhost:1313 预览时，浏览器发送的本地 Referer 会导致图床直接返回 403 Forbidden。

我们可以通过重写 Hugo 的 Markdown 图片渲染器，强制图片在加载时不发送 Referer。在项目根目录下新建 layouts/_markup/render-image.html：

<!-- layouts/_markup/render-image.html -->
{{- $lightgallery := .Page.Params.lightgallery | default site.Params.Page.lightgallery | default false -}}
{{- $destination := replaceRE "^/static" "" .Destination -}}

{{- if .Title -}}
<figure>
    {{- if $lightgallery -}}
    <a class="lightgallery" href="{{ $destination }}" title="{{ .Text }}" data-thumbnail="{{ $destination }}" data-sub-html="<h2>{{ .Title }}</h2>">
    {{- end -}}
    <!-- 关键点：注入 referrerpolicy="no-referrer" -->
    <img loading="lazy" referrerpolicy="no-referrer" src="{{ $destination }}" alt="{{ .Text }}">
    {{- if $lightgallery -}}
    </a>
    {{- end -}}
    <figcaption class="image-caption">{{ .Title | safeHTML }}</figcaption>
</figure>
{{- else -}}
<!-- 关键点：注入 referrerpolicy="no-referrer" -->
<img class="tw:inline" loading="lazy" referrerpolicy="no-referrer" src="{{ $destination }}" alt="{{ .Text }}">
{{- end -}}

这一行小小的 HTML 属性 referrerpolicy="no-referrer"，完美根治了本地预览图床图片报 403 的顽疾！

3. 自定义样式变量覆盖

如果你用的是 Git 子模块安装的主题，直接改主题里的 CSS 会导致升级困难。最好的做法是在项目级重写样式。在 assets/css/_override.scss 中覆盖全局字体（以引入霞鹜文楷字体为例）：

/* assets/css/_override.scss */
@font-face {
    font-family: 'LXGW Bright';
    src: url('/fonts/LXGWBright.woff2') format('woff2');
    font-weight: normal;
    font-style: normal;
    font-display: swap;
}

:root {
    /* 覆盖 DoIt 主题内置的全局字体变量 */
    --global-font-family: 'LXGW Bright', -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
}

4. 评论系统：优雅且免维护的 Utterances

我不希望引入多余的第三方臃肿评论脚本，更不希望为此去维护一个后端的数据库。因此，我选用了基于 GitHub Issues 的 Utterances。 其在 hugo.toml 中的配置非常轻量：

# hugo.toml
[params.page.comment]
  enable = true
  [params.page.comment.utterances]
    enable = true
    repo = "your-github-username/your-blog-comments-repo" # 绑定的公共 GitHub 仓库
    issueTerm = "title"                                    # 用博文标题作为 issue 的匹配项
    label = "comments"                                     # 自动打上 comments 标签
    lightTheme = "github-light"
    darkTheme = "github-dark"

不仅加载速度极快，而且非常契合技术博客的格调。

四、 DevOps 自动化部署：双端脚本护航

如果每一次写完文章，都需要手动去清理缓存、全量构建、暂存提交、然后安全推送，写博客的积极性很快就会被这些重复机械的劳动磨灭。

为此，我编写了两套功能对齐的部署脚本（Linux/WSL 下的 ./deploy.sh 与 Windows 下的 deploy.ps1）。以下是脚本中最核心、最有技术含量的三大防护模块的脱敏代码实现：

1. 智能 Git 冲突防御（拦截未拉取代码直接 Push）

脚本会在执行部署前拉取远程状态，比对本地与远程的提交差异。如果发现本地落后，立即强行终止，防御代码被强制覆盖的悲剧：

# deploy.sh 片段
local remote_ref=$(git rev-parse --abbrev-ref --symbolic-full-name '@{u}' 2>/dev/null || echo "")
if [ -n "$remote_ref" ]; then
    echo "拉取远程仓库状态 (git fetch)..."
    git fetch --quiet 2>/dev/null
    
    # 统计本地落后于远程的 commit 数量
    local behind_commits=$(git rev-list --count HEAD.."$remote_ref" 2>/dev/null || echo "0")
    if [ "$behind_commits" -gt 0 ]; then
        echo "❌ 部署被拦截：本地分支落后远程分支 $behind_commits 个提交！"
        echo "请先执行 git pull，解决可能存在的冲突后再尝试部署。"
        exit 1
    fi
fi

2. 自动化草稿（Draft）检测雷达

利用 Hugo 内置指令列出所有带有 draft: true 的文件并优雅高亮，避免你把半成品文章不小心发到线上：

# deploy.sh 片段
check_drafts() {
    if command -v hugo &> /dev/null; then
        # hugo list drafts 会输出草稿列表，用 tail 剥离掉首行表头
        local drafts=$(hugo list drafts 2>/dev/null | tail -n +2 || true)
        if [ -n "$drafts" ]; then
            echo "═══════════════════════════════════════"
            echo " 📝 提醒：以下文章当前仍为草稿 (draft: true)"
            echo " 它们不会被部署到线上版本："
            echo "$drafts" | while read -r line; do
                local filename=$(echo "$line" | cut -d',' -f1)
                local title=$(echo "$line" | cut -d',' -f2)
                echo "   - $filename ($title)"
            done
            echo "═══════════════════════════════════════"
        fi
    fi
}

3. TTY 交互式终端感知

当在常规终端里双击或运行时，它会等待用户敲击键盘确认；若被 VS Code Task、后台定时器或 CI/CD pipeline 自动触发，它能自动感知并直接跳过阻碍性的 TTY 确认，防止任务永久挂起死锁：

# deploy.sh 片段
if [ "$confirm" = true ]; then
    # [ -t 0 ] 用来判断标准输入是否来源于真实的交互式终端
    if [ -t 0 ]; then
        read -p "是否继续部署? [y/N] " -n 1 -r
        echo
        if [[ ! $REPLY =~ ^[Yy]$ ]]; then
            echo "❌ 已取消部署"
            exit 0
        fi
    else
        echo "ℹ 检测到非交互式环境，自动跳过人工确认步骤"
    fi
fi

四、 托管平台与云端渲染

博客的源文件被推送到 GitHub 后，会由 Cloudflare Pages 自动接管。

• 它的构建容器会自动检测博客的更新，全自动下载 Hugo 依赖并拉取子模块。
• 重新编译后，把静态文件全球分发。静态文件不需要我推送到第二个仓库，我的 Git 源码仓库就是唯一的真理来源（Source of Truth）。

总结

一个看似简单的博客，其背后蕴含着多语言架构设计、CDN 图床缓存、Git 子模块管理、双系统 shell/PowerShell 脚本编写、无服务器计算 (Serverless Workers) 以及 CI/CD 管道构建等一系列工程实践。

生命不息，折腾不止。这个博客就是我最好的代码试验田，希望未来的日子里，它能记录下我更多、更有价值的思考与探索。

SSH（Secure Shell，安全外壳协议），是一套加密的远程登录协议，标准端口：22。 简单理解：安全地远程连接另一台计算机 / 服务器。

可以使用 SSH（安全外壳协议）在 GitHub 上的存储库中访问和写入数据。 通过 SSH 进行连接时，使用本地计算机上的私钥文件进行身份验证。

SSH 认证：解决「你能不能连上 GitHub、推送代码」（通道权限）

提交签名（SSH 签名 / GPG 签名）：解决「这条 commit 到底是不是你写的」（内容真伪）

两者完全独立、互不替代。

SSH 密钥用于 GitHub 连接认证

作用场景

当你使用 git@github.com:xxx/xxx.git（SSH 协议地址）进行 clone/pull/push,

• 使用 SSH 公私钥完成传输层身份校验
• 替代 HTTPS 方式输入账号密码 / Personal Access Token
• 全程通信流量加密

工作原理

• 本地保存私钥（保密），GitHub 账户保存你的公钥；
• 发起 SSH 连接时，服务器发起加密挑战；
• 本地私钥应答；GitHub 使用公钥验证通过 → 允许访问仓库。

关键特点

• 只在建立网络连接那一刻生效；
• 完全不保护 commit 本身；
• 无法防止提交伪造：任何人本地修改 git config user.name / user.email，就可以伪装成你提交代码并 push 到仓库。
• 举例：别人电脑上设置你的名字邮箱，通过他自己的 SSH 密钥推送，GitHub 只会显示提交人是你，无法识别伪造。

简易配置命令

# 生成ed25519密钥（推荐，优于RSA）
ssh-keygen -t ed25519 -C "你的github注册邮箱"
# 启动agent
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
# 复制公钥
cat ~/.ssh/id_ed25519.pub
GitHub 设置 → SSH and GPG keys → New SSH key
Key type 选择：Authentication Key（身份验证密钥）
测试连通：
bash
ssh -T git@github.com

Git 提交签名

核心目标

给每一条 commit/tag 数据本身打上数字签名

• 证明：这条提交由持有私钥的本人创建；
• 证明：提交内容生成后没有被篡改；
• GitHub 校验成功，展示绿色 Verified 标识。

Git 原生最早只支持 GPG 签名； Git ≥2.34 新增支持 SSH 签名（可以复用你现有的 SSH 密钥，不用额外生成 GPG）

如果你想用同一把 SSH 密钥既登录 github 又签名 commit： 必须在 GitHub 添加两次：一条 Authentication Key，一条 Signing Key

实操：使用 SSH 密钥对 commit 进行签名

Git 全局配置

# 指定使用SSH格式签名，而非默认gpg
git config --global gpg.format ssh
# 指定你的SSH公钥路径作为签名密钥
git config --global user.signingkey ~/.ssh/id_ed25519.pub
# 开启：所有commit自动签名（不用每次加参数-S）
git config --global commit.gpgsign true
# 开启tag自动签名
git config --global tag.gpgsign true

GitHub 网页端配置

Settings → SSH and GPG keys → New SSH key Title 随意填写； Key type 务必选择 Signing Key（不要选 Authentication！） 粘贴公钥 id_ed25519.pub 全部内容保存

验证

# 创建空测试提交
git commit --allow-empty -m "test ssh signed commit"
# 查看签名信息
git log --show-signature -1
git push

一、小习惯为什么有效

1. 小行动会复利

习惯的影响不会立刻显现。每天进步 1%，一年后的结果约为 $1.01^{365} \approx 37.78$；每天退步 1%，结果约为 $0.99^{365} \approx 0.03$。现实中的变化不会如此精确，但方向很清楚：微小行动经过足够长的时间，会产生巨大的差距。

坏习惯也会复利。体重、存款、知识和生活环境，往往都是日常行为长期累积后的结果。

因此，不要只用眼前的结果评价习惯。更可靠的问题是：我今天是否完成了应该重复的动作？

2. 关注系统，不只关注目标

目标描述结果，系统描述过程。例如，“减重十公斤”是目标，“每天晚饭后散步并减少含糖饮料”是系统。

只盯着目标有四个问题：

1. 成功者和失败者可能拥有相同的目标。
2. 达成目标只是一次性的改变，系统停止后结果也可能消失。
3. 把幸福推迟到目标完成之后，会让过程变得痛苦。
4. 目标容易让人只在意终点，而忽略每天真正需要做的事。

如果习惯总是失败，先检查系统：提示是否清楚，行动是否足够简单，环境是否支持它，而不是先责怪自己缺乏意志力。

3. 从身份出发

行为改变有三个层次：

1. 结果：我想得到什么，例如减重、读完一本书。
2. 过程：我需要做什么，例如锻炼、每天阅读。
3. 身份：我想成为怎样的人，例如健康的人、读者。

与其说“我正在戒烟”，不如说“我不抽烟”。前者仍把吸烟者当作自己的身份，后者是在确认新的身份。

每次行动都是给某种身份投票。一次行动不会改变你，但反复行动会不断提供证据，让新的自我认识变得可信。目标不是“读完一本书”，而是成为一个会阅读的人；不是“跑完马拉松”，而是成为一个跑步者。

二、习惯的四个步骤

习惯通常按以下循环运行：

提示 → 渴求 → 反应 → 奖励

建立好习惯时，依次问自己：

1. 怎样让它显而易见？
2. 怎样让它有吸引力？
3. 怎样让它简便易行？
4. 怎样让它令人愉悦？

戒除坏习惯时反过来做：让提示消失，让行为失去吸引力，增加行动阻力，让结果变得令人不满意。

三、第一定律：让它显而易见

1. 先观察，再改变

很多习惯已经自动化，我们甚至意识不到触发它们的提示。可以先做一张“习惯记分卡”，按时间写下每天的行为，再给每项标记为有益、有害或中性。

重点不是立刻批评自己，而是看见行为的真实顺序。必要时可以使用“指差确认”：说出自己即将做什么，以及它可能带来的结果。

2. 给行为安排时间和地点

不要只说“以后多运动”，而要写成：

我将在[时间]于[地点]做[行为]。

例如：“我将在工作日 18:30 于小区楼下走路 20 分钟。”明确的时间和地点比模糊的愿望更容易执行。

3. 使用习惯叠加

把新习惯接在已有习惯之后：

继[当前习惯]之后，我将[新习惯]。

例如：喝完咖啡后写三行待办；刷完牙后读两页书；收拾完晚饭后准备第二天的水杯。

4. 设计环境

环境比意志力稳定。想多喝水，就把水瓶放在视线内；想练琴，就把吉他放在客厅显眼处；想少吃零食，就不要把零食放在桌边。

让好习惯的工具触手可及，让坏习惯的提示离开当前环境。

四、第二定律：让它有吸引力

1. 把需要做的事和喜欢做的事绑定

可以使用这个公式：

1. 继[当前习惯]之后，我将[需要做的事]。
2. 继[需要做的事]之后，我将[想做的事]。

例如，只有完成十分钟拉伸后才能看新闻；完成三个客户电话后才能查看比赛消息。喜欢的行为成为完成必要行为后的奖励。

2. 借助群体影响

人最容易模仿三类人的习惯：亲近的人、多数人和有影响力的人。加入一个把目标行为视为正常的群体，往往比独自依靠意志力更容易坚持。

3. 找到坏习惯背后的真实动机

表面的渴求通常对应更深层的需要。吸烟可能被误认为是社交或减压，但真正的需要可能是放松、归属感或短暂休息。找到真实需要后，才能用更健康的方式满足它。

五、第三定律：让它简便易行

1. 先追求次数，再追求质量

摄影课的经典对比是：一组学生追求作品数量，另一组追求作品质量，最后数量组通常进步更多。开始阶段最重要的是重复，而不是每次都做到完美。

2. 减少阻力

把运动服提前放在床边，把常用软件放到容易找到的位置，把学习材料提前打开。好习惯少一步，执行概率就多一点。

生活中占用时间最多的行为，通常也是最方便的行为。与其不断提高意志力，不如先把“弯折的水管”拉直，减少开始行动的阻力。

3. 用两分钟开始

把习惯缩小到两分钟以内：

• “读书”变成“打开书并读一页”。
• “跑步”变成“换上跑鞋”。
• “整理房间”变成“收起一件物品”。

两分钟版本不是最终目标，而是进入习惯轨道的入口。先稳定开始，再逐渐增加难度。

4. 让坏习惯难以发生

删除购物软件，给娱乐应用设置限制，把零食放到不方便拿取的地方，或让自己在做出冲动行为前增加一个确认步骤。增加一点阻力，就能打断自动化循环。

六、第四定律：让它令人愉悦

1. 让进步立即可见

习惯追踪可以把抽象的进步变成具体记录，例如在日历上打勾、记录阅读页数或移动一个回形针。看见连续行动本身，就是一种即时奖励。

但不要把“连续记录”看得高于习惯本身。偶尔中断并不可怕，原则是：绝不连续错过两次。

2. 选择与身份一致的奖励

奖励应该强化长期方向。想多运动，可以奖励自己按摩或一次户外活动；想存钱，可以把省下的钱转入旅行账户。用甜食奖励减肥、用消费奖励存钱，都会让短期奖励和长期身份互相冲突。

3. 使用问责和习惯契约

可以请朋友监督，或写下一份习惯契约，明确三件事：要做什么、多久检查一次、没有做到时承担什么成本。问责的作用不是羞辱自己，而是让坏习惯的即时成本变得真实。

七、方法速查

八、从好到更好

选择适合自己的领域

天赋和基因不能代替努力，但可以帮助我们找到更适合自己的方向。选择能发挥优势的环境，习惯会更容易坚持；如果找不到合适的领域，也可以调整规则，创造适合自己的玩法。

防止无聊和倦怠

任务太难会让人放弃，太简单又会让人无聊。最容易保持动力的区域，是“略有挑战但仍然做得到”的难度。

成功后的最大风险不是失败，而是厌倦。专业人士和普通人的差别，往往不在于谁从未失去兴趣，而在于失去新鲜感后谁仍能按计划继续。

用复盘避免自动犯错

习惯让我们不用思考就能行动，但也可能让小错误长期存在。可以定期回顾：哪些行为有效，哪里出现了阻力，下一轮要调整什么。

习惯动作 + 刻意练习 = 熟练。

同时，不要把身份变成牢笼。身份应该帮助你持续行动，也应该允许你在新证据出现时继续成长。

结语

改变习惯不必从巨大的目标开始。先选择一个身份，设计一个足够小、足够具体的动作，把它放进合适的时间和环境中，然后重复、记录、复盘。

真正重要的不是某一天表现得多么完美，而是能否让正确的行为在大多数普通日子里持续发生。

没什么特别好说的，我喜欢使用 ventoy 制作启动 U 盘，之后将 openSUSE 风滚草 的镜像拷贝进去就可以了。

KDE Plasma 桌面配置

我对于 Plasma 的配置非常简单，有以下几个步骤：

1. 将任务栏移到上面，并缩小到 40
2. 设置 > Appearance > Icons 换一个喜欢的图标包，默认的图标包有一点丑，我选择的是 Papirus
3. 设置 > Workspace Behavior > Virtual Desktops 调整虚拟桌面的排列，我将行数设置为 1 行，默认 2 个虚拟桌面即可
4. 设置 > Window Management > Task Switcher 将任务切换效果从 Breeze 切换成 Compact，最简单的切换效果，顺便把 Alt + ` 的快捷键删除了
5. 设置 > Input Devices > Keyboard > Advanced 勾选 Configure keyboard options 和下面的 Make Caps Lock an additional Ctrl 我们当然要将大写锁定键完全换成 Ctrl

KDE Plasma 用户在登录系统后，首次链接无线网络时会遇到 KDE 钱包的报错提醒（缺少密钥）。

为了避免重复输入验证密码。打开 KDE 钱包，选择 新建钱包 ，然选择传统，blowfish 加密文件，然后不输入密码，直接确认保存。这样你就有了一个空（无验证密码）的 KDE 钱包。联网就无需验证身份了。

Yast 配置和软件源更改

首先我们需要安装一下简体中文语言包，我们在 Yast > Language > Seconday Language 中选中 Simplified Chinese 就可以安装上中文语言包了。

接着我们打开 Software Repositories 把我们安装后自带的一个本地仓库（类似于 openSUSE-20240216-0 ）删除。

我们再将官方源换成 中科大 openSUSE 源 ，由于 openSUSE 使用了 MirrorBrain 技术，中央服务器 (download.opensuse.org) 会按照 IP 地理位置中转下载请求到附近的镜像服务器（但刷新软件源时仍从中央服务器获取 元数据），所以更改软件源通常只会加快刷新软件源的速度，而对下载速度影响不大。

我们再添加一下 Packman 源，直接在终端中：

bash

sudo zypper ar -cfp 90 https://mirrors.ustc.edu.cn/packman/suse/openSUSE_Tumbleweed/ USTC:PACKMAN

之后我们刷新并更新风滚草即可：

bash

sudo zypper ref && sudo zypper dup
sudo reboot

接着我们安装一些多媒体编码器：

bash

sudo zypper dist-upgrade --from USTC:PACKMAN --allow-vendor-change
sudo zypper install --from USTC:PACKMAN ffmpeg gstreamer-plugins-{good,bad,ugly,libav} libavcodec-full vlc-codecs

网络代理配置

我们使用 v2raya 来进行网络代理，先安装 v2ray 内核和 v2raya

bash

sudo zypper in v2ray
opi v2raya

打开 v2raya 服务后按照 快速上手 即可使用网络代理，使用透明代理可以为几乎所有的程序进行网络代理。

bash

sudo systemctl enable --now v2raya.service

更多代理使用方法可以参考 配置代理 。

字体与中文输入法

在 KDE 中安装字体很简单，只需要把字体往 Font Management 里面拖动就行了（最好是放在 Personal Fonts 分组里面），之后你可以使用 fc-cache -fv 刷新字体。

比较传统的方法是放到下面的文件夹中，按照优先级排序是：

bash

Font directories:
        /usr/X11R6/lib/X11/fonts
        /opt/kde3/share/fonts
        ~/.local/share/fonts
        ~/.local/share/flatpak/exports/share/fonts
        /var/lib/flatpak/exports/share/fonts
        /usr/local/share/fonts
        /usr/share/fonts
        ~/.fonts
        /usr/share/fonts/100dpi
        /usr/share/fonts/75dpi
        /usr/share/fonts/Type1
        /usr/share/fonts/cyrillic
        /usr/share/fonts/encodings
        /usr/share/fonts/ghostscript
        /usr/share/fonts/misc
        /usr/share/fonts/texlive-lm
        /usr/share/fonts/truetype
        /usr/share/fonts/xscreensaver
        /usr/share/fonts/encodings/large

推荐放在 ~/.fonts 或是 ~/.local/share/fonts 文件夹中，然后同样用 fc-cache -fv 刷新字体即可。

我个人推荐的字体是 Sarasa Term SC Nerd ，因为它在 Emacs 中使用可以处理表格对齐的问题，同时包含 Nerd Fonts，比较省心。

输入法推荐安装 Fcitx5 ：

bash

sudo zypper in fcitx5 fcitx5-chinese-addons
sudo zypper in fcitx5-configtool #  安装配置工具（可选）

在安装 Fcitx5 的时候，会默认卸载替换掉旧的 Fcitx，我们跟随系统提示操作即可。

安装后重新登陆，我们在设置 > Reginonal Settings > Input Method 中点击 Add Input Method 添加 Pinyin 即可，这里的一些环境变量使用 X11 的 KDE 的话系统已经自动帮我们设置好了。

我们还可以点击 Configure addons 设置一些输入法 UI 等。

词典可以帮助改善输入法的使用体验，以下是两个受欢迎的词库：

• felixonmars/fcitx5-pinyin-zhwiki
• wuhgit/CustomPinyinDictionary

请根据仓库的 README 文件将下载或下载解压后的 .dict 文件放置到 ~/.local/share/fcitx5/pinyin/dictionaries/ 文件夹中（如果文件夹不存在，你需要手动新建此文件夹），再重启一下 fcitx5 即可。

安装软件

我将我一开始安装的一些软件列下来（我随便写了一些，可以按需下载安装）：

bash

通过 zypper 安装：
git
emacs
opi
keepassxc
mpv
telegram-desktop
qbittorrent
filezilla
wireshark
flameshot # 安装指南 (https://zh.opensuse.org/Flameshot)
cheat
nodejs
syncthing

通过 opi 安装
megasync
google-chrome-stable
v2raya

电源管理（针对笔记本电脑）

我们使用默认的 TLP 配置即可，你可以使用 TLPUI 来更简单地配置。

bash

sudo zypper in tlp
sudo systemctl disable tlp && sudo systemctl stop tlp
sudo systemctl enable tlp

我们在 TLPUI 中简单设置一下充电阈值即可，这样可以延长一些笔记本电池的寿命

bash

START_CHARGE_THRESH_BAT0=75
# 开始充电阈值
STOP_CHARGE_THRESH_BAT0=85
# 停止充电阈值

我们可以用下面这条命令检查电池状态：

bash

sudo tlp-stat -b

终端模拟器

这个选择自己称手的就行了，以前我比较喜欢折腾 shell，现在懒得去配置了，就用默认的 bash 就行了，安装一个 Ohmybash 能让它好看一些， 目前我最喜欢的 shell 居然是 emacs 里面的 eshell 吧（笑）。

此外，如果我使用 zsh，我个人很讨厌 Ohmyzsh，我会换成 zim 这种轻量化的配置框架。

终端模拟器的话我一直在用 kitty ，它对于颜色支持的比较好，而且还自带 kitten 插件，每次我到新机器上直接用 kitten 就能把主题啥的配置好，性能也非常快。

我最喜欢的终端字体是 CaskaydiaMono Nerd Font 。

此外，新的终端模拟器 Warp 在我写这篇文章的时候，已经可以在 Linux 上使用了，我在 MacOS 上一直很喜欢使用这个非常现代的终端。

终端模拟器的配置随便换个字体就行了，还有一点是我比较讨厌透明背景色的终端配置。

参考链接

• openSUSE WIKI 快速配置指南
• openSUSE WIKI 电池管理
• v2raya 用户文档

自己随便记录的关于 denote 的一些使用方法，绝大部分都是直接翻译的官方文档。

参考文档

denote 文档

标准笔记创建

提示用户输入以创建笔记的命令包括但不限于：

• denote
• denote-signature
• denote-type
• denote-date
• denote-subdirectory
• denote-rename-file
• denote-dired-rename-files

The denote-templates 选项

用户可以以模版开始创建一个新的笔记。

创建模版的配置：

elisp

(setq denote-templates
      '((report . "* Some heading\n\n* Another heading")
        (memo . "* Some heading\n\n* Another heading)))

更好的方法是用 concat 函数来将字符串连接起来：

emacs-lisp

(setq denote-templates
      `((report . "* Some heading\n\n* Another heading")
        (memo . ,(concat "* Some heading"
                         "\n\n"
                         "* Another heading"
                         "\n\n"))))

维护单独的笔记目录 silos

silos 这个概念就是笔记存放在不同地方，目录与目录之间是分离的，我们把这样的目录叫做 silos 。

要创建一个 silos ，首先我们需要在笔记目录下创建一个 .dir-locals.el 文件，在创建的时候 Emacs 会提醒我们是否存储这个路径变量，我们选择是即可。

我们向 .dir-locals.el 文件中写入：

emacs-lisp

;;; Directory Local Variables.  For more information evaluate:
;;;
;;;     (info "(emacs) Directory Variables")

((nil . ((denote-directory . "/path/to/silo/")
         (denote-infer-keywords . nil))))

下面是我的笔记目录（ 01Index 是我的 denote-directory ）：

bash

./01Index/
├── .DS_Store
├── 20240228T160157--mastering-eshell__emacs_linux_shell.assets
├── 20240228T160157--mastering-eshell__emacs_linux_shell.org
├── 20240315T225352--c语言程序设计现代方法__c.org
├── 20240317T201104--cpp-primer__cpp.org
├── 20240407T230222--西方哲学史__reading.org
└── ltximg
./02Area/
├── .dir-locals.el
├── 20240201T021341--emacs-manual-note__emacs.assets
├── 20240201T021341--emacs-manual-note__emacs.org
├── 20240302T153745--计算机网络原理__network.assets
├── 20240302T153745--计算机网络原理__network.org
├── 20240320T175109--操作系统__operatingsystem.assets
├── 20240320T175109--操作系统__operatingsystem.org
├── 20240328T141613--计算机系统结构__computerarchitecture.assets
└── 20240328T141613--计算机系统结构__computerarchitecture.org
./03Resource/
├── .dir-locals.el
├── 20240221T162109--kde-plasma-桌面-korganizer-等软件关闭后仍然占用约-800-m-内存__bug_kde.assets
├── 20240221T162109--kde-plasma-桌面-korganizer-等软件关闭后仍然占用约-800-m-内存__bug_kde.org
└── 20240222T000349--opensuse-tumbleweed-和-kde-的个人安装过程__kde_linux_opensuse.org
./04Project/
├── .dir-locals.el
└── 20240417T220159--denote-使用方法__emacs.org

之后我们还要用自定义用户配置命令自动选择 silo ，这样我们平常使用 denote 命令的时候默认将笔记放到 01Index 中， 当我们切换到 02Area 时，我们这时使用 denote 相关命令，笔记就会自动存放到当前的 silo 中了。

我的用户配置如下：

emacs-lisp

(defvar my-denote-silo-directories
    `("/home/MEGA/02Area"
      "/home/MEGA/03Resource"
      "/home/MEGA/04Project"
      ;; You don't actually need to include the `denote-directory' here
      ;; if you use the regular commands in their global context.  I am
      ;; including it for completeness.
      ,denote-directory)
    "List of file paths pointing to my Denote silos.
  This is a list of strings.")

  (defvar my-denote-commands-for-silos
    '(denote
      denote-date
      denote-subdirectory
      denote-template
      denote-type)
    "List of Denote commands to call after selecting a silo.
  This is a list of symbols that specify the note-creating
  interactive functions that Denote provides.")

  (defun my-denote-pick-silo-then-command (silo command)
    "Select SILO and run Denote COMMAND in it.
  SILO is a file path from `my-denote-silo-directories', while
  COMMAND is one among `my-denote-commands-for-silos'."
    (interactive
     (list (completing-read "Select a silo: " my-denote-silo-directories nil t)
           (intern (completing-read
                    "Run command in silo: "
                    my-denote-commands-for-silos nil t))))
    (let ((denote-directory silo))
      (call-interactively command)))

关于 silo 的实现并不优雅，这是一个比较新的功能。我们现在只能凑合用了，我觉得作者应该将 silo 这种分散仓库概念集合到对于 denote-directory 的配置中。

因为毕竟我不可能总是将笔记放在一个文件夹中，总是用 denote-subdirectory 也不是办法。

笔记文件命名规范

笔记被存放在 denote-directory 中，默认是 ~/Documents/notes 。

默认遵循下面这个命名规范：

text

DATE==SIGNATURE--TITLE__KEYWORDS.EXTENSION

DATE 字段以 年-月-日 的格式表示日期，后跟大写字母 T 表示当前时间，同时 DATE 也作为每个笔记文件的唯一标识符。

SIGNATURE 字段中包含一串字母数字字符。签名没有明确定义的用途，由用户定义。一个用例是使用它们在文件之间建立顺序关系（例如 1、1a、1b、1b1、1b2 等）。

TITEL 字段默认小写，并且带有连字符。

KEYWORDS 字段由一个或多个条目组成，这些条目用下划线分隔，输入 KEYWORDS 时用逗号分隔。

Examples:

text

20220610T043241--initial-thoughts-on-the-zettelkasten-method__notetaking.org
20220610T062201--define-custom-org-hyperlink-type__denote_emacs_package.md
20220610T162327--on-hierarchy-and-taxis__notetaking_philosophy.txt

denote-prompts 可以按照如下方式来配置：

text

DATE.EXT
DATE--TITLE.EXT
DATE__KEYWORDS.EXT
DATE==SIGNATURE.EXT
DATE==SIGNATURE--TITLE.EXT
DATE==SIGNATURE--TITLE__KEYWORDS.EXT
DATE==SIGNATURE__KEYWORDS.EXT

链接笔记

denote 提供了不同的命令在笔记之间创建链接。

所有的被链接的文件都必须是 denote 文件，无法识别其他文件。

添加一个单独的链接

denote-link 命令在 minibuffer 中选择一个文件插入到当前文件中作为链接。链接的格式取决于当前的文件是 Org 还是 Markdown。

我们也可以再 Org 文件中支持链接到标题，使用 denote-org-store-link-to-heading 命令，其他文件格式不支持。

当使用前缀键（默认是 C-u ）调用 denote-link ，无论文件类型如何，他都会设置链接为 [[denote:IDENTIFIER]] 的格式。

默认情况下，链接的描述是这样确定的：

denote-org-store-link-to-heading 用户选项

选项 denote-org-store-link-to-heading 确定 org-store-link 是否链接到当前 Org 文件的标题。

org-store 就是把当前的链接存储起来，之后用 org-insert-link 插入，而 denote-org-store-link-to-heading 选项会影响到这个命令。

当该选项为非 nil 时， org-store-link 就是将当前标题的链接存储起来，而不是存储 denote 文件的链接。

如果标题没有 CUSTOM_ID ，则创建 PROPERTIES 它并将其包含在标题的抽屉中。如果存在 CUSTOM_ID ， org-store-link 按原样使用。

插入执行 org 文件中标题的链接

作为 denote-org-extras.el 拓展的一部分， denote-org-extras-link-to-heading 会提供执行 Org 文件标题的链接。

链接形式如下：

text

[[denote:IDENTIFIER::#ORG-HEADING-CUSTOM-ID]][Description::Heading text]]

插入一个符合正则表达式的链接

命令 denote-add-links 添加数个链接，链接匹配正则表达式。这些链接作为列表排版插入，例如：

text

- link1
- link2
- link3

可以使用的正则表达式示例：

• journal 匹配所有包含 journal 标题名字的笔记。
• _journal 匹配所有关键字为 journal 的笔记。
• ^2022.*_journal 匹配所有在 2022 开始的笔记，并且含有关键字 journal 。
• \.txt 匹配拓展名为 txt 的文件。

链接到一个已存在的笔记或者创建一个新的笔记

在一个人的笔记工作流程中，他们可能在阐述某个主题时，但他们想要连接到另一个主题时。 Denote 提供了几个方便的命令：

• denote-link-after-creating

  在后台创建一个新笔记并且直接链接到这里。

• denote-link-after-creating-with-command

  这个命令和上面一个类似，只是提示输入创建笔记的命令。

• denote-link-or-create

  使用 denote-link 在目标文件，必须时创建它。

反向链接的 buffer

denote-backlinks 会生成一个自定义的缓冲区，其中显示指向当前笔记的反向链接。 “反向链接”是返回当前条目的链接。

默认情况下，反向链接的 buffer 设计为显示链接到当前条目的注释的文件名。每个文件名都显示在自己的行上。

text

Backlinks to "On being honest" (20220614T130812)
------------------------------------------------

20220614T145606--let-this-glance-become-a-stare__journal.txt
20220616T182958--feeling-butterflies-in-your-stomach__journal.txtx

反向链接缓冲区使用的是 Emacs 内置的 Xref 基础设施。在某些操作系统上，用户可能需要将某些可执行文件添加到相关的环境变量中。