Hugo文档

hugo-theme-plume — Hugo 文档模板

作者 Dobefu

Plume 是一个基于 Hugo 的轻量级文档主题，不依赖外部资源，支持响应式布局、自动深色模式、代码高亮、搜索与多语言。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

2 个预览视图

桌面端首页1 / 2

访问演示网站在新标签页打开

桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 2

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-03查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

不依赖任何外部依赖，安装后无需额外前端构建链

响应式布局，并提供移动端导航

自动深色模式与代码语法高亮

内置目录（TOC）、搜索与多语言（i18n）支持

支持 Web app manifest 与 SEO 相关配置

可通过 Hugo Module 或 Git Submodule 两种方式接入

模板详细介绍

Plume 是一个面向文档站点的 Hugo 主题，定位为轻量且不引入外部依赖。它提供响应式布局、自动深色模式、代码语法高亮、移动端导航、目录（TOC）、搜索、多语言（i18n）以及 Web app manifest 等能力，可用于搭建以内容阅读为主的文档站点。

安装方式有两种：作为 Hugo Module 引入，或作为 Git Submodule 放到 themes/plume 目录。主题通过 hugo.toml 配置，README 给出了目录层级、代码高亮、Goldmark 扩展（删除线、mark、插入、上下标、passthrough 等）的示例配置。

Hugo文档

适合你的项目吗？

适用场景

为开源项目搭建文档站点
编写产品使用手册或知识库
需要多语言与站内搜索的文档站
希望主题不引入外部依赖、便于长期维护的静态站点

适合人群

使用 Hugo 构建静态站点的开发者
需要轻量文档主题、不想引入外部依赖的团队
需要多语言文档与站内搜索的项目
接受通过 hugo.toml 配置主题行为的用户

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
新建站点：hugo new site mysite，进入目录后执行 hugo mod init 与 hugo mod get github.com/Dobefu/hugo-theme-plume
2
已有站点可作为 Hugo Module 引入，或在站点根目录执行 git submodule add https://github.com/Dobefu/hugo-theme-plume.git themes/plume
3
在 hugo.toml 中通过 [module] 的 module.imports 引入主题，或设置 theme = "plume"
4
按 README 示例配置 markup.tableOfContents、markup.highlight 与 markup.goldmark 扩展
5
主题采用 MIT 许可，分发时保留版权与许可声明；演示图片、字体、图标等第三方素材需单独核对许可

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

https://github.com/Dobefu/hugo-theme-plume/blob/main/LICENSE https://github.com/Dobefu/hugo-theme-plume/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-03。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: Hugo Themes
资料与维护参考分: 资料较完整 · 83 / 100
技术栈: Hugo
网站类型: 文档

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2025-12-02
截图检查日期: 2026-10-03

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: [email protected] · 2026-10-04

查看当时使用的来源资料

SHA-256: 653be928e19046ef48fdc7d4c469ae111555bd37398e54614629929e5a00e434

2026-10-03T13:44:16.135Z

来源文件 / 仓库

# Plume

A lightweight Hugo documentation theme without any external dependencies.

![Screenshot](https://github.com/Dobefu/hugo-theme-plume/blob/main/images/screenshot.png?raw=true)

## Features

- [x] Zero dependencies
- [x] Responsive design
- [x] Automatic dark mode
- [x] Syntax highlighting
- [x] Mobile navigation
- [x] Table of contents
- [x] SEO optimisation
- [x] Multi-language support (i18n)
- [x] Web app manifest
- [x] Search

## Installation (new site)

Create a new Hugo site with Plume:

```bash
hugo new site mysite
cd mysite
hugo mod init github.com/<username>/<site>
hugo mod tidy
hugo mod get github.com/Dobefu/hugo-theme-plume
```

Add to your `hugo.toml`:

```toml
[module]
  [[module.imports]]
    path = "github.com/Dobefu/hugo-theme-plume"
```

## Installation (existing site)

### As a Hugo Module

```bash
hugo mod init github.com/<username>/<site>
hugo mod tidy
hugo mod get github.com/Dobefu/hugo-theme-plume
```

Add to your `hugo.toml`:

```toml
[module]
  [[module.imports]]
    path = "github.com/Dobefu/hugo-theme-plume"
```

### As a Git Submodule

```bash
git submodule add https://github.com/Dobefu/hugo-theme-plume.git themes/plume
```

Add to your `hugo.toml`:

```toml
theme = "plume"
```

## Configuration

To configure the theme, update the `hugo.toml` file with the following:

```toml
[module]
  [[module.imports]]
    path = "github.com/Dobefu/hugo-theme-plume"

[markup]
  [markup.tableOfContents]
    startLevel = 2
    endLevel = 4

  [markup.highlight]
    lineNos = true
    noClasses = false

  [markup.goldmark]
    [markup.goldmark.extensions]
      strikethrough = false

      [markup.goldmark.extensions.extras]
        delete.enable = true
        mark.enable = true
        insert.enable = true
        subscript.enable = true
        superscript.enable = true

      [markup.goldmark.extensions.passthrough]
        enable = true

        [markup.goldmark.extensions.passthrough.delimiters]
          block = [['\[', '\]']]
          inline = [['\(', '\)']]

```

## License

MIT License - see [LICENSE](LICENSE) for details.

反馈内容错误