Migrate everything else via prefix_directives
This is a partial commit of: egrep -rl '\[\[[a-z]+ ' doc | xargs --max-args 1 ./ikiwiki-transition prefix_directivesmaster
parent
121d0f3456
commit
47d179802d
|
@ -19,7 +19,7 @@ Bus connections
|
|||
* Bus Nr. 02 - **Wiki Developers Tour** - next stop: [MeatballWiki TourBusStop](http://www.usemod.com/cgi-bin/mb.pl?TourBusStop)
|
||||
* Bus Nr. 42 - **Software Developers Tour** - next stop: [Ward's Wiki TourBusStop](http://c2.com/cgi/wiki?TourBusStop)
|
||||
|
||||
[[meatballwiki TourBusMap]]
|
||||
[[!meatballwiki TourBusMap]]
|
||||
|
||||
Famous sights to visit here at **ikiwiki**
|
||||
==========================================
|
||||
|
|
|
@ -3,7 +3,7 @@ elsewhere. Link items to [[bugs/done]] when done.
|
|||
|
||||
Also see the [Debian bugs](http://bugs.debian.org/ikiwiki).
|
||||
|
||||
[[inline pages="bugs/* and !bugs/done and !bugs/discussion and
|
||||
[[!inline pages="bugs/* and !bugs/done and !bugs/discussion and
|
||||
!link(patch) and !link(bugs/done) and !bugs/*/*"
|
||||
feedpages="created_after(bugs/no_commit_mails_for_new_pages)"
|
||||
actions=yes rootpage="bugs" postformtext="Add a new bug titled:" show=0]]
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
[[meta title="CSS"]]
|
||||
[[!meta title="CSS"]]
|
||||
|
||||
## Using CSS with ikiwiki
|
||||
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
[[meta title="CSS Market"]]
|
||||
[[!meta title="CSS Market"]]
|
||||
|
||||
User contributed stylesheet files for ikiwiki. Feel free to add your own
|
||||
stylesheets here. (Upload as wiki pages; wiki gnomes will convert them to css
|
||||
|
@ -7,18 +7,18 @@ files..)
|
|||
* **[[css_market/zack.css]]**, contributed by [[StefanoZacchiroli]],
|
||||
customized mostly for *blogging purposes*, can be seen in action on
|
||||
[zack's blog](http://www.bononia.it/~zack/blog/)
|
||||
[[meta stylesheet="zack"]]
|
||||
[[!meta stylesheet="zack"]]
|
||||
|
||||
* **[[css_market/kirkambar.css]]**, contributed by [[Roktas]]. This far from perfect
|
||||
stylesheet follows a [Gitweb](http://www.kernel.org/git/?p=git/git.git;a=tree;f=gitweb)
|
||||
like theme, so it may provide a consistent look'n feel along with the [[rcs/git]] backend. ;-)
|
||||
You can see it in action on [kirkambar](http://kirkambar.net/) (Turkish content).
|
||||
[[meta stylesheet="kirkambar"]]
|
||||
[[!meta stylesheet="kirkambar"]]
|
||||
|
||||
* **[[css_market/embeddedmoose.css]]**, contributed by [[JoshTriplett]].
|
||||
Designed for [Embedded Moose](http://embeddedmoose.com). Some ideas from the
|
||||
Debian lighttpd index.html page.
|
||||
[[meta stylesheet="embeddedmoose"]]
|
||||
[[!meta stylesheet="embeddedmoose"]]
|
||||
|
||||
* **Refresh**, contributed by [[FredericLespez]]. Adapted from a free template
|
||||
designed by [styleshout](http://www.styleshout.com).
|
||||
|
@ -34,18 +34,18 @@ files..)
|
|||
**[[css_market/02_Template.tmpl]]**. If you prefer
|
||||
[my header image](http://martin.wuertele.net/images/header.png) you can
|
||||
use it under the terms of the MIT License (see png comment).
|
||||
[[meta stylesheet="02_Template"]]
|
||||
[[!meta stylesheet="02_Template"]]
|
||||
|
||||
* **[[css_market/cstamas.css]]**, contributed by [[cstamas]].
|
||||
This one is based on embeddedmoose, however it is slightly different now.
|
||||
[My webpage's](http://users.itk.ppke.hu/~cstamas/tag/english) is not the same.
|
||||
You can grab some pictures used as background patterns from there.
|
||||
[[meta stylesheet="cstamas"]]
|
||||
[[!meta stylesheet="cstamas"]]
|
||||
|
||||
* **[[css_market/bma.css]]**, contributed by [bma](http://subvert.org.uk/~bma/).
|
||||
Not quite the same as I use on my site, since that has slightly modified
|
||||
templates.
|
||||
[[meta stylesheet="bma"]]
|
||||
[[!meta stylesheet="bma"]]
|
||||
|
||||
If your web browser allows selecting between multiple stylesheets, this
|
||||
page can be viewed using many of the stylesheets above. For example, if
|
||||
|
|
|
@ -11,7 +11,7 @@ Installation steps and requirements are listed on the [[install]] page.
|
|||
## packages
|
||||
|
||||
To install with apt, if using Debian (since 4.0), or Ubuntu (since 6.10):
|
||||
[[template id=note text="""
|
||||
[[!template id=note text="""
|
||||
Note that Debian 4.0 and especially Ubuntu 6.10 contain older versions of
|
||||
ikiwiki, there have been lots of enhancements and bug fixes since those
|
||||
versions.
|
||||
|
|
|
@ -1,12 +1,12 @@
|
|||
[[meta title="example blog"]]
|
||||
[[!meta title="example blog"]]
|
||||
|
||||
[[pagestats pages="./tags/*"]]
|
||||
[[!pagestats pages="./tags/*"]]
|
||||
|
||||
Welcome to my blog. Have a look at the most recent posts below, or
|
||||
browse the tag cloud on the right. An archive of all [[posts]] is also
|
||||
available.
|
||||
|
||||
[[inline pages="./posts/* and !*/Discussion" show="10"
|
||||
[[!inline pages="./posts/* and !*/Discussion" show="10"
|
||||
actions=yes rootpage="./posts"]]
|
||||
|
||||
----
|
||||
|
|
|
@ -1,3 +1,3 @@
|
|||
Here is a full list of posts to my [[blog|index]].
|
||||
|
||||
[[inline pages="./posts/* and !*/Discussion" archive=yes feedshow=10 quick=yes]]
|
||||
[[!inline pages="./posts/* and !*/Discussion" archive=yes feedshow=10 quick=yes]]
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
This is the first post to this example blog. To add new posts, just add
|
||||
files to the blog/posts/ subdirectory, or use the web form.
|
||||
|
||||
[[tag tags/tech]]
|
||||
[[!tag tags/tech]]
|
||||
|
|
|
@ -4,4 +4,4 @@ Example sidebar
|
|||
* [[Archive|posts]]
|
||||
|
||||
Categories:
|
||||
[[map pages="./tags/* and !*/Discussion"]]
|
||||
[[!map pages="./tags/* and !*/Discussion"]]
|
||||
|
|
|
@ -1,3 +1,3 @@
|
|||
[[pagestats pages="./tags/*"]]
|
||||
[[!pagestats pages="./tags/*"]]
|
||||
|
||||
On the right you can see the tag cloud for this blog.
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
This feed contains pages in the "life" category.
|
||||
|
||||
[[inline pages="link(tags/life) and ./posts/* and !*/Discussion"
|
||||
[[!inline pages="link(tags/life) and ./posts/* and !*/Discussion"
|
||||
show="10" actions=yes]]
|
||||
|
|
|
@ -1,3 +1,3 @@
|
|||
This feed contains pages in the "tech" category.
|
||||
|
||||
[[inline pages="link(tags/tech) and !*/Discussion" show=10 actions=yes]]
|
||||
[[!inline pages="link(tags/tech) and !*/Discussion" show=10 actions=yes]]
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
This is FooBar's bug list. Link bugs to [[bugs/done]] when done.
|
||||
|
||||
[[inline pages="./bugs/* and !./bugs/done and !link(done)
|
||||
[[!inline pages="./bugs/* and !./bugs/done and !link(done)
|
||||
and !*/Discussion" actions=yes postform=yes show=0]]
|
||||
|
|
|
@ -1,3 +1,3 @@
|
|||
recently fixed [[bugs]]
|
||||
|
||||
[[inline pages="./* and link(./done) and !*/Discussion" sort=mtime show=10]]
|
||||
[[!inline pages="./* and link(./done) and !*/Discussion" sort=mtime show=10]]
|
||||
|
|
|
@ -1,6 +1,6 @@
|
|||
FooBar frequently asked questions.
|
||||
|
||||
[[toc ]]
|
||||
[[!toc ]]
|
||||
|
||||
## Is this a real program?
|
||||
|
||||
|
|
|
@ -2,4 +2,4 @@ This is where annoucements of new releases, features, and other news is
|
|||
posted. FooBar users are recommended to subscribe to this page's RSS
|
||||
feed.
|
||||
|
||||
[[inline pages="./news/* and !*/Discussion" rootpage="news" show="30"]]
|
||||
[[!inline pages="./news/* and !*/Discussion" rootpage="news" show="30"]]
|
||||
|
|
|
@ -3,5 +3,5 @@
|
|||
<TMPL_VAR news>
|
||||
|
||||
</TMPL_IF>
|
||||
FooBar <TMPL_VAR version> released with [[toggle text="these changes" id="changelog"]]
|
||||
[[toggleable id="changelog" text="""<TMPL_VAR changelog>"""]]
|
||||
FooBar <TMPL_VAR version> released with [[!toggle text="these changes" id="changelog"]]
|
||||
[[!toggleable id="changelog" text="""<TMPL_VAR changelog>"""]]
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
An overview of some of ikiwiki's features:
|
||||
[[toc ]]
|
||||
[[!toc ]]
|
||||
|
||||
## Uses a real RCS
|
||||
|
||||
|
|
|
@ -4,5 +4,5 @@ _This is a bold experiment by me, since I have exactly such a question. This ove
|
|||
|
||||
## Current topics ##
|
||||
|
||||
[[inline pages="forum/* and !forum/discussion and !forum/*/*"
|
||||
[[!inline pages="forum/* and !forum/discussion and !forum/*/*"
|
||||
actions=yes rootpage="forum" postformtext="Add a new thread titled:" show=0]]
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
[[meta title="Free Software"]]
|
||||
[[!meta title="Free Software"]]
|
||||
|
||||
ikiwiki, and this documentation wiki, are licensed under the terms of the
|
||||
GNU [[GPL]], version 2 or later.
|
||||
|
|
|
@ -17,7 +17,7 @@ BTW, ikiwiki doesn't displays the #foo anchor in the example
|
|||
> [[preprocessor_directive|preprocessordirective]] for it, though.
|
||||
> --[[JoshTriplett]]
|
||||
|
||||
>> [[tag wishlist]]
|
||||
>> [[!tag wishlist]]
|
||||
>> I'd like to implement such a thing. Joey, what is this supposed to look like?
|
||||
>> `\[[anchor WHATEVER]]`? --[[tschwinge]]
|
||||
|
||||
|
|
|
@ -4,7 +4,7 @@ suitable for publishing on a website. Ikiwiki stores pages and history in a
|
|||
There are many other [[features]], including support for
|
||||
[[blogging|ikiwiki/blog]], as well as a large array of [[plugins]].
|
||||
|
||||
[[template id=links]]
|
||||
[[!template id=links]]
|
||||
|
||||
## using ikiwiki
|
||||
|
||||
|
@ -15,7 +15,7 @@ with ikiwiki, and some [[tips]].
|
|||
All wikis are supposed to have a [[SandBox]], so this one does too.
|
||||
|
||||
This site generally runs the latest release of ikiwiki; currently, it runs
|
||||
ikiwiki [[version ]].
|
||||
ikiwiki [[!version ]].
|
||||
|
||||
## developer resources
|
||||
|
||||
|
|
|
@ -5,7 +5,7 @@ Do so here..
|
|||
Note that for more formal bug reports or todo items, you can also edit the
|
||||
[[bugs]] and [[todo]] pages.
|
||||
|
||||
[[toc ]]
|
||||
[[!toc ]]
|
||||
|
||||
# Installation/Setup questions
|
||||
|
||||
|
@ -268,7 +268,7 @@ easily, perl is possible (but I'm not strong in perl).
|
|||
|
||||
> Jamey Sharp and I have a set of scripts in progress to convert other wikis to ikiwiki, including history, so that we can migrate a few of our wikis. We already have support for migrating MoinMoin wikis to ikiwiki, including conversion of the entire history to Git. We used this to convert the [XCB wiki](http://xcb.freedesktop.org/wiki/) to ikiwiki; until we finalize the conversion and put the new wiki in place of the old one, you can browse the converted result at <http://xcb.freedesktop.org/ikiwiki>. We already plan to add support for TWiki (including history, since you can just run parsecvs on the TWiki RCS files to get Git), so that we can convert the [Portland State Aerospace Society wiki](http://psas.pdx.edu) (currently in Moin, but with much of its history in TWiki, and with many of its pages still in TWiki format using Jamey's TWiki format for MoinMoin).
|
||||
>
|
||||
> Our scripts convert by way of HTML, using portions of the source wiki's code to render as HTML (with some additional code to do things like translate MoinMoin's `\[[TableOfContents]]` to ikiwiki's `\[[toc ]]`), and then using a modified [[cpan HTML::WikiConverter]] to turn this into markdown and ikiwiki. This produces quite satisfactory results, apart from things that don't have any markdown equivalent and thus remain HTML, such as tables and definition lists. Conversion of the history occurs by first using another script we wrote to translate MoinMoin history to Git, then using our git-map script to map a transformation over the Git history.
|
||||
> Our scripts convert by way of HTML, using portions of the source wiki's code to render as HTML (with some additional code to do things like translate MoinMoin's `\[[TableOfContents]]` to ikiwiki's `\[[toc ]]`), and then using a modified [[!cpan HTML::WikiConverter]] to turn this into markdown and ikiwiki. This produces quite satisfactory results, apart from things that don't have any markdown equivalent and thus remain HTML, such as tables and definition lists. Conversion of the history occurs by first using another script we wrote to translate MoinMoin history to Git, then using our git-map script to map a transformation over the Git history.
|
||||
>
|
||||
> We will post the scripts as soon as we have them complete enough to convert our wikis.
|
||||
>
|
||||
|
|
|
@ -11,8 +11,8 @@ Ikiwiki is a perl program, and needs a recent version of perl such as
|
|||
It's recommended you have a C compiler, as ikiwiki uses one to build
|
||||
wrappers.
|
||||
|
||||
Ikiwiki requires the [[cpan Text::Markdown]], [[cpan URI]],
|
||||
[[cpan HTML::Parser]], [[cpan HTML::Template]], and [[cpan HTML::Scrubber]]
|
||||
Ikiwiki requires the [[!cpan Text::Markdown]], [[!cpan URI]],
|
||||
[[!cpan HTML::Parser]], [[!cpan HTML::Template]], and [[!cpan HTML::Scrubber]]
|
||||
perl modules be installed. It can also use a lot of other perl modules, if
|
||||
they are available.
|
||||
|
||||
|
|
|
@ -2,7 +2,7 @@ This is where announcements of new releases, features, and other news are
|
|||
posted. [[IkiWikiUsers]] are recommended to subscribe to this page's RSS
|
||||
feed.
|
||||
|
||||
[[inline pages="news/* and !news/*/* and !news/discussion"
|
||||
[[!inline pages="news/* and !news/*/* and !news/discussion"
|
||||
feedpages="created_after(news/Article_on_Ikiwiki_as_a_BTS)" rootpage="news" show="30"]]
|
||||
|
||||
By the way, some other pages with RSS feeds about ikiwiki include
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
I've produced a [code_swarm](http://vis.cs.ucdavis.edu/~ogawa/codeswarm/)
|
||||
visualization of the first 2+ years of ikiwiki's commit history.
|
||||
|
||||
[[img screenshot.png size="480x360"]]
|
||||
[[!img screenshot.png size="480x360"]]
|
||||
|
||||
* [15 mb avi](http://kitenet.net/~joey/screencasts/ikiwiki_swarm.avi)
|
||||
* [stream on vimeo](http://vimeo.com/1324348)
|
||||
|
|
|
@ -9,7 +9,7 @@ default configuration:
|
|||
the procedure described at [[tips/switching_to_usedirs]]
|
||||
or edit your setup file to turn `usedirs` off: `usedirs => 0,`
|
||||
* [[plugins/OpenID]] logins are now enabled by default, if the
|
||||
[[cpan Net::OpenID::Consumer]] perl module is available. Password logins
|
||||
[[!cpan Net::OpenID::Consumer]] perl module is available. Password logins
|
||||
are also still enabled by default. If you like, you can turn either OpenID
|
||||
or password logins off via the `disable_plugins` setting.
|
||||
|
||||
|
@ -29,4 +29,4 @@ An overview of changes in the year since the 1.0 release:
|
|||
* Some support for other markup languages than markdown: rst, textile.
|
||||
* Unit test suite, with more than 300 tests.
|
||||
|
||||
[[meta date="2007-04-30 00:51:57 -0400"]]
|
||||
[[!meta date="2007-04-30 00:51:57 -0400"]]
|
||||
|
|
|
@ -10,4 +10,4 @@ log back in, try out the OpenID signup process if you don't already have an
|
|||
OpenID, and see how OpenID works for you. And let me know your feelings about
|
||||
making such a switch. --[[Joey]]
|
||||
|
||||
[[poll 59 "Accept only OpenID for logins" 18 "Accept only password logins" 35 "Accept both"]]
|
||||
[[!poll 59 "Accept only OpenID for logins" 18 "Accept only password logins" 35 "Accept both"]]
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
Quick poll: Do you feel that ikiwiki is fast enough on this server, or
|
||||
should I move it to my much beefier auxiliary server?
|
||||
|
||||
[[poll open=no 40 "It's fast enough" 6 "It's too slow!" 4 "No opinion"]]
|
||||
[[!poll open=no 40 "It's fast enough" 6 "It's too slow!" 4 "No opinion"]]
|
||||
|
||||
If you have specifics on performance issues, you might mention them on the
|
||||
[[discussion]] page.
|
||||
|
|
|
@ -1,8 +1,8 @@
|
|||
News for ikiwiki 2.49:
|
||||
|
||||
The search plugin no longer uses hyperestraier. Instead, to use it you
|
||||
will now need to install xapian-omega, and the [[cpan Search::Xapian]],
|
||||
[[cpan HTML::Scrubber]], and [[cpan Digest::SHA1]] perl modules. Ie,
|
||||
will now need to install xapian-omega, and the [[!cpan Search::Xapian]],
|
||||
[[!cpan HTML::Scrubber]], and [[!cpan Digest::SHA1]] perl modules. Ie,
|
||||
`apt-get install xapian-omega libsearch-xapian-perl libhtml-scrubber-perl libdigest-sha1-perl`
|
||||
|
||||
Also, wikis that use the search plugin will need to be rebuilt,
|
||||
|
@ -10,8 +10,8 @@ News for ikiwiki 2.49:
|
|||
but can be done by running `ikiwiki-mass-upgrade` as root, or
|
||||
running `ikiwiki -setup` on individual setup files.
|
||||
|
||||
ikiwiki 2.49 released with [[toggle text="these changes"]]
|
||||
[[toggleable text="""
|
||||
ikiwiki 2.49 released with [[!toggle text="these changes"]]
|
||||
[[!toggleable text="""
|
||||
* haiku: Generate valid xhtml.
|
||||
* ikiwiki-mass-rebuild: Don't trust $! when setting $)
|
||||
* inline: The optimisation in 2.41 broke nested inlines. Detect those
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
ikiwiki 2.50 released with [[toggle text="these changes"]]
|
||||
[[toggleable text="""
|
||||
ikiwiki 2.50 released with [[!toggle text="these changes"]]
|
||||
[[!toggleable text="""
|
||||
* img: Support captions.
|
||||
* img: Don't generate empty title attributes, etc.
|
||||
* img: Allow setting defaults for class and id too.
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
ikiwiki 2.51 released with [[toggle text="these changes"]]
|
||||
[[toggleable text="""
|
||||
ikiwiki 2.51 released with [[!toggle text="these changes"]]
|
||||
[[!toggleable text="""
|
||||
* Improve toplevel parentlink to link directly to index.html when usedirs is
|
||||
disabled.
|
||||
* map: Add a "show" parameter. "show=title" can be used to display page
|
||||
|
|
|
@ -4,8 +4,8 @@ News for ikiwiki 2.52:
|
|||
wiki in /etc/ikiwiki/wikilist this will be done automatically when the
|
||||
Debian package is upgraded. Or use ikiwiki-mass-rebuild to force a rebuild.
|
||||
|
||||
ikiwiki 2.52 released with [[toggle text="these changes"]]
|
||||
[[toggleable text="""
|
||||
ikiwiki 2.52 released with [[!toggle text="these changes"]]
|
||||
[[!toggleable text="""
|
||||
* attachment: New plugin for uploading and managing attachments.
|
||||
This includes a fairly powerful PageSpec based admin pref for deciding
|
||||
whether to accept a given upload, and an attachment management interface
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
ikiwiki 2.53 released with [[toggle text="these changes"]]
|
||||
[[toggleable text="""
|
||||
ikiwiki 2.53 released with [[!toggle text="these changes"]]
|
||||
[[!toggleable text="""
|
||||
* search: generate configuration files once only when rebuilding
|
||||
(Gabriel McManus)
|
||||
* attachment: Fix an uninitialised value warning when editing a page
|
||||
|
|
|
@ -7,5 +7,5 @@ once it's ready to be applied, add a 'patch' tag so it will show up here.
|
|||
If your patch is non-trivial and might need several iterations to get
|
||||
right, please consider publishing a [[git]] branch.
|
||||
|
||||
[[inline pages="(todo/* or bugs/*) and link(patch) and !link(bugs/done) and
|
||||
[[!inline pages="(todo/* or bugs/*) and link(patch) and !link(bugs/done) and
|
||||
!link(todo/done) and !*/Discussion" rootpage="todo" archive="yes"]]
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
Most of ikiwiki's [[features]] are implemented as plugins. Many of these
|
||||
plugins are included with ikiwiki.
|
||||
|
||||
[[pagestats pages="plugins/type/* and !plugins/type/slow"]]
|
||||
[[!pagestats pages="plugins/type/* and !plugins/type/slow"]]
|
||||
|
||||
There's documentation if you want to [[write]] your own plugins, or you can
|
||||
[[install]] plugins [[contributed|contrib]] by others.
|
||||
|
@ -13,7 +13,7 @@ will fit most uses of ikiwiki.
|
|||
|
||||
## Plugin directory
|
||||
|
||||
[[inline pages="plugins/* and !plugins/type/* and !plugins/write and
|
||||
[[!inline pages="plugins/* and !plugins/type/* and !plugins/write and
|
||||
!plugins/write/* and !plugins/contrib and !plugins/install and !*/Discussion"
|
||||
feedpages="created_after(plugins/graphviz)" archive="yes"
|
||||
rootpage="plugins/contrib" postformtext="Add a new plugin named:" show=0]]
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
[[meta title="Revision Control Systems"]]
|
||||
[[!meta title="Revision Control Systems"]]
|
||||
|
||||
Ikiwiki supports using several revision control systems for storing page
|
||||
histories.
|
||||
|
@ -10,7 +10,7 @@ generic that it can be adapted to work with many systems by writing a
|
|||
[[git]] is another well-tested option.
|
||||
|
||||
These are all the supported revision control systems:
|
||||
[[inline pages="rcs/* and !*/Discussion and !rcs/details" archive=yes]]
|
||||
[[!inline pages="rcs/* and !*/Discussion and !rcs/details" archive=yes]]
|
||||
|
||||
There is a page with [[details]] about how the different systems work with
|
||||
ikiwiki, for the curious.
|
||||
|
|
|
@ -1,6 +1,6 @@
|
|||
A few bits about the RCS backends
|
||||
|
||||
[[toc ]]
|
||||
[[!toc ]]
|
||||
|
||||
## Terminology
|
||||
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
[[meta title="Git"]]
|
||||
[[!meta title="Git"]]
|
||||
|
||||
[Git][git] is a distributed revison control system originally developed for
|
||||
the Linux kernel. Ikiwiki supports storing a wiki in git.
|
||||
|
|
|
@ -7,4 +7,4 @@ come in. When running as a [[cgi]] with tla, ikiwiki automatically
|
|||
commits edited pages to the Arch repostory, and uses the Arch
|
||||
log to generate the [[RecentChanges]] page.
|
||||
|
||||
Note that the tla support needs the [[cpan MailTools]] perl module.
|
||||
Note that the tla support needs the [[!cpan MailTools]] perl module.
|
||||
|
|
|
@ -55,8 +55,8 @@ Bulleted list
|
|||
|
||||
----
|
||||
|
||||
[[template id=note text="this is generated by the [[plugins/haiku]] plugin"]]
|
||||
[[haiku hint="sandbox play"]]
|
||||
[[!template id=note text="this is generated by the [[plugins/haiku]] plugin"]]
|
||||
[[!haiku hint="sandbox play"]]
|
||||
|
||||
----
|
||||
|
||||
|
@ -78,4 +78,4 @@ The haiku will change after every save, mind you.
|
|||
|
||||
This sandbox is also a [[ikiwiki/blog]]!
|
||||
|
||||
[[inline pages="sandbox/* and !*/Discussion" rootpage="sandbox" show="4" archive="yes"]]
|
||||
[[!inline pages="sandbox/* and !*/Discussion" rootpage="sandbox" show="4" archive="yes"]]
|
||||
|
|
|
@ -1,3 +1,3 @@
|
|||
Testing nested inlines:
|
||||
|
||||
[[inline pages="sandbox/test_nested_inlines/* and !sandbox/test_nested_inlines/*/*" feeds="no"]]
|
||||
[[!inline pages="sandbox/test_nested_inlines/* and !sandbox/test_nested_inlines/*/*" feeds="no"]]
|
||||
|
|
|
@ -6,7 +6,7 @@ security issues with this program than with cat(1). If, however, you let
|
|||
others edit pages in your wiki, then some possible security issues do need
|
||||
to be kept in mind.
|
||||
|
||||
[[toc levels=2]]
|
||||
[[!toc levels=2]]
|
||||
|
||||
----
|
||||
|
||||
|
@ -362,9 +362,9 @@ allow the security hole to be exploited.
|
|||
|
||||
The htmlscrubber did not block javascript in uris. This was fixed by adding
|
||||
a whitelist of valid uri types, which does not include javascript.
|
||||
([[cve CVE-2008-0809]]) Some urls specifyable by the meta plugin could also
|
||||
([[!cve CVE-2008-0809]]) Some urls specifyable by the meta plugin could also
|
||||
theoretically have been used to inject javascript; this was also blocked
|
||||
([[cve CVE-2008-0808]]).
|
||||
([[!cve CVE-2008-0808]]).
|
||||
|
||||
This hole was discovered on 10 February 2008 and fixed the same day
|
||||
with the release of ikiwiki 2.31.1. (And a few subsequent versions..)
|
||||
|
@ -377,7 +377,7 @@ parties.
|
|||
Cross Site Request Forging could be used to constuct a link that would
|
||||
change a logged-in user's password or other preferences if they clicked on
|
||||
the link. It could also be used to construct a link that would cause a wiki
|
||||
page to be modified by a logged-in user. ([[cve CVE-2008-0165]])
|
||||
page to be modified by a logged-in user. ([[!cve CVE-2008-0165]])
|
||||
|
||||
These holes were discovered on 10 April 2008 and fixed the same day with
|
||||
the release of ikiwiki 2.42. A fix was also backported to Debian etch, as
|
||||
|
@ -391,7 +391,7 @@ pre-emtively guard against that, current versions of ikiwiki store password
|
|||
hashes (using Eksblowfish).
|
||||
|
||||
If you use the [[plugins/passwordauth]] plugin, I recommend upgrading to
|
||||
ikiwiki 2.48, installing the [[cpan Authen::Passphrase]] perl module, and running
|
||||
ikiwiki 2.48, installing the [[!cpan Authen::Passphrase]] perl module, and running
|
||||
`ikiwiki-transition hashpassword` to replace all existing cleartext passwords
|
||||
with strong blowfish hashes.
|
||||
|
||||
|
@ -404,7 +404,7 @@ passwords in cleartext over the net to log in, either.
|
|||
This hole allowed ikiwiki to accept logins using empty passwords, to openid
|
||||
accounts that didn't use a password. It was introduced in version 1.34, and
|
||||
fixed in version 2.48. The [bug](http://bugs.debian.org/483770) was
|
||||
discovered on 30 May 2008 and fixed the same day. ([[cve CVE-2008-0169]])
|
||||
discovered on 30 May 2008 and fixed the same day. ([[!cve CVE-2008-0169]])
|
||||
|
||||
I recommend upgrading to 2.48 immediatly if your wiki allows both password
|
||||
and openid logins.
|
||||
|
|
|
@ -1,6 +1,6 @@
|
|||
This tutorial will walk you through setting up a wiki with ikiwiki.
|
||||
|
||||
[[toc ]]
|
||||
[[!toc ]]
|
||||
|
||||
## [[Download]] and [[install]] ikiwiki.
|
||||
|
||||
|
@ -32,8 +32,8 @@ This will create a simple main page for the wiki.
|
|||
$EDITOR index.mdwn
|
||||
|
||||
In the editor, you could start by entering a simple page like
|
||||
[[toggle id=page text="this one"]].
|
||||
[[toggleable id=page text="""
|
||||
[[!toggle id=page text="this one"]].
|
||||
[[!toggleable id=page text="""
|
||||
Welcome to your new wiki.
|
||||
|
||||
All wikis are supposed to have a \[[SandBox]],
|
||||
|
@ -116,14 +116,14 @@ should be preserved, but not checked into revision control.
|
|||
The new [[ikiwiki-makerepo]] command automates setting up a wiki in
|
||||
revision control.
|
||||
|
||||
[[toggle id=subversion text="Subversion"]]
|
||||
[[toggleable id=subversion text="""
|
||||
[[!toggle id=subversion text="Subversion"]]
|
||||
[[!toggleable id=subversion text="""
|
||||
REPOSITORY=~/wikirepo
|
||||
ikiwiki-makerepo svn $SRCDIR $REPOSITORY
|
||||
"""]]
|
||||
|
||||
[[toggle id=git text="Git"]]
|
||||
[[toggleable id=git text="""
|
||||
[[!toggle id=git text="Git"]]
|
||||
[[!toggleable id=git text="""
|
||||
REPOSITORY=~/wiki.git
|
||||
ikiwiki-makerepo git $SRCDIR $REPOSITORY
|
||||
|
||||
|
@ -132,20 +132,20 @@ ikiwiki uses git repositories, and some important caveats
|
|||
about using the git repositories.
|
||||
"""]]
|
||||
|
||||
[[toggle id=mercurial text="Mercurial"]]
|
||||
[[toggleable id=mercurial text="""
|
||||
[[!toggle id=mercurial text="Mercurial"]]
|
||||
[[!toggleable id=mercurial text="""
|
||||
REPOSITORY=$SRCDIR
|
||||
ikiwiki-makerepo mercurial $SRCDIR
|
||||
"""]]
|
||||
|
||||
[[toggle id=bazaar text="Bazaar"]]
|
||||
[[toggleable id=bazaar text="""
|
||||
[[!toggle id=bazaar text="Bazaar"]]
|
||||
[[!toggleable id=bazaar text="""
|
||||
REPOSITORY=$SRCDIR
|
||||
ikiwiki-makerepo bzr $SRCDIR
|
||||
"""]]
|
||||
|
||||
[[toggle id=tla text="TLA"]]
|
||||
[[toggleable id=tla text="""
|
||||
[[!toggle id=tla text="TLA"]]
|
||||
[[!toggleable id=tla text="""
|
||||
REPOSITORY=~/wikirepo
|
||||
tla make-archive me@localhost--wiki $REPOSITORY
|
||||
tla my-id "<me@localhost>"
|
||||
|
@ -158,8 +158,8 @@ about using the git repositories.
|
|||
tla import
|
||||
"""]]
|
||||
|
||||
[[toggle id=monotone text="Monotone"]]
|
||||
[[toggleable id=monotone text="""
|
||||
[[!toggle id=monotone text="Monotone"]]
|
||||
[[!toggleable id=monotone text="""
|
||||
# These instructions are standard instructions to import a directory into monotone
|
||||
# and set it up so that you don't need any passwords to use it
|
||||
REPOSITORY=~/.ikiwiki/mtn.db
|
||||
|
|
|
@ -1,6 +1,6 @@
|
|||
This map excludes discussion pages, as well as subpages that are in feeds.
|
||||
|
||||
[[map pages="* and !*/discussion and !recentchanges
|
||||
[[!map pages="* and !*/discussion and !recentchanges
|
||||
and !bugs/* and !examples/*/* and !news/* and !tips/* and !plugins/*
|
||||
and !sandbox/* and !todo/* and !users/*
|
||||
and !*.css and !*.ico and !*.png and !*.svgz and !*.gif"]]
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
[[meta title="Summer of Code"]]
|
||||
[[!meta title="Summer of Code"]]
|
||||
|
||||
This page includes information about ikiwiki's involvement in
|
||||
[Google Summer of Code](http://code.google.com/soc/).
|
||||
|
|
|
@ -3,6 +3,6 @@ have a great idea for an ikiwiki project not on this list, please file it
|
|||
as a todo item, and ask us if it might work as a Summer of Code project,
|
||||
but please don't add the `soc` tag yourself.
|
||||
|
||||
[[inline pages="(todo/* or bugs/*) and link(soc) and !todo/done and
|
||||
[[!inline pages="(todo/* or bugs/*) and link(soc) and !todo/done and
|
||||
!link(todo/done) and !bugs/done and !link(bugs/done) and
|
||||
!*/Discussion" actions=yes show=0]]
|
||||
|
|
|
@ -1,13 +1,13 @@
|
|||
<span class="infobox">
|
||||
Plugin: <TMPL_VAR name><br />
|
||||
Author: <TMPL_VAR author><br />
|
||||
Included in ikiwiki: [[if test="sourcepage(plugins/contrib/*)" then="""no""" else="""yes"""]]<br />
|
||||
Included in ikiwiki: [[!if test="sourcepage(plugins/contrib/*)" then="""no""" else="""yes"""]]<br />
|
||||
Enabled by default: <TMPL_IF core>yes<TMPL_ELSE>no</TMPL_IF><br />
|
||||
Included in [[/plugins/goodstuff]]: [[if test="backlink(plugins/goodstuff)" all=no then="""yes""" else="""no"""]]<br />
|
||||
Currently enabled: [[if test="enabled(<TMPL_VAR name>)" then="yes" else="no"]]<br />
|
||||
Included in [[/plugins/goodstuff]]: [[!if test="backlink(plugins/goodstuff)" all=no then="""yes""" else="""no"""]]<br />
|
||||
Currently enabled: [[!if test="enabled(<TMPL_VAR name>)" then="yes" else="no"]]<br />
|
||||
</span>
|
||||
[[if test="sourcepage(plugins/contrib/*)" then="""[[meta title="<TMPL_VAR name> (third party plugin)"]]"""]]
|
||||
<TMPL_IF core>[[tag plugins/type/core]]</TMPL_IF>
|
||||
[[!if test="sourcepage(plugins/contrib/*)" then="""[[!meta title="<TMPL_VAR name> (third party plugin)"]]"""]]
|
||||
<TMPL_IF core>[[!tag plugins/type/core]]</TMPL_IF>
|
||||
<TMPL_UNLESS NAME="name">
|
||||
This template is used to create an infobox for an ikiwiki plugin. It uses
|
||||
these parameters:
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
This page is a place to document tips and techniques for using ikiwiki.
|
||||
|
||||
[[inline pages="tips/* and !tips/*/*"
|
||||
[[!inline pages="tips/* and !tips/*/*"
|
||||
feedpages="created_after(tips/howto_avoid_flooding_aggregators)" archive="yes"
|
||||
rootpage="tips" postformtext="Add a new tip about:" show=0]]
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
[[meta title="inside .ikiwiki"]]
|
||||
[[!meta title="inside .ikiwiki"]]
|
||||
|
||||
The `.ikiwiki` directory contains ikiwiki's internal state. Normally,
|
||||
you don't need to look in it, but here's some tips for how to do so if
|
||||
|
|
|
@ -1,14 +1,14 @@
|
|||
[[meta title="Integrated issue tracking with Ikiwiki"]]
|
||||
[[!meta title="Integrated issue tracking with Ikiwiki"]]
|
||||
|
||||
[[meta author="Joey Hess, LinuxWorld.com"]]
|
||||
[[!meta author="Joey Hess, LinuxWorld.com"]]
|
||||
|
||||
[[meta copyright="""
|
||||
[[!meta copyright="""
|
||||
Copyright 2007 Joey Hess <joeyh@ikiwiki.info>, LinuxWorld.com
|
||||
[First published](http://www.linuxworld.com/news/2007/040607-integrated-issue-tracking-ikiwiki.html)
|
||||
on [LinuxWorld.com](http://www.linuxworld.com/), a publication of Network
|
||||
World Inc., 118 Turnpike Rd., Southboro, MA 01772.
|
||||
"""]]
|
||||
[[meta license="[[GPL|freesoftware]]"]]
|
||||
[[!meta license="[[GPL|freesoftware]]"]]
|
||||
|
||||
Wikis are not just for encyclopedias and websites anymore. You can use
|
||||
Ikiwiki in combination with your revision control system to handle issue
|
||||
|
|
|
@ -3,19 +3,19 @@ as any [[patches|patch]]. If it seems more like a bug in the existing code,
|
|||
post it to [[bugs]] instead. Link items to [[todo/done]] when done.
|
||||
|
||||
<!-- currently commented out because I lost all my mtimes :-)
|
||||
[[if test="enabled(postsparkline)"
|
||||
[[!if test="enabled(postsparkline)"
|
||||
then="""
|
||||
How long will it take your todo item to be fixed? Well...
|
||||
[[postsparkline pages="todo/* and !todo/done and !link(todo/done) and !todo/*/*"
|
||||
[[!postsparkline pages="todo/* and !todo/done and !link(todo/done) and !todo/*/*"
|
||||
max=12 ymin=10 formula=permonth style=bar barwidth=2 barspacing=1 height=13]]
|
||||
this many are being added per month
|
||||
[[postsparkline pages="todo/* and !todo and link(todo/done)"
|
||||
[[!postsparkline pages="todo/* and !todo and link(todo/done)"
|
||||
max=12 ymin=10 formula=permonth time=mtime style=bar barwidth=2 barspacing=1 height=13]]
|
||||
while this many are being fixed.
|
||||
"""]]
|
||||
-->
|
||||
|
||||
[[inline pages="todo/* and !todo/done and !link(todo/done) and
|
||||
[[!inline pages="todo/* and !todo/done and !link(todo/done) and
|
||||
!link(patch) and !link(wishlist) and !todo/*/*"
|
||||
feedpages="created_after(todo/supporting_comments_via_disussion_pages)"
|
||||
actions=yes archive=yes rootpage="todo" postformtext="Add a new todo item titled:" show=0]]
|
||||
|
|
|
@ -6,6 +6,6 @@ comments.
|
|||
|
||||
List of users
|
||||
=============
|
||||
[[inline pages="users/* and !users/*/* and !*/Discussion"
|
||||
[[!inline pages="users/* and !users/*/* and !*/Discussion"
|
||||
feeds=no archive=yes sort=title template=titlepage
|
||||
rootpage="users" postformtext="Add yourself as an ikiwiki user:"]]
|
||||
|
|
|
@ -2,5 +2,5 @@ These [[todo]] tagged 'wishlist' encompass all kinds of features and
|
|||
improvements people would like to see in ikiwiki. Good patches for any of
|
||||
these will likely be accepted.
|
||||
|
||||
[[inline pages="todo/* and !todo/done and !link(todo/done) and
|
||||
[[!inline pages="todo/* and !todo/done and !link(todo/done) and
|
||||
link(wishlist) and !link(patch) and !todo/*/*" archive=yes show=0]]
|
||||
|
|
Loading…
Reference in New Issue