文檔 on Hugo Bootstrap

打賞小部件

Sun, 29 Jan 2023 19:44:19 +0800

打賞小部件，又稱 buy me a coffee 小部件，其通過使用捐贈或小費，為讀者提供了一種支持創作者的筦道。

Algolia

Sun, 27 Nov 2022 19:53:12 +0800

The client search will become slower and slower with the content grows, it’s reasonable to have a remote search service to handle search requests from a large site.

Algolia is a popular search service that provides free plan (10k records, 10k requests per month). After reading this article, you will learn how to configure Algolia and automatically upload index files.

IFrame Shortcode

Sat, 19 Nov 2022 13:00:48 +0800

A detailed description of iframe shortcode.

遊戲 Shortcode

Tue, 15 Nov 2022 21:16:48 +0800

A detailed description of game shortcode.

落地頁佈局

Thu, 15 Sep 2022 10:46:23 +0800

In this article, we’ll talk about the landing page layout, you may be interested in it if you’re going to customizing the pages in Markdown way.

Repository Widget

Fri, 09 Sep 2022 21:06:19 +0800

The repository widget shows the commit information about current page, it’s useful for users to view or edit the source code.

部署概覽

Wed, 27 Jul 2022 18:00:25 +0800

在本節中，我們將談論部署的關鍵點，以避免部署期間的大多數問題。

布局覆蓋

Wed, 27 Jul 2022 16:05:37 +0800

根據 Hugo Layouts Lookup Order，可以很容易地覆蓋 Hugo 和主題的布局和模板。這對那些想自定義某些特定布局或參數的用戶來說很有用。

粘性小部件

Wed, 27 Jul 2022 08:54:43 +0800

當頁面太長時，側邊欄會隨著滾動而消失，頁面看起來就不那麽整潔美觀了。所以本文將介紹如何使用粘性部件來避免這個問題。

多語言

Wed, 27 Jul 2022 08:06:06 +0800

HBS 支持多種語言，如英語、簡體中文、繁體中文、法語和俄語等。

PurgeCSS

Mon, 25 Jul 2022 12:06:00 +0800

PurgeCSS 是一個很棒的工具，可以從你的網站上刪除未使用的 CSS。在本節中，我們將深入探討 PurgeCSS 是如何工作的，以及我們應該註意什麽。

性能

Sat, 23 Jul 2022 18:30:48 +0800

本文我們來探討下如何提高站點的性能。

事件

Sat, 23 Jul 2022 17:33:59 +0800

本文列出一些主題觸發的一些事件，你可以通過事件監聽器來捕獲這些事件。

SCSS 變量

Sat, 23 Jul 2022 17:23:28 +0800

感謝 assets/main/scss/_variables.scss，我們可以更改主題和 Bootstrap 的默認 SCSS 變量。

文本 Shortcodes

Fri, 15 Jul 2022 01:00:43 +0800

在本文中，我們將探討文本的一些短代碼，例如文本的對齊、轉換和選擇。

構建 Docker 鏡像

Wed, 13 Jul 2022 10:30:29 +0800

本文將詳細介紹如何構建 Docker 鏡像。

部署於 GitHub Pages

Wed, 13 Jul 2022 10:30:23 +0800

本文將介紹如何使用 GitHub Actions 部署站點到 GitHub Pages。

部署於 Cloudflare Pages

Tue, 12 Jul 2022 20:06:24 +0800

本文將介紹於 Cloudflare Pages 上部署站點。

部署於 Netlify

Tue, 12 Jul 2022 14:20:49 +0800

本文將介紹如何部署站點於 Netlify。

Snackbar

Sat, 02 Jul 2022 21:14:37 +0800

相信使用過代碼塊復製按鈕的用戶，對 Snackbar 並不陌生，其告知用戶應用程序執行的結果。本文將舉例說明如何使用 Snackbar，以滿足用戶對自定義交互的需要。

升級

Sat, 25 Jun 2022 22:15:02 +0800

本文將介紹如何正確地升級主題版本。

Code Toggle

Mon, 13 Jun 2022 16:54:28 +0800

The code-toggle shortcode generates code blocks of various formats according to the configuration code of any supported format.

先決條件

Mon, 13 Jun 2022 16:32:09 +0800

在安裝主題前，請確保你滿足先決條件。

簡介

Mon, 13 Jun 2022 16:32:09 +0800

Hugo Bootstrap Theme(HBS) 是壹個快速、響應式、多用途和功能豐富的 Hugo 主題。其通常用於博客和文檔站點。

通過 via Hugo Module 安裝

Sat, 26 Feb 2022 17:10:39 +0200

This article refers to the modern, up-to-date installation method of installing the theme locally as Hugo module.

Proxy (Optional)

If you’re located at China mainland without VPN, the Hugo module download may fail.

There are two proxies for this: GOPROXY.CN and GOPROXY.IO.

1$ export HUGO_MODULE_PROXY=https://goproxy.cn

Please note that, Hugo doesn’t respect the GOPROXY env var, please use HUGO_MODULE_PROXY instead.

You can also set the module.proxy instead of using env var.

Docs 佈局

Wed, 12 Jan 2022 10:56:34 -0800

在本文中，我們將探討 docs 佈局，其可用來編寫項目文檔，個人筆記等。

菜單

Thu, 16 Dec 2021 17:25:20 +0800

我們預定義了兩種類型的菜單：main 和 footer，分別表示頂部的應用程序欄菜單和頁腳菜單。本文將簡要介紹如何使用菜單。

FAQ 頁面

