Release 1.0

[grego]

Blades seem stable to me now to mark the next release as 1.0,
It would probably make sense to wait for maciejhirsz/ramhorns#75 to be merged, so that we can use upstream Ramhorns.

Any feedback on current stability and desired features/improvements/breaking changes is the most welcome, to make this release as robust as possible.

[akasmix]

I found blades when I was looking for a quick Rust-based static site generator. It's cool, but there's a problem. To put it simply, sections do not know anything about subsections

.
└─── content
   ├─── about.md
   ├─── index.md
   ├─── posts
   │ ├─── post-1.md
   │ ├─── post-2.md
   │ ├─── something.md
   │ └─── index.md
   └─── reviews
       ├─── books
       │ ├─── broken-glass.md
       │ └─── index.md
       ├─── movies
       │ ├─── godfather.md
       │ └─── index.md
       ├─── pasta.md
       └─── index.md

Nothing wrong with posts, but reviews also look like end section, no links to the nested books or movies. Breadcrumbs don't work properly too. For the page SITE/reviews/movies/godfather.md, breadcrumbs would look like this SITE / reviews / godfather. This means that I can get the very first ancestor of the structure. I'm willing to lose super speed to get a more complex but workable site structure. Or it might be worth mentioning that blades doesn't fully support subsections in sections

[grego]

The issue with incomplete breadcrumbs is a bug, I just submitted a fix in 1cb447e.
You can access subsections of subsections as follows: {{#subsections}} {{#subsections}} ... {{/subsections}} {{/subsections}}.

[akasmix]

Thanks, that was super quick. I'm going to try and make a blog for myself this weekend.

Another suggestion. I have a bunch of posts grouped into dirs, mostly how-to guides. I don't want to add extra files like index.md. It would be really nice if Blades could use the name of the parent folder as the section title if there is no index.md in it. After all, "linux-guides" or "recipes" is better than nothing. Just a nice thing to have. Although potentially problematic (removing invalid characters and stuff).

P.S. I don't understand anything about the web and generators under the hood, so if my suggestions are crazy, just ignore them.

[grego]

It would be really nice if Blades could use the name of the parent folder as the section title if there is no index.md in it

That is what Blades already does :)

[akasmix]

Do I need to use some special settings to make it work? I haven't looked into it closely, but it doesn't happen by default for me. Yes, Blades creates an index file on the fly, but without a title. Maybe we just had a bit of a misunderstanding.

I use default minimal theme (42f0e71), my test content: example-content.zip

./public/posts/index.html output file:

Left: actual result with example content | Right: real index.md is present

[akasmix]

@grego Sorry for ping, but could you please publish a new release (e.g., 0.6.0) to make the bug fix 1cb447e easily accessible for everyone? It’s not urgent, but it would simplify my CI workflow. Thank you for your work!

[grego]

Alright, published 0.6.0