Hugo 主题

上一页/下一页： 所有主题

mini

一个快速、简约且响应式的 Hugo 博客主题。

下载
mini

Hugo 主题 Mini

英语 | 简体中文

一个快速、简约且响应式的 Hugo 主题。

./images/screenshot.png

  • 在线演示
  • 示例站点源码

特性

  • 快速
  • 简约
  • 响应式
  • 归档
  • 标签

1. 安装

⚠️ 如果您安装了 Hugo 二进制文件，您的机器可能没有安装 Go。要检查是否安装了 Go

$ go version

Go 模块在 v1.14 中被认为是生产就绪的。下载 Go。

  1. 在您的项目的根目录中，如果您尚未初始化，请初始化 Hugo 模块系统

    $ hugo mod init github.com/<your_user>/<your_project>

  2. 将主题的存储库添加到您的 config.yaml

    theme: 
   - github.com/nodejh/hugo-theme-mini

1.2 作为 Git 子模块

  1. 在您的 Hugo 站点文件夹中运行

    $ git submodule add https://github.com/nodejh/hugo-theme-mini.git themes/mini

  2. 将主题的目录添加到您的 config.yaml

    theme: mini

有关更多信息，请阅读 Hugo 的官方设置指南。

2. 入门

成功安装主题后，还需要几个步骤才能使您的站点运行。

2.1 配置文件

查看此主题的 exampleSite 文件夹。您会找到一个名为 config.yaml 的文件。要使用它，请将 config.yaml 复制到您的 Hugo 站点的根文件夹中。随意更改此主题中的字符串。

⚠️ 您可能需要删除以下行：themesDir: ../../

2.2 默认内容语言

您可以通过 defaultContentLanguage 设置默认内容语言

defaultContentLanguage: en

默认为 en。现在支持

  • en：英语
  • zh：中文
  • nl：荷兰语
  • fr：法语
  • es：西班牙语
  • da：丹麦语

更多关于多语言的信息：多语言模式。

2.3 添加评论

要启用评论，请将以下内容添加到您的配置文件中

  • Disqus 短名称：disqusShortname: your-disqus-shortname

  • 启用评论

    params:
  enableComments: true

2.4 Google Analytics

要启用 Google Analytics，请将以下内容添加到您的配置文件中

  • Google Analytics ID：googleAnalytics: your-google-analytics-id

  • 启用 Google Analytics

    params:
  enableGoogleAnalytics: true

2.5 Logo 和 favicon

您可以使用自己的图像替换每个页面顶部的日志和网站图标。为此，请将您自己的 logo 和网站图标放入您网站静态目录的 images 目录中，然后将其命名为 avatar.png 和 favicon.ico。例如

- content
- static
└── images
    ├── avatar.png
    └── favicon.ico

2.6 几乎完成

为了查看您的站点运行情况，请运行 Hugo 的内置本地服务器。

$ hugo server

现在在浏览器的地址栏中输入 https://#:1313。

2.7 生产环境

要在生产环境中运行（例如，要让 Google Analytics 显示出来），请在构建命令之前运行 HUGO_ENV=production。例如

HUGO_ENV=production hugo

注意：上述命令在 Windows 上不起作用。如果您运行的是 Windows 操作系统，请使用以下命令

set HUGO_ENV=production
hugo

3. 可选配置

3.1 内容目录

要启用内容目录，您可以将 showToc 设置为 true。

例如

showToc: true

3.2 禁用单个帖子上的评论

您可以在 front matter 中将 enableComments 设置为 false，以禁用单个帖子上的 Disqus 评论。

例如

---
title: Some title
enableComments: false
---

3.3 自定义 CSS 和 JS

你可以将自定义的 CSS 和 JS 文件放到 static 目录中，或者使用以 http:// 或 https:// 开头的远程 CSS 和 JS 文件。

例如

customCSS:
  - css/custom.css # local css in `static/css/custom.css`
  - https://example.com/custom.css # remote css
customJS:
  - js/custom.js # local js in `static/js/custom.js`
  - https://example.com/custom.js # remote js

3.4 数学公式排版

KaTeX 启用了数学符号。

  • 要全局启用 KaTex，请在项目的配置中将参数 math 设置为 true
  • 要在每个页面上启用 KaTex，请在内容文件中将参数 math 设置为 true

3.5 在主页中隐藏文章摘要

要在主页中隐藏文章摘要，您可以将 hiddenPostSummaryInHomePage 设置为 true，默认值为 false。

例如

hiddenPostSummaryInHomePage: true

许可证

MIT

另请参阅