用户手册

欢迎来到 HB （Hugo Bootstrap） 框架，很荣幸能吸引到你的注意。

本节内容

• 入门指南

  了解如何开始使用 HB。

  • 简介
    HB（Hugo Bootstrap）是一个模块化的框架，其构建于 Hugo 和 Bootstrap 之上。 HB 不是一个主题，而是用来建立一个主题的。
  • 先决条件
    HB 是一个功能丰富的框架，但同时也具有着一定的复杂性。本文将详细列出 HB 的环境要求，以便你可以正常地开发和使用 HB 模块和主题。
  • 安装

    我们提供了一个入门主题模板，以便你快速地创建一个 HB 站点。

  • 安装到已有站点

    本文介绍如何安装 HB 和模块到已有站点。

• 配置
  • 配置结构

    本文将尽量简单地介绍 Hugo 的配置结构。

  • 菜单配置

    本文介绍菜单的属性和如何设置菜单。

  • 多语言配置

    先前我们粗略地了解了 Hugo 的配置结构，接下来将介绍如何对多语言站点进行配置。

  • 图标配置
    图标搜索和使用指南。
• 内容
  • 创建内容

    内容是站点最基本，也是最核心的部分，本文将介绍内容的一些基本概念，以及如何创建内容。

  • Markdown 语法指南

    本文将提供一些能用于 Hugo 内容文件的 Markdown 的基础语法示例。

  • 短代码
    各种各样的段代码列表。
  • 表格
    在本指南中，你将学习如何配置和创建表格。
• 部署
  • 部署概览

    本文介绍关于部署的关键点。

  • 为 Hugo 站点创建 Docker 镜像

    本文描述了如何为 Hugo 站点创建 Docker 镜像，以便推送到容器注册中心，并部署于自搭建服务器、Docker Swarm 或 k8s 集群等。

  • 于 Cloudflare Pages 部署站点

    通过本文，你将学习到如何 Cloudflare Pages 上部署站点。

  • 于 Github Pages 部署站点

    本教程展示如何于 GitHub Pages 部署站点。

  • 于 Netlify 部署站点

    这篇文章包含了如何在 Netlify 上部署网站的分步说明。

• 用户进阶指南

  主题用户进阶指南。

  • 添加自定义 HTML 标记

    你可能希望包含自定义 HTML 标记，以扩展功能，这对于 HugoPress 内置钩子和 HB 自定义钩子来说小菜一碟。

  • 自定义脚本

    本文将描述如何添加自定义脚本。

  • 自定义样式

    HB 允许添加自定义样式和覆盖 Bootstrap 默认的 SCSS 变量。

• 问题排查
  已知问题清单和相应的解决方案。
• 观感
  • 仅开启暗色模式
    取消浅色和自动模式/主题，只保留适合自己口味的深色模式/主题是合理的。
• 加入我们

  很高兴你计划加入我们，我们感谢任何贡献。你可以通过以下方式支持这个项目。