1bl4z3r / hermit-v2 Goto Github PK
View Code? Open in Web Editor NEWContinuing Hermit's legacy to be minimal and fast theme
Home Page: https://1bl4z3r.github.io/hermit-V2/
License: MIT License
Continuing Hermit's legacy to be minimal and fast theme
Home Page: https://1bl4z3r.github.io/hermit-V2/
License: MIT License
Hello! While going through the demo website I've noticed that the LaTeX is no longer working and isn't showing up anymore. It can be seen here: https://1bl4z3r.github.io/hermit-V2/posts/typography/. Here is what I'm seeing on my end: https://i.imgur.com/xKxJfZa.png
I am using LibreWolf on Windows 10.
As of version 1.0.0, looking at the example site's MathJax post: https://1bl4z3r.github.io/hermit-V2/posts/mathjax-support/
The left/right scrolling is huge due to the first code block in the configuration section.
Any thoughts on having the scrolling limited to within the code block (and not the entire page)?
As an example, check out the code blocks here work (left/right scrolling is scoped to the code block): https://blowfish.page/docs/shortcodes/#alert
With Hugo 0.120.3, I am getting a warning:
> hugo server -D
...
hugo v0.120.3-a4892a07b41b7b3f1f143140ee4ec0a9a5cf3970+extended darwin/arm64 BuildDate=2023-11-01T17:57:00Z VendorInfo=gohugoio
WARN The author key in site configuration is deprecated. Use params.author.name instead.
Any chance we can update https://1bl4z3r.github.io/hermit-V2/en/posts/explaining-configs/ to match this?
Thanks in advance
Describe the bug
I've upgraded hermit-V2 theme in my blog from v1.0.5 to the latest - v1.1.4
and the build had failure (detailed output in Terminal Output section),
as my understanding the problem is here:
https://github.com/1bl4z3r/hermit-V2/blob/main/layouts/_default/baseof.html#L19
{{ $c_css := resources.Get . | resources.ExecuteAsTemplate "css/style.css" $rootCtx | toCSS | minify | fingerprint -}}
I'm surprised because as I see empty css/style.css exists in theme,
maybe this is misconfiguration of hugo (my fault) or blog configuration conflict to theme, but all works find before (on v.1.0.5).
Could you please check it?
To Reproduce
Have no idea, it seems the fastest way to reproduce the bug its just clone the blog and run hugo build:
Terminal Output
$ hugo -Dw --logLevel debug server
Watching for changes in /home/buran/projects/blog/{archetypes,assets,content,data,i18n,layouts,static,themes}
Watching for config changes in /home/buran/projects/blog/hugo.toml
Start building sites …
hugo v0.123.7+extended linux/amd64 BuildDate=unknown
INFO build: step process substep collect files 3 files_total 3 duration 2.11206ms
INFO build: step process duration 2.368108ms
INFO build: step assemble duration 3.116779ms
INFO static: syncing static files to / duration 15.526749ms
INFO deprecated: .Site.DisqusShortname was deprecated in Hugo v0.120.0 and will be removed in a future release. Use .Site.Config.Services.Disqus.Shortname instead.
INFO build: step render pages 13 content 10 duration 108.256449ms
INFO build: step postProcess duration 8.529µs
INFO build: duration 114.262578ms
Built in 115 ms
Error: error building site: render: failed to render pages: render of "page" failed: "/home/buran/projects/blog/themes/hermit-v2/layouts/_default/baseof.html:19:40": execute of template failed: template: _default/single.html:19:40: executing "_default/single.html" at <resources.ExecuteAsTemplate>: error calling ExecuteAsTemplate: type <nil> not supported in Resource transformations
Expected behavior
Missed css/style.css should not be cause build failure.
Hugo (please complete the following information):
Additional context
Archlinux
Describe the bug
Hugo is capable of minifying svg files: https://gohugo.io/hugo-pipes/minification/
For this to work, the svg file simply need to be treated like other assets, such as custom CSS.
When migrating from Hermit to Hermit-V2, looking at footer.html
, it seems there is a change where it add "Made with Hugo" and "Theme Hermit-V2":
Any chance you'd be willing to add a config flag to disable those additions? I prefer to have a smaller footer.
Trying to copy layouts/partials/footer.html
into my own project dir, and modify it myself for now, I get the below error when running hugo server -D
:
Error: error building site: TOCSS: failed to transform "css/style.css" (text/x-scss). Check your Hugo installation; you need the extended version to build SCSS/SASS with transpiler set to 'libsass'.: this feature is not available in your current Hugo version, see https://goo.gl/YMrWcn for more information
So maybe if you don't want to add new config flags, how can I override the layouts/partials/footer.html
myself?
Describe the bug
404 page should not be indexed by the search engine. Per https://developers.google.com/search/docs/crawling-indexing/block-indexing, this can be done by adding a noindex
meta to the page.
Even though this page does not appear in sitemap.xml
and search engine won't discover it in the first place, but if someone posts a misspelled link to the site somewhere else, search engines would inadvertently indexed the page through the link.
When legacyLayout = true
, I find the post-end
bar seems to be in the wrong place. See the below screenshot:
I think a few options for when legacyLayout = true
:
post-end
in favor of art-end
art-end
and move post-end
above the metadata (what hermit v1 has)What do you think? Thanks in advance
Hi.
I'm using hermit previously and found hermit-v2 last weekend. Thank you @1bl4z3r for releasing this, and there are a lot of new exciting features.
There are a lot of social icon available, but it's always not enough, as people in different area / country may use different social media. I customized a WeChat icon in my hermit blog. Since hermit-v2 imports "share" feature, it's not working well in main page and share button (at the same time).
So I would like to know how a suitable social icon could be created, and what's the guideline I should follow with, so that we don't have to do "feature request" but just submit a pull request to add support for hermit-v2.
Here I have some svg examples of WeChat. (codes here and here ). I would like to ask what size (height & weight) / color / etc... should I use
Describe the bug
The demo site doesn't have custom 404 enabled, e.g., https://1bl4z3r.github.io/hermit-V2/en/about-hugo/s
I don't know why, as I found the theme by default creates a 404.html
file.
What for there is this file?
How to see this styling in action?
Hello,
Changes made in commit 4e7988b.
config.toml
to hugo.toml
. Reference https://gohugo.io/getting-started/configuration/#hugotoml-vs-configtomlPlease change links and images.
Thanx!
It would be useful for customize own site.
For example:
mixins must be moved from this file forever.
So if a developer wants to change something, he doesn't override the full _predefined, just a small part.
It would be cool to support a share button at the bottom of posts. It could be an opt-in feature, or enabled by default.
https://discourse.gohugo.io/t/share-buttons-for-blog-posts/12384 is a forum post with some ideas, the best seems to be https://codingnconcepts.com/hugo/social-icons-hugo/.
Thanks for your consideration, let me know what you think
Describe the bug
When first using the hermit-V2 theme, no word count will be output for posts.
This is because the partial [posts-single-info.html](https://github.com/1bl4z3r/hermit-V2/blob/5ee9c821259bda1867ba3708992a8aa97bd095ed/layouts/partials/posts_single_info.html#L12)
references a translation key wordCount
, which by default does not exist:
<p>{{- partial "svg.html" (dict "context" . "name" "posts_single_wordcount") }}{{ i18n "wordCount" . -}} {{- partial "readTime.html" . -}}</p>
This confused me for a little while.
One could include a file i18n/en.toml
in the theme directory structure with a "default" English translation, and explain in the README what to do if languages other than English are used.
What do you think?
Sites using hermit-V2
wikiI'm not using any of the i18n features, is it possible to remove /en/
from the urls?
Update README so that new users can install your repo as a git submodule instead of still using the original repo.
Currently from https://1bl4z3r.github.io/hermit-V2/:
It seems to me there is either:
Do you agree? Imo it's visually imbalanced at the moment
In #28 I was able to override my footer.html
partial.
However, I discovered index.html
doesn't use the footer.html
partial. Can we move index.html
to either:
home-footer.html
to a partial that can be overriddenindex.html
use the footer.html
partialThank you in advance for your consideration
The demo site's GitHub icon here: https://1bl4z3r.github.io/hermit-V2/
Instead of just pointing to https://github.com/, can we have it take us to either:
Thank you in advance!
Here is what my current share menu looks like (as of 3eabdaf), and it looks great. 🥳
For many share features on other website, a sharing option is supported that copies the page's hyperlink to the clipboard. On Google Chrome's mobile app, this sharing option is called "Copy link".
My request here: add a share option for just copying the page's link to the clipboard
Describe the bug
After disabling RSS in hugo.toml
via disableKinds = ["RSS"]
, the footer RSS icon is still visible, and it links to a 404 page.
To Reproduce
Steps to reproduce the behavior:
disableKinds = ["RSS"]
to hugo.toml
.Expected behavior
RSS icon should become invisible.
Hugo (please complete the following information):
The recent changes have been awesome, I am looking to use them now.
Either:
git submodule
to use the staging
branchmain
branch can be updatedDo you mind updating the main
branch? I think having the example site diverge from the main
branch can be confusing to new users
I keep getting the following error when trying to use a userstyles.scss
file.
Error: error building site: TOCSS: failed to transform "css/style.css" (text/x-scss): "/home/uzair/Documents/git/test/themes/hermit-v2/assets/scss/style.scss:10:1": File to import not found or unreadable: userstyles.scss.
I have my userstyles.scss
file under assets/scss/
as per the README but I see that userstyles.scss
is being checked at assets/scss/userstyles.scss
and then it tries to import userstyles.scss
from the project root.
hermit-V2/assets/scss/style.scss
Lines 9 to 11 in 630960e
If I create an empty userstyles.scss
in assets/scss/
folder and have the actual one at the project root then things work fine.
The original hermit theme placed post metadata like tags, Git commit, and word count on the bottom of the post.
It seems hermit-V2 is placing that metadata on the top of a post. Is there any way to control if metadata goes at the top or bottom or the page?
I am a fan of Hugo's Hermit theme, and use it for my blog onetwofoureight.com.
I was going to change theme to one with a page sharing feature, however, I came across this today. And coincidentally, the v1 release was this morning, haha wow!
Very excited to transition to this, cheers!
hugo v0.120.1 was rolled out yesterday and my Ubuntu snap package force-updated from v0.119.x.
Now I get the following errors when trying hugo serve
:
ERROR render of "taxonomy" failed: "/home/aron/dev/rasterra/hermit-V2/layouts/_default/baseof.html:13:4": execute of template failed: template: _default/list.html:13:4: executing "_default/list.html" at <partial "structured-data.html" .>: error calling partial: execute of template failed: template: _internal/opengraph.html:47:9: executing "_internal/opengraph.html" at <site>: can't evaluate field facebook_admin in type []interface {}
Error: error building site: render: failed to render pages: render of "home" failed: "/home/aron/dev/rasterra/hermit-V2/layouts/_default/baseof.html:13:4": execute of template failed: template: index.html:13:4: executing "index.html" at <partial "structured-data.html" .>: error calling partial: execute of template failed: template: _internal/opengraph.html:47:9: executing "_internal/opengraph.html" at <site>: can't evaluate field facebook_admin in type []interface {}
in v0.120.0 they deprecated site.Social
in favor of site.Params.social
.
Internal templates like _internal/opengraph.html
are now looking for parameters there. (see gohugoio/hugo@4910312)
This collides with the definition in theme's hugo.toml
. (array of social media links)
Internal templates do not expect an array, so we get the error above.
Probably to change [[params.social]]
entries in hugo.toml
to something else e.g. [[params.socialLinks]]
.
The site builds fine when I change or remove said entries.
Check out https://blowfish.page/docs/configuration/, it has a sequence of tables that document hugo.toml
or frontmatter parameters:
It would be nice if Hermit-V2 had a similar post documenting configuration parameters with defaults/descriptions
I have fully migrated to hermit-V2
theme for onetwofoureight.com (GitHub repo). Thanks for making this theme!
When turning on shareSocial
in my config, I observed the LinkedIn share isn't working for me. When I click the link, here's what I get:
When running hugo server -D
, here is the URL behind the LinkedIn icon that leads to this error page: https://www.linkedin.com/shareArticle?mini=true&url=http%3a%2f%2flocalhost%3a1313%2ftags%2f&title=Tags&summary=Tags%2c%20by%201248%0a%3cnil%3e%0a%0ahttp%3a%2f%2flocalhost%3a1313%2ftags%2f%0a&source=http%3a%2f%2flocalhost%3a1313%2f
The path to favicon is hardcoded as favicon.ico
. svg can't be used here.
By allowing an svg favicon, the favicon can color itself based on browser theme (light, dark, etc.). See this blog post for a quick example: https://www.billerickson.net/favicon-dark-mode/
It is bad decision to have one big file for all icons.
Let's imagine: I want to change only one icon, but I have to override full file. Ugly!
Idea: split svg.html into svg/name.html
So if a developer wants to change some icon, he doesn't override the full svg.html, just a concrete small file.
The fix in 556699f has a side effect, which is my site starts using the hermit-V2's about
option from the repo's hugo.toml
:
Line 41 in 556699f
It leads to this error:
> hugo server -D
...
hugo v0.120.3-a4892a07b41b7b3f1f143140ee4ec0a9a5cf3970+extended darwin/arm64 BuildDate=2023-11-01T17:57:00Z VendorInfo=gohugoio
ERROR [en] REF_NOT_FOUND: Ref "about-hugo" from page "posts/post-title.md": page not found
The issue arises because my About post in content/
is not named about-hugo
, it's just named about
.
Fix option 1 (falls onto users): when migrating to [params.author]
, one has to override both name
and about
:
[params.author]
name = "James Braza"
about = "about"
Fix option 2 (falls onto hermit-v2): removing the [params.author]
section from the main
branch's hugo.toml
What do you think? I am not sure which is the better route.
I am not finding it obvious where the source content underlying the example site is: https://1bl4z3r.github.io/hermit-V2/
Can a link be posted in the README for the example site?
Hi!
Maybe I'm misunderstanding the purpose of the themeColor
option in hugo.toml
, but I can't get it to work as it should.
In the example, this is set to '#494f5c'
Line 68 in 93f7434
And this does match the background colour I get when I use this value in my hugo.toml
. But if I change this value, I can't see what changes.
From what I can tell, most of the theme colour values are hard-coded in _predefined.scss
:
hermit-V2/assets/scss/_predefined.scss
Lines 2 to 7 in 93f7434
And I can't really see where themeColor actually gets used, apart from here:
hermit-V2/layouts/partials/site-meta.html
Line 14 in 93f7434
But I'm not sure it's working correctly. Any ideas?
Hi! Thanks for the great theme 😄
The latest v1.0.12 build causes an error to be thrown when the theme is cloned as a submodule of a repository which does not have an assets/scss
directory due to the addition of this code:
hermit-V2/assets/scss/style.scss
Lines 9 to 11 in 93f7434
$ hugo serve
Start building sites …
hugo v0.111.3+extended linux/amd64 BuildDate=2023-03-16T08:41:31Z VendorInfo=debian:0.111.3-1
Error: Error building site: EXECUTE-AS-TEMPLATE: failed to transform "scss/style.scss" (text/x-scss): template: scss/style.scss:9:14: executing "scss/style.scss" at <readDir "assets/scss">: error calling readDir: failed to read directory "assets/scss": open /home/path/to/repo/assets/scss: no such file or directory
Built in 18 ms
I'm guessing this is down to the fact that although an if
is being used, the readDir
tries to read the contents of assets/scss
before the if
is invoked. Maybe there's another if
statement that could be nested in here to avoid failing out if the directory doesn't exist.
It's not a showstopping issue, because creating an empty assets/scss
directory is enough to make this work as it did before, but it might be one to call out in the README for new users that this directory needs to exist. I only noticed this so easily because the theme previously worked and I was able to see quite quickly from the recent commits what the cause was. I think a user who is newer to the theme might just be puzzled by this one.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.