LinuxWorld
LinuxWorld Conference and Expo August 4-7, 2008 Call for papers open until Feb. 22
Subscribe to this site with RSS

Integrated issue tracking with Ikiwiki

Connect project documentation with bug tracking and the revision control system, using a new powerful approach to Wiki software.

Wikis are not just for encyclopedias and Web sites anymore. You can use Ikiwiki in combination with your revision control system to handle issue tracking, news feeds, and other needs of a software project. The wiki can make your bug reports as much a part of your software project as its code, with interesting results.

Ikiwiki is a wiki engine with a twist. It's best described by the term "wiki compiler". Just as a typical software project consists of source code that is stored in revision control and compiled with make and gcc, an ikiwiki-based wiki is stored as human editable source in a revision control system, and built into HTML using ikiwiki.

Ikiwiki uses your revision control system to track changes and handle tasks such as rolling back changes and merging edits. Because it takes advantage of revision control, there are no annoying warnings about other people editing a file, or finding yourself locked out of a file because someone else started editing it and left. Instead, the other person's changes will be automatically merged with yours when you commit.

In the rare cases in which automatic merging fails because of concurrent edits to the same part of a page, regular commit conflict markers are shown in the file to let you resolve the conflict, as you would for conflicting edit in source code.

Ikiwiki is a full-featured wiki that you can use for a variety of purposes, from traditional wikis to blogs, podcasting, or even aggregating other sites' RSS feeds into a Planet page. While people are using Ikiwiki for purposes ranging from genealogy research to shoe accessory sales, one thing it's especially well suited for is collaborative software development, including announcements, documentation, managing a software project's Web site, and even acting as an issue tracking system.

Building a project wiki with ikiwiki

The simplest way to use ikiwiki is to build static HTML files from source wiki files. This example builds a wiki for an imaginary software project. The wiki source files used in this example are available in the examples/softwaresite section of ikiwiki's documentation.

1 | 2 | 3 | 4 | 5 | 6 |  Next >

Integrated issue tracking with Ikiwiki By Anonymous on April 7, 2007, 3:14 am Reply | Read entire comment For fucks sake - 3 lines of text and you call that a page. I'm wearing out my mouse clicking along to find the next word in the article.

What a lousy commenting system. By Anonymous on April 11, 2007, 7:31 am Reply | Read entire comment What a lousy commenting system.

What an awfully stupid idea. By Anonymous on April 11, 2007, 7:30 am Reply | Read entire comment What an awfully stupid idea.

All comments (4)

Note: Register to have your user name appear; otherwise your comment will show up as "Anonymous."

*Anonymous comments will only appear once they are approved by the moderator.

Newsletter sign-up

Sign up for one of Network World's newsletters compliments of Linux World

Linux & Open Source News Alert
Web Applications Alert
Video & Podcast Alert
Security: Threat  Alert
Virtualization Alert

Email Address: