今日最大感悟 可以都记在这里 就比如这个网站的使用方法
博客维护手册
最后更新：2026-05-04
一、架构概览
你的电脑 服务器 (134.209.97.93)
┌──────────────────────┐ ┌──────────────────┐
│ blog-papers/ (Obsidian)│ 部署脚本 │ /var/www/blog/ │
│ ├ llm学习记录/ │──Hugo构建──▶│ Nginx │
│ ├ 通信原理/ │ SCP上传 │ ↓ │
│ ├ 胡思乱想/ │ │ wyxbupt.me │
│ └ templates/ │ │ │
├──────────────────────┤ └──────────────────┘
│ blog-scripts/ │
│ └ deploy-blog.ps1 │
│ └ rebuild-section-indexes.py │
└──────────────────────┘
二、日常使用
写文章
-
打开 Obsidian，vault 在
E:\_MyCollegeLife\blog-papers -
在对应文件夹里新建笔记：
-
llm学习记录/→ LLM相关 -
通信原理/→ 通信课程 -
胡思乱想/→ 随笔杂谈
-
-
用模板：
Ctrl+T→ 选择博客模板 -
写正文
部署
powershell -File E:_MyCollegeLife\blog-scripts\deploy-blog.ps1
部署脚本自动做：
-
扫描所有
.md文件，补全缺失的 frontmatter（标题、日期、分类） -
自动将日期补上
+08:00时区（防止被 Hugo 当成未来文章排除） -
重建每个板块的
_index.md -
Hugo 构建
-
SCP 上传到服务器
查看效果
| 页面 | URL |
|---|---|
| 首页/全部文章 | https://wyxbupt.me/ |
| LLM学习记录 | https://wyxbupt.me/posts/llm学习记录/ |
| 通信原理 | https://wyxbupt.me/posts/通信原理/ |
| 胡思乱想 | https://wyxbupt.me/posts/胡思乱想/ |
三、Markdown 写作语法
基础
一级标题
二级标题
粗体 斜体 删除线 代码
- 无序列表
- 有序列表
引用
链接
代码块
def hello():
print("Hello")
数学公式（LaTeX）
行内：$E = mc^2$
块公式：
$$ \int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $$多行对齐：
$$ \begin{aligned} Q_\theta(s_t,a) &= r_t + \gamma V_\theta(s_{t+1}) \\ A_\theta(s_t,a) &= Q_\theta(s_t,a) - V_\theta(s_t) \end{aligned} $$支持的数学环境：aligned、align*、cases、matrix 等。
图片
Obsidian 粘贴图片后，把 ![[Pasted image xxx.png]] 改成：
图片文件存在 E:\_MyCollegeLife\blog-papers\（Obsidian vault 根目录），会自动发布。
PDF / 附件链接
PDF 放在 blog-papers 下面也会自动发布，但不会自动出现在文章列表里，需要在 .md 里手动写链接。
不要写 Obsidian 的 [[SKILL0.pdf]]，博客里要写标准 Markdown 链接：
[SKILL0.pdf](/agentic-RL系列/SKILL0.pdf)
规则是：
[显示文字](/目录名/文件名.pdf)
例如文件在：
E:\_MyCollegeLife\blog-papers\agentic-RL系列\SKILL0.pdf
网站链接就是：
[SKILL0.pdf](/agentic-RL系列/SKILL0.pdf)
不要用 ./SKILL0.pdf。文章页面生成后 URL 会多一层文章 slug，浏览器可能会去错误的目录找文件，导致 404。
Callout（提示框）
[!note] 笔记
内容
[!warning] 注意
内容
表格
| 列1 | 列2 | 列3 |
|---|---|---|
| A | B | C |
四、Frontmatter 说明
部署脚本会自动补全，也可以手动写：
title: “文章标题”
date: “2026-05-04T00:00:00+08:00” # 时区必须 +08:00！
draft: false
tags: [标签1, 标签2]
categories: [“板块名”]
summary: “摘要（显示在卡片上）”
math: true # 如果这篇文章需要LaTeX（默认全局开启）
重要：日期必须带时区 +08:00！ 部署脚本会自动补，不用担心。
五、已知问题与解决
新文章不显示？
-
部署脚本已自动修复：每次部署会扫描所有日期，补上
+08:00 -
如果还是不显示，检查
draft: false
LaTeX公式不渲染？
-
Hugo 已配置 Goldmark passthrough，
$$和$会原样保留给 KaTeX -
浏览器硬刷新：
Ctrl+F5
图片不显示？
-
把 Obsidian 的
![[...]]改成标准 -
图片存在
blog-papers/下任意位置即可
终端显示乱码？
-
只是 PowerShell 显示问题，文件本身是 UTF-8，不影响网站
-
用 Python 操作中文文件更安全
六、修改过的文件
| 文件 | 说明 |
|---|---|
blog-papers/胡思乱想/平庸之恶.md |
日期加时区 |
blog/layouts/posts/section.html |
板块页卡片渲染 |
blog/layouts/partials/math.html |
KaTeX 数学支持 |
blog/layouts/partials/extend_head.html |
加载 KaTeX |
blog-scripts/rebuild-section-indexes.py |
板块索引生成 |
blog-scripts/deploy-blog.ps1 |
日期自动规范化 |
blog/hugo.toml |
math + Goldmark passthrough + 静态文件挂载 |
七、备份
文章归档在 E:\_MyCollegeLife\blog-archive\，不在 Hugo 发布范围内。