我的第一篇

这份Hugo Stack 博客更新发布指南为您整理好了。整个工作流基于您调通的 “Obsidian 写作 $\rightarrow$ 本地电脑 Hugo 编译 $\rightarrow$ 小乌龟 SVN 专属隔离仓库一键同步”。

您可以把这段内容保存到您的 Obsidian 知识库中，方便以后每次发布时对照操作：

🚀 Timeline 个人博客更新发布指南

📝 日常核心铁律：

大小写敏感：图片后缀必须是小写的 .jpg 或 .png（绝对不能是大写的 .JPG），否则新加坡服务器不识别。
物理位置对齐：文章中的图片必须和文章的 .md 文件并排放在同一个文件夹下。

阶段一：在 Obsidian 中写作与本地预览

1. 启动本地实时预览

在本地电脑打开 D:\my-blog 目录下的 CMD 黑色窗口，输入命令并回车：

1
.\hugo server 

提示：保持这个黑色窗口不要关闭。

2. 创作文章

打开 Obsidian（确保仓库路径指向了 D:\my-blog\content\post\），新建或修改文章。文章顶部必须包含以下标准格式参数：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
---
title: "这里写文章的真实标题"
description: "这里写一两句简短的卡片简介"
date: 2026-05-16
image: "03.jpg"              # 首页卡片大图。确保 03.jpg 与此文章在同一文件夹下
categories:
    - 技术分享                 # 分类卡片（点击可聚合）
tags:
    - Hugo
---

3. 本地验收

打开浏览器访问：http://localhost:1313/，检查侧边栏名字、简介，并点进新文章确认文字排版、嵌入的 B 站视频、以及 .jpg 封面图片是否全部完美显示。

阶段二：本地一键打包编译

确认本地预览无误后，我们需要把 Markdown 笔记提炼成能直接挂在公网上的纯静态网页。

回到刚才的 CMD 黑色窗口，按下键盘 Ctrl + C，然后输入 Y 回车，关闭本地测试服务。
在 CMD 窗口中运行正式的打包命令：
1
.\hugo --minify
预期结果：看到命令行吐出一个整齐的表格，提示 Total in ... ms。此时，最新渲染生成的 30 多个网页文件和新图片已经全部躺在了 D:\my-blog\public\ 文件夹里。

阶段三：小乌龟 SVN 一键发布至新加坡服务器

因为我们配置了服务器端的 post-commit 自动同步钩子，现在您只需在 Windows 电脑上动动鼠标，文件就会自动飞去服务器并覆盖旧网页。

1. 深度抓漏并添加新文件（极其重要）

由于新文章和新图片生成在 public/ 的极深层子目录里，直接 Commit 会漏掉文件，必须先执行 Add：

鼠标双击进入电脑的 D:\my-blog\public\ 文件夹。
在空白处点击鼠标右键 $\rightarrow$ 选择 TortoiseSVN $\rightarrow$ 点击 Add… (添加)。
在弹出的全选窗口中，直接点击下方的 “Select all” (全选) 按钮，确保所有新生成的 HTML 和深层图片被全部勾选，然后点击 OK。

2. 正式 Commit 提交上线

依然在 D:\my-blog\public\ 文件夹空白处点击鼠标右键 $\rightarrow$ 选择 SVN Commit… (提交)。
在弹出的窗口最上方的 Message 框中，随便打几个字（例如：更新了我的第一篇文章）。
检查下方列表无误后，点击 OK。
成功标志：进度条刷刷滚完，最下方提示 Completed At revision: xx。

🌐 最终外网验收

关闭电脑上的所有开发工具，直接用手机或电脑浏览器访问您的独立域名：

1
https://timeline.net.cn

检查点：

确认新文章卡片成功出现在首页。
如果图片由于浏览器顽固缓存没有刷新出来，在电脑上按下 Ctrl + F5 强制刷新即可。