https://domal.cc/tags/%E5%BC%80%E5%8F%91%E5%B7%A5%E5%85%B7/ Domal Hugo -- gohugo.io https://domal.cc/thinking/hugo%E5%90%8E%E7%AB%AF%E8%AE%BE%E6%83%B3---2/ Mon, 07 Sep 2026 22:17:00 +0800 https://domal.cc/thinking/hugo%E5%90%8E%E7%AB%AF%E8%AE%BE%E6%83%B3---2/ <p>又开始折腾了。在完成了 Windows 桌面客户端之后，我又有了新想法。</p>
<p>需求很纯粹：<strong>手机编辑内容 → 一键发布上线。</strong> 想法听着简单，但第一步就被卡住了——手机上无法直接运行 <code>hugo.exe</code>，而移植 Hugo 源码更是难上加难（这点我曾用 DeepSeek 求证过）。于是 DeepSeek 给了我两条现成的方案，先记录如下。</p>
<h2 id="方案-agithub-仓库--github-actions-自动构建发布推荐最省心">方案 A：GitHub 仓库 + GitHub Actions 自动构建发布（推荐，最省心）</h2>
<h3 id="原理">原理</h3>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">手机（写/改 Markdown）→ push 到 GitHub 仓库
</span></span><span class="line"><span class="cl"> → GitHub Actions 检测到 push
</span></span><span class="line"><span class="cl"> → 自动跑 hugo 构建 public/
</span></span><span class="line"><span class="cl"> → 自动用 SSH/SFTP 上传到宝塔站点目录
</span></span></code></pre></div><h3 id="手机端需要什么">手机端需要什么</h3>
<ul>
<li>手机编辑器：<strong>GitHub 网页编辑</strong>、手机版 GitHub App，或任何<strong>支持 GitHub 同步的 Markdown 编辑器</strong>（如 Obsidian 手机版 + Git 插件）；</li>
<li>手机改完文件 → 提交 → push，发布全流程即告完成。</li>
</ul>
<h3 id="需要做的一次性配置">需要做的一次性配置</h3>
<ol>
<li>把博客源码推到一个 GitHub（私有）仓库；</li>
<li>在仓库里放一个 Actions 工作流文件（<code>.github/workflows/deploy.yml</code>），内容大致是：检出代码 → 安装 hugo → 执行 <code>hugo --minify</code> → 用 <code>scp/sftp</code> 上传到宝塔；</li>
<li>在 GitHub Secrets 中存放服务器 IP / 账号 / 私钥（<strong>无需把密码写进代码</strong>）。</li>
</ol>
<h3 id="优点">优点</h3>
<ul>
<li><strong>手机零开发</strong>：不动手写任何 App，用现成的 GitHub App / 网页编辑器即可；</li>
<li><strong>发布全自动</strong>：<code>push</code> 即发布，贴合"手机端写完即发"的需求；</li>
<li><strong>有版本历史</strong>：可回滚、可备份，心里踏实。</li>
</ul>
<h3 id="缺点">缺点</h3>
<ul>
<li>需要手机能访问 GitHub（国内网络可能要代理）；</li>
<li>用户需略懂 Git 概念（不过 GitHub 手机 App 的"提交"按钮已经足够简单）。</li>
</ul>
<blockquote>
<p>这本质上是把之前讨论过的「GitHub 中转 + 服务器构建」路线自动化了，前端发布动作完全不在手机端执行。</p> https://domal.cc/posts/md-client-%E4%BD%BF%E7%94%A8%E6%96%B9%E6%B3%95/ Sat, 05 Sep 2026 23:30:00 +0800 豆沫 https://domal.cc/posts/md-client-%E4%BD%BF%E7%94%A8%E6%96%B9%E6%B3%95/ <h1 id="hugo-markdown-client简称-hmdc使用方法">Hugo Markdown Client（简称 HMDC）使用方法</h1>
<blockquote>
<p class="dropcap">适用于 <code>publish</code> 文件夹中构建好的 <strong>HMDC.exe</strong>（单文件自包含版本）。
本教程面向<strong>不熟悉命令行 / Git</strong> 的 Hugo 博客写作者，教你在图形界面里完成「写文章 → 本地预览 → 发布上线」的全部流程。</p>
</blockquote>
<hr>
<h2 id="目录">目录</h2>
<ol>
<li><a href="#%E4%B8%80%E8%AE%A4%E8%AF%86-HMDC">认识 HMDC</a></li>
<li><a href="#%E4%BA%8C%E5%AE%89%E8%A3%85%E4%B8%8E%E5%90%AF%E5%8A%A8">安装与启动</a></li>
<li><a href="#%E4%B8%89%E5%87%86%E5%A4%87-hugo%E5%8F%AA%E9%9C%80%E4%B8%80%E6%AC%A1">准备 Hugo（只需一次）</a></li>
<li><a href="#%E5%9B%9B%E7%95%8C%E9%9D%A2%E5%B8%83%E5%B1%80%E6%80%BB%E8%A7%88">界面布局总览</a></li>
<li><a href="#%E4%BA%94%E7%AC%AC%E4%B8%80%E6%AD%A5%E6%89%93%E5%BC%80-hugo-%E9%A1%B9%E7%9B%AE">第一步：打开 Hugo 项目</a></li>
<li><a href="#%E5%85%AD%E5%86%99%E6%96%87%E7%AB%A0markdown-%E7%BC%96%E8%BE%91%E5%99%A8%E8%AF%A6%E8%A7%A3">写文章：Markdown 编辑器详解</a></li>
<li><a href="#%E4%B8%83frontmatter%E6%96%87%E7%AB%A0%E5%85%83%E6%95%B0%E6%8D%AE">Frontmatter：文章元数据</a></li>
<li><a href="#%E5%85%AB%E7%BC%96%E8%BE%91%E9%A2%84%E8%A7%88%E6%A8%A1%E5%BC%8F%E5%88%87%E6%8D%A2">编辑/预览模式切换</a></li>
<li><a href="#%E4%B9%9D%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86">文件管理（新建/复制/重命名/删除）</a></li>
<li><a href="#%E5%8D%81%E6%9C%AC%E5%9C%B0%E9%A2%84%E8%A7%88%E5%90%AF%E5%8A%A8-hugo-%E6%9C%8D%E5%8A%A1%E5%99%A8">本地预览：启动 Hugo 服务器</a></li>
<li><a href="#%E5%8D%81%E4%B8%80ai-%E5%8A%A9%E6%89%8Bdeepseek-%E5%8A%A0%E6%8C%81">AI 助手（DeepSeek 加持）</a></li>
<li><a href="#%E5%8D%81%E4%BA%8C%E6%9E%84%E5%BB%BA%E5%8F%91%E5%B8%83%E5%88%B0%E5%AE%9D%E5%A1%94%E6%9C%8D%E5%8A%A1%E5%99%A8">构建发布到宝塔服务器</a></li>
<li><a href="#%E5%8D%81%E4%B8%89%E5%A4%9A%E8%AF%AD%E8%A8%80%E7%BD%91%E7%AB%99%E9%95%9C%E5%83%8F%E5%A4%8D%E5%88%B6">多语言网站：镜像复制</a></li>
<li><a href="#%E5%8D%81%E5%9B%9B%E4%B8%AA%E6%80%A7%E5%8C%96%E4%B8%BB%E9%A2%98%E4%B8%8E%E8%AF%AD%E8%A8%80">个性化：主题与语言</a></li>
<li><a href="#%E5%8D%81%E4%BA%94%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E4%BD%8D%E7%BD%AE">配置文件位置</a></li>
<li><a href="#%E5%8D%81%E5%85%AD%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E6%8E%92%E6%9F%A5">常见问题排查</a></li>
</ol>
<hr>
<h2 id="一认识-hmdc">一、认识 HMDC</h2>
<p><strong>HMDC</strong> 是一款 Windows 桌面应用，目标是让完全不会命令行的用户也能管理 Hugo 静态博客。它把三大能力集成在一个窗口里：</p>
<ul>
<li><strong>写作</strong>：带格式工具栏、行号、表格/代码等一键插入的 Markdown 编辑器；</li>
<li><strong>预览</strong>：一键在「源码」和「渲染后页面」之间切换；</li>
<li><strong>发布</strong>：本地构建 <code>public/</code> 后通过 SFTP 直接上传到宝塔服务器。</li>
</ul>
<hr>
<h2 id="二安装与启动">二、安装与启动</h2>
<h3 id="21-系统要求">2.1 系统要求</h3>
<ul>
<li><strong>Windows 10 / 11</strong>（64 位）</li>
<li><strong>无需安装 .NET</strong>（HMDC.exe 是 self-contained 单文件，已内置运行时）</li>
<li><strong>无需预装 Hugo</strong>（见下一节，可在 HMDC 内自动下载）</li>
<li>硬盘空间：程序本体约 76 MB</li>
</ul>
<h3 id="22-启动">2.2 启动</h3>
<p>把整个 <code>publish</code> 文件夹复制到任意位置（如桌面、D 盘），<strong>双击 <code>HMDC.exe</code></strong> 即可运行。</p> https://domal.cc/posts/md-client%E8%BF%9B%E5%B1%95/ Fri, 04 Sep 2026 22:35:00 +0800 豆沫 https://domal.cc/posts/md-client%E8%BF%9B%E5%B1%95/ <p>这段时间一直在打磨自己写的 <strong>Hugo Markdown Client</strong>，到现在功能上已经差不多收尾了。</p>
<p>从最早的只能写本地 Markdown 并手动同步，到后来逐步补齐了 Frontmatter 编辑、标签与分类管理、多语言文件的目录组织，再到接入项目文件树与静态资源整理，整套桌面工作流的体验已经比刚开始顺滑许多。</p>
<h2 id="下一步ssh--docker-一键发布">下一步：SSH + Docker 一键发布</h2>
<p>目前离「写完即发布」还差最后一公里——把内容推送并构建上线。</p>
<p>接下来准备测试的方案是：</p>
<ul>
<li>通过 <strong>SSH</strong> 将本地更新的内容直接推送到部署在 <strong>Docker</strong> 上的 Hugo 站点仓库；</li>
<li>触发容器内的一次 <code>hugo</code> 构建；</li>
<li>将构建产物刷新到对外服务的目录，完成一次发布。</li>
</ul>
<p>目标是把以上步骤串成<strong>一个动作</strong>，在 Client 里点一下，即可完成「推送 + 构建 + 发布」的全流程。真正实现从边写边推到一键上线的闭环。</p>
<h2 id="待验证的问题">待验证的问题</h2>
<p>这里也有一些具体的技术点需要在测试中确认：</p>
<ul>
<li>SSH 鉴权与密钥的管理是否足够安全、又不至于太繁琐；</li>
<li>远程触发构建的方式是走 <code>docker exec</code> 还是挂载目录后监听触发更稳妥；</li>
<li>构建增量与缓存策略，避免每次全量编译拖慢发布速度；</li>
<li>构建失败时的回滚与错误反馈是否清晰。</li>
</ul>
<h2 id="小结">小结</h2>
<p>这个收尾阶段最值得期待的，其实是整条链路真正跑通的那一刻——写作、管理、发布都待在一个自己可控的 Client 里完成。等 SSH + Docker 的推送测试通过后，再回来补一篇更完整的流程记录。</p> https://domal.cc/thinking/hugo%E5%90%8E%E7%AB%AF%E8%AE%BE%E6%83%B3/ Sun, 09 Aug 2026 09:00:00 +0800 https://domal.cc/thinking/hugo%E5%90%8E%E7%AB%AF%E8%AE%BE%E6%83%B3/ <p>记录一款面向 Hugo 内容管理者的 Windows 桌面客户端。</p>
<h1 id="一切的起点hugo-很好但发布太痛了">一切的起点：Hugo 很好，但“发布”太痛了</h1>
<p>我使用 Hugo 搭建个人博客已经很长时间了。坦白说，Hugo 本身作为静态站点生成器，速度快、生态好、主题丰富，几乎无可挑剔。</p>
<p>但有一个环节，始终让我如鲠在喉——<strong>发布上线</strong>。</p>
<p>每一次写完文章，我需要经历的是：</p>
<ul>
<li>打开命令行，cd 到站点目录；</li>
<li>执行 <code>hugo</code> 构建，生成 <code>public/</code> 目录；</li>
<li>打开 FTP/SFTP 客户端，连接到服务器；</li>
<li>手动找到远程网站根目录（比如宝塔面板的 <code>/www/wwwroot/xxx</code>）；</li>
<li>将本地 <code>public/</code> 目录里的文件，一个一个上传覆盖；</li>
<li>刷新浏览器，确认上线。</li>
</ul>
<p>如果只是偶尔写一篇，倒也还能忍。但当你需要频繁更新、修正错别字、调整排版时，这套流程的<strong>重复成本</strong>就会急剧放大。更别提有时候 SFTP 客户端连接超时、文件漏传、目录搞错——每一步都藏着让人抓狂的细节。</p>
<p>我也尝试过 Git + GitHub Actions 或 Webhook 的自动化方案，但坦白说，<strong>配置门槛同样不低</strong>：要在服务器上建 bare 仓库、配置 post-receive hook、设置权限……对于只想安静写点东西的博主来说，这显然是过度工程。</p>
<p><strong>转折</strong>忘了具体哪天，我偶然刷到一款叫“一言”的 APP——它的核心功能非常简单：用户在手机端写下几句话，点击发布，内容就会立即出现在个人页面上。没有复杂的后台配置，没有“部署”这个概念，用户感知到的只有一个动作：<strong>写，然后它就上线了</strong>。</p>
<p>这个极简体验给了我很大的触动。</p>
<p>我在想：<strong>Hugo 博客能不能也做到这样？</strong></p>
<p>能不能有一个界面，用户只负责：</p>
<ul>
<li>在本地打开一个编辑器；</li>
<li>写 Markdown；</li>
<li>点击一个按钮；</li>
</ul>
<p>然后剩下的所有事情（保存文件、调用 Hugo 构建、通过 SSH/SFTP 上传到宝塔面板的网站目录）全部由工具自动完成？</p>
<p>有想法了，也有目标了，说搞就搞。开始借助AI帮我整理思路，以及项目规划。</p>
<h2 id="一项目全景与核心目标">一、项目全景与核心目标</h2>
<h3 id="11-我的项目定位">1.1 我的项目定位</h3>
<p>一款面向 Hugo 内容管理者的 Windows 桌面客户端（C# + WPF），让使用者<strong>无需接触命令行</strong>，在图形界面中完成：</p>