用戶手冊

歡迎來到 HB （Hugo Bootstrap） 框架，很榮幸能吸引到你的注意。

本節內容

• 入門指南

  瞭解如何開始使用 HB。

  • 簡介
    HB（Hugo Bootstrap）是一個模塊化的框架，其構建於 Hugo 和 Bootstrap 之上。 HB 不是一個主題，而是用來建立一個主題的。
  • 先決條件
    HB 是一個功能豐富的框架，但同時也具有着一定的複雜性。本文將詳細列出 HB 的環境要求，以便你可以正常地開發和使用 HB 模塊和主題。
  • 安裝

    我們提供了一個入門主題模板，以便你快速地創建一個 HB 站點。

  • 安裝到已有站點

    本文介紹如何安裝 HB 和模塊到已有站點。

• 配置
  • 配置結構

    本文將盡量簡單地介紹 Hugo 的配置結構。

  • 多語言配置

    先前我們粗略地瞭解了 Hugo 的配置結構，接下來將介紹如何對多語言站點進行配置。

  • 菜單配置

    本文介紹菜單的屬性和如何設置菜單。

  • 圖標配置
    圖標搜索和使用指南。
• 內容
  • 創建內容

    內容是站點最基本，也是最核心的部分，本文將介紹內容的一些基本概念，以及如何創建內容。

  • Markdown 語法指南

    本文將提供一些能用於 Hugo 內容文件的 Markdown 的基礎語法示例。

  • 短代碼
    各種各樣的段代碼列表。
  • 表格
    在本指南中，你將學習如何配置和建立表格。
• 部署
  • 部署概覽

    本文介紹關於部署的關鍵點。

  • 於 Cloudflare Pages 部署站點

    通過本文，你將學習到如何 Cloudflare Pages 上部署站點。

  • 於 Github Pages 部署站點

    本教程展示如何於 GitHub Pages 部署站點。

  • 於 Netlify 部署站點

    這篇文章包含了如何在 Netlify 上部署網站的分步說明。

  • 爲 Hugo 站點創建 Docker 鏡像

    本文描述瞭如何爲 Hugo 站點創建 Docker 鏡像，以便推送到容器註冊中心，並部署於自搭建服務器、Docker Swarm 或 k8s 集羣等。

• 用戶進階指南

  主題用戶進階指南。

  • 自定義腳本

    本文將描述如何添加自定義腳本。

  • 自定義樣式

    HB 允許添加自定義樣式和覆蓋 Bootstrap 默認的 SCSS 變量。

  • 添加自定義 HTML 標記

    你可能希望包含自定義 HTML 標記，以擴展功能，這對於 HugoPress 內置鉤子和 HB 自定義鉤子來說小菜一碟。

• 問題排查
  已知問題清單和相應的解決方案。
• 加入我們

  很高興你計劃加入我們，我們感謝任何貢獻。你可以通過以下方式支持這個項目。

• 觀感
  • 僅開啟暗色模式
    取消淺色和自動模式/主題，只保留適合自己口味的深色模式/主題是合理的。