这是一个 Hugo + Stack 主题搭起来的博客骨架。这篇文章的作用是:三个月后你(或者帮你维护的人)回来看,能立刻知道每个文件是干什么的。
目录结构
| |
写一篇新文章
| |
生成后直接写正文。本站不用封面图,front matter 里不要写 image:——写了但图不存在,主题会把 Featured image of post 标题 这串 alt 文字当内容显示在卡片上,看起来像多了一行标题。
用目录而不是单个 .md 文件,是为了让将来要放的文章配图跟着文章走——迁移、删除、备份都不会留下孤儿图。
图片要不要跟正文同目录
Hugo 的图片处理(缩放、生成 srcset、构建期取主色)只对页面资源生效,也就是和 index.md 同目录的文件。放在 static/ 里的图片会被原样拷贝,既不压缩也不生成多分辨率版本。
正文用图建议还是放同目录。几百张之后,更合理的做法是放到对象存储或图床,Markdown 里直接写完整 URL。
常用命令
| |
构建产物在
public/,已加入.gitignore。部署时把它同步到服务器即可,不需要在服务器上装任何运行时。
记一笔字数
中文写作时 Hugo 的 .Summary 依赖 hasCJKLanguage = true,已在 hugo.toml 里打开。没开的话,摘要会按空格切词,中文会被当成一个超长单词处理,首页摘要全部失效。
| 配置项 | 作用 | 当前值 |
|---|---|---|
hasCJKLanguage | 中文分词与字数统计 | true |
pagination.pagerSize | 每页文章数 | 6 |
permalinks.post | 文章 URL 规则 | /p/:slug/ |
改配色不要去动 themes/stack,全部写在 assets/scss/custom.scss 里——主题升级时你的改动不会被覆盖。