Hugo博客工具站

comfortable-basic — Hugo 博客模板

作者 freemagee

Comfortable Basic 是 freemagee 发布的极简 Hugo 博客主题，采用 MIT 许可，强调移动端适配与阅读体验，适合结构简单的个人博客。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

3 个预览视图

桌面端首页1 / 3

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

桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

极简 Hugo 博客主题，强调内容可读性与移动端适配

内容结构约定清晰：首页简介、about 页面与 post 文章目录

提供完整的 Hugo 站点 TOML 配置示例，含 params 与分类法设置

支持 Hugo 内置 Chroma 高亮，也可通过 useHighlightJS 切换到 Highlight.js

采用 MIT 许可，允许免费使用、修改、商用与分发

模板详细介绍

Comfortable Basic 是一个面向博客类站点的 Hugo 主题，仓库描述为“Minimal Hugo blog theme”，README 说明其目标是现代、简洁，并强调可读性与移动端友好。主题内容结构建议为首页 _index.md 作为站点顶部简介、about 目录存放关于页、post 目录存放全部 Markdown 文章，整体面向“文章 + 关于页”的简单博客形态。

主题提供示例 Hugo 站点配置（TOML），包含 baseURL、languageCode、title、paginate、theme，以及 params 下的 description、metaDescription、author、authorWebsite、titleSeperator、useHighlightJS，并配置 category 与 tag 两个分类法。README 提到主题内置 Hugo 的 Chroma 语法高亮，同时可选用 Highlight.js 作为替代，通过 useHighlightJS 开关控制；启用 Highlight.js 会引入额外 JavaScript 与字体，使主题体积增加，关闭后可减少约 90KB。README 的 TODO 列出尚未实现的功能：可选 logo 支持、图片类型文章、多页面处理，说明这些能力当前不在主题范围内。

Hugo博客工具站

适合你的项目吗？

适用场景

搭建以文章列表和关于页为主的个人博客
需要一个结构简单、便于直接修改的 Hugo 主题起点
希望用 Hugo 内置语法高亮，或按需切换到 Highlight.js 的站点
以 Markdown 写作、通过 post 目录组织全部文章的内容站点

适合人群

使用 Hugo 并希望快速起步的个人博客作者
偏好极简排版、以文字内容为主的站点
能接受手动配置主题参数、按约定组织 content 目录的用户
需要 MIT 许可下可自由修改与分发的博客主题的开发者

上手与定制指南

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

1
在 Hugo 站点根目录执行 cd themes && git clone https://github.com/freemagee/comfortable-basic 完成安装
2
在站点配置中设置 theme = "comfortable-basic"，并按 README 示例填写 baseURL、title、paginate 等字段
3
按约定组织 content 目录：根 _index.md 作为首页简介，about/_index.md 作为关于页，post 目录存放文章
4
如需关闭 Highlight.js 并改用 Hugo 内置高亮，将 params.useHighlightJS 设为 false
5
仓库 TODO 中列出的 logo 支持、图片类型文章与多页面处理尚未实现，使用前需自行评估

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

启用 Highlight.js 会引入额外 JavaScript 与字体，使主题体积增大；可通过 useHighlightJS = false 关闭以减小体积。
Highlight.js 为可选功能，需在主题配置中设置 useHighlightJS 开关；关闭后改用 Hugo 内置 Chroma 高亮。
README 的 TODO 表明可选 logo 支持、图片类型文章与多页面处理尚未实现，当前不在主题功能范围内。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

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

This unfortunately has bumped the theme file size up with the extra JavaScript, and some additional fonts.
README 原文

A flag has been added to the theme config `useHighlightJS = true` that can be set to false to disable *Highlightjs* and just use Hugo's default syntax highlighting.
README 原文

- [ ] Optional logo support - [ ] Add image type posts - [ ] Handle multiple pages
README 原文

https://github.com/freemagee/comfortable-basic/blob/master/LICENSE.md https://github.com/freemagee/comfortable-basic/blob/master/README.md

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

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料一般 · 62 / 100
技术栈: Hugo
网站类型: 博客 · 工具站

这个分数如何计算

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

这个项目需要核对什么

记录的仓库更新时间: 2023-01-04
截图检查日期: 2026-10-02

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: d6a56de9bcb4f3d5028f35cb2a8d6afa90d348511be25a6ca7ca2fea0791d7c6

2026-10-02T21:19:10.848Z

来源文件 / 仓库

# Comfortable Basic

Comfortable Basic is a modern, simple Hugo theme. Intended for a blog like site.

View: [Demo using hugoBasicExample](https://freemagee.github.io/comfortable-basic/)

![Screenshot](https://github.com/freemagee/comfortable-basic/raw/master/images/screenshot.png)

## Features

- Mobile friendly
- Emphasis on readability
- Lightweight(ish) see [notes](#notes)

## Installation

Inside the folder of your Hugo site run:

```bash
$ cd themes
$ git clone https://github.com/freemagee/comfortable-basic
```

*For more information read the official [setup guide](https://gohugo.io/overview/installing/) of Hugo.*

## Example HUGO site config toml

```toml
baseURL= "https://example.com"
languageCode= "en-gb"
title= "Example Site"
paginate = 3
theme = "comfortable-basic"
pluralizeListTitles = false
pygmentsUseClasses = true

[params]
  description = "This is a website!"
  metaDescription = "Used as 'description' meta tag for both home and index pages. If not set, 'description' will be used instead"
  author = "SOMEGUY"
  authorWebsite = "https://example.com"
  titleSeperator = "/"
  useHighlightJS = true

[taxonomies]
  category = "categories"
  tag = "tags"
```

### Content Architecture Example

This theme is meant for a simple blog with posts and a about page. To get the most from it is recommended to structure your **content** folder like this:

```
+---content
    |   _index.md # This is the intro, it will appear at the
    |               top of the site on the homepage only
    |
    +---about
    |       _index.md # This is the about page content
    |
    \---post
            # all markdown posts
```

Simple as that.

## Notes

Recently added some better code syntax highlighting. Hugo has really good built-in highlighting using [Chroma](https://gohugo.io/content-management/syntax-highlighting/). Ran into some formatting issues with some code and extra white space being added. So have added [Highlightjs](https://highlightjs.org/) as an alternative. This unfortunately has bumped the theme file size up with the extra JavaScript, and some additional fonts. So that is why Comfortable Basic is lightweight(ish) at around > 300kb.

**Performance update**
A flag has been added to the theme config `useHighlightJS = true` that can be set to false to disable *Highlightjs* and just use Hugo's default syntax highlighting. This can save about 90Kb.

### TODO

- [ ] Optional logo support
- [ ] Add image type posts
- [ ] Handle multiple pages

反馈内容错误