0.18.0 zola serve requires restart to complete Getting Started Overview

[iamorphen]

Documentation issue

(Thanks for Zola!)

Summary

I am new to Zola and started by following the Getting Started Overview documentation. When following the current docs top-down as-is, I get a 404 when attempting to follow the instructions here:

If you go to http://127.0.0.1:1111/blog/, you will see the section page for blog. The list is empty because we don't have any blog posts. Let's fix that now.

I need to kill zola serve and restart it, and then the page resolves.

Runtime: macOS 14.1.1, Zola 0.18.0, Firefox 121.0.1.

Proposed solution

At the time of this writing, the hosted docs say they're for Zola 0.17.*, so maybe my experience is a known or expected issue. However, I don't see any advisories in the docs on master either. Possible solutions are updating the docs to mention that we might need to restart zola serve or making the zola tool robust to whatever underlying changes it needs to monitor for the docs to work as-is.

[pranaysy]

I am experiencing the exact same issue with Zola 0.18.0 on Windows 10 22H2 running Firefox 122.0.1. I can confirm that killing zola serve and restarting fixes the issue.

[ulab]

I do think that the order in which pages and templates are created is wrong. The introduction creates the content first, then the template file. So you get:

Error: Failed to build the site
Error: Failed to render section '.../content/blog/_index.md'
Error: Reason: Tried to render `blog.html` but the template wasn't found

While creating the template then is recognized, it only reloads the template, not the content.

Change detected @ 2024-04-29 16:39:14
-> Template changed .../templates/blog-page.html
Reloading only template
Done in 2ms.

If you create the templates first and then the content, it will work without restarting.