All meta titles are first extracted at scan time, i.e. before we turn
PO files back into translated markdown; escaping of double-quotes in
PO files breaks the meta plugin's parsing enough to save ugly titles
to %pagestate at this time.
Then, at render time, every page's passes on row through the Great
Rendering Chain (filter->preprocess->linkify->htmlize), and the meta
plugin's preprocess hook is this time in a position to correctly
extract the titles from slave pages.
This is, unfortunately, too late: if the page A, linking to the page B,
is rendered before B, it will display the wrongly-extracted meta title
as the link text to B.
On the one hand, such a corner case only happens on rebuild: on
refresh, every rendered page is fixed to contain correct meta titles.
On the other hand, it can take some time to get every page fixed.
We therefore re-render every rendered page after a rebuild to fix them
at once. As this more or less doubles the time needed to rebuild the
wiki, we do so only when really needed.
Signed-off-by: intrigeri <intrigeri@boum.org>
It will set up an ikiwiki instance tuned for use in blogging.
As part of this change, move the example sites into /usr/share/ikiwiki so
they are available even if docs are not installed.
This rewritten setup page starts with auto.setup and explains
basic customisation and use after that has set up a wiki. It's much easier
to follow than the old method, with less things to learn. (Downside: Less
it learned.)
Asking for only the head worked in my tests, but I've found a site where it
didn't -- apparently ikiwiki didn't get a chance to do or finish the
refresh when HEADed. Getting the whole url, waiting for ikiwiki to finish,
avoided the update problem.
ikiwiki has some pretty distinct fingerprints even when it's used
in unusual ways on sites that don't make it obvious it's being used:
* tova: a) rss and atom feed buttons
b) use of toc plugin on some pages
c) usual page.tmpl droppings
d) (I know the tova guys :)
* awesome: a) usual page.tmpl droppings
b) ikiwiki/ page and rest of basewiki pages exist
* UK software patents: used to use ikiwiki based on similar
fingerprints, but not now. Removed