diff options
| -rw-r--r-- | basewiki/helponformatting.mdwn | 54 | ||||
| -rw-r--r-- | basewiki/index.mdwn | 5 | ||||
| -rw-r--r-- | basewiki/markdown.mdwn | 9 | ||||
| -rw-r--r-- | basewiki/sandbox.mdwn | 32 | ||||
| -rw-r--r-- | basewiki/wikilink.mdwn | 15 | ||||
| -rw-r--r-- | doc/todo.mdwn | 5 |
6 files changed, 115 insertions, 5 deletions
diff --git a/basewiki/helponformatting.mdwn b/basewiki/helponformatting.mdwn new file mode 100644 index 000000000..545148e86 --- /dev/null +++ b/basewiki/helponformatting.mdwn @@ -0,0 +1,54 @@ +## Help on formatting text + +Text on this wiki is written in a form very close to how you might write +text for an email message. + +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: + +## ## h2 +### ### h3 +#### #### h4 + +To create a horizontal rule, just write three or more dashes 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: + + 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: <<http://ikiwiki.kitenet.net>>, or you can use the form +\[link text\]\(url\) + +---- + +This style of text formatting is called [[MarkDown]]. diff --git a/basewiki/index.mdwn b/basewiki/index.mdwn new file mode 100644 index 000000000..5eb94b443 --- /dev/null +++ b/basewiki/index.mdwn @@ -0,0 +1,5 @@ +Welcome to the your new wiki. + +All wikis are supposed to have a [[SandBox]], so this one does too. + +This wiki is powered by [ikiwiki](http://ikiwiki.kitenet.net). diff --git a/basewiki/markdown.mdwn b/basewiki/markdown.mdwn new file mode 100644 index 000000000..9a0fff198 --- /dev/null +++ b/basewiki/markdown.mdwn @@ -0,0 +1,9 @@ +[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. + +For documentation about the markdown syntax, see +[Markdown: syntax](http://daringfireball.net/projects/markdown/syntax). + +Note that [[WikiLink]]s are not part of the markdown syntax, and are the +only bit of markup that this wiki handles internally. diff --git a/basewiki/sandbox.mdwn b/basewiki/sandbox.mdwn new file mode 100644 index 000000000..c93c8f331 --- /dev/null +++ b/basewiki/sandbox.mdwn @@ -0,0 +1,32 @@ +This is the SandBox, a page anyone can edit to learn how to use the wiki. + +---- + +Here's a paragraph. + +Here's another one with *emphasised* text. + +# Header + +## Subheader + +> This is a blockquote. +> +> This is the first level of quoting. +> +> > This is nested blockquote. +> +> Back to the first level. + +Numbered list + +1. First item. +1. Another. +1. And another.. + +Bulleted list + +* *item* +* item + +[[WikiLink]] diff --git a/basewiki/wikilink.mdwn b/basewiki/wikilink.mdwn new file mode 100644 index 000000000..ac0ec9d56 --- /dev/null +++ b/basewiki/wikilink.mdwn @@ -0,0 +1,15 @@ +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]]". + +Note that there are some special [[SubPage/LinkingRules]] that come into +play when linking between [[SubPage]]s. + +WikiLinks can be entered in any case you like, the page they link to is +always lowercased. + +Note that if the file linked to by a WikiLink looks like an image, it will +be displayed inline on the page. diff --git a/doc/todo.mdwn b/doc/todo.mdwn index 30677fc42..5c79219fe 100644 --- a/doc/todo.mdwn +++ b/doc/todo.mdwn @@ -97,11 +97,6 @@ recentchanges that goes to the diff for any listed change. Possibly add "next 100" link to it, but OTOH, you can just use svn log if you need that data.. -## base wiki - -Need a toned down version of this wiki with a basic frontpage, sandbox and -docs to use as a seed for new wikis. - ## search * full text (use third-party tools?) |