Hugo UI Blog
Blog theme for Hugo.
Install
git submodule add 'https://github.com/pkgstore/hugo-ui-blog.git' 'themes/ui-blog'
Update
git submodule update --remote --merge
Uninstall
m='ui-blog'; git submodule deinit -f "themes/${m}"; git rm -r --cached "themes/${m}"; rm -rf ".git/modules/themes/${m}"; rm -rf "themes/${m}"
Configuration
Theme configuration for params.yml
.
# -------------------------------------------------------------------------------------------------------------------- #
# Meta.
# -------------------------------------------------------------------------------------------------------------------- #
author:
name: 'John Doe'
email: 'john.doe@example.com'
manifest:
short_name:
en: ''
ru: ''
color:
background: '#ffffff'
theme: '#ffffff'
categories:
- 'books'
- 'education'
- 'utilities'
ui:
color:
theme:
light: '#ffffff'
dark: ''
# -------------------------------------------------------------------------------------------------------------------- #
# API.
# -------------------------------------------------------------------------------------------------------------------- #
api:
user_agent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36'
github:
user: ''
email: ''
token: ''
gitlab:
user: ''
email: ''
token: ''
# -------------------------------------------------------------------------------------------------------------------- #
# Search.
# -------------------------------------------------------------------------------------------------------------------- #
search:
bing:
enabled: false
google:
enabled: true
yandex:
enabled: false
# -------------------------------------------------------------------------------------------------------------------- #
# Taxonomy.
# -------------------------------------------------------------------------------------------------------------------- #
taxonomy:
authors:
grid:
cols: 2
cover:
size: '120px'
avatar:
size: '256'
categories:
grid:
cols: 3
cover:
size: '96px'
icon:
name: 'far fa-folder-open'
size: '2x'
# -------------------------------------------------------------------------------------------------------------------- #
# Node.
# -------------------------------------------------------------------------------------------------------------------- #
node:
cover:
image:
enabled: true
placeholder: 'https://images.unsplash.com/photo-1585776245991-cf89dd7fc73a'
crop: 'entropy'
fit: 'crop'
lg:
width: '1600'
height: '900'
md:
width: '160'
height: '160'
tabs:
source:
enabled: true
info:
enabled: true
categories:
enabled: true
tags:
enabled: true
authors:
enabled: true
related:
enabled: true
meta:
enabled: true
stats:
enabled: true
comments:
enabled: true
giscus:
repo: ''
repo_id: ''
category: ''
category_id: ''
mapping: 'pathname'
strict: '1'
reactions: '1'
metadata: '0'
position: 'top'
theme: 'preferred_color_scheme'
share:
enabled: true
social:
enabled: true
qrcode:
enabled: true
url:
enabled: true
file:
enabled: true
Front matter
title: '{{ ($title) }}' # Title of material.
description: '' # Description of material.
images: # Images from https://unsplash.com. Format: URL.
- 'https://images.unsplash.com/photo-1585776245991-cf89dd7fc73a'
cover: # Cover of material.
crop: 'entropy' # Crop mode controls how the image is aligned when fit=crop is set.
# Info: https://docs.imgix.com/apis/rendering/size/crop.
fit: 'crop' # The fit parameter controls how the output image is fit to its target dimensions after resizing,
# and how any background areas will be filled.
# Info: https://docs.imgix.com/apis/rendering/size/fit.
categories: # Categories of material.
- 'cat_01'
- 'cat_02'
- 'cat_03'
tags: # Tags of material.
- 'tag_01'
- 'tag_02'
- 'tag_03'
authors: # Authors of material.
- 'Author_01'
- 'Author_02'
sources: # Sources of material. Format: URL.
- ''
license: 'CC-BY-SA-4.0' # License ID (https://github.com/spdx/license-list-data/tree/main/json/details).
complexity: '' # Complexity of material. Example: '0' / '1' / '2'.
toc: 1 # Enable / disable table of content.
comments: 1 # Enable / disable comments.
Functions
- If article is in
InDev
category, then a notification appears about updating article. - If article is in
Opinion
category, then a notification about personal opinion appears in article.