Tue, 07 Dec 2021 21:46:43 +0800

FAQ 頁面是一個常見問題的集合。

通過 Git Submodule 安裝

Sat, 04 Dec 2021 10:43:39 +0800

This article refers to the traditional installation method of cloning the theme locally as Git submodule. While this installation method is still widely used, we recommend to install the theme as Hugo module.

從頭開始創建站點

1$ git clone https://github.com/razonyang/hugo-theme-bootstrap-skeleton myblog
2$ cd myblog
3$ git submodule add https://github.com/razonyang/hugo-theme-bootstrap themes/hugo-theme-bootstrap
4$ sed -i "s/theme:.*/theme: hugo-theme-bootstrap/g" config/_default/config.yaml
5$ rm go.mod go.sum
6$ hugo mod npm pack
7$ npm install
8$ hugo server

如果你使用的是 Windows，請改用 xcopy .\themes\hugo-theme-bootstrap\exampleSite /E。

添加內容

Sat, 04 Dec 2021 10:43:39 +0800

主要 Sections

mainSections 參數用於過濾頁面，默認為 ["posts", "docs"]。

1mainSections = ["blog", "posts", "docs", "notes"]

Front Matter

Front Matter is the place where we put page metadata and parameters, such as title, date and so on.

Formats

Hugo supports three formats of front matter: YAML, TOML and JSON.

快速入門

Sat, 04 Dec 2021 10:43:39 +0800

圖片查看器

Fri, 03 Dec 2021 20:46:50 +0800

Image viewer is an image gallery, it will be shown up when you click a non-linkable image.

It also provides many tools, such as zoom in, zoom out and rotate.

觀感

Fri, 03 Dec 2021 19:42:57 +0800

默認情况下，使用此主題的網站具有預設字體、顏色和總體外觀。但是，默認方案不可能滿足所有人的要求，但是不要擔心，你可以輕鬆地覆蓋主題預設值，例如調色板顏色、字體、語法高亮。

漸進式 web 應用程序

Fri, 03 Dec 2021 19:39:01 +0800

PWAs(漸進式 web 應用程序) 是使用一些特定的科技和標準模式開發的，允許它們同時利用 web 和本機應用程序功能。

HBS 提供了一些基本的特性，如將網站安裝到主荧幕、預緩存檔案和離線可用。

搜索頁面

Fri, 03 Dec 2021 11:16:51 +0800

如果您的網站中有許多文章，讀者可能很難檢索到文章，因此，我們添加了搜索功能。

歸檔頁面

Fri, 03 Dec 2021 11:16:51 +0800

歸檔頁面按照年份對文章進行歸檔。

打賞小部件

Fri, 03 Dec 2021 11:10:19 +0800

打賞小部件，又稱buy me a coffee小部件，其通過使用捐贈或小費，為讀者提供了一種支持創作者的筦道。

然而其只能用於二維碼收款，其他請移步 funding widget。

作者小部件

Fri, 03 Dec 2021 11:10:19 +0800

作者小部件位於側邊欄，用於簡要地自我介紹。

社交連結

Thu, 02 Dec 2021 16:27:45 +0800

社交連結social參數是一組平臺映射到用戶標識的鍵值對。其支持很多熱門的社交平臺，比如Twitter、Facebook、Reddit、GitHub。本文列出了所有受支持的平臺，及其使用方法。

聯繫表單

Tue, 30 Nov 2021 23:56:00 +0800

我們可以將郵寄地址放在社交連結上，以便讀者聯繫我們。但不幸的是，郵件或多或少會被當成垃圾郵件，甚至被過濾。因此我們帶來了一個聯系表單的功能。

自定義資源

Sun, 28 Nov 2021 16:00:56 +0800

作為一個可定制的主題，其提供了定制資源的能力，無論是定制 CSS 和 JS，還是引入第三方 CSS 和 JS。

鉤子

Sat, 27 Nov 2021 21:04:35 +0800

作為一個靈活的主題，它應該能够自定義程式碼和集成協力廠商服務。因此，我們帶來了一個叫做鉤子的特性。

在本文中，我們將介紹所有鉤子並提供一些用例。

參與我們

Sat, 27 Nov 2021 19:54:29 +0800

我們很樂意傾聽你的意見和反饋，也歡迎你參與進來。

評論小部件

Sat, 27 Nov 2021 19:54:29 +0800

Disqus、Utterances 和 Giscus 評論小部件都是開箱即用的。本文將展示如何配置它們，甚至自定義你自己的評論小部件。

頁面參數

Sat, 27 Nov 2021 19:53:24 +0800

頁面參數位於 Front Matter。

站點參數

Sat, 27 Nov 2021 19:53:24 +0800

站點參數文件默認為 config/_default/params.toml。

配置

Sat, 27 Nov 2021 19:53:24 +0800

站點配置文件默認為 config/_default/config.toml。

配置結構

Sat, 27 Nov 2021 19:53:24 +0800

如示例站點所示，我們使用 Configuration Directory 為了維護更簡單的組織和特定於環境的設置，它在多語言站點上特別有用。

圖像處理

Sun, 15 Aug 2021 14:19:06 +0800

本文提供一些調整圖片大小、裁剪和對齊圖片的用例。

Markdown 語法指南

Mon, 09 Nov 2020 00:00:00 +0000

This article offers a sample of basic Markdown syntax that can be used in Hugo content files, also it shows whether basic HTML elements are decorated with CSS in a Hugo theme.

Alert Shortcode

Thu, 22 Oct 2020 00:00:00 +0000

本文將介紹如何使用 alert shortcode。