archives/2009/01

shortcuts

Sun, 29 Jun 2008 20:16:49 +0200

This wiki has shortcuts disabled.

Some examples of using shortcuts include:

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

This page controls what shortcut links the wiki supports.

[[!shortcut name=google url="http://www.google.com/search?q=%s"]]
[[!shortcut name=archive url="http://web.archive.org/*/%S"]]
[[!shortcut name=gmap url="http://maps.google.com/maps?q=%s"]]
[[!shortcut name=gmsg url="http://groups.google.com/groups?selm=%s"]]
[[!shortcut name=wikipedia url="http://en.wikipedia.org/wiki/%s"]]
[[!shortcut name=wikitravel url="http://wikitravel.org/en/%s"]]
[[!shortcut name=wiktionary url="http://en.wiktionary.org/wiki/%s"]]
[[!shortcut name=debbug url="http://bugs.debian.org/%S" desc="Debian 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=debpkgsid url="http://packages.debian.org/sid/%s"]]
[[!shortcut name=debpts url="http://packages.qa.debian.org/%s"]]
[[!shortcut name=debmsg url="http://lists.debian.org/msgid-search/%s"]]
[[!shortcut name=debrt url="https://rt.debian.org/Ticket/Display.html?id=%s"]]
[[!shortcut name=debss url="http://snapshot.debian.net/package/%s"]]
- Usage: [[!debss package]], [[!debss package#version]], or [[!debss package/version]]. See http://snapshot.debian.net for details.
[[!shortcut name=debwiki url="http://wiki.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=gnomebug url="http://bugzilla.gnome.org/show_bug.cgi?id=%s" desc="GNOME bug #%s"]]
[[!shortcut name=linuxbug url="http://bugzilla.kernel.org/show_bug.cgi?id=%s" desc="Linux bug #%s"]]
[[!shortcut name=mozbug url="https://bugzilla.mozilla.org/show_bug.cgi?id=%s" desc="Mozilla bug #%s"]]
[[!shortcut name=gnulist url="http://lists.gnu.org/mailman/listinfo/%s" desc="%s@gnu.org"]]
[[!shortcut name=marcmsg url="http://marc.info/?i=%s"]]
[[!shortcut name=marclist url="http://marc.info/?l=%s"]]
[[!shortcut name=gmane url="http://dir.gmane.org/gmane.%s" desc="gmane.%s"]]
[[!shortcut name=gmanemsg url="http://mid.gmane.org/%s"]]
[[!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=hoogle url="http://haskell.org/hoogle/?q=%s"]]
[[!shortcut name=iki url="http://ikiwiki.info/%S/"]]
[[!shortcut name=ljuser url="http://%s.livejournal.com/"]]
[[!shortcut name=rfc url="http://www.ietf.org/rfc/rfc%s.txt" desc="RFC %s"]]
[[!shortcut name=c2 url="http://c2.com/cgi/wiki?%s"]]
[[!shortcut name=meatballwiki url="http://www.usemod.com/cgi-bin/mb.pl?%s"]]
[[!shortcut name=emacswiki url="http://www.emacswiki.org/cgi-bin/wiki/%s"]]
[[!shortcut name=haskellwiki url="http://haskell.org/haskellwiki/%s"]]
[[!shortcut name=dict url="http://www.dict.org/bin/Dict?Form=Dict1&Strategy=&Database=&Query=%s"]]
[[!shortcut name=imdb url="http://imdb.com/find?q=%s"]]
[[!shortcut name=gpg url="http://pgpkeys.mit.edu:11371/pks/lookup?op=vindex&exact=on&search=0x%s"]]
[[!shortcut name=perldoc url="http://perldoc.perl.org/search.html?q=%s"]]
[[!shortcut name=whois url="http://reports.internic.net/cgi/whois?whois_nic=%s&type=domain"]]
[[!shortcut name=cve url="http://cve.mitre.org/cgi-bin/cvename.cgi?name=%s"]]
[[!shortcut name=cia url="http://cia.vc/stats/project/%s"]]
[[!shortcut name=ciauser url="http://cia.vc/stats/user/%s"]]
[[!shortcut name=flickr url="http://www.flickr.com/photos/%s"]]
[[!shortcut name=man url="http://linux.die.net/man/%s"]]
[[!shortcut name=ohloh url="http://www.ohloh.net/projects/%s"]]
[[!shortcut name=cpanrt url="https://rt.cpan.org/Ticket/Display.html?id=%s" desc="CPAN RT#%s"]]
[[!shortcut name=novellbug url="https://bugzilla.novell.com/show_bug.cgi?id=%s" desc="bug %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 [[!wikipedia url_encoding]] it, and '%S' is replaced with the raw, non-encoded text. 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.

linkingrules

Sun, 29 Jun 2008 20:16:49 +0200

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.

note

Sun, 29 Jun 2008 20:16:49 +0200

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

openidlogin-bg.gif

Sun, 29 Jun 2008 20:16:49 +0200

subpage

Sun, 29 Jun 2008 20:16:49 +0200

ikiwiki supports placing pages in a directory hierarchy. For example, this page, SubPage has some related pages placed under it, like 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.

ikiwiki

Sun, 29 Jun 2008 20:16:49 +0200

This wiki is powered by ikiwiki.

Some documentation on using ikiwiki:

sandbox

Sun, 29 Jun 2008 20:16:49 +0200

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

First item.
Another.
And another..

Bulleted list

item
item

WikiLink

searching

Sun, 29 Jun 2008 20:16:49 +0200

This wiki has searching disabled.

If searching is enabled, you can enter search terms in the search field, as you'd expect. There are a few special things you can do to construct more powerful searches.

To match a phrase, enclose it in double quotes.
AND can be used to search for documents containing two expressions.
OR can be used to search for documents containing either one of two expressions.
Parentheses can be used to build up complicated search expressions. For example, "(foo AND bar) OR (me AND you)"
Prefix a search term with "-" to avoid it from appearing in the results. For example, "-discussion" will omit "discussion".
To search for a page with a given title, use "title:foo".
To search for pages that contain a "bar" link, use "link:bar".

OpenID

Sun, 29 Jun 2008 20:16:49 +0200

This wiki has OpenID enabled.

OpenID 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:

Your OpenID is the URL that you are given when you sign up. 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  openid="http://yourid.myopenid.com/"
       server="http://www.myopenid.com/server"]]

diff.png

Sun, 29 Jun 2008 20:16:49 +0200