From 88e8f08c8ffe61fbb3aa8d0fbf78a86c30c65543 Mon Sep 17 00:00:00 2001 From: joey Date: Tue, 13 Feb 2007 23:10:45 +0000 Subject: * Make the basewiki be full of symlinks to pages that should be the same in the doc wiki. This will allow direct edits to alter the base wiki without manual munging. --- Makefile.PL | 2 +- basewiki/blog.mdwn | 36 +----- basewiki/favicon.ico | Bin 393 -> 18 bytes basewiki/helponformatting.mdwn | 79 +------------ basewiki/local.css | 4 +- basewiki/markdown.mdwn | 11 +- basewiki/openid.mdwn | 35 +----- basewiki/pagespec.mdwn | 72 +----------- basewiki/preprocessordirective.mdwn | 34 +----- basewiki/shortcuts.mdwn | 19 +-- basewiki/smileys.mdwn | 51 +------- basewiki/smileys/alert.png | Bin 220 -> 0 bytes basewiki/smileys/angry.png | Bin 295 -> 0 bytes basewiki/smileys/attention.png | Bin 164 -> 0 bytes basewiki/smileys/biggrin.png | Bin 173 -> 0 bytes basewiki/smileys/checkmark.png | Bin 133 -> 0 bytes basewiki/smileys/devil.png | Bin 354 -> 0 bytes basewiki/smileys/frown.png | Bin 168 -> 0 bytes basewiki/smileys/icon-error.png | Bin 159 -> 0 bytes basewiki/smileys/icon-info.png | Bin 177 -> 0 bytes basewiki/smileys/idea.png | Bin 372 -> 0 bytes basewiki/smileys/ohwell.png | Bin 167 -> 0 bytes basewiki/smileys/prio1.png | Bin 153 -> 0 bytes basewiki/smileys/prio2.png | Bin 159 -> 0 bytes basewiki/smileys/prio3.png | Bin 154 -> 0 bytes basewiki/smileys/redface.png | Bin 306 -> 0 bytes basewiki/smileys/sad.png | Bin 299 -> 0 bytes basewiki/smileys/smile.png | Bin 356 -> 0 bytes basewiki/smileys/smile2.png | Bin 334 -> 0 bytes basewiki/smileys/smile3.png | Bin 326 -> 0 bytes basewiki/smileys/smile4.png | Bin 275 -> 0 bytes basewiki/smileys/star_off.png | Bin 297 -> 0 bytes basewiki/smileys/star_on.png | Bin 374 -> 0 bytes basewiki/smileys/thumbs-up.png | Bin 118 -> 0 bytes basewiki/smileys/tired.png | Bin 157 -> 0 bytes basewiki/smileys/tongue.png | Bin 176 -> 0 bytes basewiki/style.css | 229 +----------------------------------- basewiki/subpage.mdwn | 12 +- basewiki/subpage/linkingrules.mdwn | 32 ----- basewiki/wikiicons/diff.png | Bin 219 -> 0 bytes basewiki/wikilink.mdwn | 24 +--- debian/changelog | 5 +- doc/blog.mdwn | 35 ++++++ doc/favicon.ico | Bin 0 -> 393 bytes doc/helponformatting.mdwn | 78 ++++++++++++ doc/local.css | 3 + doc/markdown.mdwn | 10 ++ doc/openid.mdwn | 34 ++++++ doc/pagespec.mdwn | 71 +++++++++++ doc/preprocessordirective.mdwn | 33 ++++++ doc/sandbox.mdwn | 2 +- doc/shortcuts.mdwn | 18 +++ doc/smileys.mdwn | 50 ++++++++ doc/smileys/alert.png | Bin 0 -> 220 bytes doc/smileys/angry.png | Bin 0 -> 295 bytes doc/smileys/attention.png | Bin 0 -> 164 bytes doc/smileys/biggrin.png | Bin 0 -> 173 bytes doc/smileys/checkmark.png | Bin 0 -> 133 bytes doc/smileys/devil.png | Bin 0 -> 354 bytes doc/smileys/frown.png | Bin 0 -> 168 bytes doc/smileys/icon-error.png | Bin 0 -> 159 bytes doc/smileys/icon-info.png | Bin 0 -> 177 bytes doc/smileys/idea.png | Bin 0 -> 372 bytes doc/smileys/ohwell.png | Bin 0 -> 167 bytes doc/smileys/prio1.png | Bin 0 -> 153 bytes doc/smileys/prio2.png | Bin 0 -> 159 bytes doc/smileys/prio3.png | Bin 0 -> 154 bytes doc/smileys/redface.png | Bin 0 -> 306 bytes doc/smileys/sad.png | Bin 0 -> 299 bytes doc/smileys/smile.png | Bin 0 -> 356 bytes doc/smileys/smile2.png | Bin 0 -> 334 bytes doc/smileys/smile3.png | Bin 0 -> 326 bytes doc/smileys/smile4.png | Bin 0 -> 275 bytes doc/smileys/star_off.png | Bin 0 -> 297 bytes doc/smileys/star_on.png | Bin 0 -> 374 bytes doc/smileys/thumbs-up.png | Bin 0 -> 118 bytes doc/smileys/tired.png | Bin 0 -> 157 bytes doc/smileys/tongue.png | Bin 0 -> 176 bytes doc/style.css | 228 +++++++++++++++++++++++++++++++++++ doc/subpage.mdwn | 11 ++ doc/subpage/linkingrules.mdwn | 32 +++++ doc/wikiicons/diff.png | Bin 0 -> 219 bytes doc/wikilink.mdwn | 23 ++++ 83 files changed, 644 insertions(+), 629 deletions(-) mode change 100644 => 120000 basewiki/blog.mdwn mode change 100644 => 120000 basewiki/favicon.ico mode change 100644 => 120000 basewiki/helponformatting.mdwn mode change 100644 => 120000 basewiki/local.css mode change 100644 => 120000 basewiki/markdown.mdwn mode change 100644 => 120000 basewiki/openid.mdwn mode change 100644 => 120000 basewiki/pagespec.mdwn mode change 100644 => 120000 basewiki/preprocessordirective.mdwn mode change 100644 => 120000 basewiki/shortcuts.mdwn mode change 100644 => 120000 basewiki/smileys.mdwn delete mode 100644 basewiki/smileys/alert.png delete mode 100644 basewiki/smileys/angry.png delete mode 100644 basewiki/smileys/attention.png delete mode 100644 basewiki/smileys/biggrin.png delete mode 100644 basewiki/smileys/checkmark.png delete mode 100644 basewiki/smileys/devil.png delete mode 100644 basewiki/smileys/frown.png delete mode 100644 basewiki/smileys/icon-error.png delete mode 100644 basewiki/smileys/icon-info.png delete mode 100644 basewiki/smileys/idea.png delete mode 100644 basewiki/smileys/ohwell.png delete mode 100644 basewiki/smileys/prio1.png delete mode 100644 basewiki/smileys/prio2.png delete mode 100644 basewiki/smileys/prio3.png delete mode 100644 basewiki/smileys/redface.png delete mode 100644 basewiki/smileys/sad.png delete mode 100644 basewiki/smileys/smile.png delete mode 100644 basewiki/smileys/smile2.png delete mode 100644 basewiki/smileys/smile3.png delete mode 100644 basewiki/smileys/smile4.png delete mode 100644 basewiki/smileys/star_off.png delete mode 100644 basewiki/smileys/star_on.png delete mode 100644 basewiki/smileys/thumbs-up.png delete mode 100644 basewiki/smileys/tired.png delete mode 100644 basewiki/smileys/tongue.png mode change 100644 => 120000 basewiki/style.css mode change 100644 => 120000 basewiki/subpage.mdwn delete mode 100644 basewiki/subpage/linkingrules.mdwn delete mode 100644 basewiki/wikiicons/diff.png mode change 100644 => 120000 basewiki/wikilink.mdwn create mode 100644 doc/blog.mdwn create mode 100644 doc/favicon.ico create mode 100644 doc/helponformatting.mdwn create mode 100644 doc/local.css create mode 100644 doc/markdown.mdwn create mode 100644 doc/openid.mdwn create mode 100644 doc/pagespec.mdwn create mode 100644 doc/preprocessordirective.mdwn create mode 100644 doc/shortcuts.mdwn create mode 100644 doc/smileys.mdwn create mode 100644 doc/smileys/alert.png create mode 100644 doc/smileys/angry.png create mode 100644 doc/smileys/attention.png create mode 100644 doc/smileys/biggrin.png create mode 100644 doc/smileys/checkmark.png create mode 100644 doc/smileys/devil.png create mode 100644 doc/smileys/frown.png create mode 100644 doc/smileys/icon-error.png create mode 100644 doc/smileys/icon-info.png create mode 100644 doc/smileys/idea.png create mode 100644 doc/smileys/ohwell.png create mode 100644 doc/smileys/prio1.png create mode 100644 doc/smileys/prio2.png create mode 100644 doc/smileys/prio3.png create mode 100644 doc/smileys/redface.png create mode 100644 doc/smileys/sad.png create mode 100644 doc/smileys/smile.png create mode 100644 doc/smileys/smile2.png create mode 100644 doc/smileys/smile3.png create mode 100644 doc/smileys/smile4.png create mode 100644 doc/smileys/star_off.png create mode 100644 doc/smileys/star_on.png create mode 100644 doc/smileys/thumbs-up.png create mode 100644 doc/smileys/tired.png create mode 100644 doc/smileys/tongue.png create mode 100644 doc/style.css create mode 100644 doc/subpage.mdwn create mode 100644 doc/subpage/linkingrules.mdwn create mode 100644 doc/wikiicons/diff.png create mode 100644 doc/wikilink.mdwn diff --git a/Makefile.PL b/Makefile.PL index fd13255cd..cfcc19db7 100755 --- a/Makefile.PL +++ b/Makefile.PL @@ -45,7 +45,7 @@ extra_install: $(CP) -a templates/* $(DESTDIR)$(PREFIX)/share/ikiwiki/templates install -d $(DESTDIR)$(PREFIX)/share/ikiwiki/basewiki - $(CP) -a basewiki/* $(DESTDIR)$(PREFIX)/share/ikiwiki/basewiki + $(CP) -aL basewiki/* $(DESTDIR)$(PREFIX)/share/ikiwiki/basewiki install -d $(DESTDIR)$(PREFIX)/share/man/man1 install -m 644 ikiwiki.man $(DESTDIR)$(PREFIX)/share/man/man1/ikiwiki.1 diff --git a/basewiki/blog.mdwn b/basewiki/blog.mdwn deleted file mode 100644 index 859fa6aaa..000000000 --- a/basewiki/blog.mdwn +++ /dev/null @@ -1,35 +0,0 @@ -You can turn any page on this wiki into a weblog by inserting a -[[PreProcessorDirective]]. Like this: - - \[[inline pages="blog/* and !*/Discussion" show="10" rootpage="blog"]] - -Any pages that match the specified [[PageSpec]] (in the example, any -[[SubPage]] of "blog") will be part of the blog, and the newest 10 -of them will appear in the page. Note that if files that are not pages -match the [[PageSpec]], they will be included in the feed using RSS -enclosures, which is useful for podcasting. - -The optional `rootpage` parameter tells the wiki that new posts to this blog -should default to being [[SubPage]]s of "blog", and enables a form at the -top of the blog that can be used to add new items. - -If you want your blog to have an archive page listing every post ever made -to it, you can accomplish that like this: - - \[[inline pages="blog/* and !*/Discussion" archive="yes"]] - -You can even create an automatically generated list of all the pages on the -wiki, with the most recently added at the top, like this: - - \[[inline pages="* and !*/Discussion" archive="yes"]] - -If you want to be able to add pages to a given blog feed by tagging them, -you can do that too. To tag a page, just make it link to a page or pages -that represent its tags. Then use the special link() [[PageSpec]] to match -all pages that have a given tag: - - \[[inline pages="link(life)"]] - -Or include some tags and exclude others: - - \[[inline pages="link(debian) and !link(social)"]] diff --git a/basewiki/blog.mdwn b/basewiki/blog.mdwn new file mode 120000 index 000000000..1b35deb8a --- /dev/null +++ b/basewiki/blog.mdwn @@ -0,0 +1 @@ +../doc/blog.mdwn \ No newline at end of file diff --git a/basewiki/favicon.ico b/basewiki/favicon.ico deleted file mode 100644 index 354b627f0..000000000 Binary files a/basewiki/favicon.ico and /dev/null differ diff --git a/basewiki/favicon.ico b/basewiki/favicon.ico new file mode 120000 index 000000000..0572371db --- /dev/null +++ b/basewiki/favicon.ico @@ -0,0 +1 @@ +../doc/favicon.ico \ No newline at end of file diff --git a/basewiki/helponformatting.mdwn b/basewiki/helponformatting.mdwn deleted file mode 100644 index 3a0ddb9f2..000000000 --- a/basewiki/helponformatting.mdwn +++ /dev/null @@ -1,78 +0,0 @@ -# Help on formatting text - -Text on this wiki is, by default, written in a form very close to how you -might write text for an email message. This style of text formatting is -called [[MarkDown]], and it works like this: - -Leave blank lines between paragraphs. - -You can \**emphasise*\* or \*\***strongly emphasise**\*\* text by placing it -in single or double asterisks. - -To create a list, start each line with an asterisk: - -* "* this is my list" -* "* another item" - -To make a numbered list, start each line with a number (any number will -do) followed by a period: - -1. "1. first line" -2. "2. second line" -2. "2. third line" - -To create a header, start a line with one or more `#` characters followed -by a space and the header text. The number of `#` characters controls the -size of the header: - -# # h1 -## ## h2 -### ### h3 -#### #### h4 -##### ##### h5 -###### ###### h6 - -You can also make the first two levels of heading by underlining text with -equals or dash: - -heading 1 -========= - - heading 1 - ========= - -heading 2 ---------- - - heading 2 - --------- - -To create a horizontal rule, just write three or more dashes or stars on -their own line: - ----- - -To quote someone, prefix the quote with ">": - -> To be or not to be, -> that is the question. - -To write a code block, indent each line with a tab or 4 spaces: - - 10 PRINT "Hello, world!" - 20 GOTO 10 - -To link to another page on the wiki, place the page's name inside double -square brackets, so you would use `\[[WikiLink]]` to link to [[WikiLink]]. - -To link to any other web page, or to an email address, you can just put the url in angle brackets: <>, or you can use the form -\[link text\]\(url\) - ----- - -You can also use [[PreProcessorDirective]]s to do additional cool stuff. - -[[if test="enabled(smiley)" then=""" -Also, because this wiki has the smiley plugin enabled, you can -insert [[smileys]] and some other useful symbols. -"""]] diff --git a/basewiki/helponformatting.mdwn b/basewiki/helponformatting.mdwn new file mode 120000 index 000000000..56c810f3c --- /dev/null +++ b/basewiki/helponformatting.mdwn @@ -0,0 +1 @@ +../doc/helponformatting.mdwn \ No newline at end of file diff --git a/basewiki/local.css b/basewiki/local.css deleted file mode 100644 index a0dec8cfd..000000000 --- a/basewiki/local.css +++ /dev/null @@ -1,3 +0,0 @@ -/* ikiwiki local style sheet */ - -/* Add local styling here, instead of modifying style.css. */ diff --git a/basewiki/local.css b/basewiki/local.css new file mode 120000 index 000000000..f081a6a60 --- /dev/null +++ b/basewiki/local.css @@ -0,0 +1 @@ +../doc/local.css \ No newline at end of file diff --git a/basewiki/markdown.mdwn b/basewiki/markdown.mdwn deleted file mode 100644 index 317a17db9..000000000 --- a/basewiki/markdown.mdwn +++ /dev/null @@ -1,10 +0,0 @@ -[Markdown](http://daringfireball.net/projects/markdown/) -is a minimal markup language that resembles plain text as used in -email messages. It is the markup language used by this wiki by default. - -For documentation about the markdown syntax, see [[HelpOnFormatting]] and -[Markdown: syntax](http://daringfireball.net/projects/markdown/syntax). - -Note that [[WikiLink]]s and [[PreProcessorDirective]]s are not part of the -markdown syntax, and are the only bit of markup that this wiki handles -internally. diff --git a/basewiki/markdown.mdwn b/basewiki/markdown.mdwn new file mode 120000 index 000000000..1724caec2 --- /dev/null +++ b/basewiki/markdown.mdwn @@ -0,0 +1 @@ +../doc/markdown.mdwn \ No newline at end of file diff --git a/basewiki/openid.mdwn b/basewiki/openid.mdwn deleted file mode 100644 index 7c6d2bda7..000000000 --- a/basewiki/openid.mdwn +++ /dev/null @@ -1,34 +0,0 @@ -[[meta title="OpenID"]] - -[[template id=note text=""" -[[if test="enabled(openid)" - then="This wiki has OpenID **enabled**." - else="This wiki has OpenID **disabled**."]] -"""]] - -[OpenID](http://openid.net) is a decentralized authentication mechanism -that allows you to have one login that you can use on a growing number of -websites. - -To sign up for an OpenID, visit one of the following identity providers: - -* [MyOpenID](https://www.myopenid.com/) -* [GetOpenID](https://getopenid.com/) -* [Videntity](http://videntity.org/) -* [LiveJournal](http://www.livejournal.com/openid/) -* or any of the many others out there.. - -Your OpenID is the URL that you are given when you sign up. -[[if test="enabled(openid)" then=""" -To sign in to this wiki using OpenID, just enter it in the OpenID field in the -signin form. You do not need to give this wiki a password or go through any -registration process when using OpenID. -"""]] - ---- - -It's also possible to make a page in the wiki usable as an OpenID url, -by delegating it to an openid server. Here's an example of how to do that: - - \[[meta link="http://www.myopenid.com/server" rel="openid.server"]] - \[[meta link="http://yourid.myopenid.com/" rel="openid.delegate"]] diff --git a/basewiki/openid.mdwn b/basewiki/openid.mdwn new file mode 120000 index 000000000..3a37eab73 --- /dev/null +++ b/basewiki/openid.mdwn @@ -0,0 +1 @@ +../doc/openid.mdwn \ No newline at end of file diff --git a/basewiki/pagespec.mdwn b/basewiki/pagespec.mdwn deleted file mode 100644 index 53519e7f0..000000000 --- a/basewiki/pagespec.mdwn +++ /dev/null @@ -1,71 +0,0 @@ -To select a set of pages, such as pages that are locked, pages -whose commit emails you want subscribe to, or pages to combine into a -blog, the wiki uses a PageSpec. This is an expression that matches -a set of pages. - -The simplest PageSpec is a simple list of pages. For example, this matches -any of the three listed pages: - - foo or bar or baz - -More often you will want to match any pages that have a particular thing in -their name. You can do this using a glob pattern. "`*`" stands for any part -of a page name, and "`?`" for any single letter of a page name. So this -matches all pages about music, and any [[SubPage]]s of the SandBox, but does -not match the SandBox itself: - - *music* or SandBox/* - -You can also prefix an item with "`!`" to skip pages that match it. So to -match all pages except for Discussion pages and the SandBox: - - * and !SandBox and !*/Discussion - -Some more elaborate limits can be added to what matches using any of these -functions: - -* "`link(page)`" - match only pages that link to a given page -* "`backlink(page)`" - match only pages that a given page links to -* "`creation_month(month)`" - match only pages created on the given month -* "`creation_day(mday)`" - or day of the month -* "`creation_year(year)`" - or year -* "`created_after(page)`" - match only pages created after the given page - was created -* "`created_before(page)`" - match only pages created before the given page - was created - -For example, to match all pages in a blog that link to the page about music -and were written in 2005: - - blog/* and link(music) and creation_year(2005) - -More complex expressions can also be created, by using parentheses for -grouping. For example, to match pages in a blog that are tagged with either -of two tags, use: - - blog/* and (link(tag/foo) or link(tag/bar)) - -Note that page names in PageSpecs are matched against the absolute -filenames of the pages in the wiki, so a pagespec "foo" used on page -"a/b" will not match a page named "a/foo" or "a/b/foo". To match -relative to the directory of the page containing the pagespec, you can -use "./". For example, "./foo" on page "a/b" matches page "a/foo". - -## Old syntax - -The old PageSpec syntax was called a "GlobList", and worked differently in -two ways: - -1. "and" and "or" were not used; any page matching any item from the list - matched. -2. If an item was prefixed with "`!`", then no page matching that item - matched, even if it matched an earlier list item. - -For example, here is the old way to match all pages except for the SandBox -and Discussion pages: - - * !SandBox !*/Discussion - -Using this old syntax is still supported. However, the old syntax is -deprecated and will be removed at some point, and using the new syntax is -recommended. diff --git a/basewiki/pagespec.mdwn b/basewiki/pagespec.mdwn new file mode 120000 index 000000000..71ea44d15 --- /dev/null +++ b/basewiki/pagespec.mdwn @@ -0,0 +1 @@ +../doc/pagespec.mdwn \ No newline at end of file diff --git a/basewiki/preprocessordirective.mdwn b/basewiki/preprocessordirective.mdwn deleted file mode 100644 index 1e2332c09..000000000 --- a/basewiki/preprocessordirective.mdwn +++ /dev/null @@ -1,33 +0,0 @@ -Preprocessor directives are similar to a [[WikiLink]] in form, except they -contain spaces and parameters. The general form is: - - \[[directive param="value" param="value"]] - -This gets expanded before the rest of the page is processed, and can be used -to transform the page in various ways. - -The quotes around values can be omitted if the value is a simple word. -Also, some directives may use parameters without values, for example: - - \[[tag foo]] - -Note that if a preprocessor directive has no parameters, a space still must -be put after its name, to avoid confusion with a [[WikiLink]]. For example: - - \[[pagecount ]] - -A preprocessor directive does not need to all be on one line, it can be -wrapped to multiple lines if you like: - - \[[directive foo="baldersnatch" - bar="supercalifragalisticexpealadocious" baz=11]] - -Also, multiple lines of *quoted* text can be used for a value. -To allow quote marks inside the quoted text, delimit the block -of text with triple-quotes: - - \[[directive text=""" - 1. "foo" - 2. "bar" - 3. "baz" - """]] diff --git a/basewiki/preprocessordirective.mdwn b/basewiki/preprocessordirective.mdwn new file mode 120000 index 000000000..f786ed33b --- /dev/null +++ b/basewiki/preprocessordirective.mdwn @@ -0,0 +1 @@ +../doc/preprocessordirective.mdwn \ No newline at end of file diff --git a/basewiki/shortcuts.mdwn b/basewiki/shortcuts.mdwn deleted file mode 100644 index f9d586bbf..000000000 --- a/basewiki/shortcuts.mdwn +++ /dev/null @@ -1,18 +0,0 @@ -This page controls what shortcut links the wiki supports. - -* [[shortcut name=google url="http://www.google.com/search?q=%s"]] -* [[shortcut name=wikipedia url="http://en.wikipedia.org/wiki/%s"]] -* [[shortcut name=debbug url="http://bugs.debian.org/%s" desc="bug #%s"]] -* [[shortcut name=deblist url="http://lists.debian.org/debian-%s" desc="debian-%s@lists.debian.org"]] -* [[shortcut name=debpkg url="http://packages.debian.org/%s"]] -* [[shortcut name=debpts url="http://packages.qa.debian.org/%s"]] -* [[shortcut name=fdobug url="https://bugs.freedesktop.org/show_bug.cgi?id=%s" desc="freedesktop.org bug #%s"]] -* [[shortcut name=fdolist url="http://lists.freedesktop.org/mailman/listinfo/%s" desc="%s@lists.freedesktop.org"]] -* [[shortcut name=cpan url="http://search.cpan.org/search?mode=dist&query=%s"]] -* [[shortcut name=ctan url="http://tug.ctan.org/cgi-bin/ctanPackageInformation.py?id=%s"]] -* [[shortcut name=iki url="http://ikiwiki.kitenet.net/%s.html"]] -* [[shortcut name=ljuser url="http://%s.livejournal.com/"]] - -To add a new shortcut, use the "shortcut" preprocessor directive. "%s" is -replaced with the text passed to the named shortcut. The optional desc -parameter controls the description of the link. diff --git a/basewiki/shortcuts.mdwn b/basewiki/shortcuts.mdwn new file mode 120000 index 000000000..33892d73a --- /dev/null +++ b/basewiki/shortcuts.mdwn @@ -0,0 +1 @@ +../doc/shortcuts.mdwn \ No newline at end of file diff --git a/basewiki/smileys.mdwn b/basewiki/smileys.mdwn deleted file mode 100644 index e5377ced2..000000000 --- a/basewiki/smileys.mdwn +++ /dev/null @@ -1,50 +0,0 @@ -This page is used to control what smileys are supported by the wiki. -Just write the text of a smiley to display it. - -* \:) [[smileys/smile.png]] -* \:-) [[smileys/smile.png]] -* \:D [[smileys/biggrin.png]] -* \:-D [[smileys/biggrin.png]] -* \B) [[smileys/smile2.png]] -* \B-) [[smileys/smile2.png]] -* \:)) [[smileys/smile3.png]] -* \:-)) [[smileys/smile3.png]] -* \;) [[smileys/smile4.png]] -* \;-) [[smileys/smile4.png]] -* \:\ [[smileys/ohwell.png]] -* \:/ [[smileys/ohwell.png]] -* \:-/ [[smileys/ohwell.png]] -* \>:> [[smileys/devil.png]] -* \X-( [[smileys/angry.png]] -* \<:( [[smileys/frown.png]] -* \:( [[smileys/sad.png]] -* \:-( [[smileys/sad.png]] -* \:-? [[smileys/tongue.png]] -* \:o [[smileys/redface.png]] -* \|) [[smileys/tired.png]] -* \|-) [[smileys/tired.png]] -* \{OK} [[smileys/thumbs-up.png]] -* \{X} [[smileys/icon-error.png]] -* \{i} [[smileys/icon-info.png]] -* \(./) [[smileys/checkmark.png]] -* \(!) [[smileys/idea.png]] -* \[!] [[smileys/attention.png]] -* \/!\ [[smileys/alert.png]] -* \{*} [[smileys/star_on.png]] -* \{o} [[smileys/star_off.png]] -* \{1} [[smileys/prio1.png]] -* \{2} [[smileys/prio2.png]] -* \{3} [[smileys/prio3.png]] - -For example: {*} B) {*} - ----- - -To change the supported smileys, just edit the lists on this page. -Note that the format is important; each list item should start with the -text that is turned into the smiley, escaped so that users can see what -produces it, followed by a [[WikiLink]] to the image to display. - -/!\ Bear in mind that the link to the image needs to be written in a way that -will work if it's copied to other pages on the wiki. So be sure to include the -smileys directory in the path to the file. diff --git a/basewiki/smileys.mdwn b/basewiki/smileys.mdwn new file mode 120000 index 000000000..057df5adf --- /dev/null +++ b/basewiki/smileys.mdwn @@ -0,0 +1 @@ +../doc/smileys.mdwn \ No newline at end of file diff --git a/basewiki/smileys/alert.png b/basewiki/smileys/alert.png deleted file mode 100644 index 5bb87e33f..000000000 Binary files a/basewiki/smileys/alert.png and /dev/null differ diff --git a/basewiki/smileys/angry.png b/basewiki/smileys/angry.png deleted file mode 100644 index 05bc69f74..000000000 Binary files a/basewiki/smileys/angry.png and /dev/null differ diff --git a/basewiki/smileys/attention.png b/basewiki/smileys/attention.png deleted file mode 100644 index 7e064566d..000000000 Binary files a/basewiki/smileys/attention.png and /dev/null differ diff --git a/basewiki/smileys/biggrin.png b/basewiki/smileys/biggrin.png deleted file mode 100644 index f71b42c11..000000000 Binary files a/basewiki/smileys/biggrin.png and /dev/null differ diff --git a/basewiki/smileys/checkmark.png b/basewiki/smileys/checkmark.png deleted file mode 100644 index 8869caa19..000000000 Binary files a/basewiki/smileys/checkmark.png and /dev/null differ diff --git a/basewiki/smileys/devil.png b/basewiki/smileys/devil.png deleted file mode 100644 index 8684c3970..000000000 Binary files a/basewiki/smileys/devil.png and /dev/null differ diff --git a/basewiki/smileys/frown.png b/basewiki/smileys/frown.png deleted file mode 100644 index 2999b55ea..000000000 Binary files a/basewiki/smileys/frown.png and /dev/null differ diff --git a/basewiki/smileys/icon-error.png b/basewiki/smileys/icon-error.png deleted file mode 100644 index 53b1055f6..000000000 Binary files a/basewiki/smileys/icon-error.png and /dev/null differ diff --git a/basewiki/smileys/icon-info.png b/basewiki/smileys/icon-info.png deleted file mode 100644 index c08b08d74..000000000 Binary files a/basewiki/smileys/icon-info.png and /dev/null differ diff --git a/basewiki/smileys/idea.png b/basewiki/smileys/idea.png deleted file mode 100644 index 37bc02ddc..000000000 Binary files a/basewiki/smileys/idea.png and /dev/null differ diff --git a/basewiki/smileys/ohwell.png b/basewiki/smileys/ohwell.png deleted file mode 100644 index a83adfbf5..000000000 Binary files a/basewiki/smileys/ohwell.png and /dev/null differ diff --git a/basewiki/smileys/prio1.png b/basewiki/smileys/prio1.png deleted file mode 100644 index 774d34d65..000000000 Binary files a/basewiki/smileys/prio1.png and /dev/null differ diff --git a/basewiki/smileys/prio2.png b/basewiki/smileys/prio2.png deleted file mode 100644 index 3c6fac54f..000000000 Binary files a/basewiki/smileys/prio2.png and /dev/null differ diff --git a/basewiki/smileys/prio3.png b/basewiki/smileys/prio3.png deleted file mode 100644 index 2d03e62ce..000000000 Binary files a/basewiki/smileys/prio3.png and /dev/null differ diff --git a/basewiki/smileys/redface.png b/basewiki/smileys/redface.png deleted file mode 100644 index 9a8739253..000000000 Binary files a/basewiki/smileys/redface.png and /dev/null differ diff --git a/basewiki/smileys/sad.png b/basewiki/smileys/sad.png deleted file mode 100644 index 68d9966cf..000000000 Binary files a/basewiki/smileys/sad.png and /dev/null differ diff --git a/basewiki/smileys/smile.png b/basewiki/smileys/smile.png deleted file mode 100644 index b51b3ff49..000000000 Binary files a/basewiki/smileys/smile.png and /dev/null differ diff --git a/basewiki/smileys/smile2.png b/basewiki/smileys/smile2.png deleted file mode 100644 index 43ea05f9d..000000000 Binary files a/basewiki/smileys/smile2.png and /dev/null differ diff --git a/basewiki/smileys/smile3.png b/basewiki/smileys/smile3.png deleted file mode 100644 index c690ccc2f..000000000 Binary files a/basewiki/smileys/smile3.png and /dev/null differ diff --git a/basewiki/smileys/smile4.png b/basewiki/smileys/smile4.png deleted file mode 100644 index f8f5b523d..000000000 Binary files a/basewiki/smileys/smile4.png and /dev/null differ diff --git a/basewiki/smileys/star_off.png b/basewiki/smileys/star_off.png deleted file mode 100644 index c5535c3de..000000000 Binary files a/basewiki/smileys/star_off.png and /dev/null differ diff --git a/basewiki/smileys/star_on.png b/basewiki/smileys/star_on.png deleted file mode 100644 index ec5c03097..000000000 Binary files a/basewiki/smileys/star_on.png and /dev/null differ diff --git a/basewiki/smileys/thumbs-up.png b/basewiki/smileys/thumbs-up.png deleted file mode 100644 index 1faabace7..000000000 Binary files a/basewiki/smileys/thumbs-up.png and /dev/null differ diff --git a/basewiki/smileys/tired.png b/basewiki/smileys/tired.png deleted file mode 100644 index a3d5c56fb..000000000 Binary files a/basewiki/smileys/tired.png and /dev/null differ diff --git a/basewiki/smileys/tongue.png b/basewiki/smileys/tongue.png deleted file mode 100644 index 65105407c..000000000 Binary files a/basewiki/smileys/tongue.png and /dev/null differ diff --git a/basewiki/style.css b/basewiki/style.css deleted file mode 100644 index 3b8a24d9a..000000000 --- a/basewiki/style.css +++ /dev/null @@ -1,228 +0,0 @@ -/* ikiwiki style sheet */ - -/* Note that instead of modifying this style sheet, you can instead edit - * local.css and use it to override or change settings in this one. - */ - -.header { - margin: 0; - font-size: 22px; - font-weight: bold; - line-height: 1em; - display: block; -} - -.author { - margin: 0; - font-size: 18px; - font-weight: bold; - display: block; -} - -.actions ul { - margin: 0; - padding: 6px; - list-style-type: none; - border-bottom: 1px solid #000; -} - -.inlinepage .actions ul { - border-bottom: 0; -} - -.actions li { - display: inline; - padding: .2em .4em; -} - -#backlinks { - margin: 1em 0; -} - -.tags { - clear: both; -} - -div.tags { - border-top: 1px solid #000; -} - -#footer { - margin: 1em 0; -} - -#searchform { - display: inline; - float: right; -} - -#editcontent { - width: 100%; -} - -/* Stuff for the RecentChanges table. */ -tr.changeheader { - background: #eee; - color: black !important; -} -tr.changeinfo { - background: #eee; - color: black !important; -} -th.changeheader { - padding: 1px .3em; -} -td.changeinfo { - padding: 1px .3em; -} -td.changetime { - white-space: nowrap; - padding: 1px .3em; -} -td.changelog { - font-style: italic; -} - -.pagecloud { - padding: 10px 10px; - border: 1px solid #aaa; - background: #eee; - color: black !important; -} - -/* Used for adding a blog page. */ -#blogform { - padding: 10px 10px; - border: 1px solid #aaa; - background: #eee; - color: black !important; -} - -.inlinepage { - padding: 10px 10px; - border: 1px solid #aaa; -} - -.pageinfo { - clear: both; - font-style: italic; - display: block; -} - -/* Used for invalid form fields. */ -.fb_invalid { - color: red; - background: white !important; -} - -/* Used for required form fields. */ -.fb_required { - font-weight: bold; -} - -/* Orange feed button. */ -.feedbutton { - background: #ff6600; - color: white !important; - border-left: 1px solid #cc9966; - border-top: 1px solid #ccaa99; - border-right: 1px solid #993300; - border-bottom: 1px solid #331100; - padding: 0px 0.5em 0px 0.5em; - font-family: sans-serif; - font-weight: bold; - font-size: small; - text-decoration: none; - margin-top: 1em; -} -.feedbutton:hover { - color: white !important; - background: #ff9900; -} - -/* Tag cloud. */ -.pagecloud { - float: right; - width: 30%; - text-align: center; -} -.smallestPC { font-size: 70%; } -.smallPC { font-size: 85%; } -.normalPC { font-size: 100%; } -.bigPC { font-size: 115%; } -.biggestPC { font-size: 130%; } - -#sidebar { - line-height: 3ex; - width: 20ex; - float: right; - margin-left: 40px; - margin-bottom: 40px; - padding: 2ex 2ex; -} - -.infobox { - float: right; - margin-left: 2ex; - margin-top: 1ex; - margin-bottom: 1ex; - padding: 1ex 1ex; - border: 1px solid #aaa; -} - -.notebox { - float: right; - margin-left: 2ex; - margin-top: 1ex; - margin-bottom: 1ex; - padding: 1ex 1ex; - border: 1px solid #aaa; - width: 25% -} - -/* outlines */ -li.L1 { - list-style: upper-roman; -} -li.L2 { - list-style: decimal; -} -li.L3 { - list-style: lower-alpha; -} -li.L4 { - list-style: disc; -} -li.L5 { - list-style: square; -} -li.L6 { - list-style: circle; -} -li.L7 { - list-style: lower-roman; -} -li.L8 { - list-style: upper-alpha; -} - -hr.poll { - height: 10pt; - color: white !important; - background: #eee; - border: 2px solid black; -} -div.poll { - margin-top: 1ex; - margin-bottom: 1ex; - padding: 1ex 1ex; - border: 1px solid #aaa; -} - -input#openid_url { - background: url(http://openid.net/login-bg.gif) no-repeat; - background-color: #fff; - background-position: 0 50%; - color: #000; - padding-left: 18px; -} diff --git a/basewiki/style.css b/basewiki/style.css new file mode 120000 index 000000000..f32009635 --- /dev/null +++ b/basewiki/style.css @@ -0,0 +1 @@ +../doc/style.css \ No newline at end of file diff --git a/basewiki/subpage.mdwn b/basewiki/subpage.mdwn deleted file mode 100644 index 43669209c..000000000 --- a/basewiki/subpage.mdwn +++ /dev/null @@ -1,11 +0,0 @@ -ikiwiki supports placing pages in a directory hierarchy. For example, -this page, [[SubPage]] has some related pages placed under it, like -[[SubPage/LinkingRules]]. This is a useful way to add some order to your -wiki rather than just having a great big directory full of pages. - -To add a SubPage, just make a subdirectory and put pages in it. For -example, this page is SubPage.mdwn in this wiki's source, and there is also -a SubPage subdirectory, which contains SubPage/LinkingRules.mdwn. Subpages -can be nested as deeply as you'd like. - -Linking to and from a SubPage is explained in [[LinkingRules]]. diff --git a/basewiki/subpage.mdwn b/basewiki/subpage.mdwn new file mode 120000 index 000000000..04ec383fc --- /dev/null +++ b/basewiki/subpage.mdwn @@ -0,0 +1 @@ +../doc/subpage.mdwn \ No newline at end of file diff --git a/basewiki/subpage/linkingrules.mdwn b/basewiki/subpage/linkingrules.mdwn deleted file mode 100644 index c1062304a..000000000 --- a/basewiki/subpage/linkingrules.mdwn +++ /dev/null @@ -1,32 +0,0 @@ -To link to or from a [[SubPage]], you can normally use a regular -[[WikiLink]] that does not contain the name of the parent directory of -the [[SubPage]]. Ikiwiki descends the directory hierarchy looking for a -page that matches your link. - -For example, if FooBar/SubPage links to "OtherPage", ikiwiki will first -prefer pointing the link to FooBar/SubPage/OtherPage if it exists, next -to FooBar/OtherPage and finally to OtherPage in the root of the wiki. - -Note that this means that if a link on FooBar/SomePage to "OtherPage" -currently links to OtherPage, in the root of the wiki, and FooBar/OtherPage -is created, the link will _change_ to point to FooBar/OtherPage. On the -other hand, a link from BazBar to "OtherPage" would be unchanged by this -creation of a [[SubPage]] of FooBar. - -You can also specify a link that contains a directory name, like -"FooBar/OtherPage" to more exactly specify what page to link to. This is -the only way to link to an unrelated [[SubPage]]. - -You can use this to, for example, to link from BazBar to "FooBar/SubPage", -or from BazBar/SubPage to "FooBar/SubPage". - -You can also use "/" at the start of a link, to specify exactly which page -to link to, when there are multiple pages with similar names and the link -goes to the wrong page by default. For example, linking from -"FooBar/SubPage" to "/OtherPage" will link to the "OtherPage" in the root -of the wiki, even if there is a "FooBar/OtherPage". - -Also, if the wiki is configured with a userdir, you can link to pages -within the userdir without specifying a path to them. This is to allow for -easy linking to a user's page in the userdir, to sign a comment. These -links are checked for last of all. diff --git a/basewiki/wikiicons/diff.png b/basewiki/wikiicons/diff.png deleted file mode 100644 index 0b98d79ac..000000000 Binary files a/basewiki/wikiicons/diff.png and /dev/null differ diff --git a/basewiki/wikilink.mdwn b/basewiki/wikilink.mdwn deleted file mode 100644 index 46da8c301..000000000 --- a/basewiki/wikilink.mdwn +++ /dev/null @@ -1,23 +0,0 @@ -WikiLinks provide easy linking between pages of the wiki. To create a -[[WikiLink]], just put the name of the page to link to in double brackets. -For example "\[[WikiLink]]". - -If you ever need to write something like "\[[WikiLink]] without creating a -wikilink, just prefix it with a "\", like "\\\\[[WikiLink]]". - -There are some special [[SubPage/LinkingRules]] that come into play when -linking between [[SubPages|SubPage]]. - -Also, if the file linked to by a WikiLink looks like an image, it will -be displayed inline on the page. - -WikiLinks are matched with page names in a case-insensitive manner, so you -don't need to worry about getting the case the same, and can capitalise -links at the start of a sentence, and so on. - -It's also possible to write a WikiLink that uses something other than the -page name as the link text. For example "\[[foo_bar|SandBox]]" links to the -SandBox page, but the link will appear like this: [[foo_bar|SandBox]] - -**Note that you cannot use spaces in WikiLinks**. Replace spaces with -underscores. diff --git a/basewiki/wikilink.mdwn b/basewiki/wikilink.mdwn new file mode 120000 index 000000000..f63c38ed2 --- /dev/null +++ b/basewiki/wikilink.mdwn @@ -0,0 +1 @@ +../doc/wikilink.mdwn \ No newline at end of file diff --git a/debian/changelog b/debian/changelog index 21b5e2563..d77b97dcd 100644 --- a/debian/changelog +++ b/debian/changelog @@ -8,8 +8,11 @@ ikiwiki (1.43) UNRELEASED; urgency=low say if they're currently enabled or not, and in various other places in the wiki. * Updated Spanish translation. + * Make the basewiki be full of symlinks to pages that should be the same + in the doc wiki. This will allow direct edits to alter the base wiki + without manual munging. - -- Joey Hess Mon, 12 Feb 2007 13:50:25 -0500 + -- Joey Hess Tue, 13 Feb 2007 18:06:02 -0500 ikiwiki (1.42) unstable; urgency=low diff --git a/doc/blog.mdwn b/doc/blog.mdwn new file mode 100644 index 000000000..859fa6aaa --- /dev/null +++ b/doc/blog.mdwn @@ -0,0 +1,35 @@ +You can turn any page on this wiki into a weblog by inserting a +[[PreProcessorDirective]]. Like this: + + \[[inline pages="blog/* and !*/Discussion" show="10" rootpage="blog"]] + +Any pages that match the specified [[PageSpec]] (in the example, any +[[SubPage]] of "blog") will be part of the blog, and the newest 10 +of them will appear in the page. Note that if files that are not pages +match the [[PageSpec]], they will be included in the feed using RSS +enclosures, which is useful for podcasting. + +The optional `rootpage` parameter tells the wiki that new posts to this blog +should default to being [[SubPage]]s of "blog", and enables a form at the +top of the blog that can be used to add new items. + +If you want your blog to have an archive page listing every post ever made +to it, you can accomplish that like this: + + \[[inline pages="blog/* and !*/Discussion" archive="yes"]] + +You can even create an automatically generated list of all the pages on the +wiki, with the most recently added at the top, like this: + + \[[inline pages="* and !*/Discussion" archive="yes"]] + +If you want to be able to add pages to a given blog feed by tagging them, +you can do that too. To tag a page, just make it link to a page or pages +that represent its tags. Then use the special link() [[PageSpec]] to match +all pages that have a given tag: + + \[[inline pages="link(life)"]] + +Or include some tags and exclude others: + + \[[inline pages="link(debian) and !link(social)"]] diff --git a/doc/favicon.ico b/doc/favicon.ico new file mode 100644 index 000000000..354b627f0 Binary files /dev/null and b/doc/favicon.ico differ diff --git a/doc/helponformatting.mdwn b/doc/helponformatting.mdwn new file mode 100644 index 000000000..3a0ddb9f2 --- /dev/null +++ b/doc/helponformatting.mdwn @@ -0,0 +1,78 @@ +# Help on formatting text + +Text on this wiki is, by default, written in a form very close to how you +might write text for an email message. This style of text formatting is +called [[MarkDown]], and it works like this: + +Leave blank lines between paragraphs. + +You can \**emphasise*\* or \*\***strongly emphasise**\*\* text by placing it +in single or double asterisks. + +To create a list, start each line with an asterisk: + +* "* this is my list" +* "* another item" + +To make a numbered list, start each line with a number (any number will +do) followed by a period: + +1. "1. first line" +2. "2. second line" +2. "2. third line" + +To create a header, start a line with one or more `#` characters followed +by a space and the header text. The number of `#` characters controls the +size of the header: + +# # h1 +## ## h2 +### ### h3 +#### #### h4 +##### ##### h5 +###### ###### h6 + +You can also make the first two levels of heading by underlining text with +equals or dash: + +heading 1 +========= + + heading 1 + ========= + +heading 2 +--------- + + heading 2 + --------- + +To create a horizontal rule, just write three or more dashes or stars on +their own line: + +---- + +To quote someone, prefix the quote with ">": + +> To be or not to be, +> that is the question. + +To write a code block, indent each line with a tab or 4 spaces: + + 10 PRINT "Hello, world!" + 20 GOTO 10 + +To link to another page on the wiki, place the page's name inside double +square brackets, so you would use `\[[WikiLink]]` to link to [[WikiLink]]. + +To link to any other web page, or to an email address, you can just put the url in angle brackets: <>, or you can use the form +\[link text\]\(url\) + +---- + +You can also use [[PreProcessorDirective]]s to do additional cool stuff. + +[[if test="enabled(smiley)" then=""" +Also, because this wiki has the smiley plugin enabled, you can +insert [[smileys]] and some other useful symbols. +"""]] diff --git a/doc/local.css b/doc/local.css new file mode 100644 index 000000000..a0dec8cfd --- /dev/null +++ b/doc/local.css @@ -0,0 +1,3 @@ +/* ikiwiki local style sheet */ + +/* Add local styling here, instead of modifying style.css. */ diff --git a/doc/markdown.mdwn b/doc/markdown.mdwn new file mode 100644 index 000000000..317a17db9 --- /dev/null +++ b/doc/markdown.mdwn @@ -0,0 +1,10 @@ +[Markdown](http://daringfireball.net/projects/markdown/) +is a minimal markup language that resembles plain text as used in +email messages. It is the markup language used by this wiki by default. + +For documentation about the markdown syntax, see [[HelpOnFormatting]] and +[Markdown: syntax](http://daringfireball.net/projects/markdown/syntax). + +Note that [[WikiLink]]s and [[PreProcessorDirective]]s are not part of the +markdown syntax, and are the only bit of markup that this wiki handles +internally. diff --git a/doc/openid.mdwn b/doc/openid.mdwn new file mode 100644 index 000000000..7c6d2bda7 --- /dev/null +++ b/doc/openid.mdwn @@ -0,0 +1,34 @@ +[[meta title="OpenID"]] + +[[template id=note text=""" +[[if test="enabled(openid)" + then="This wiki has OpenID **enabled**." + else="This wiki has OpenID **disabled**."]] +"""]] + +[OpenID](http://openid.net) is a decentralized authentication mechanism +that allows you to have one login that you can use on a growing number of +websites. + +To sign up for an OpenID, visit one of the following identity providers: + +* [MyOpenID](https://www.myopenid.com/) +* [GetOpenID](https://getopenid.com/) +* [Videntity](http://videntity.org/) +* [LiveJournal](http://www.livejournal.com/openid/) +* or any of the many others out there.. + +Your OpenID is the URL that you are given when you sign up. +[[if test="enabled(openid)" then=""" +To sign in to this wiki using OpenID, just enter it in the OpenID field in the +signin form. You do not need to give this wiki a password or go through any +registration process when using OpenID. +"""]] + +--- + +It's also possible to make a page in the wiki usable as an OpenID url, +by delegating it to an openid server. Here's an example of how to do that: + + \[[meta link="http://www.myopenid.com/server" rel="openid.server"]] + \[[meta link="http://yourid.myopenid.com/" rel="openid.delegate"]] diff --git a/doc/pagespec.mdwn b/doc/pagespec.mdwn new file mode 100644 index 000000000..53519e7f0 --- /dev/null +++ b/doc/pagespec.mdwn @@ -0,0 +1,71 @@ +To select a set of pages, such as pages that are locked, pages +whose commit emails you want subscribe to, or pages to combine into a +blog, the wiki uses a PageSpec. This is an expression that matches +a set of pages. + +The simplest PageSpec is a simple list of pages. For example, this matches +any of the three listed pages: + + foo or bar or baz + +More often you will want to match any pages that have a particular thing in +their name. You can do this using a glob pattern. "`*`" stands for any part +of a page name, and "`?`" for any single letter of a page name. So this +matches all pages about music, and any [[SubPage]]s of the SandBox, but does +not match the SandBox itself: + + *music* or SandBox/* + +You can also prefix an item with "`!`" to skip pages that match it. So to +match all pages except for Discussion pages and the SandBox: + + * and !SandBox and !*/Discussion + +Some more elaborate limits can be added to what matches using any of these +functions: + +* "`link(page)`" - match only pages that link to a given page +* "`backlink(page)`" - match only pages that a given page links to +* "`creation_month(month)`" - match only pages created on the given month +* "`creation_day(mday)`" - or day of the month +* "`creation_year(year)`" - or year +* "`created_after(page)`" - match only pages created after the given page + was created +* "`created_before(page)`" - match only pages created before the given page + was created + +For example, to match all pages in a blog that link to the page about music +and were written in 2005: + + blog/* and link(music) and creation_year(2005) + +More complex expressions can also be created, by using parentheses for +grouping. For example, to match pages in a blog that are tagged with either +of two tags, use: + + blog/* and (link(tag/foo) or link(tag/bar)) + +Note that page names in PageSpecs are matched against the absolute +filenames of the pages in the wiki, so a pagespec "foo" used on page +"a/b" will not match a page named "a/foo" or "a/b/foo". To match +relative to the directory of the page containing the pagespec, you can +use "./". For example, "./foo" on page "a/b" matches page "a/foo". + +## Old syntax + +The old PageSpec syntax was called a "GlobList", and worked differently in +two ways: + +1. "and" and "or" were not used; any page matching any item from the list + matched. +2. If an item was prefixed with "`!`", then no page matching that item + matched, even if it matched an earlier list item. + +For example, here is the old way to match all pages except for the SandBox +and Discussion pages: + + * !SandBox !*/Discussion + +Using this old syntax is still supported. However, the old syntax is +deprecated and will be removed at some point, and using the new syntax is +recommended. diff --git a/doc/preprocessordirective.mdwn b/doc/preprocessordirective.mdwn new file mode 100644 index 000000000..1e2332c09 --- /dev/null +++ b/doc/preprocessordirective.mdwn @@ -0,0 +1,33 @@ +Preprocessor directives are similar to a [[WikiLink]] in form, except they +contain spaces and parameters. The general form is: + + \[[directive param="value" param="value"]] + +This gets expanded before the rest of the page is processed, and can be used +to transform the page in various ways. + +The quotes around values can be omitted if the value is a simple word. +Also, some directives may use parameters without values, for example: + + \[[tag foo]] + +Note that if a preprocessor directive has no parameters, a space still must +be put after its name, to avoid confusion with a [[WikiLink]]. For example: + + \[[pagecount ]] + +A preprocessor directive does not need to all be on one line, it can be +wrapped to multiple lines if you like: + + \[[directive foo="baldersnatch" + bar="supercalifragalisticexpealadocious" baz=11]] + +Also, multiple lines of *quoted* text can be used for a value. +To allow quote marks inside the quoted text, delimit the block +of text with triple-quotes: + + \[[directive text=""" + 1. "foo" + 2. "bar" + 3. "baz" + """]] diff --git a/doc/sandbox.mdwn b/doc/sandbox.mdwn index 540d7296e..78d6e11c7 100644 --- a/doc/sandbox.mdwn +++ b/doc/sandbox.mdwn @@ -81,4 +81,4 @@ Ethan wants to make a [[sandbox/castle]] in the sand. hi -just testing \ No newline at end of file +just testing diff --git a/doc/shortcuts.mdwn b/doc/shortcuts.mdwn new file mode 100644 index 000000000..f9d586bbf --- /dev/null +++ b/doc/shortcuts.mdwn @@ -0,0 +1,18 @@ +This page controls what shortcut links the wiki supports. + +* [[shortcut name=google url="http://www.google.com/search?q=%s"]] +* [[shortcut name=wikipedia url="http://en.wikipedia.org/wiki/%s"]] +* [[shortcut name=debbug url="http://bugs.debian.org/%s" desc="bug #%s"]] +* [[shortcut name=deblist url="http://lists.debian.org/debian-%s" desc="debian-%s@lists.debian.org"]] +* [[shortcut name=debpkg url="http://packages.debian.org/%s"]] +* [[shortcut name=debpts url="http://packages.qa.debian.org/%s"]] +* [[shortcut name=fdobug url="https://bugs.freedesktop.org/show_bug.cgi?id=%s" desc="freedesktop.org bug #%s"]] +* [[shortcut name=fdolist url="http://lists.freedesktop.org/mailman/listinfo/%s" desc="%s@lists.freedesktop.org"]] +* [[shortcut name=cpan url="http://search.cpan.org/search?mode=dist&query=%s"]] +* [[shortcut name=ctan url="http://tug.ctan.org/cgi-bin/ctanPackageInformation.py?id=%s"]] +* [[shortcut name=iki url="http://ikiwiki.kitenet.net/%s.html"]] +* [[shortcut name=ljuser url="http://%s.livejournal.com/"]] + +To add a new shortcut, use the "shortcut" preprocessor directive. "%s" is +replaced with the text passed to the named shortcut. The optional desc +parameter controls the description of the link. diff --git a/doc/smileys.mdwn b/doc/smileys.mdwn new file mode 100644 index 000000000..e5377ced2 --- /dev/null +++ b/doc/smileys.mdwn @@ -0,0 +1,50 @@ +This page is used to control what smileys are supported by the wiki. +Just write the text of a smiley to display it. + +* \:) [[smileys/smile.png]] +* \:-) [[smileys/smile.png]] +* \:D [[smileys/biggrin.png]] +* \:-D [[smileys/biggrin.png]] +* \B) [[smileys/smile2.png]] +* \B-) [[smileys/smile2.png]] +* \:)) [[smileys/smile3.png]] +* \:-)) [[smileys/smile3.png]] +* \;) [[smileys/smile4.png]] +* \;-) [[smileys/smile4.png]] +* \:\ [[smileys/ohwell.png]] +* \:/ [[smileys/ohwell.png]] +* \:-/ [[smileys/ohwell.png]] +* \>:> [[smileys/devil.png]] +* \X-( [[smileys/angry.png]] +* \<:( [[smileys/frown.png]] +* \:( [[smileys/sad.png]] +* \:-( [[smileys/sad.png]] +* \:-? [[smileys/tongue.png]] +* \:o [[smileys/redface.png]] +* \|) [[smileys/tired.png]] +* \|-) [[smileys/tired.png]] +* \{OK} [[smileys/thumbs-up.png]] +* \{X} [[smileys/icon-error.png]] +* \{i} [[smileys/icon-info.png]] +* \(./) [[smileys/checkmark.png]] +* \(!) [[smileys/idea.png]] +* \[!] [[smileys/attention.png]] +* \/!\ [[smileys/alert.png]] +* \{*} [[smileys/star_on.png]] +* \{o} [[smileys/star_off.png]] +* \{1} [[smileys/prio1.png]] +* \{2} [[smileys/prio2.png]] +* \{3} [[smileys/prio3.png]] + +For example: {*} B) {*} + +---- + +To change the supported smileys, just edit the lists on this page. +Note that the format is important; each list item should start with the +text that is turned into the smiley, escaped so that users can see what +produces it, followed by a [[WikiLink]] to the image to display. + +/!\ Bear in mind that the link to the image needs to be written in a way that +will work if it's copied to other pages on the wiki. So be sure to include the +smileys directory in the path to the file. diff --git a/doc/smileys/alert.png b/doc/smileys/alert.png new file mode 100644 index 000000000..5bb87e33f Binary files /dev/null and b/doc/smileys/alert.png differ diff --git a/doc/smileys/angry.png b/doc/smileys/angry.png new file mode 100644 index 000000000..05bc69f74 Binary files /dev/null and b/doc/smileys/angry.png differ diff --git a/doc/smileys/attention.png b/doc/smileys/attention.png new file mode 100644 index 000000000..7e064566d Binary files /dev/null and b/doc/smileys/attention.png differ diff --git a/doc/smileys/biggrin.png b/doc/smileys/biggrin.png new file mode 100644 index 000000000..f71b42c11 Binary files /dev/null and b/doc/smileys/biggrin.png differ diff --git a/doc/smileys/checkmark.png b/doc/smileys/checkmark.png new file mode 100644 index 000000000..8869caa19 Binary files /dev/null and b/doc/smileys/checkmark.png differ diff --git a/doc/smileys/devil.png b/doc/smileys/devil.png new file mode 100644 index 000000000..8684c3970 Binary files /dev/null and b/doc/smileys/devil.png differ diff --git a/doc/smileys/frown.png b/doc/smileys/frown.png new file mode 100644 index 000000000..2999b55ea Binary files /dev/null and b/doc/smileys/frown.png differ diff --git a/doc/smileys/icon-error.png b/doc/smileys/icon-error.png new file mode 100644 index 000000000..53b1055f6 Binary files /dev/null and b/doc/smileys/icon-error.png differ diff --git a/doc/smileys/icon-info.png b/doc/smileys/icon-info.png new file mode 100644 index 000000000..c08b08d74 Binary files /dev/null and b/doc/smileys/icon-info.png differ diff --git a/doc/smileys/idea.png b/doc/smileys/idea.png new file mode 100644 index 000000000..37bc02ddc Binary files /dev/null and b/doc/smileys/idea.png differ diff --git a/doc/smileys/ohwell.png b/doc/smileys/ohwell.png new file mode 100644 index 000000000..a83adfbf5 Binary files /dev/null and b/doc/smileys/ohwell.png differ diff --git a/doc/smileys/prio1.png b/doc/smileys/prio1.png new file mode 100644 index 000000000..774d34d65 Binary files /dev/null and b/doc/smileys/prio1.png differ diff --git a/doc/smileys/prio2.png b/doc/smileys/prio2.png new file mode 100644 index 000000000..3c6fac54f Binary files /dev/null and b/doc/smileys/prio2.png differ diff --git a/doc/smileys/prio3.png b/doc/smileys/prio3.png new file mode 100644 index 000000000..2d03e62ce Binary files /dev/null and b/doc/smileys/prio3.png differ diff --git a/doc/smileys/redface.png b/doc/smileys/redface.png new file mode 100644 index 000000000..9a8739253 Binary files /dev/null and b/doc/smileys/redface.png differ diff --git a/doc/smileys/sad.png b/doc/smileys/sad.png new file mode 100644 index 000000000..68d9966cf Binary files /dev/null and b/doc/smileys/sad.png differ diff --git a/doc/smileys/smile.png b/doc/smileys/smile.png new file mode 100644 index 000000000..b51b3ff49 Binary files /dev/null and b/doc/smileys/smile.png differ diff --git a/doc/smileys/smile2.png b/doc/smileys/smile2.png new file mode 100644 index 000000000..43ea05f9d Binary files /dev/null and b/doc/smileys/smile2.png differ diff --git a/doc/smileys/smile3.png b/doc/smileys/smile3.png new file mode 100644 index 000000000..c690ccc2f Binary files /dev/null and b/doc/smileys/smile3.png differ diff --git a/doc/smileys/smile4.png b/doc/smileys/smile4.png new file mode 100644 index 000000000..f8f5b523d Binary files /dev/null and b/doc/smileys/smile4.png differ diff --git a/doc/smileys/star_off.png b/doc/smileys/star_off.png new file mode 100644 index 000000000..c5535c3de Binary files /dev/null and b/doc/smileys/star_off.png differ diff --git a/doc/smileys/star_on.png b/doc/smileys/star_on.png new file mode 100644 index 000000000..ec5c03097 Binary files /dev/null and b/doc/smileys/star_on.png differ diff --git a/doc/smileys/thumbs-up.png b/doc/smileys/thumbs-up.png new file mode 100644 index 000000000..1faabace7 Binary files /dev/null and b/doc/smileys/thumbs-up.png differ diff --git a/doc/smileys/tired.png b/doc/smileys/tired.png new file mode 100644 index 000000000..a3d5c56fb Binary files /dev/null and b/doc/smileys/tired.png differ diff --git a/doc/smileys/tongue.png b/doc/smileys/tongue.png new file mode 100644 index 000000000..65105407c Binary files /dev/null and b/doc/smileys/tongue.png differ diff --git a/doc/style.css b/doc/style.css new file mode 100644 index 000000000..3b8a24d9a --- /dev/null +++ b/doc/style.css @@ -0,0 +1,228 @@ +/* ikiwiki style sheet */ + +/* Note that instead of modifying this style sheet, you can instead edit + * local.css and use it to override or change settings in this one. + */ + +.header { + margin: 0; + font-size: 22px; + font-weight: bold; + line-height: 1em; + display: block; +} + +.author { + margin: 0; + font-size: 18px; + font-weight: bold; + display: block; +} + +.actions ul { + margin: 0; + padding: 6px; + list-style-type: none; + border-bottom: 1px solid #000; +} + +.inlinepage .actions ul { + border-bottom: 0; +} + +.actions li { + display: inline; + padding: .2em .4em; +} + +#backlinks { + margin: 1em 0; +} + +.tags { + clear: both; +} + +div.tags { + border-top: 1px solid #000; +} + +#footer { + margin: 1em 0; +} + +#searchform { + display: inline; + float: right; +} + +#editcontent { + width: 100%; +} + +/* Stuff for the RecentChanges table. */ +tr.changeheader { + background: #eee; + color: black !important; +} +tr.changeinfo { + background: #eee; + color: black !important; +} +th.changeheader { + padding: 1px .3em; +} +td.changeinfo { + padding: 1px .3em; +} +td.changetime { + white-space: nowrap; + padding: 1px .3em; +} +td.changelog { + font-style: italic; +} + +.pagecloud { + padding: 10px 10px; + border: 1px solid #aaa; + background: #eee; + color: black !important; +} + +/* Used for adding a blog page. */ +#blogform { + padding: 10px 10px; + border: 1px solid #aaa; + background: #eee; + color: black !important; +} + +.inlinepage { + padding: 10px 10px; + border: 1px solid #aaa; +} + +.pageinfo { + clear: both; + font-style: italic; + display: block; +} + +/* Used for invalid form fields. */ +.fb_invalid { + color: red; + background: white !important; +} + +/* Used for required form fields. */ +.fb_required { + font-weight: bold; +} + +/* Orange feed button. */ +.feedbutton { + background: #ff6600; + color: white !important; + border-left: 1px solid #cc9966; + border-top: 1px solid #ccaa99; + border-right: 1px solid #993300; + border-bottom: 1px solid #331100; + padding: 0px 0.5em 0px 0.5em; + font-family: sans-serif; + font-weight: bold; + font-size: small; + text-decoration: none; + margin-top: 1em; +} +.feedbutton:hover { + color: white !important; + background: #ff9900; +} + +/* Tag cloud. */ +.pagecloud { + float: right; + width: 30%; + text-align: center; +} +.smallestPC { font-size: 70%; } +.smallPC { font-size: 85%; } +.normalPC { font-size: 100%; } +.bigPC { font-size: 115%; } +.biggestPC { font-size: 130%; } + +#sidebar { + line-height: 3ex; + width: 20ex; + float: right; + margin-left: 40px; + margin-bottom: 40px; + padding: 2ex 2ex; +} + +.infobox { + float: right; + margin-left: 2ex; + margin-top: 1ex; + margin-bottom: 1ex; + padding: 1ex 1ex; + border: 1px solid #aaa; +} + +.notebox { + float: right; + margin-left: 2ex; + margin-top: 1ex; + margin-bottom: 1ex; + padding: 1ex 1ex; + border: 1px solid #aaa; + width: 25% +} + +/* outlines */ +li.L1 { + list-style: upper-roman; +} +li.L2 { + list-style: decimal; +} +li.L3 { + list-style: lower-alpha; +} +li.L4 { + list-style: disc; +} +li.L5 { + list-style: square; +} +li.L6 { + list-style: circle; +} +li.L7 { + list-style: lower-roman; +} +li.L8 { + list-style: upper-alpha; +} + +hr.poll { + height: 10pt; + color: white !important; + background: #eee; + border: 2px solid black; +} +div.poll { + margin-top: 1ex; + margin-bottom: 1ex; + padding: 1ex 1ex; + border: 1px solid #aaa; +} + +input#openid_url { + background: url(http://openid.net/login-bg.gif) no-repeat; + background-color: #fff; + background-position: 0 50%; + color: #000; + padding-left: 18px; +} diff --git a/doc/subpage.mdwn b/doc/subpage.mdwn new file mode 100644 index 000000000..43669209c --- /dev/null +++ b/doc/subpage.mdwn @@ -0,0 +1,11 @@ +ikiwiki supports placing pages in a directory hierarchy. For example, +this page, [[SubPage]] has some related pages placed under it, like +[[SubPage/LinkingRules]]. This is a useful way to add some order to your +wiki rather than just having a great big directory full of pages. + +To add a SubPage, just make a subdirectory and put pages in it. For +example, this page is SubPage.mdwn in this wiki's source, and there is also +a SubPage subdirectory, which contains SubPage/LinkingRules.mdwn. Subpages +can be nested as deeply as you'd like. + +Linking to and from a SubPage is explained in [[LinkingRules]]. diff --git a/doc/subpage/linkingrules.mdwn b/doc/subpage/linkingrules.mdwn new file mode 100644 index 000000000..c1062304a --- /dev/null +++ b/doc/subpage/linkingrules.mdwn @@ -0,0 +1,32 @@ +To link to or from a [[SubPage]], you can normally use a regular +[[WikiLink]] that does not contain the name of the parent directory of +the [[SubPage]]. Ikiwiki descends the directory hierarchy looking for a +page that matches your link. + +For example, if FooBar/SubPage links to "OtherPage", ikiwiki will first +prefer pointing the link to FooBar/SubPage/OtherPage if it exists, next +to FooBar/OtherPage and finally to OtherPage in the root of the wiki. + +Note that this means that if a link on FooBar/SomePage to "OtherPage" +currently links to OtherPage, in the root of the wiki, and FooBar/OtherPage +is created, the link will _change_ to point to FooBar/OtherPage. On the +other hand, a link from BazBar to "OtherPage" would be unchanged by this +creation of a [[SubPage]] of FooBar. + +You can also specify a link that contains a directory name, like +"FooBar/OtherPage" to more exactly specify what page to link to. This is +the only way to link to an unrelated [[SubPage]]. + +You can use this to, for example, to link from BazBar to "FooBar/SubPage", +or from BazBar/SubPage to "FooBar/SubPage". + +You can also use "/" at the start of a link, to specify exactly which page +to link to, when there are multiple pages with similar names and the link +goes to the wrong page by default. For example, linking from +"FooBar/SubPage" to "/OtherPage" will link to the "OtherPage" in the root +of the wiki, even if there is a "FooBar/OtherPage". + +Also, if the wiki is configured with a userdir, you can link to pages +within the userdir without specifying a path to them. This is to allow for +easy linking to a user's page in the userdir, to sign a comment. These +links are checked for last of all. diff --git a/doc/wikiicons/diff.png b/doc/wikiicons/diff.png new file mode 100644 index 000000000..0b98d79ac Binary files /dev/null and b/doc/wikiicons/diff.png differ diff --git a/doc/wikilink.mdwn b/doc/wikilink.mdwn new file mode 100644 index 000000000..46da8c301 --- /dev/null +++ b/doc/wikilink.mdwn @@ -0,0 +1,23 @@ +WikiLinks provide easy linking between pages of the wiki. To create a +[[WikiLink]], just put the name of the page to link to in double brackets. +For example "\[[WikiLink]]". + +If you ever need to write something like "\[[WikiLink]] without creating a +wikilink, just prefix it with a "\", like "\\\\[[WikiLink]]". + +There are some special [[SubPage/LinkingRules]] that come into play when +linking between [[SubPages|SubPage]]. + +Also, if the file linked to by a WikiLink looks like an image, it will +be displayed inline on the page. + +WikiLinks are matched with page names in a case-insensitive manner, so you +don't need to worry about getting the case the same, and can capitalise +links at the start of a sentence, and so on. + +It's also possible to write a WikiLink that uses something other than the +page name as the link text. For example "\[[foo_bar|SandBox]]" links to the +SandBox page, but the link will appear like this: [[foo_bar|SandBox]] + +**Note that you cannot use spaces in WikiLinks**. Replace spaces with +underscores. -- cgit v1.2.3