Site

what a build makes

wiki build turns the pages into a website in docs/wiki/site, beside them.^[1] The site is never committed.^[2] It is rebuilt each time wiki serve starts, and a page edited while the server runs appears after wiki build.^[2] What refuses a page is described on Checks, and how the site is served on Local server.

Addresses

Every page is a folder holding one file, index.html, and every link names that file.^[3] That way the same site works both through a server and opened straight from disk.^[3] wiki publish builds it with clean addresses instead, which work only on a host.^[4] A link that leaves the wiki opens in a new tab, is marked nofollow and ends in an arrow, without its author writing anything but the link.^[5]

The build deletes whatever it no longer makes, so a removed page leaves nothing behind.^[6] For the same reason, it refuses to write into a folder it did not make, so it never empties a folder made by anything else.^[7]

A link to a wiki page that does not exist is drawn red instead of blue, and wiki check refuses it, naming the page and the line.^[8] A link to any other file that does not exist is not refused, and leads nowhere.^[9]

Dates

Each page ends with the day it last changed.^[10] That date moves only when the page's own text does: restyling or rebuilding the site leaves every date alone.^[10] The goals page is the exception: its date moves whenever any page's intent changes, including a draft's.^[11]

The record of dates is committed with the pages, because a date taken from the clock would say "today" forever.^[10] Every command that builds the site records dates, and wiki check never does.^[12] Instead, wiki check refuses a page whose text has changed since its date was recorded, and a record of a page that no longer exists, and says to run wiki build.^[13]

Search

The search box matches page titles only, not what the pages say, and shows at most eight results.^[14] Its index is written into every page rather than fetched, so search works from disk too.^[15]

Audiences

wiki user builds only the pages marked for users, which say audience = "user" in their front matter; an infobox group can be marked the same way.^[16] The user build strips every reference, every red mark and the Source tab.^[17] Every field is listed on Front matter.