No description
Find a file
2023-10-07 18:47:54 +00:00
.github/workflows 2023-09-26 15:08:02 2023-09-26 15:08:02 +00:00
archetypes 2023-10-06 13:39:32 2023-10-06 13:39:33 +00:00
assets 2023-10-07 18:47:54 2023-10-07 18:47:54 +00:00
data 2023-10-06 19:46:54 2023-10-06 19:46:54 +00:00
i18n 2023-10-06 20:58:13 2023-10-06 20:58:13 +00:00
layouts 2023-10-07 18:46:03 2023-10-07 18:46:03 +00:00
static/webfonts 2023-09-28 09:59:51 2023-09-28 09:59:51 +00:00
.gitignore 2023-09-26 15:07:30 2023-09-26 15:07:31 +00:00
.mailmap 2023-09-28 18:59:38 2023-09-28 18:59:38 +00:00
CHANGELOG.md 2023-09-26 15:07:30 2023-09-26 15:07:31 +00:00
CONTRIBUTING.md 2023-09-26 15:07:30 2023-09-26 15:07:31 +00:00
go.mod 2023-09-26 15:07:30 2023-09-26 15:07:31 +00:00
LICENSE 2023-09-26 15:07:30 2023-09-26 15:07:31 +00:00
README.md 2023-10-04 09:31:57 2023-10-04 09:31:57 +00:00
theme.yml 2023-09-29 11:50:15 2023-09-29 11:50:15 +00:00

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.

# -------------------------------------------------------------------------------------------------------------------- #
# 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:
    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:
    info:
      enabled: true
      categories:
        enabled: true
      tags:
        enabled: true
      authors:
        enabled: true
      related:
        enabled: true
      meta:
        enabled: true
      stats:
        enabled: true
    license:
      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.