Radified Community Forums
Rad Community Non-Technical Discussion Boards >> YaBB Forum Software + Rad Web Site >> Wiki?

Message started by Rad on Oct 6th, 2009 at 11:53pm

Title: Wiki?
Post by Rad on Oct 6th, 2009 at 11:53pm
I was thinking of installing a wiki. Can't hurt. Might help.

I recall Nigel touting one, but can't recall which. Dokuwiki I think. I know it was PHP-based, cuz he suggested looking at the code, as an example of a well-coded program.

Anybody have experience with wikis?

I found these links.



Wikis have 'standards'?

Title: Re: Wiki?
Post by MrMagoo on Oct 7th, 2009 at 12:31am
I've considered converting my articles into wiki's multiple times.  I mostly like the idea, although I'd have to have editing controls to keep spammers out and the information credible.  Plus I'm not sure how to make sure the advertisements stay placed correctly as people edit the content.  Overall though, it's an attractive idea.  I'm sure many people who read my articles have something they could add, even if it's just fixing spelling mistakes.

Mediawiki powers Wikipedia.  It is good software, but might be overpowered for Radified.

I've also used TWiki before.  It worked ok.  Perl-based, which I know you are a fan of.

It's also popular to use Drupal as a wiki, but I don't have much experience with it.


Title: Re: Wiki?
Post by Rad on Oct 7th, 2009 at 1:47am
so many choices.


DokuWiki[1] was created by Andreas Gohr in June 2004. In July the first official release was published on Freshmeat [2]. A big step in the development was the re-design of the parser and the renderer in January 2005. The new design was a big performance improvement and made DokuWiki usable for bigger documentation projects. It also prepared DokuWiki for an introduction of a generic plugin interface which simplified the development and maintenance of add-ons. A push of the level of awareness was the introduction of DokuWiki in the Linux distributions Debian in April and Gentoo Linux in July 2005. It is currently one of the most popular wiki engines in use.

Title: Re: Wiki?
Post by Rad on Oct 7th, 2009 at 11:28am
From Nigel.

Your recollection is correct, I did indeed recommend DokuWiki, for several reasons. As you recalled, I commend the quality of the PHP code itself as worthy of study.

Another primary quality of Doku is that the underlying backing storage is plain text files in the host webserver, which you can copy and move around to easily backup or replicate your wiki instances; other Wiki software (most notably MediaWiki) tends to use a database behind the scenes, which complicates things immensely.

[ I set up a Doku installation internal to the Symantec Auckland site for our internal needs in about 2004, and spent a lot of time expanding and improving it, and it has served us well. ]

Yes, there are Wiki standards, of sorts. These are really more along the lines of consensus about things like how to refer between Wikis, but there is one very important effort which deserves special note. Ward Cunningham, creator of the original Wiki concept and software, put quite some time and effort into trying to get folks to agree on a common syntax for Wikis since there had been an explosion of violently incompatible syntaxes expanding on his original design.

The result is at http://www.wikicreole.org/ - as with the syntax design of DokuWiki, that consensus syntax is heavily influenced by, but slightly different to, John Gruber's syntax for web publishing, Markdown - http://daringfireball.net/projects/markdown/ (another piece of code that's worth your time to study & understand).

Although Doku isn't the same as Creole, it's close, and Doku's extra features over and above Creole are pretty powerful.

One other Wiki of practical note is Trac - see http://trac.edgewall.org/ - not because it's a Wiki as much as it integrates one with a front end to Subversion along with a simple bug-tracking tool.

I wouldn't recommend you install or use Trac, but it's good to be aware of it since that particular package of source control + wiki + bug tracking is something that you will want to get used to if you're interested at all in writing code. Trac isn't anything particularly special compared to hosted environments like Google Code - http://code.google.com - but it's installable privately and plenty of people use it instead of hosted services.

- Nigel

Radified Community Forums » Powered by YaBB 2.4!
YaBB © 2000-2009. All Rights Reserved.