The template engine is not so awesome (it is the Go template engine, really awkward!). Another thing that is really not awesome is that Hugo doesn't use semantic versioning, so that you don't have any idea whether the new version will break your project or not.
Hugo is awesome, its documentation is not
71–80 of 128 posts
Re: Hugo is awesome, its documentation is not
#72Earlier quoted context omitted.
> such as the documentation for the Spring framework. Oh god, so true. It doesn't help when it's not a single project, but fifteen hundred different projects (as is the case with spring) and it's impossible to find a coherent documentation beyond the most basic examples.
Right its easier to switch entirely to something else. If you use Micronaut, Microprofile, Vert.x etc your life is much easier.
It's been years since I've using Spring. Everybody who pays me to work in Java has used Guava for a while. Most of what I do on my own account is in Python or C (yuck!) or AVR8 assembler. The one Java project I am working on for myself uses balls-to-the-walls metaprogramming and code generation and is designed to enable even more metaprogramming and code generation and doesn't need dependency injection.
I spent a lot of time learning Spring in the day and I felt it filled a gap in Java in a way Guava really doesn't. I call it "configuration driven development". I was writing a large series of report generators in Python and all of them had the structure of "a little script that assembles a few objects in a library together to do a task". In the case of Java that "script" is naturally a Java class that needs to be compiled, goes through the build process, involves artifact management, etc. It's very nice that Spring provides a "general configuration file" that lets you patch together a few objects without having to compile anything.
Re: Hugo is awesome, its documentation is not
#73And so does its themes. It seems that the good UI/UX web designers don't have interest to Hugo theme. I check the Hugo theme site [0], but difficult to find out the good one. Not like some React/Vue community.
Here is my wife site [1] with custom Call me Sam theme [2]. Check it out and let see what a hardware designer can do for his wife :)
Re: Hugo is awesome, its documentation is not
#74Earlier quoted context omitted.
I think the title is silly, but the article is reasonable. I have this same problem with the documentation for the (really absolutely incredibly useful) Caddy webserver. Caddy itself is extremely powerful and you can do a lot with the configuration. But finding how you do that requires exploring the documentation as if it were a hypertext adventure. Some of this comes from the documentation effort being repeated for…
Caddy's 2.x documentation almost put me off Caddy haha Try to find how to use the `ask` function to verify whether a requested domain should get a certificate provisioned. If you can do it without having to manually sift through the docs and then give up and tackle it with trial and error I'll.. well I'll be put in my place, but it proper tripped me up when I needed it
I had a bit of a battle to find out how to do a couple of things, but the weirdest challenge was to find out how to force it to refresh a Let's Encrypt certificate!
I absolutely love the performance, and now I have it working, I am super-pleased with the simplicity of the configuration for e.g. a nuxt static site with a PHP graphql server.
But it really was a bit mindbending.
Re: Hugo is awesome, its documentation is not
#75When I made my site statically generated, I considered using Hugo, but I ruled it out after 15 or so minutes because i ran into the same issue with the docs. Ended up just writing a python script to do it which didn't take long
The only thing I did different is spent more than 15 minutes on trying to understand the documentation. Maybe it was just finding what the secret was that deserved such dense documentation.
Re: Hugo is awesome, its documentation is not
#76The template engine is not so awesome (it is the Go template engine, really awkward!). Another thing that is really not awesome is that Hugo doesn't use semantic versioning, so that you don't have any idea whether the new version will break your project or not.
Once a Hugo update broke my website. So what I did was to take the latest version of the binary, and chugged it in the repo with the site code. Now I just never update.
Also helps with the urge to tweak things instead of writing (not that I write much anyways).
Re: Hugo is awesome, its documentation is not
#77I mean, I get it, but why not opening a couple of PRs then? It is an open source project after all.
Re: Hugo is awesome, its documentation is not
#78well I figured out how Hugo works only by “clone the existing Hugo theme, change something, see what happens”.
Re: Hugo is awesome, its documentation is not
#79Earlier quoted context omitted.
Right its easier to switch entirely to something else. If you use Micronaut, Microprofile, Vert.x etc your life is much easier.
It's been years since I've using Spring. Everybody who pays me to work in Java has used Guava for a while. Most of what I do on my own account is in Python or C (yuck!) or AVR8 assembler. The one Java project I am working on for myself uses balls-to-the-walls metaprogramming and code generation and is designed to enable even more metaprogramming and code generation and doesn't need dependency injection. I spent a lot…
> It's very nice that Spring provides a "general configuration file" that lets you patch together a few objects without having to compile anything.
Used to with xml files, now its attribute driven, just another way to double the complexity again :)
Re: Hugo is awesome, its documentation is not
#80I like Hugo quite a lot, but I don't like Go's standard library templates. I wonder if it is possible to use https://github.com/valyala/quicktemplate with Hugo?
Zola [1] was created exactly for this reason. It even says so in the Readme. The templates are based on Jinja though, not mako. They also claim that their CLI is intuitive and documentation is good. I certainly found it more comprehensible than Hugo's.