欢迎使用 Compost 主题! 🎉
使用 Tailwind CSS 构建的简单、轻量级的 Hugo 主题。
Compost 是一个简单、轻量级的 Hugo 主题。主要基于 Congo 改造，并参考了 hugo-starter-tailwind-basic 等。
特性
- 样式基于 Tailwind CSS
4.x，在
assets/css/main.css中使用 CSS 优先（CSS-first）配置，由 Hugo 的css.TailwindCSS编译，并配合官方的 Typography 插件 。 - 可以使用
hugo命令直接构建和测试（使用了 #8343 中提到的一些技巧）。 - 🌐 特别为简体中文语言定制了文章样式（只在 html 的 lang 为 zh 时应用）。
- ✨ 使用 Hugo 内置功能自动调整图片大小，并添加原生延迟加载属性。
使用
需要 Hugo v0.166.0 或更高版本，以及 Node.js
（Tailwind CSS CLI 通过 npm 安装）。
- 在 Hugo 项目里指定主题为
github.com/canstand/compost，并且在hugo.toml里添加必要的配置：
# required: 合并主题的配置（Tailwind CSS 构建相关）
[build]
_merge = 'deep'
# required
[markup]
_merge = 'deep'
# for better seo
[minify]
_merge = 'deep'
[module]
[[module.mounts]]
source = 'assets'
target = 'assets'
# required: hugo_stats.json 是 Tailwind CSS 样式表的内容来源
[[module.mounts]]
source = 'hugo_stats.json'
target = 'assets/notwatching/hugo_stats.json'
disableWatch = true
[[module.imports]]
path = 'github.com/canstand/compost'
# required: 主题使用 Tailwind CSS CLI 编译样式表
[security]
[security.exec]
allow = [
'^(dart-)?sass$',
'^go$',
'^git$',
'^node$',
'^postcss$',
'^tailwindcss$',
]
- 安装或升级依赖：
hugo mod get -u
hugo mod npm pack
npm install
- 之后按正常开发与测试：
hugo server
二次开发
演示站点位于 exampleSite，它本身就是一个完整的 Hugo 项目，需要像普通站点一样安装依赖：
npm install
hugo mod npm pack --source exampleSite
npm install --prefix exampleSite
hugo server --source exampleSite
注意：如果修改了 package.hugo.json 中的依赖，需要重新执行
hugo mod npm pack --source exampleSite。