<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>工作流 on 123456的博客</title><link>https://www.chjyblog.xyz/tags/%E5%B7%A5%E4%BD%9C%E6%B5%81/</link><description>Recent content in 工作流 on 123456的博客</description><generator>Hugo -- gohugo.io</generator><language>zh-CN</language><lastBuildDate>Sat, 31 Oct 2026 21:00:00 +0800</lastBuildDate><atom:link href="https://www.chjyblog.xyz/tags/%E5%B7%A5%E4%BD%9C%E6%B5%81/index.xml" rel="self" type="application/rss+xml"/><item><title>从这里开始</title><link>https://www.chjyblog.xyz/p/start-here/</link><pubDate>Sat, 31 Oct 2026 21:00:00 +0800</pubDate><guid>https://www.chjyblog.xyz/p/start-here/</guid><description>&lt;p&gt;这是一个 Hugo + Stack 主题搭起来的博客骨架。这篇文章的作用是：三个月后你（或者帮你维护的人）回来看，能立刻知道每个文件是干什么的。&lt;/p&gt;&#10;&lt;h2 id="目录结构"&gt;&lt;a href="#%e7%9b%ae%e5%bd%95%e7%bb%93%e6%9e%84" class="header-anchor"&gt;&lt;/a&gt;目录结构&#10;&lt;/h2&gt;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 2&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 3&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 4&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 5&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 6&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 7&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 8&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 9&#10;&lt;/span&gt;&lt;span class="lnt"&gt;10&#10;&lt;/span&gt;&lt;span class="lnt"&gt;11&#10;&lt;/span&gt;&lt;span class="lnt"&gt;12&#10;&lt;/span&gt;&lt;span class="lnt"&gt;13&#10;&lt;/span&gt;&lt;span class="lnt"&gt;14&#10;&lt;/span&gt;&lt;span class="lnt"&gt;15&#10;&lt;/span&gt;&lt;span class="lnt"&gt;16&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;blog/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── config/_default/ # 站点配置，按职责拆成 4 个文件&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├── hugo.toml # 基础：域名、语言、永久链接&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├── params.toml # 主题参数：侧栏、卡片、组件&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├── menu.toml # 导航与社交图标&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├── markup.toml # Markdown 渲染 / 代码高亮&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └── related.toml # 相关文章排序权重&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── content/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├── post/ # 文章（每篇一个目录）&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ │ └── start-here/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ │ └── index.md # 只放正文；本站不用封面图&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └── page/ # 关于 / 归档 / 搜索 等固定页&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── assets/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├── scss/custom.scss # 所有视觉改动只写这里&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └── img/avatar.png&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;└── themes/stack/ # git submodule，不要改&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;h2 id="写一篇新文章"&gt;&lt;a href="#%e5%86%99%e4%b8%80%e7%af%87%e6%96%b0%e6%96%87%e7%ab%a0" class="header-anchor"&gt;&lt;/a&gt;写一篇新文章&#10;&lt;/h2&gt;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo new post/文章目录名/index.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;p&gt;生成后直接写正文。本站&lt;strong&gt;不用封面图&lt;/strong&gt;，front matter 里不要写 &lt;code&gt;image:&lt;/code&gt;——写了但图不存在，主题会把 &lt;code&gt;Featured image of post 标题&lt;/code&gt; 这串 alt 文字当内容显示在卡片上，看起来像多了一行标题。&lt;/p&gt;&#10;&lt;p&gt;用&lt;strong&gt;目录&lt;/strong&gt;而不是单个 &lt;code&gt;.md&lt;/code&gt; 文件，是为了让将来要放的文章配图跟着文章走——迁移、删除、备份都不会留下孤儿图。&lt;/p&gt;&#10;&lt;h2 id="图片要不要跟正文同目录"&gt;&lt;a href="#%e5%9b%be%e7%89%87%e8%a6%81%e4%b8%8d%e8%a6%81%e8%b7%9f%e6%ad%a3%e6%96%87%e5%90%8c%e7%9b%ae%e5%bd%95" class="header-anchor"&gt;&lt;/a&gt;图片要不要跟正文同目录&#10;&lt;/h2&gt;&lt;p&gt;Hugo 的图片处理（缩放、生成 &lt;code&gt;srcset&lt;/code&gt;、构建期取主色）只对&lt;strong&gt;页面资源&lt;/strong&gt;生效，也就是和 &lt;code&gt;index.md&lt;/code&gt; 同目录的文件。放在 &lt;code&gt;static/&lt;/code&gt; 里的图片会被原样拷贝，既不压缩也不生成多分辨率版本。&lt;/p&gt;&#10;&lt;p&gt;正文用图建议还是放同目录。几百张之后，更合理的做法是放到对象存储或图床，Markdown 里直接写完整 URL。&lt;/p&gt;&#10;&lt;h2 id="常用命令"&gt;&lt;a href="#%e5%b8%b8%e7%94%a8%e5%91%bd%e4%bb%a4" class="header-anchor"&gt;&lt;/a&gt;常用命令&#10;&lt;/h2&gt;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1&#10;&lt;/span&gt;&lt;span class="lnt"&gt;2&#10;&lt;/span&gt;&lt;span class="lnt"&gt;3&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo server -D &lt;span class="c1"&gt;# 本地预览，含草稿&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo --gc --minify &lt;span class="c1"&gt;# 生产构建到 public/&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo new post/xxx/index.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;构建产物在 &lt;code&gt;public/&lt;/code&gt;，已加入 &lt;code&gt;.gitignore&lt;/code&gt;。部署时把它同步到服务器即可，不需要在服务器上装任何运行时。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;h2 id="记一笔字数"&gt;&lt;a href="#%e8%ae%b0%e4%b8%80%e7%ac%94%e5%ad%97%e6%95%b0" class="header-anchor"&gt;&lt;/a&gt;记一笔字数&#10;&lt;/h2&gt;&lt;p&gt;中文写作时 Hugo 的 &lt;code&gt;.Summary&lt;/code&gt; 依赖 &lt;code&gt;hasCJKLanguage = true&lt;/code&gt;，已在 &lt;code&gt;hugo.toml&lt;/code&gt; 里打开。没开的话，摘要会按空格切词，中文会被当成一个超长单词处理，首页摘要全部失效。&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;配置项&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;作用&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;当前值&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;hasCJKLanguage&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;中文分词与字数统计&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;true&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;pagination.pagerSize&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;每页文章数&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;6&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;permalinks.post&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文章 URL 规则&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/p/:slug/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;改配色不要去动 &lt;code&gt;themes/stack&lt;/code&gt;，全部写在 &lt;code&gt;assets/scss/custom.scss&lt;/code&gt; 里——主题升级时你的改动不会被覆盖。&lt;/p&gt;&#10;</description></item></channel></rss>