hbstack / theme Goto Github PK

View Code? Open in Web Editor NEW

72.0 2.0 19.0 61.65 MB

HB starter theme for blog, docs, digital garden, gallery and landing pages. HB 新手博客、文档、数字花园、图库和落地页主题。

Home Page: https://theme.hbstack.dev/

License: MIT License

Dockerfile 45.59% HTML 16.61% TypeScript 5.20% SCSS 32.60%

blog docs hb hugo hugo-theme hugopress digital-garden template gallery landing-page

theme's Introduction

HB Theme Template

The starter theme template of HB Framework, live demo: https://theme.hbstack.dev/.

News

Our cards style theme is available now.

Documentation

English	简体中文
Prerequisites	先决条件
Installation	安裝
Configuration	配置
Content	内容
Deployment	部署
Modules	模块

Features

Fast and SEO friendly: PageSpeed Insight scored perfect 💯 in all four metrics on mobile and desktop.
Multi-purpose: blog, project documentation, digital garden, gallery, landing pages and so on.
Responsive: mobile first, built on top of Bootstrap v5.3.
🧊 Modular and flexible: extend features via various modules.
🌓 Dark mode: light, dark or auto (follow system).
🔍 Search: powerful client side fuzzy search that allows filtering and sorting of results, as well as searching from all multilingual sites.
PurgeCSS: remove unused CSS.
🚀 PWA:
- Installable: add site to home screen.
- Offline available: offline page and offline image.
- Allow precaching resources, such as CSS, JS and fonts.
Advanced:
- Custom SCSS variables and style.
- Custom JavaScript.
- Custom HTML markup:
🖼️ Images Processing: process images via URL query string and fragment, such as alignment, resizing, cropping and so on, friendly to Markdown.
💻 Code block panel: expand toggle, code copy button, line number toggle and wrap toggle.
Menus: supports header menus and footer menus.
Related posts slide.
🖼️ Image viewer: zoom in/out image.
🗂️ Archives: group by year and month.
📝 Multiple authors: articles can be co-authored.
🌐 Multilingual.
⬅️ RTL: supports Right-to-Left languages.
⬆️ Back/Return to top button.
Social links: supports header and footer social links.
Content: supports KaTex (math), Mermaid (diagrams) and Bootstrap shortcodes.
...

Screenshot

theme's People

Contributors

Stargazers

Watchers

Forkers

khoile2002 fixit-theme fixit-theme ronibd0 k-kipruto xiaoyaozz rubonnek rhit-armstrjj iansmith davsk soelucas stardoom4 razonyang wanglu119 stopspazzing jasonning96 m1keh greekra tesdt2024

theme's Issues

Support for Plausible Analytics

Is support for Plausible Analytics planned?

Hbs blog page speed

HBS landing page speed is excellent. Doc section page speed decrease on mobile platform. Blog page speed on mobile platform is still lower due to img, several.js, comments section, gravatar, etc. https://pagespeed.web.dev/analysis/https-hb-theme-hugomods-com-en-blog-2023-03-tutorial/jjkbaq6n9w?form_factor=mobile
If it should be than it is.

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

This repository currently has no open or pending branches.

Detected dependencies

dockerfile

Dockerfile

gomod

go.mod

go 1.19

github.com/GoogleChrome/workbox v7.1.0+incompatible

github.com/KaTeX/KaTeX v0.16.10

github.com/gohugoio/hugo-mod-bootstrap-scss/v5 v5.20300.20200

github.com/gohugoio/hugo-mod-jslibs-dist/popperjs/v2 v2.21100.20000

github.com/hbstack/back-to-top v0.2.0

github.com/hbstack/base v0.5.1

github.com/hbstack/bigger-picture v0.10.1

github.com/hbstack/blog v0.32.1

github.com/hbstack/blog/modules/breadcrumb v0.1.22

github.com/hbstack/blog/modules/content-panel v0.1.21

github.com/hbstack/blog/modules/featured-image v0.2.21

