Blog Module Configuration Guide

1[params.hb.blog.related_posts]
2  number = 6           # Number of related posts to show
3  list_style = "slide" # Options: slide, vertical

 1
 2---
 3title: 'Your Blog Post Title'
 4date: 2025-01-03T10:00:00Z
 5draft: false
 6
 7# Content Organization
 8description: 'SEO-friendly description'
 9featured: true # Mark as featured post
10pinned: false # Pin to top of listing
11series: ['Tutorial'] # Group into series
12categories: ['Tech'] # Post categories
13tags: ['Hugo', 'Blog'] # Post tags
14authors: ['john-doe'] # Multiple authors supported
15
16# Page Behavior
17comments: true # Enable comments (default: true)
18sidebar: true # Show sidebar (default: true)
19toc: true # Show table of contents
20noindex: false # SEO indexing control
21
22# Social and Sharing
23images: ['/images/featured.png'] # Featured image for social sharing
24
25# Custom Parameters
26weight: 10 # Manual ordering
27nav_weight: 100 # Navigation weight
28---

 1# HBStack Blog Module Configuration
 2hb:
 3  blog:
 4    # Core settings
 5    enabled: true
 6    post_thumbnail_height: 180px
 7    post_thumbnail_resize_height: 360
 8    post_thumbnail_default: images/thumbnail.png
 9    post_read_more: true
10    paginate: 12
11    post_thumbnail_placeholder: 'Blog'
12    post_thumbnail: true
13    list_cols_lg: 3
14    post_date_format: ':date_long'
15
16    # Homepage settings
17    home:
18      taxonomies: true
19      featured_posts: 5
20      main_sections:
21        - blog
22        - posts
23        - tutorials
24
25    # Sidebar configuration
26    sidebar:
27      enabled: true
28      position: start
29      width: 0.35
30      max_width: 320px
31      sticky: true
32
33      # Profile widget
34      profile:
35        avatar: /images/avatar.png
36        avatar_size: 200
37        title: 'Personal Blog'
38        description: 'Welcome to my tech blog'
39        company: '[Your Company](https://example.com)'
40        location: 'Internet'
41        socials:
42          github: yourusername
43          twitter: yourusername
44          linkedin: yourprofile
45
46      # Posts widget
47      posts:
48        style: pills
49        list_style: slide
50        recent_count: 10
51        featured_count: 5
52
53      # Taxonomies widget
54      taxonomies:
55        style: pills
56        count: true
57        limit: 10
58
59    # Comment system (choose one)
60    giscus:
61      repo: username/repository
62      repo_id: R_kgDOJP3qtA
63      category_id: DIC_kwDOJP3qtM4CVavM
64
65    # Social sharing
66    social_share_buttons:
67      media:
68        twitter: true
69        linkedin: true
70        facebook: true
71        reddit: true
72        email: true

 1---
 2title: Blog
 3menu:
 4  main:
 5    identifier: blog
 6    weight: 3
 7    params:
 8      icon:
 9        vendor: fas
10        name: blog
11        color: primary
12      description: 'Latest blog posts and tutorials'
13---
14Welcome to my blog where I share insights about technology, programming, and web development.

 1---
 2title: "Getting Started with HBStack Blog"
 3date: 2025-01-03T10:00:00Z
 4draft: false
 5featured: true
 6pinned: true
 7description: "Learn how to set up and configure the HBStack blog module"
 8
 9# Organization
10series: ["HBStack Guide"]
11categories: ["Web Development"]
12tags: ["Hugo", "HBStack", "Blog"]
13authors: ["your-username"]
14
15# SEO and Social
16images: ["/images/blog/hbstack-intro.png"]
17noindex: false
18
19# Page features
20comments: true
21sidebar: true
22toc: true
23---
24
25This post will guide you through setting up the HBStack blog module...
26
27
28
29
30
31## Introduction
32
33The HBStack blog module provides...

 1# content/authors/john-doe/_index.md
 2---
 3title: 'John Doe'
 4description: 'Senior Developer and Tech Writer'
 5images: ['/images/authors/john-doe.jpg']
 6socials:
 7  github: johndoe
 8  twitter: johndoe
 9  linkedin: johndoe
10  website: https://johndoe.dev
11---
12John is a senior developer with 10 years of experience...

1---
2title: 'Collaborative Post'
3authors: ['john-doe', 'jane-smith']
4---

 1# First post in series
 2---
 3title: 'Getting Started with Hugo - Part 1'
 4series: ['Hugo Tutorial']
 5nav_weight: 1
 6---
 7# Second post in series
 8---
 9title: 'Advanced Hugo Features - Part 2'
10series: ['Hugo Tutorial']
11nav_weight: 2
12---

 1---
 2title: Blog Section
 3menu:
 4  main:
 5    identifier: blog
 6    weight: 3
 7    params:
 8      icon:
 9        vendor: fas
10        name: blog
11---

1---
2title: Featured Post
3featured: true
4---

 1# HBStack Blog Module Configuration: https://hbstack.dev/modules/blog/overview/
 2hb:
 3  ##----------------------------blog module----------------------------------
 4  blog:
 5    post_thumbnail_height: 180px
 6    post_thumbnail_resize_height: 360
 7    post_thumbnail_default: images/thumbnail.png # from assets folder
 8    post_read_more: true # whether to show the read more link.
 9    paginate: 12 # the number of posts per page.
10    post_thumbnail_placeholder: GB #text of thumbnail placeholder, default to site title.
11    post_thumbnail: true # whether to show the thumbnails, No image if false
12    list_cols_lg: 3 # original was 2, I changed the _card.html, not fully working
13    post_date_format: ':date_long' # see https://gohugo.io/functions/dateformat/#datetime-formatting-layouts.
14
15    ##^^^^^^^^^^^^^^^^^^^^^^^^^Blog home Page Settings ^^^^^^^^^^^^^^^^^^^^^^^^
16    home: # homepage settings.
17      taxonomies: true # remove the taxonomies stat from the homepage.
18      featured_posts: 5 # the number of the featured posts.
19      main_sections: # leave it empty to include all regular pages.
20        - docs
21        - blog
22        - tutorial
23        - courses
24        - modules
25    sidebar:
26      posts:
27        #style: pills
28        # list_style: vertical
29        recent_count: 10 # the number of recent posts.
30        featured_count: 5 # the number of featured posts.
31      taxonomies:
32        style: pills
33        count: true # whether to show the number of posts associated to the item.
34        limit: 10 # the maximum number of the item.
35      profile:
36        avatar: /images/avatar.png
37        avatar_size: 200
38        title: Personal blogs
39        # description: Profile description other than site description.
40        # company: "[HB STACK](https://hbstack.dev/)"
41        # location: Internet
42        # socials:
43        # - name: githubsponsors
44        # id: razonyang
45        # - name: paypal
46        # id: razonyang
47        # - name: afdian
48        # id: razonyang
49        # - name: github
50        # id: hbstack
51        # - name: rss
52        # id: true
53        # - name: mastodon
54        # id: https://techhub.social/@hbstack
55    #giscus:
56    # repo: hbstack/theme
57    # repo_id: R_kgDOJP3qtA
58    # category_id: DIC_kwDOJP3qtM4CVavM

1---
2title: About
3sidebar: false
4---