X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/c35444826ca47123697a8f2512866f4f99964cc4..778597174ef28c71bfec68071ed16feaf413f8ec:/doc/usage.mdwn diff --git a/doc/usage.mdwn b/doc/usage.mdwn index aa352736c..29ec09670 100644 --- a/doc/usage.mdwn +++ b/doc/usage.mdwn @@ -56,10 +56,12 @@ These options control the mode that ikiwiki is operating in. In setup mode, ikiwiki reads the config file, which is really a perl program that can call ikiwiki internal functions. + [[ikiwiki.setup]] is an example of such a config file. + The default action when --setup is specified is to automatically generate wrappers for a wiki based on data in a config file, and rebuild the wiki. - - [[ikiwiki.setup]] is an example of such a config file. + If you only want to build any changed pages, you can use --refresh with + --setup. * --wrappers @@ -99,9 +101,10 @@ configuration options of their own. * --templatedir - Specify the directory that the page [[templates]] are stored in. - Default is `/usr/share/ikiwiki/templates`, or another location as - configured at build time. + Specify the directory that the page [[templates]] are stored in. Default + is `/usr/share/ikiwiki/templates`, or another location as configured at + build time. If the templatedir is changed, missing templates will still + be searched for in the default location as a fallback. * --underlaydir @@ -159,7 +162,12 @@ configuration options of their own. * --rss, --norss - If rss is set, ikiwiki will generate rss feeds for pages that inline + If rss is set, ikiwiki will generate RSS feeds for pages that inline + a [[blog]]. + +* --atom, --noatom + + If atom is set, ikiwiki will generate Arom feeds for pages that inline a [[blog]]. * --pingurl url @@ -223,6 +231,12 @@ configuration options of their own. Enables or disables "Discussion" links from being added to the header of every page. The links are enabled by default. +* --userdir subdir + + Optionally, allows links to users of the wiki to link to pages inside a + subdirectory of the wiki. The default is to link to pages in the toplevel + directory of the wiki. + * --timeformat format Specify how to display the time or date. The format string is passed to the @@ -230,7 +244,7 @@ configuration options of their own. * --verbose, --no-verbose - Be vebose about what is being done. + Be verbose about what is being done. * --syslog, --no-syslog