On Linux & macOS the following command should work. For Windows you have to adapt $PWD
accordingly:
zola build --base-url="$PWD/public/index.html" --output-dir="$PWD/public"
- Visit https://prismjs.com/download.html
- Select version: "Minified"
- Select theme: "Default"
- Select languages: "Rust" (and only Rust)
- Select plugins: "Keep Markup", "Highlight Keywords" (experimental)
- Save files and replace the ones in
static
- In
git
, discard changes to CSS which now make the page look ugly (for example but not limited to:font-style
,background
, ...)
- https://ezgif.com/image-to-datauri
- Add to
postprocess.js
The pentagram has a few desirable properties:
- easier and safer to execute compared to heptagrams and tridecagrams,
- faster to draw,
- has excellent documentation spanning several centuries,
- and, most importantly, it requires less blood and is therefore more ergonomic.
In other words, the pentagram is the Rust of summoning circles.
They are messy to compose and their internals are unspecified. In contrast, Box
and Vec
are relatively well defined or at least simple. I might accept PRs, but there is a good chance for that PR to be complex and outdated soon.
Some of the wontfix end up on Github with a brief comment why. The most common reason something didn't get fixed: The comment was too short or cryptic, and it was unclear what's actually broken.
Images are easier to create, but harder to version. Between PNGs and SVGs, HTML had the nicest balance.
At the risk of being overly specific, the persona the page is written for:
- 3+ years non-Rust programming experience (Java, Python, C, ...)
- 2+ weeks Rust experience (read a book or completed a tutorial)
- some familiarity with C-level concepts (memory, pointers)
We of course hope to provide value even if someone doesn't fall into that bucket, but not at the expense of a streamlined experience for our target audience.
Maybe. The current policy is not set in stone but is vaguely:
- To add items to an existing list the entry should be high quality and the list shouldn't grow too long.
- To add a specific link somewhere else it should be the best of its kind for that purpose.