HugoHTML作品集博客

sulv-hugo-papermod — Hugo 作品集模板

作者 xyming108

基于 Hugo PaperMod 修改的博客主题,仓库采用 MIT 许可,附带演示站点与建站教程链接。

看看你的网站会是什么样

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

3 个预览视图
桌面端首页1 / 3
桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

01

基于 Hugo PaperMod 主题修改,仓库采用 MIT 许可

02

提供在线演示站点,并有桌面端、移动端与内页截图

03

内置 bilibili、youtube、ppt、douban、innerlink、gallery 等 shortcodes

04

通过 git submodule 引入 themes/hugo-PaperMod 官方主题

05

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 时可能遇到的换行符转换问题及对应处理命令。

HugoHTML作品集博客

适合你的项目吗?

适用场景

  • 搭建个人博客站点
  • 作为 Hugo 博客主题的二次修改起点
  • 在文章中嵌入视频、PPT、豆瓣条目或图集等内容
  • 参考演示站点评估主题的页面布局

适合人群

  • 使用 Hugo 构建博客的开发者
  • 希望基于 PaperMod 做个性化调整的用户
  • 需要中文建站教程与 shortcode 示例的博客作者

上手与定制指南

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

  1. 1

    git clone 仓库后需执行 git submodule update --init 拉取 themes/hugo-PaperMod 子模块

  2. 2

    在项目目录运行 hugo server -D,浏览器访问 localhost:1313 预览

  3. 3

    模板内含较多个人信息字段,需按作者提供的建站教程逐项修改

  4. 4

    部署到 GitHub 若出现 LF/CRLF 换行符提示,可执行 git config core.autocrlf false

  5. 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 原文

{{< innerlink src="posts/tech/mysql_1.md" >}}

README 原文
https://github.com/xyming108/sulv-hugo-papermod/blob/main/LICENSEhttps://github.com/xyming108/sulv-hugo-papermod/blob/main/README.md

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`,解决换行符自动转换的问题。
反馈内容错误

看看同类模板

对比同技术栈与用途的模板,找到更适合的视觉与内容结构。