- Install zola
- clone repo
- cd into repo
zola serve
- docs are located in
content/docs
- every new markdown file in
/content/docs/
should automatically appear on/docs
. - any headers should automatically appear automatically in the Table of Contents with anchor tags
- code examples are in
code
- create
cargo new some-new-example
- add
some-new-example
to the workspace members incode/Cargo.toml
- write your code
- add a comment
//<section-name>
before your example snippet - add a comment
//</section-name>
after your example snippet - in your
content/docs/some_feature.md
include your code sample with:{{ code(path="some-new-example/src/main.rs", section="section-name") }}
- No source for tour
- Tour doesn't work with zola server (should be fixed on next update)
- links are being html escaped
- wasm tour is kind of hacked together
- https://github.com/hecrj/iced/tree/master/web
- then some copy and pasting of a JS lib into the
tour.js
file