Hugo Theme Bootstrap Docs v0

Install via 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. It describes how to install, upgrade the theme, and write new articles. While this installation method is still widely used, we recommend to install the theme as Hugo module . Installation Create a New Site from Scratch 1$ hugo new site myblog 2$ cd myblog 3$ git init 4$ git submodule add https://github.com/razonyang/hugo-theme-bootstrap themes/hugo-theme-bootstrap 5$ cp -a themes/hugo-theme-bootstrap/exampleSite/* .

Install 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. It describes how to install, upgrade the theme, and write new articles. 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$ go env -w GOPROXY=https://goproxy.cn,direct or 1$ go env -w GOPROXY=https://goproxy.io,direct Installation Install a new site from scratch Step 1: Create skeleton site Create and enter new site: 1$ hugo new site my-new-blog 2$ cd my-new-blog Step 2: Turn your new site into a Hugo module: 1$ hugo mod init github.

Starter Template

Mon, 01 Jan 0001 00:00:00 +0000

The starter template for newbie.

Look and Feel

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

By default, a site using this theme has the default fonts, colors, and general look and feel. However, the default scheme cannot satisfy everyone, but don’t worry, you can easily override the theme defaults, such as palette colors, fonts, syntax highlighting.

Adding Content

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

Main Sections The mainSections parameter is used to filter pages, default to ["posts", "docs"]. 1mainSections = ["blog", "posts", "docs", "notes"] Content Types You may want to use docs layout in other sections instead of /docs, such as /notes. It’s easy to do that by setting type = "docs" on the front matter. Archetypes We can also create a archetype for notes, let’s Hugo take care of the type. 1$ cp themes/hugo-theme-bootstrap/archetypes/default.

Configuration

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

As the example site shown, we use Configuration Directory to maintain easier organization and environment specific settings, it is especially useful on multilingual sites.

Getting Started

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

HBS(Hugo Bootstrap) is a fast, responsive and feature-rich Hugo theme for personal blog and documentations. Please make sure you meet the prerequisites prior to installing the theme.

Gallery Shortcode

Fri, 25 Mar 2022 00:00:00 +0000

This article shows how to use the gallery shortcode.

Troubleshooting

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

This article lists some common problems so that you can easily solve them.

Docs Layout

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

In this post we explore the docs layout that can be used to publish project documentation, a Personal Knowledge Base (PKM), a Digital Garden , a Second Brain , a Zettelkasten , your notes, and more.

FAQ Layout

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

The FAQ page is a collection of frequently asked questions.

Image Viewer

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.

Progressive Web App

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

PWAs(Progressive web apps ) are web apps developed using a number of specific technologies and standard patterns to allow them to take advantage of both web and native app features.

We are in the experimental stage of PWA, but some major features have been added, such as install site to home screen, precache files and available offline.

Archive Layout

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

The archive page is a collection of posts grouped by year.

Search Layout

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

It may be difficult for readers to retrieve an article in the case if there are many articles in your site, therefore, we added the search feature.

Author Widget

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

The author widget is located in the sidebar, in order to introduce yourself briefly.

Reward Widget

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

The reward widget, AKA buy me a coffee widget, gives the readers a way to support a creator through the use of donations or tips.

Social Links

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

The social parameter is a set of key value pairs of social links that mapping from platform to their user identifier. It supports many popular social platforms, such as Twitter, Facebook, Reddit, GitHub. This article lists all supported platforms and how to use them.

Contact Form

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

We can put our email address on social links so that readers can contact us. Unfortunately, emails will be more or less treated as spam and even filtered. Therefore, we bring a feature called contact form.

Custom Assets

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

As a customizable theme, it provides the ability to customize assets, whether it is customizing CSS and JS or introducing third-party CSS and JS.

Comments Widget

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

Disqus and Utterances comments widgets are supported out of box. This article shows how to configure them and even customize your own comment widgets.

Get Involved

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

We are happy to listen to your opinions and feedback, and welcome you to get involved.

Hooks

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

As a flexible theme, it should have the ability to customize code and integrate third-party services. Therefore, we brought a feature called hook.

In this article, we will introduce all hooks and provide some use cases.

Diagram Guide

Wed, 01 Sep 2021 11:36:50 +0800

This article offers a sample of basic diagram usage that can be used in Hugo content files.

Please see also Mermaid .

Image Processing

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

This article offers some use cases for showing how to resize and align images.

Markdown Syntax Guide

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

This article shows how to use the alert shortcode.

Media Shortcodes

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

A detailed description of media shortcodes, such as Bilibili, Tencent, Youku, iQiyi and Netease Music.

Online IDE Shortcodes

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

A detailed description of online IDE shortcodes, such as JSFiddle, CodePen, JSRun.

Rich Content

Sun, 10 Mar 2019 00:00:00 +0000

Hugo ships with several Built-in Shortcodes for rich content, along with a Privacy Config and a set of Simple Shortcodes that enable static and no-JS versions of various social media embeds.

Placeholder Text

Sat, 09 Mar 2019 00:00:00 +0000

Lorem est tota propiore conpellat pectoribus de pectora summo.

Math Typesetting

Fri, 08 Mar 2019 00:00:00 +0000

Mathematical notation in a Hugo project can be enabled by using third party JavaScript libraries.

Emoji Support

Tue, 05 Mar 2019 00:00:00 +0000

Emoji can be enabled in a Hugo project in a number of ways.

About

Thu, 28 Feb 2019 00:00:00 +0000

Written in Go, Hugo is an open source static site generator available under the Apache Licence 2.0. Hugo supports TOML, YAML and JSON data file types, Markdown and HTML content files and uses shortcodes to add rich content. Other notable features are taxonomies, multilingual mode, image processing, custom output formats, HTML/CSS/JS minification and support for Sass SCSS workflows. Hugo makes use of a variety of open source projects including: https://github.

Contact Us

Mon, 01 Jan 0001 00:00:00 +0000

FAQs

Mon, 01 Jan 0001 00:00:00 +0000

Level 4

Mon, 01 Jan 0001 00:00:00 +0000

Unlimited level of documentation catalog.

Offline

Mon, 01 Jan 0001 00:00:00 +0000

Hugo Theme Bootstrap Docs v0

Install via Git Submodule

Install via Hugo Module

Starter Template

Look and Feel

Menu

Adding Content

Configuration

Getting Started

Gallery Shortcode

Troubleshooting

Docs Layout

FAQ Layout

Image Viewer

Progressive Web App

Archive Layout

Search Layout

Author Widget

Reward Widget

Social Links

Contact Form

Custom Assets

Comments Widget

Get Involved

Hooks

Diagram Guide

Image Processing

Markdown Syntax Guide

Alert Shortcode

Media Shortcodes

Online IDE Shortcodes

Rich Content

Placeholder Text

Math Typesetting

Emoji Support

About

Contact Us

FAQs

Level 4

Offline