github.com/hbstack/blog/modules/giscus v0.1.23

github.com/hbstack/blog/modules/heading-sign v0.1.23

github.com/hbstack/blog/modules/post-nav v0.3.8

github.com/hbstack/blog/modules/related-posts v0.3.0

github.com/hbstack/blog/modules/sidebar/posts v0.7.1

github.com/hbstack/blog/modules/sidebar/profile v1.2.0

github.com/hbstack/blog/modules/sidebar/taxonomies v0.4.1

github.com/hbstack/blog/modules/toc-scrollspy v0.1.20

github.com/hbstack/bootstrap v0.2.2

github.com/hbstack/breadcrumb v0.6.0

github.com/hbstack/bs-tooltip v0.1.1

github.com/hbstack/carousel v0.2.5

github.com/hbstack/code-block-panel v0.1.2

github.com/hbstack/content-panel v0.9.0

github.com/hbstack/docs v0.16.0

github.com/hbstack/docs/modules/breadcrumb v0.1.9

github.com/hbstack/docs/modules/content-panel v0.1.8

github.com/hbstack/docs/modules/doc-nav v0.3.6

github.com/hbstack/docs/modules/featured-image v0.2.8

github.com/hbstack/docs/modules/giscus v0.1.10

github.com/hbstack/docs/modules/heading-sign v0.1.9

github.com/hbstack/docs/modules/toc-scrollspy v0.1.7

github.com/hbstack/featured-image v0.2.1

github.com/hbstack/footer v0.4.1

github.com/hbstack/footer/modules/socials v0.3.0

github.com/hbstack/gallery v0.12.0

github.com/hbstack/gallery/modules/breadcrumb v0.1.0

github.com/hbstack/giscus v0.1.1

github.com/hbstack/hb v0.12.2

github.com/hbstack/header v0.14.3

github.com/hbstack/header/modules/language-picker v0.1.24

github.com/hbstack/header/modules/search v0.1.35

github.com/hbstack/header/modules/socials v0.2.0

github.com/hbstack/header/modules/theme-toggle v0.4.4

github.com/hbstack/heading-sign v0.2.0

github.com/hbstack/mermaid v0.2.1

github.com/hbstack/meta/recommended v0.2.10

github.com/hbstack/noscript v0.6.0

github.com/hbstack/pagination v0.7.0

github.com/hbstack/progress-bar v0.1.0

github.com/hbstack/pwa v0.1.2

github.com/hbstack/scrollbar v0.1.0

github.com/hbstack/search v0.2.1

github.com/hbstack/slide v0.3.2

github.com/hbstack/snackbar v0.1.2

github.com/hbstack/socials v0.14.1

github.com/hbstack/syntax-highlighting v0.2.0

github.com/hbstack/syntax-highlighting/styles/gruvbox v0.1.1

github.com/hbstack/toc-scrollspy v0.1.0

github.com/henrygd/bigger-picture v1.1.16

github.com/hugomods/base v0.6.0

github.com/hugomods/bootstrap v0.21.2

github.com/hugomods/code-block-panel v0.6.0

github.com/hugomods/font-awesome v6.5.2+incompatible

github.com/hugomods/fuse-js v0.1.0

github.com/hugomods/giscus v0.1.1

github.com/hugomods/gravatar v0.2.0

github.com/hugomods/hugopress v0.2.3

github.com/hugomods/i18n-js v0.2.1

github.com/hugomods/icons v0.6.3

github.com/hugomods/icons/vendors/bootstrap v0.5.6

github.com/hugomods/icons/vendors/font-awesome v0.6.6

github.com/hugomods/icons/vendors/simple-icons v1.0.38

github.com/hugomods/idb-js v0.1.0

github.com/hugomods/images v0.10.1

github.com/hugomods/katex v0.3.1

github.com/hugomods/mermaid v0.1.1

github.com/hugomods/pwa v0.8.0

