* debian/copyright: turn comments on provenance into Comment
* brokenlinks: sort the pages that link to the missing page, for
better reproducibility
+ * Add [[!meta date]] to news items and tips, since the git checkout
+ and build process can leave the checkout date in the tarball
+ release, leading to unstable sorting
-- Joey Hess <id@joeyh.name> Tue, 28 Apr 2015 12:24:08 -0400
-[Integrated issue tracking with Ikiwiki](http://www.linuxworld.com/news/2007/040607-integrated-issue-tracking-ikiwiki.html) by Joey Hess is now available on LinuxWorld.com. (LinuxWorld's author contract also allows this article to become part of the project's documentation.) Learn how to use Ikiwiki inlining and PageSpecs for lightweight workflow. Joey also explains how having the BTS and docs in the project's revision control system can help users of distributed revision control systems keep bug tracking info in sync with code changes.
\ No newline at end of file
+[[!meta date="2007-04-06 21:29:16 +0000"]]
+
+[Integrated issue tracking with Ikiwiki](http://www.linuxworld.com/news/2007/040607-integrated-issue-tracking-ikiwiki.html) by Joey Hess is now available on LinuxWorld.com. (LinuxWorld's author contract also allows this article to become part of the project's documentation.) Learn how to use Ikiwiki inlining and PageSpecs for lightweight workflow. Joey also explains how having the BTS and docs in the project's revision control system can help users of distributed revision control systems keep bug tracking info in sync with code changes.
+[[!meta date="2008-07-11 09:58:19 -0400"]]
+
I've produced a [code_swarm](http://vis.cs.ucdavis.edu/~ogawa/codeswarm/)
visualization of the first 2+ years of ikiwiki's commit history.
+[[!meta date="2008-06-12 16:34:18 -0400"]]
+
I was asked a good question today: How can a company find someone to work
on ikiwiki? To help answer this question, I've set up a [[consultants]] page.
If you might be interested in being paid to work on ikiwiki, please add your
-After looking up and noticing that another 8 hours had passed, replying to people and hacking, I've added a [[TipJar]] page, in case anyone feels like tossing me a few bucks for ikiwiki. TIA! --[[Joey]]
\ No newline at end of file
+[[!meta date="2006-12-29 07:05:57 +0000"]]
+
+After looking up and noticing that another 8 hours had passed, replying to people and hacking, I've added a [[TipJar]] page, in case anyone feels like tossing me a few bucks for ikiwiki. TIA! --[[Joey]]
+[[!meta date="2008-10-24 16:08:36 -0400"]]
+
Now you can use [[git]] to clone this wiki, and push your changes back,
thanks to ikiwiki's new support for [[tips/untrusted_git_push]]. Enjoy
working on the wiki while offline! --[[Joey]]
+[[!meta date="2010-08-05 17:44:47 -0400"]]
+
ikiwiki-hosting is an interface on top of Ikiwiki to allow easy management
of lots of ikiwiki sites. I developed it for
[Branchable](http://www.branchable.com/), an Ikiwiki hosting provider.
+[[!meta date="2007-03-15 10:55:18 +0000"]]
+
Google has accepted ikiwiki as a mentoring organization for [Summer of Code 2007](http://code.google.com/soc).
See our [[Summer_of_Code|soc]] page for projects.
---[[JoshTriplett]]
\ No newline at end of file
+--[[JoshTriplett]]
+[[!meta date="2007-11-26 19:14:22 -0500"]]
+
I've put together a short screencast that covers approximatly the first
half of the [[setup]] document, and includes a demo of setting up a blog
using ikiwiki.
+[[!meta date="2008-12-31 15:30:41 -0500"]]
+
Ikiwiki has reached version 3.0 and entered a new phase in its
[[development_cycle|roadmap]].
+[[!meta date="2007-02-20 10:11:01 +0000"]]
+
Ikiwiki now has an IRC channel: `#ikiwiki` on irc.oftc.net
The channel features live commit messages for CIA for changes to both
+[[!meta date="2007-10-24 22:21:06 -0400"]]
+
I've started using git as ikiwiki's main repository. See [[download]] for
repository locations.
-Ikiwiki has its own domain now, ikiwiki.info. Update your links.
\ No newline at end of file
+Ikiwiki has its own domain now, ikiwiki.info. Update your links.
+
+[[!meta date="2007-02-18 20:24:26 +0000"]]
I'll keep an eye on [[server_speed]]..
--[[Joey]]
+
+[[!meta date="2008-01-29 18:48:01 -0500"]]
making such a switch. --[[Joey]]
[[!poll 77 "Accept only OpenID for logins" 22 "Accept only password logins" 50 "Accept both"]]
+
+[[!meta date="2006-11-20 21:08:23 +0000"]]
any changes across since git makes that bog-easy.
Please report any problems..
+
+[[!meta date="2008-03-19 23:07:13 -0400"]]
this, your DNS has already caught up and you are using the new server.
By the way, the new server should be somewhat faster.
--[[Joey]]
+
+[[!meta date="2009-12-12 15:19:42 -0500"]]
[[discussion]] page.
Ikiwiki is now hosted at [Branchable](http://branchable.com/).
+
+[[!meta date="2007-02-20 10:40:02 +0000"]]
style sheet, and always appreciate suggestions for it.
--[[Joey]]
+
+[[!meta date="2006-09-23 00:12:21 +0000"]]
Thanks, David Bremner
* highlight: Add support for multiple language definition directories
Closes: #[757680](http://bugs.debian.org/757680)
- Thanks, David Bremner"""]]
\ No newline at end of file
+ Thanks, David Bremner"""]]
+[[!meta date="2014-08-15 13:20:58 -0400"]]
ikiwiki 3.20140831 released with [[!toggle text="these changes"]]
[[!toggleable text="""
- * Make --no-gettime work in initial build. Closes: #[755075](http://bugs.debian.org/755075)"""]]
\ No newline at end of file
+ * Make --no-gettime work in initial build. Closes: #[755075](http://bugs.debian.org/755075)"""]]
+[[!meta date="2014-08-31 14:21:36 -0700"]]
* Add \[[!templatebody]] directive so template pages don't have to be
simultaneously a valid template and valid HTML
* Add [[smcv]] to Uploaders and release to Debian"""]]
+[[!meta date="2014-09-16 11:16:52 +0100"]]
* debian: rename debian/link to debian/links so the intended symlinks appear
* debian: fix some wrong paths in the copyright file
"""]]
+[[!meta date="2014-10-17 01:01:53 +0100"]]
* po: If msgmerge falls over on a problem po file, print a warning
message, but don't let this problem crash ikiwiki entirely.
"""]]
+[[!meta date="2015-01-07 10:24:25 +0000"]]
In addition, version 3.20141016.2 was released on the same day to backport
the cross-site-scripting fix to Debian 8.
+
+[[!meta date="2015-03-29 22:46:39 +0100"]]
+[[!meta date="2008-08-19 05:30:33 -0400"]]
+
<a href="http://disqus.com">Disqus</a> is a comment system that you can add to your blog to manage comments.
To add it to ikiwiki first create an account at disqus and add you blog. Then click on the Admin link at that top of the main page.
+[[!meta date="2008-05-05 14:14:08 -0400"]]
+
# Introduction
I had some trouble installing ikiwiki on to a shared hosting service (DreamHost) and figured I'd post the results, since it was pretty rough to get installed. These instructions should work for Perl generally (some of the docs are borrowed from Catalyst's docs), but are tailored for Ikiwiki. There are a few items I'll file as bugs, as well, to aid future installation, but frankly the problems appear to be with installing perl as a non-root user, not anything specific to iki.
+[[!meta date="2008-10-19 18:33:59 -0400"]]
+
One may want to provide ikiwiki hosting with [[rcs/git]]+ssh access and web
server located at different hosts. Here's a description for such
a setup, using password-less SSH as a way of communication between
+[[!meta date="2008-10-18 09:21:24 -0400"]]
+
Instead of the [[plugins/search]] plugin you could embed [Google Custom Search](http://www.google.com/cse) for site search functionality.
**Unfortunately** you need [[plugins/rawhtml]] enabled.
[[!meta title="Hosting Ikiwiki with a master git repository on a remote machine"]]
+[[!meta date="2013-07-22 16:38:20 -0400"]]
This tutorial explains how to set up a wiki such that:
+[[!meta date="2013-09-26 09:22:26 -0400"]]
+
# Howto avoid heavy files in ikiwiki git repo
Continuation of discussion at [git-annex forum](http://git-annex.branchable.com/forum/git-annex___38___ikiwiki_experiment/) turns out the git-annex tricks could be avoided.
+[[!meta date="2007-10-05 06:59:14 +0000"]]
+
Use case: You want to move away from Wordpress to Ikiwiki as your blogging/website platform, but you want to retain your old posts.
[This](http://git.chris-lamb.co.uk/?p=ikiwiki-wordpress-import.git) is a simple tool that generates [git-fast-import](http://www.kernel.org/pub/software/scm/git/docs/git-fast-import.html)-compatible data from a WordPress export XML file.
+[[!meta date="2007-09-10 04:32:55 +0000"]]
+
The source file `foo/bar.mdwn` or `foo/bar.html` generates the
page `foo/bar/index.html`, but the links to the page appear
as "`foo/bar/`". This is fine (and recommended) for pages
+[[!meta date="2011-07-14 17:27:42 -0400"]]
+
To accomplish this on a blog setup, I ran:
mkdir ${SRCDIR}/templates
+[[!meta date="2013-09-24 05:32:11 -0400"]]
+
this script can be used to convert your existing Movable Type blog/database to a ikiwiki blog.
First, go to your MT Admin panel and purge all spam comments/trackbacks. Then use this script: <http://anti.teamidiot.de/static/nei/*/Code/MovableType/mtdump_to_iki.pl>
+[[!meta date="2014-07-11 08:25:31 -0400"]]
+
Here's a simple way to create pages in which the page body (or a part of it) goes right-to-left.
This includes things you insert into the page, such as polls and blockquotes and
lists and a progress bar and so on. Some things don't work perfectly, but if
+[[!meta date="2009-04-10 17:47:39 -0400"]]
+
If you use twitter or identi.ca, here's how to make a box
on the side of your blog that holds your recent status updates
from there, like I have on [my blog](http://kitenet.net/~joey/blog/)
+[[!meta date="2007-04-14 20:18:11 +0000"]]
+
I have a [blog](http://git.kitenet.net/?p=joey/home.git;a=blob_plain;f=bin/blog)
program that I use to write blog posts in a text editor. The first line I
enter is used as the title, and it automatically comes up with a unique page
name based on the title and handles all the details of posting to my blog.
--[[Joey]]
-
+[[!meta date="2008-12-18 20:20:42 -0500"]]
+
You've enabled the [[plugins/comments]] plugin, so a set of pages on your
blog can have comments added to them. Pages with comments even have special
feeds that can be used to subscribe to those comments. But you'd like to
+[[!meta date="2013-01-18 04:42:05 -0400"]]
+
Daniel Burrows
[explains](http://algebraicthunk.net/~dburrows/blog/entry/howto-convert-your-blogger-or-blogspot-blog-to-ikiwiki/)
how to convert your Blogger/BlogSpot blog to ikiwiki.
+[[!meta date="2015-02-06 11:29:25 -0500"]]
+
[[anarcat]] wrote a
[drupal2ikiwiki](http://anarc.at/services/wiki/drupal/drupal2ikiwiki.py)
program to import his Drupal site. There's a [detailed article](http://anarc.at/blog/2015-02-06-migrating-drupal-ikiwiki/) explaining the justification behind the switch, the various approaches taken and more!
[[!toc levels=2]]
+[[!meta date="2008-10-20 16:55:38 -0400"]]
Mediawiki is a dynamically-generated wiki which stores its data in a
relational database. Pages are marked up using a proprietary markup. It is
+[[!meta date="2008-10-20 16:55:39 -0400"]]
+
This MoinMoin converter converts wikis to ikiwikis backed by a git repository, including full history. It simply parses the wiki pages into markdown using the MoinMoin engine.
The converter was originally written by [[JoshTriplett]] and included support for Tikiwiki, for which it parses the wiki pages to HTML then back into markdown using the `libhtml-wikiconverter` Perl package. That original version from Josh is still available from [his wiki page](/users/JoshTriplett).
+[[!meta date="2015-01-07 23:11:57 -0500"]]
+
[[Amitai Schlair|schmonz]] wrote an `ikiwiki-import` program that
currently can only [import from
Textpattern](https://github.com/schmonz/txp2ikiwiki), and then only
+[[!meta date="2008-05-06 19:22:09 -0400"]]
+
[[rcs/git]] and other distributed version control systems are all about
making it easy to create and maintain copies and branches of a project. And
this can be used for all sorts of interesting stuff. Since ikiwiki can use
+[[!meta date="2009-01-12 20:01:03 -0500"]]
+
It's common to name the [[cgi]] "ikiwiki.cgi", and put it somewhere
like `~/public_html/ikiwiki.cgi`, or `/var/www/wiki/ikiwiki.cgi`.
+[[!meta date="2008-11-10 17:40:03 -0500"]]
+
A [markdown mode](http://jblevins.org/projects/markdown-mode/) for
emacs can help in editing of ikiwiki
[[ikiwiki/markdown]] files.
+[[!meta date="2008-12-26 15:27:49 -0500"]]
+
Content from sites such as YouTube can be embedded into a web page. Maybe
you want to do this. But you'll find that the [[plugins/htmlscrubber]]
doesn't let you. It blocks the tags used to embed such content, because
+[[!meta date="2010-02-08 23:32:05 -0500"]]
+
The [ikiwiki-nav](http://www.vim.org/scripts/script.php?script_id=2968) plugin
for vim eases the editing of IkiWiki wikis, by letting you "follow" the
wikilinks on your file (page), by loading the file associated with a given
+[[!meta date="2008-12-29 14:58:54 -0500"]]
+
Here's how to set up a static wiki or blog using ikiwiki with no hosting
fees. Everything is hosted on github, both the git repository and the web
site. Your laptop is used to generate and publish changes to it.
+[[!meta date="2007-04-14 20:29:32 +0000"]]
+
If you have a [[blog]] that is aggregated, either on a site like Planet
Debian, or just through user subscriptions, one common problem is that
changes to the guids of items in the blog can “flood” the aggregator,
+[[!meta date="2010-07-07 10:48:36 +0000"]]
+
Enable [[plugins/lockedit]] in your setup file.
For example:
+[[!meta date="2010-03-14 14:58:13 -0400"]]
+
If you try to include a `.htaccess` file in your wiki's source, in order to
configure the web server, you'll find that ikiwiki excludes it from
processing. In fact, ikiwiki excludes any file starting with a dot, as well
+[[!meta date="2010-05-02 17:16:15 -0400"]]
+
First, if you just want to embed videos using the html5 `<video>` tag,
you can do that without switching anything else to html5.
However, if you want to fully enter the brave new world of html5, read on..
[[!template id=note text="**Table of contents** [[!toc ]]"]]
+[[!meta date="2009-09-02 17:17:15 -0400"]]
Introduction
------------
[[!toc]]
+[[!meta date="2011-06-24 17:35:14 -0400"]]
# pkgsrc
+[[!meta date="2008-06-15 15:05:02 -0400"]]
+
Remember gopher? Ikiwiki can be served up by this venerable protocol.
It's pretty simple to get it going. Just install pygopherd or another gopher
+[[!meta date="2009-08-08 16:04:58 -0400"]]
+
[Here](http://blog.spang.cc/posts/migrating_from_typo_to_ikiwiki/) is a blog post that gives instructions and a script for importing posts from [Typo](http://typosphere.org/), a Ruby-on-Rails based blogging engine.
[[!meta title="inside .ikiwiki"]]
+[[!meta date="2008-03-21 13:52:50 -0400"]]
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
[[!meta title="Integrated issue tracking with Ikiwiki"]]
+[[!meta date="2007-04-06 21:36:07 +0000"]]
[[!meta author="Joey Hess, LinuxWorld.com"]]
[[!toc]]
+[[!meta date="2007-10-22 01:45:55 +0000"]]
Using ikiwiki with the [[rcs/git]] backend, some interesting things can be done
with creating mirrors (or, really, branches) of a wiki. In this tip, I'll
[[!meta title="Laptop Ikiwiki extended"]]
+[[!meta date="2008-03-03 08:21:04 -0500"]]
I have (at least) three different hosts, `laptop`, `gitserver`, and `webserver`.
+[[!meta date="2013-04-13 11:46:28 -0400"]]
+
One can think about implementing "[[Mailman integration]]" or something, but I find that rather overdoing it. Mailman is simple enough that you can add a clean subscription form to your ikiwiki site in seconds, just add:
~~~~
+[[!meta date="2009-01-11 16:04:32 -0500"]]
+
For people that were not born with GNU emacs fingers,
there is a markdown editor (with preview and outline)
for [eclipse](http://www.eclipse.org) available
+[[!meta date="2009-08-02 13:35:04 -0400"]]
+
When using [mathopd](http://www.mathopd.org) to serve ikiwiki, be careful of your Umask settings in the mathopd.conf.
With `Umask 026` in mathopd.conf, editing pages resulted in the following errors and a 404 page when the wiki tried to take me to the updated page.
+[[!meta date="2013-07-21 20:06:12 -0400"]]
+
First, get familiar with [[howto avoid flooding aggregators]].
## Into ikiwiki, from another CMS
+[[!meta date="2014-04-01 10:39:47 -0400"]]
+
because of [[bugs/notifyemail_fails_with_some_openid_providers]], I have been struggling with finding ways of being notified of changes to pages I want to watch here.
the workaround I found so far was to join the `#ikiwiki` channel on freenode, and set the following "hilight" in irssi:
+[[!meta date="2008-05-05 14:51:26 -0400"]]
+
[NearlyFreeSpeech.net](http://NearlyFreeSpeech.net) is a shared hosting
provider with very cheap pay as you go pricing. Here's how to install ikiwiki
there if you don't have a dedicated server.
+[[!meta date="2009-10-15 18:42:46 -0400"]]
+
Ikiwiki is a wiki compiler, which means that, unlike a traditional wiki,
all the work needed to display your wiki is done up front. Where you can
see it and get annoyed at it. In some ways, this is better than a wiki
+[[!meta date="2008-07-16 17:43:57 -0400"]]
+
Here are some tips for ways to style the links
provided by the [[plugins/parentlinks]] plugin.
+[[!meta date="2010-12-12 07:33:25 +0000"]]
+
Here's the app.psgi file if you want to run ikiwiki with [PSGI](http://plackperl.org) instead of apache or other web servers:
use Plack::App::CGIBin;
+[[!meta date="2007-04-11 01:17:05 +0000"]]
+
Want to turn on the `usedirs` setting on an existing wiki without breaking
all the links into it?
"(.*)\.(atom|rss)$" => "$1/index.$2"
)
}
- }
\ No newline at end of file
+ }
+[[!meta date="2010-03-01 13:14:48 +0000"]]
+
Any wiki with a form of web-editing enabled will have to deal with
spam. (See the [[plugins/blogspam]] plugin for one defensive tool you
can deploy).
+[[!meta date="2007-04-29 22:48:35 +0000"]]
+
As of version 2.0, ikiwiki will switch to enabling the 'usedirs' setting by
default. This *will* break all URLs to wikis that did not have 'usedirs'
turned on before. You can either follow this procedure to convert your wiki
+[[!meta date="2008-10-24 15:47:18 -0400"]]
+
This tip will describe how to allow anyone on the planet to `git push`
changes into your wiki, without needing a special account. All a user needs
to know is:
+[[!meta date="2008-12-23 16:20:37 -0500"]]
+
Version 3.0 of ikiwiki makes some significant changes, which
you will need to deal with when upgrading from ikiwiki 2.x.
+[[!meta date="2007-04-14 20:18:12 +0000"]]
+
If you use Firefox or Iceweasel, the [It's All
Text](https://addons.mozilla.org/en-US/firefox/addon/4125) extension allows
you to use a real text editor like Emacs or Vim to edit the contents of text
+[[!meta date="2010-09-12 19:25:38 -0500"]]
+
# Vim and ikiwiki
## Syntax highlighting
+[[!meta date="2010-09-12 19:25:37 -0500"]]
+
This page is deprecated. See [[tips/vim_and_ikiwiki]] for the most up to date
content
+[[!meta date="2007-04-14 20:18:13 +0000"]]
+
One thing I use ikiwiki for is the web pages for software projects I
maintain. Each of my projects has a news page with an announcements feed,
and to automatically update this when I release a new version, generating
+[[!meta date="2010-03-19 17:58:40 -0400"]]
+
Here's how to convert your existing standard format ikiwiki setup file into
the new YAML format recently added to ikiwiki.