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 LinkingRules that come into play when linking between SubPages.

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 links to the SandBox page, but the link will appear like this: foo bar.

To link to an anchor inside a page, you can use something like ?WikiLink .

If the file linked to by a WikiLink looks like an image, it will be displayed inline on the page.

You can also put an url in a WikiLink, to link to an external page. Email addresses can also be used to generate a mailto link.

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"
3. "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

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 an url or email address, you can just put the url in angle brackets: <http://ikiwiki.info>, or you can use the form [link text](url)

In addition to basic html formatting using MarkDown, this wiki lets you use the following additional features:

• 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.

• Insert smileys and some other useful symbols.

• Use shortcuts to link to common resources.

  [[!wikipedia War_of_1812]]

• Create and fill out templates for repeated chunks of parameterized wiki text.

• Insert various directives onto a page to perform useful actions. For example, you can:

  • Add a table of contents to a page:

    [[!toc ]]

  • Change the title of a page:

    [[!meta title="full page title"]]

  • Create a blog by inlining a set of pages:

    [[!inline pages="blog/*"]]

Some directives that use PageSpecs allow specifying the order that matching pages are shown in. The following sort orders can be specified.

• age - List pages from the most recently created to the oldest.

• mtime - List pages with the most recently modified first.

• title - Order by title (page name), e.g. "z/a a/b a/c"

• path - Order by page name including parents, e.g. "a/b a/c z/a"

• meta(title) - Order according to the [[!meta title="foo" sortas="bar"]] or [[!meta title="foo"]] directive, or the page name if no full title was set. meta(author), meta(date), meta(updated), etc. also work.

In addition, you can combine several sort orders and/or reverse the order of sorting, with a string like age -title (which would sort by age, then by title in reverse order if two pages have the same age).

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 formatting and Markdown: syntax.

Note that WikiLinks and directives are not part of the markdown syntax, and are the only bit of markup that this wiki handles internally.

Directives are similar to a WikiLink in form, except they begin with ! and may contain 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]]

A directive does not need to all be on one line, it can be wrapped to multiple lines if you like:

