Blog Overview

[giscus[bot]]

Blog Overview

The blog module provides the basic layouts and templates for blog site.

https://hbstack.dev/modules/blog/overview/

[gavlinski]

Hi, can you please add support for lastmod manual information or revisioning auto getting from git repo for showing the date of last update of a document?

References:

• https://gohugo.io/methods/page/lastmod/
• https://squidfunk.github.io/mkdocs-material/setup/adding-a-git-repository/?h=author#revisioning

[razonyang]

LGTM.

[razonyang]

Added simple modules for showing the created and modified dates, I can add more, such as the the git commit message, links for editing and viewing the source file, but it seems dulplicated with the content panel, so I haven't make a decise yet.

• For blog layout, please import github.com/hbstack/blog/modules/revision.
• For docs layout, import github.com/hbstack/docs/modules/revision instead.

Tweak the hb.revision.date_format to change the date format, currently, it won't rendered in timeago format (sth like * days ago), since extra JS are required.

The i18n files are located at https://github.com/hbstack/revision/tree/main/i18n, I think you might want to translate the items.

[gavlinski]

Hi! It's working fine. Thanks!

Here goes some suggestions that shall improve user experience:

1. Show the full text "Revised at..." smaller at the bottom, same size of the date from the top, perhaps no need for icons, no tooltips
   
2. Place the last update info together on the top, maybe with a compact date format, tootips for each one as you've already done
   

Where can I change/add hb.revision.date_format parameter? Can you please provide more details?

[razonyang]

Available on github.com/hbstack/[email protected], to remove icons you'll need to set icons to false.

// params.yaml
hb:
  revision:
    # date_format: ':date_full'
    icons: false
    # font_size: "1rem"

[gavlinski]

Thanks! I have just two more observations:

1. The tooltip text appears to have duplicate time zone information "-0300 -0300":
   "Revisado em 2023-12-12 14:22:53 -0300 -0300", for lastmod: 2023-12-12T14:22:53-03:00
2. Could you please add one more parameter to not show the creation date? Because it already appears at the top.
   Something like: show_created: false

[razonyang]

Fixed by v0.3.0, it will use localized (:date_full and :time_full) datetime rather than raw date now.

The created_at parameter was added for showing/hiding the date of creation.

[gavlinski]

Thank you very much! Now it's working perfectly.

[razonyang]

You're welcome.

[LITUATUI]

I think I found a bug.

The blog.list_cols_lg parameter doesn't seem to be working, only the list_cols_md is working.

Example:

    list_cols_md: 2
    list_cols_lg: 3

I have a large screen (1920x1080) and only 2 article columns. I can change it with the list_cols_md parameter, but the list_cols_lg should work with my screen size.

[razonyang]

list_cols_lg work only if the sidebar was disabled (by design), but I cant remember the reason.

See hbstack/blog@f5be4a7#diff-87c53e762995c279bfb9cba355186bc80fdf748d4cd29b3898d06368d7eeb99fR36

[FuadEfendi]

I have some issues trying to disable thumbnails, when I use "post_thumbnail: false" then thumbnail id not shown but arrows overlap with link title; using latest "blog". Maybe I can fix it via CSS?

[FuadEfendi]

I have "_index.md" in "content" folder which is my "home page" (it has additional text); when I set it "type: docs" on front matter, it automatically appends all (thousands) of blog posts at the bottom. Which parameter should I use to prevent that? I tried blog.home.featured_posts = 5 but no change...

[FuadEfendi]

Something related to this, https://github.com/hbstack/docs/blob/main/layouts/partials/hb/modules/docs/section.html
It "walks" all documents, so that when I try to have "content/_index.md" as "type: docs" then homepage lists 12,000 (in my specific case) URLs... 5Mb plain HTML.

Making it "index.md" breaks menu items. I am just trying to find way to create homepage. I have tons of documents in non-standard folders which don't have "type" defined

[FuadEfendi]

Of course I can override this, in my specific case it is Ok: https://github.com/hbstack/docs/blob/main/layouts/partials/hb/modules/docs/section.html
But I am wondering, maybe there is parameter which can limit this list? "walk-docs-section-tree"

[FuadEfendi]

layout: landing?

[razonyang]

maybe there is parameter which can limit this list

There isn't, since the docs type is for section and details page.

layout: landing?

Yeah, the landing layout is better for customizing homepage and other pages, you can put anything on pages with shortcodes.