https://zeseanblog.top/tags/python/Recent content in Python on Zesean 的博客Hugo -- gohugo.iozh-CNSat, 05 Sep 2026 14:53:14 +0800https://zeseanblog.top/projects/blog/Tue, 01 Sep 2026 13:05:00 +0800https://zeseanblog.top/projects/blog/<h2 id="项目概述"><a href="#%e9%a1%b9%e7%9b%ae%e6%a6%82%e8%bf%b0" class="header-anchor"></a>项目概述 </h2><p>你现在看到的这个网站，就是我的第一个完整独立部署的 Web 项目。</p> <p>从域名备案、服务器采购，到站点搭建、HTTPS 证书、自动化部署，全流程独立完成。除了站点本身，还为它写了一套配套的本地工具：<strong>notes-ui 笔记工作台</strong>——把「写完的 Markdown 笔记 → 线上文章」的全流程做成了浏览器界面，拖拽上传、自动处理图片、分步构建部署。</p> <h2 id="架构"><a href="#%e6%9e%b6%e6%9e%84" class="header-anchor"></a>架构 </h2><pre class="mermaid" style="visibility:hidden">flowchart LR UI["notes-ui 本地笔记工作台<br/>（Flask · 127.0.0.1）"] -->|"解析 / 图片归位 / 元数据"| SRC["本地 Markdown 源码<br/>（本仓库）"] SRC -->|"hugo 构建（毫秒级）"| BUILD["静态 HTML / CSS / JS"] BUILD -->|"tar 打包 + scp 上传 + 原子替换"| SRV["腾讯云服务器<br/>Nginx 托管"] SRV -->|"Let's Encrypt HTTPS"| USER["访客<br/>zeseanblog.top"]</pre><h2 id="技术栈"><a href="#%e6%8a%80%e6%9c%af%e6%a0%88" class="header-anchor"></a>技术栈 </h2><table> <thead> <tr> <th>组件</th> <th>选择</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>静态站点生成器</td> <td>Hugo</td> <td>单二进制，构建速度极快</td> </tr> <tr> <td>主题</td> <td>Stack</td> <td>卡片式设计，简洁美观</td> </tr> <tr> <td>Web 服务器</td> <td>Nginx</td> <td>HTTP/2、gzip、静态资源缓存</td> </tr> <tr> <td>HTTPS</td> <td>Let&rsquo;s Encrypt</td> <td>免费证书，certbot 自动续期</td> </tr> <tr> <td>部署</td> <td>自研脚本</td> <td>构建 → 打包 → 上传 → 原子替换</td> </tr> <tr> <td>本地工具</td> <td>notes-ui（Flask）</td> <td>笔记上传 / 图片处理 / 分步发布 / 文章管理</td> </tr> </tbody> </table> <h2 id="配套工具notes-ui-笔记工作台"><a href="#%e9%85%8d%e5%a5%97%e5%b7%a5%e5%85%b7notes-ui-%e7%ac%94%e8%ae%b0%e5%b7%a5%e4%bd%9c%e5%8f%b0" class="header-anchor"></a>配套工具：notes-ui 笔记工作台 </h2><p>写笔记在本地编辑器，发布却要手工做一堆机械活：建目录、拷图片、改路径、拼 front matter、构建、部署、提交。notes-ui 把这条链路做成了只监听本机的 Web 界面：</p> <ul> <li><strong>导入</strong>：拖拽 <code>.md</code> 文件或整个笔记文件夹（图片自动带上），也可直接粘贴文本；自动剥离笔记自带的 front matter 并预填表单</li> <li><strong>图片处理</strong>：按正文引用自动匹配、拷入页面包 <code>images/</code>、统一改写路径，缺失的图片列清单可补传</li> <li><strong>发布流水线</strong>：生成页面包 → 构建验证 → 部署上线（二次确认、原子替换可回滚）→ 线上抽查（页面与图片 200 检查）→ git 提交，每步独立日志、可停在中途</li> <li><strong>文章管理</strong>：列出全部文章，支持编辑元数据、草稿开关、改 slug、本地预览（托管 <code>hugo server -D</code>）、删除进回收站</li> <li><strong>工程细节</strong>：零前端框架的原生单页界面；slug 实时查重；分类/标签全站自动补全；发布时间自动与最新文章错开</li> </ul> <p>技术上是一个单文件 Flask 应用（Python 标准库风格，唯一的第三方依赖就是 Flask 本身），通过 subprocess 编排 hugo / 部署脚本 / git，前端为原生 HTML/JS/CSS 单页，无构建步骤。</p> <h2 id="项目状态"><a href="#%e9%a1%b9%e7%9b%ae%e7%8a%b6%e6%80%81" class="header-anchor"></a>项目状态 </h2><p>已上线并稳定运行，持续更新学习笔记中；笔记发布日常已通过 notes-ui 完成。</p>