基于 Hugo PaperMod 主题修改,仓库采用 MIT 许可
sulv-hugo-papermod — Hugo 作品集模板
作者 xyming108
基于 Hugo PaperMod 修改的博客主题,仓库采用 MIT 许可,附带演示站点与建站教程链接。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
提供在线演示站点,并有桌面端、移动端与内页截图
内置 bilibili、youtube、ppt、douban、innerlink、gallery 等 shortcodes
通过 git submodule 引入 themes/hugo-PaperMod 官方主题
README 附带作者建站教程链接与常见问题处理说明
模板详细介绍
sulv-hugo-papermod 是博主在 Hugo PaperMod 主题基础上修改而来的博客主题,仓库以 MIT 许可发布,作者的个人网站 https://www.sulvblog.cn 即使用该主题。项目提供在线演示(https://xyming108.github.io/),桌面端与移动端首页、文章列表页均有实际截图可参考。
主题以 Hugo 为构建工具,仓库中通过 git submodule 引入 themes/hugo-PaperMod 下的官方主题,因此拉取代码后需要额外初始化子模块才能正常构建。README 说明本地预览使用 hugo server -D 命令,在 localhost:1313 查看效果。
主题内置若干自定义 shortcodes,包括 bilibili、youtube、ppt、douban、innerlink(文章内链卡片,需填写相对路径且以 .md 结尾)以及 gallery(配合 figure 使用)。模板中包含较多个人信息字段,需要使用者自行逐项修改,作者提供了建站教程链接作为参考。README 还记录了部署到 GitHub 时可能遇到的换行符转换问题及对应处理命令。
适合你的项目吗?
适用场景
- 搭建个人博客站点
- 作为 Hugo 博客主题的二次修改起点
- 在文章中嵌入视频、PPT、豆瓣条目或图集等内容
- 参考演示站点评估主题的页面布局
适合人群
- 使用 Hugo 构建博客的开发者
- 希望基于 PaperMod 做个性化调整的用户
- 需要中文建站教程与 shortcode 示例的博客作者
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
git clone 仓库后需执行 git submodule update --init 拉取 themes/hugo-PaperMod 子模块
- 2
在项目目录运行 hugo server -D,浏览器访问 localhost:1313 预览
- 3
模板内含较多个人信息字段,需按作者提供的建站教程逐项修改
- 4
部署到 GitHub 若出现 LF/CRLF 换行符提示,可执行 git config core.autocrlf false
- 5
演示图片、字体、图标等第三方素材需按各自许可单独核对
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 该主题是基于 Hugo PaperMod 主题修改的衍生作品,使用时需同时遵守上游 PaperMod 主题的许可条款。
- 仓库通过 git submodule 引入 themes/hugo-PaperMod 官方主题,克隆后必须执行 git submodule update --init 才能正常构建。
- 模板内含大量作者个人信息字段,使用者需自行逐项修改后才能用于自己的站点。
- 配置说明依赖作者外部网站上的建站教程,该教程为站外资源,可用性不受本仓库控制。
- innerlink shortcode 只能填写相对路径且路径末尾必须带 .md,否则无法正确生成文章内链卡片。
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
该主题根据Hugo PaperMod主题修改而来
README 原文
输入`git submodule update --init`,表示拉取themes/hugo-PaperMod/下的子模块
README 原文
模板内部有许多个人信息需要自己配置,请耐心修改完
README 原文
可以参考博主的建站教程:[https://www.sulvblog.cn/posts/blog/](https://www.sulvblog.cn/posts/blog/)
README 原文
https://github.com/xyming108/sulv-hugo-papermod/blob/main/LICENSEhttps://github.com/xyming108/sulv-hugo-papermod/blob/main/README.md{{< innerlink src="posts/tech/mysql_1.md" >}}
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-02。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 81 / 100
- 技术栈
- Hugo · HTML
- 网站类型
- 作品集 · 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2024-02-22
- 截图检查日期
- 2026-10-02
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
已完成服务器许可规则与 AI 来源核对;未经过人工编辑审核。
查看当时使用的来源资料
SHA-256: e9a39632d1a375cad7471cee56fd5203c9781534faf1f8f142b37a75f9e2d537
2026-10-02T16:21:30.301Z
来源文件 / 仓库语言:中文 | [English](https://github.com/xyming108/sulv-hugo-papermod/blob/main/static/README_EN.md)
> 该主题根据Hugo PaperMod主题修改而来: https://github.com/adityatelange/hugo-PaperMod
### [博客DEMO](https://xyming108.github.io/)
## 1. git clone 拉取代码
① 用`git clone`的方式拉取代码至桌面,此时会在桌面生成sulv-hugo-papermod目录
② 进入到sulv-hugo-papermod目录,输入`git submodule update --init`,表示拉取themes/hugo-PaperMod/下的子模块,里面放的是官方主题
## 2. 启动界面
③ 把目录定位到sulv-hugo-papermod下,在终端输入`hugo server -D`,在浏览器输入:localhost:1313 即可看到现成的博客模板。
## 3. 修改信息
模板内部有许多个人信息需要自己配置,请耐心修改完,可以参考博主的建站教程:[https://www.sulvblog.cn/posts/blog/](https://www.sulvblog.cn/posts/blog/)
## 4. Hugo博客交流群
🎉🎉 787018782 🎉🎉
## 5. shortcodes使用方法
`bilibili: {{< bilibili BV1Fh411e7ZH(填 bvid) >}}`
`youtube: {{< youtube w7Ft2ymGmfc >}}`
`ppt: {{< ppt src="网址" >}}`
`douban: {{< douban src="网址" >}}`
```
# 文章内链卡片
# 末尾要加 md,只能填写相对路径,如下
{{< innerlink src="posts/tech/mysql_1.md" >}}
```
```
gallery:
{{< gallery >}}
{{< figure src="https://www.sulvblog.cn/posts/read/structural_thinking/0.png" >}}
{{< figure src="https://www.sulvblog.cn/posts/read/structural_thinking/0.png" >}}
{{< /gallery >}}
```
## 5. 可能遇到的问题
1. 有些使用者会部署到github,可能遇到跨系统的问题,如提示`LF will be replaced by CRLF in ******`,这时输入命令:`git config core.autocrlf false`,解决换行符自动转换的问题。看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

hugo-PaperMod
PaperMod 是 Hugo 生态里知名度较高的主题之一,定位很明确:给博客和轻量作品集站点提供一套干净、响应式的阅读界面。
Hugo · 作品集

LoveIt
❤️A clean, elegant but advanced blog theme for Hugo 一个简洁、优雅且高效的 Hugo 主题
Hugo · 博客

hugo-coder
A minimalist blog theme for hugo.
Hugo · 博客

blowfish
Personal Website & Blog Theme for Hugo
Hugo · 博客

hugo-paper
🪺 A simple, clean, customizable Hugo theme
Hugo · 博客

hextra
Hextra 是一个 Hugo 主题,定位在文档站与博客之间:既提供侧边栏导航、目录、面包屑、分页这类文档站结构,也能承载博客内容。
Hugo · 文档
