wiki publish
build the site for a host
wiki publish builds the same site as wiki build into the folder it is given, with addresses that end
in a folder rather than a file.[1] Those addresses need a server; how they differ is described on
Site.
Usage
The folder is required.[2]
wiki publish [-h] [--root ROOT] [--wiki WIKI] OUT
wiki publish site-out
Arguments
| Argument | Meaning |
|---|---|
OUT |
the folder to build into, relative to the working directory; empty, or an earlier build[2] |
Output
It prints what wiki build prints, then a reminder that the result needs a server.[3] Like
wiki build, it records each changed page's date in UPDATED.toml.[4] On a wiki of three pages,
with the folder being wherever the command ran:[3]
wiki: goals 25 words 0 cited 0 missing
wiki: index 8 words 0 cited 0 missing
wiki: refunds 22 words 1 cited 1 missing
wiki: 1 source cited, 1 claim marked as having no source
wiki: the collected goals read in 17 words
wiki: these budgets are PROVISIONAL -- 500 words a page, 3500 for the collected goals. What this project's readers actually read has not been measured; until it is, the numbers are a guess that happens to be enforced. Set budget.calibrated in wiki.toml once it is.
wiki: 3 pages written to /path/to/notes/site-out
wiki: /path/to/notes/site-out uses clean addresses and needs a server; the site itself opens without one
Exit codes
| Code | Condition | Message |
|---|---|---|
0 |
the site is built[5] | wiki: /path/to/notes/site-out uses clean addresses and needs a server; the site itself opens without one |
1 |
a problem stops the build[5] | the problem |
2 |
OUT is not empty and was not made by the tool[5] |
wiki: /path/to/notes/taken is not empty and was not written by this tool; remove it yourself if you meant to replace it |
2 |
there is no wiki where it was pointed[5] | wiki: no wiki at nowhere |
Last updated 14 September 2026Last audited never215 wordsabout 1 minute to read5 sources cited0 claims with no source