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

code-toggle shortcode 根據任意支持的配寘程式碼，生成多種格式等效的程式碼塊。

简介

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

Hugo Bootstrap Theme(HBS) 是一个快速、响应式、多用途和功能丰富的 Hugo 主题。其通常用于博客和文档站点。

先决条件

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

在安装主题前，请确保你满足先决条件。

问题排查

Sat, 19 Mar 2022 13:46:41 +0800

本文列出了一些常见问题，以便你可以轻松解决它们。

通过 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 布局，其可用来编写项目文档，个人笔记等。

Starter Template

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

The starter template for newbie.

菜单

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.

图片查看器

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:53 +0800

作为一个可定制的主题，其提供了定制资源的能力，无论是定制 CSS 和 JS，还是引入第三方 CSS 和 JS。

钩子

Sat, 27 Nov 2021 21:04:32 +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

如示例站点所示，我们使用 Configuration Directory 为了维护更简单的组织和特定于环境的设置，它在多语言站点上特别有用。

页面参数

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。

图像处理

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。