aboutsummaryrefslogtreecommitdiff
path: root/doc/basewiki.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'doc/basewiki.mdwn')
-rw-r--r--doc/basewiki.mdwn26
1 files changed, 26 insertions, 0 deletions
diff --git a/doc/basewiki.mdwn b/doc/basewiki.mdwn
new file mode 100644
index 000000000..8392884eb
--- /dev/null
+++ b/doc/basewiki.mdwn
@@ -0,0 +1,26 @@
+The basewiki is a standard set of wiki pages that are included by default in
+all wikis that ikiwiki builds, unless the wiki overrides them with its own
+versions.
+
+It currently includes these pages:
+
+* [[index]]
+* [[sandbox]]
+* [[shortcuts]]
+* [[templates]]
+* [[ikiwiki/formatting]]
+* [[ikiwiki/markdown]]
+* [[ikiwiki/openid]]
+* [[ikiwiki/pagespec]]
+* [[ikiwiki/directive]]
+* [[ikiwiki/subpage]]
+* [[ikiwiki/wikilink]]
+
+As well as a few other files, like [[favicon.ico]], [[local.css]],
+[[style.css]], and some icons.
+
+Note that an important property of the basewiki is that it should be
+self-contained. That means that the pages listed above cannot link
+to pages outside the basewiki. Ikiwiki's test suite checks that the
+basewiki is self-contained, and from time to time links have to be
+removed (or replaced with `iki` [[shortcuts]]) to keep this invariant.