github.com/hugomods/search v0.13.3

github.com/hugomods/seo/modules/alternatives v0.1.0

github.com/hugomods/seo/modules/base v0.1.1

github.com/hugomods/seo/modules/favicons v0.2.1

github.com/hugomods/seo/modules/open-graph v0.1.0

github.com/hugomods/seo/modules/schema v0.1.1

github.com/hugomods/seo/modules/translations v0.1.0

github.com/hugomods/seo/modules/twitter-cards v0.1.0

github.com/hugomods/shortcodes v0.18.1

github.com/hugomods/simple-icons v11.14.0+incompatible

github.com/hugomods/snackbar v0.1.2

github.com/hugomods/workbox v0.1.0

github.com/jakearchibald/idb v8.0.0+incompatible

github.com/krisk/Fuse v7.0.0+incompatible

github.com/twbs/bootstrap v5.3.3+incompatible

github.com/twbs/icons v1.11.3

npm

package.json

@fullhuman/postcss-purgecss ^6.0.0

autoprefixer ^10.4.14

postcss-cli ^11.0.0

rtlcss ^4.0.0

Check this box to trigger a request for Renovate to run again on this repository

not compatible with this Hugo version

npm run dev
时报错
PS E:\projects\blog\blog-hb\themes\geek-hb> npm run dev

dev
hugo server --gc --disableFastRender --enableGitInfo -D

WARN 2023/04/19 17:19:26 Module "github.com/hbstack/hb" is not compatible with this Hugo version; run "hugo mod graph" for more information.
WARN 2023/04/19 17:19:26 Module "github.com/hbstack/carousel" is not compatible with this Hugo version; run "hugo mod graph" for more information.
WARN 2023/04/19 17:19:26 Module "github.com/hugomods/images" is not compatible with this Hugo version; run "hugo mod graph" for more information.
WARN 2023/04/19 17:19:26 Module "github.com/hbstack/content-panel" is not compatible with this Hugo version; run "hugo mod graph" for more information.
WARN 2023/04/19 17:19:26 Module "github.com/hugomods/search" is not compatible with this Hugo version; run "hugo mod graph" for more information.
Error: add site dependencies: load resources: loading templates: "C:\Users\geeks\AppData\Local\Temp\hugo_cache\modules\filecache\modules\pkg\mod\github.com\hugomods\[email protected]\layouts\partials\images\image.html:16:1": parse failed: template: partials/images/image.html:16: function "page" not defined

Digital garden

How do I create a digital garden with this theme ?

Docs appearing in front page.

Is it possible for the Docs articles to not appear in the front page where all blog posts are shown.

Append the language code to the filename.

_index.md to _index.en.md.
index.md to index.en.md.

Hugo content

Following Hugo content guidelines https://gohugo.io/content-management/organization/ I copy 9 title.md files into docs folder. All files obey strictly Hugo rules about yaml and content.
Files aren't recognised in hbs theme and I do realize that hbs theme content organisation means that for each and every page, article or doc.md I need to create folder with a name and index.md.
It will impede on using hbs theme as digital garden as I got 523 files under 202304091537-title.md (yearmonthdayhourminute-title.md).

chore: hb-theme.hugomods.com: correct invalid html

Check of theme example site with W3C validation service:

Two errors are reported:

The itemprop attribute was specified, but the element is not a property of any item.

Were great if this error (and maybe also the warnings) could be fixed.

文章预计阅读时间是在哪里设置的啊

你好，我阅读了您的文章，使用了您的HB Framework搭建了自己的博客https://yaoyifeng.top ,我自己搭建的博客网站文章预计阅读时间这个地方只有两个点，中间并没有预计时间，我不知道是改了哪里改出bug了，我想问一下这个预计阅读时间是在哪里设置的啊，非常感谢

Contact form shortcode, widget or page?

It would be nice to have a built-in contact form that could be enabled somehow. Perhaps one under the author page is enough.

I can't seem to find it if there is any.