[[!directive  foo="baldersnatch"
bar="supercalifragilisticexpialidocious" 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-double-quotes or triple-single-quotes:

[[!directive  text="""
1. "foo"
2. "bar"
3. "baz"
""" othertext='''
1. 'quux'
2. "foo"
''']]

If you want to put text with triple quotes into a parameter value, you can use perl-style here-doc syntax, even nesting it like this:

[[!directive  text=<<OUTER
[[!otherdirective <<INNER
inner text
INNER]]
outer text
OUTER]]

ikiwiki also has an older syntax for directives, which requires a space in directives to distinguish them from wikilinks. This syntax has several disadvantages: it requires a space after directives with no parameters (such as ?pagecount ), and it prohibits spaces in wikilinks. ikiwiki now provides the !-prefixed syntax shown above as default. However, ikiwiki still supports wikis using the older syntax, if the prefix_directives option is disabled.

Accommodation

There are many options for accommodation in and around Auckland for the weekend of the mini-DebConf. Check out the LCA2015 Accommodation Page.

If you booked rooms as part of your linux.conf.au 2015 registration then if you contact LCA2015 they'll be able to extend you booking if required to include the mini-DebConf weekend.

Use this template to create a popup window that is displayed when the mouse is over part of the page. This template has two parameters:

• `mouseover` - This is the text or other content that triggers the popup.
• `popup` - This should be the content of the popup window. It can be anything, even images or a whole little wiki page, but should not be too large for good usability.

Note that browsers that do not support the CSS will display the popup inline in the page, inside square brackets. []

Use this template to insert a note into a page. The note will be styled to float to the right of other text on the page. This template has one parameter:

• `text` - the text to display in the note

This wiki has shortcuts enabled.

Some examples of using shortcuts include:

[[!google  foo]]
[[!wikipedia  War_of_1812]]
[[!debbug  12345]]
Check the [[!google  ikiwiki desc="google search for %s"]].

This page controls what shortcut links the wiki supports.

• shortcut google points to https://encrypted.google.com/search?q=%s
• shortcut archive points to http://web.archive.org/*/%S
• shortcut gmap points to https://maps.google.com/maps?q=%s
• shortcut gmsg points to https://groups.google.com/groups?selm=%s
• shortcut wikipedia points to https://en.wikipedia.org/wiki/%W
• shortcut wikitravel points to https://wikitravel.org/en/%s
• shortcut wiktionary points to https://en.wiktionary.org/wiki/%s
• shortcut debbug points to http://bugs.debian.org/%S
• shortcut deblist points to https://lists.debian.org/debian-%s
• shortcut debpkg points to http://packages.debian.org/%s
• shortcut debpkgsid points to http://packages.debian.org/sid/%s
• shortcut debpts points to http://packages.qa.debian.org/%s
• shortcut debmsg points to https://lists.debian.org/msgid-search/%s
• shortcut debrt points to https://rt.debian.org/Ticket/Display.html?id=%s
• shortcut debss points to http://snapshot.debian.org/package/%s/
  • Usage: [[!debss package]] or [[!debss package/version]]. See http://snapshot.debian.org/ for details.
• shortcut debwiki points to https://wiki.debian.org/%S
• shortcut fdobug points to https://bugs.freedesktop.org/show_bug.cgi?id=%s
• shortcut fdolist points to http://lists.freedesktop.org/mailman/listinfo/%s
• shortcut gnomebug points to https://bugzilla.gnome.org/show_bug.cgi?id=%s
• shortcut linuxbug points to https://bugzilla.kernel.org/show_bug.cgi?id=%s
• shortcut mozbug points to https://bugzilla.mozilla.org/show_bug.cgi?id=%s
• shortcut gnulist points to https://lists.gnu.org/mailman/listinfo/%s
• shortcut marcmsg points to http://marc.info/?i=%s
• shortcut marclist points to http://marc.info/?l=%s
• shortcut gmane points to http://dir.gmane.org/gmane.%s
• shortcut gmanemsg points to http://mid.gmane.org/%s
• shortcut cpan points to http://search.cpan.org/search?mode=dist&query=%s
• shortcut ctan points to http://tug.ctan.org/cgi-bin/ctanPackageInformation.py?id=%s
• shortcut hoogle points to http://haskell.org/hoogle/?q=%s
• shortcut iki points to http://ikiwiki.info/%S/
• shortcut ljuser points to http://%s.livejournal.com/
• shortcut rfc points to https://www.ietf.org/rfc/rfc%s.txt
• shortcut c2 points to http://c2.com/cgi/wiki?%s
• shortcut meatballwiki points to http://www.usemod.com/cgi-bin/mb.pl?%s
• shortcut emacswiki points to http://www.emacswiki.org/cgi-bin/wiki/%s
• shortcut haskellwiki points to http://haskell.org/haskellwiki/%s
• shortcut dict points to http://www.dict.org/bin/Dict?Form=Dict1&Strategy=&Database=&Query=%s
• shortcut imdb points to http://imdb.com/find?q=%s
• shortcut gpg points to http://pgpkeys.mit.edu:11371/pks/lookup?op=vindex&exact=on&search=0x%s
• shortcut perldoc points to http://perldoc.perl.org/search.html?q=%s
• shortcut whois points to http://reports.internic.net/cgi/whois?whois_nic=%s&type=domain
• shortcut cve points to https://cve.mitre.org/cgi-bin/cvename.cgi?name=%s
• shortcut flickr points to https://secure.flickr.com/photos/%s
• shortcut man points to http://manpages.debian.org/%s
• shortcut ohloh points to https://www.ohloh.net/p/%s
• shortcut cpanrt points to https://rt.cpan.org/Ticket/Display.html?id=%s
• shortcut novellbug points to https://bugzilla.novell.com/show_bug.cgi?id=%s
• shortcut ubupkg points to http://packages.ubuntu.com/%s
• shortcut mozillazinekb points to http://kb.mozillazine.org/%s
• shortcut freebsdwiki points to http://wiki.freebsd.org/%s
• shortcut hackage points to http://hackage.haskell.org/package/%s
• shortcut pkgsrc points to http://pkgsrc.se/%S
• shortcut doi points to http://dx.doi.org/%s
• shortcut arxiv points to http://arxiv.org/abs/%s

To add a new shortcut, use the shortcut directive. In the url, "%s" is replaced with the text passed to the named shortcut, after url encoding it, and '%S' is replaced with the raw, non-encoded text. Additionally, %W is replaced with the text encoded just right for Wikipedia. The optional desc parameter controls the description of the link.

Remember that the name you give the shortcut will become a new directive. Avoid using a name that conflicts with an existing directive. These directives also accept a desc parameter that will override the one provided at definition time.

If you come up with a shortcut that you think others might find useful, consider contributing it to the shortcuts page on the ikiwiki wiki, so that future versions of ikiwiki will include your shortcut in the standard underlay.

Ikiwiki uses many templates for many purposes. By editing its templates, you can fully customise its appearance, and avoid duplicate content.

Ikiwiki uses the HTML::Template module as its template engine. This supports things like conditionals and loops in templates and is pretty easy to learn. All you really need to know to modify templates is this:

• To insert the value of a template variable, use <TMPL_VAR variable>.
• To make a block of text conditional on a variable being set use <TMPL_IF variable>text</TMPL_IF>.
• To use one block of text if a variable is set and a second if it's not, use <TMPL_IF variable>text<TMPL_ELSE>other text</TMPL_IF>

template pages

Template pages are regular wiki pages containing a templatebody directive, used as templates for other pages. The parts of the template page outside the directive can be used to document it.

The template directive allows template pages to be filled out and inserted into other pages in the wiki.

These template pages are currently available:

note

popup

If the template does not contain a templatebody directive, the entire source of the page is used for the template. This is deprecated.

template files

Template files are unlike template pages in that they have the extension .tmpl. Template files are used extensively by Ikiwiki to generate html. They can contain html that would not normally be allowed on a wiki page.

Template files are located in /usr/share/ikiwiki/templates by default; the templatedir setting can be used to make another directory be searched first. Customised template files can also be placed inside the "templates/" directory in your wiki's source -- files placed there override ones in the templatedir.

Here is a full list of the template files used:

• page.tmpl - Used for displaying all regular wiki pages. This is the key template to customise to change the look and feel of Ikiwiki.

• rsspage.tmpl - Used for generating rss feeds for blogs.

• rssitem.tmpl - Used for generating individual items on rss feeds.
• atompage.tmpl - Used for generating atom feeds for blogs.
• atomitem.tmpl - Used for generating individual items on atom feeds.
• inlinepage.tmpl - Used for displaying a post in a blog.
• archivepage.tmpl - Used for listing a page in a blog archive page.
• titlepage.tmpl - Used for listing a page by title in a blog archive page.
• microblog.tmpl - Used for showing a microblogging post inline.
• blogpost.tmpl - Used for a form to add a post to a blog (and rss/atom links)
• feedlink.tmpl - Used to add rss/atom links if blogpost.tmpl is not used.
• aggregatepost.tmpl - Used by the aggregate plugin to create a page for a post.
• searchform.tmpl, googleform.tmpl - Used by the search plugin and google plugin to add search forms to wiki pages.
• searchquery.tmpl - This is a Omega template, used by the search plugin.
• comment.tmpl - Used by the comments plugin to display a comment.
• change.tmpl - Used to create a page describing a change made to the wiki.
• recentchanges.tmpl - Used for listing a change on the RecentChanges page.
• autoindex.tmpl - Filled in by the autoindex plugin to make index pages.
• autotag.tmpl - Filled in by the tag plugin to make tag pages.
• calendarmonth.tmpl, calendaryear.tmpl - Used by ikiwiki-calendar to make calendar archive pages.
• trails.tmpl - Used by the trail plugin to generate links on each page that is a member of a trail.
• notifyemail.tmpl - Used by the notifymail plugin to generate mails about changed pages.
• editpage.tmpl, editconflict.tmpl, editcreationconflict.tmpl, editfailedsave.tmpl, editpagegone.tmpl, pocreatepage.tmpl, editcomment.tmpl commentmoderation.tmpl, renamesummary.tmpl, passwordmail.tmpl, openid-selector.tmpl, revert.tmpl - Parts of ikiwiki's user interface; do not normally need to be customised.

Slides are up

The slides from our speakers are now about on the site, and are linked to from Programme.

Thank you to the speakers and the attendees for making the mini-debconf a success!

An initial porgramme for the LCA2015 Debian miniconference on Monday 12 is now available, this may yet change.

Due to a limited number of talk submissions the Saturday session of the mini-DebConf is now an unconference day.

We have a venue!

The New Zealand 2015 mini-DebConf will be held in the Owen G Glenn Building at the University of Auckland. This is the same venue as LCA2015 and for more information you can see their venue page.

Within the building, we'll be in the 260-040B Seminar Room on Level 0.

Woohoo! We've put out the Call for Presentations for the combined LCA2015 Debian Miniconf and NZ2015 mini-DebConf, both being held in Auckland, New Zealand in 2015!