I’ve made this post to discuss documentation.
Is it possible to add admonition support (!!! warning) to Zola? For example, Zola deletes the output directory when the server is killed. It might not be clear that the --output-dir flag will delete all data in the given directory, even if this directory already exists and contains data. I’d like to add a warning note for “–output-dir”. Maybe the command line should also warn if the directory given for --output-dir already exists.
I’ve made a quickstart section (currently called “Overview”) (https://github.com/photong/zola/blob/docs-next/docs/content/documentation/getting-started/overview.md) that shows how to make a very simple site. I’d like to add a more detailed “Tutorial” section that builds on this simple site to create a usable blog. I’m thinking of adding:
i. A basic theme (if Zola gets a default theme, use that; if not, use Bulma CSS framework).
ii. Posts with images (to show how asset colocation works).
iii. Blog sections made with folders (to show how _index.md works).
iv. Author information (as TOML file to show how data loading works).
v. An image gallery (to show the image processing features).
I’ll consider any other ideas.