Kwiki(3)

📦
version 0.39 · 2 versions
, in fedora 43

👑 Kwiki(3) — the manual page bestie 💖

okay so this is Kwiki(3), and it lives in the User Contributed Perl Documentation section of your friendly neighbourhood man pages. it's a whole thing. buckle up 🎀

✨ NAME ✨

Kwiki — The Kwiki Wiki Building Framework 💅

🛑 KWIKI 2.0 🛑

okay bestie, STOP. do NOT install this CPAN module. read this section first and you'll get why, fr fr. 😭

Kwiki-0.38 and the huge pile of Kwiki CPAN modules have been sitting pretty stable on CPAN for the last couple years. but here's the tea: stable also means undeveloped. it's giving museum exhibit. 🫠

in December 2006 the Kwiki community woke up and started actively developing Kwiki again. they call the revitalized project Kwiki 2.0. and no, that's not a version number (at least not yet), it's a code name for the whole effort. ✨

some goals of Kwiki 2.0:

  • Make Kwiki easier to install and maintain
  • Make Kwiki fast
  • Make Kwiki plugins easier to develop
  • Make Kwiki more fun

and they've made a lot of headway on these goals and on other goals too. 💖

Kwiki is really simple to install now. All the Perl dependencies come with Kwiki, and are preinstalled. so literally all you need is Perl 5.8.3 and a web server. and actually they give you a web server too!! 🎀

NOTE: Preinstalled means the modules are all linked into a lib tree that is separate from your installed Perl modules. this is good for several reasons and they are all slay:
  1. Installing modules takes a lot of time.
  2. Kwiki is guaranteed to have module versions that work.
  3. Kwiki doesn't change anything about your system's Perl lib.
  4. You can delete all the modules by just deleting the Kwiki checkout.
  5. Upgrading Kwiki is simple as svn update!
  6. You can install Kwiki without root permissions.

also Kwiki is now smoking fast if you use Kwiki::FastCGI. there are also some new caching modules that make Kwiki even faster still. 🔥

here's the important part: all the new stuff is not yet on CPAN. if you want to install Kwiki, get it from the subversion repository (highly recommended) or from tarball downloads.

you will be amazed at how simple and fast it is to install the new Kwiki, which comes with nearly 500 Perl modules. the longest part is literally just checking out the repository. see <http://www.kwiki.org/?InstallingKwiki2> for the details. 💜

eventually all this work will make it back to CPAN, but likely not for a while. 🕰️

here's a list of references for more info, iykyk:

finally, there are generally a good amount of helpful people on IRC. please drop by sometime!! 🫶

cheers, Ingy 🎀

here's the old Kwiki.pm doc. it might be a little out of date... 💀

✨ SYNOPSIS ✨

> kwiki -new cgi-bin/my-kwiki

Kwiki software installed! Point your browser at this location.

📌 NOTE 📌

if you're impatient (don't worry, that's a good thing!!) go read Kwiki::Command to get the details on how to install and configure a new Kwiki wiki in record time. ⚡

🌸 DESCRIPTION 🌸

a Wiki is a website that lets its users add pages, and edit any existing pages. it's one of the most popular forms of web collaboration, no cap. if you're new to wiki, go visit http://c2.com/cgi/wiki?WelcomeVisitors — which is possibly the oldest wiki, and has lots of info about how wikis work. 🦋

Kwiki is a Perl wiki implementation based on the Spoon application architecture and using the Spiffy object orientation model. the major goals of Kwiki are that it be easy to install, maintain and extend. 💅

all the features of a Kwiki wiki come from plugin modules. the base installation comes with the bare minimum plugins to make a working Kwiki. to make a really nice Kwiki installation you need to install additional plugins. which plugins you pick is entirely up to you. another goal of Kwiki is that every installation will be unique. when there are hundreds of plugins available, this will hopefully be the case. 👑

🧚 CGI::Kwiki 🧚

Kwiki is the successor of the popular CGI::Kwiki software. it's a complete refactoring of that code. the new code has a lovely plugin API and is much cleaner and extendable on all fronts. ✨

there is currently no automated way to upgrade a CGI::Kwiki installation to Kwiki. it's actually quite easy to do by hand though. instructions on how to do it are here: http://www.kwiki.org/?KwikiMigrationByHand 🛠️

📚 DOCUMENTATION 📚

all of the future Kwiki module documentation is being written at the http://doc.kwiki.org/ wiki. check there for the latest doc, and help improve it. each successive release of Kwiki will include the latest doc from that site. 💖

💜 CREDITS 💜

i am currently employed by Socialtext, Inc. they make high quality social software for enterprise deployment. Socialtext has a bold new vision of building their products over Open Source software and returning the generic source code to the community. this results in a win/win effect for both entities. you get this shiny new wiki framework, and Socialtext can take advantage of your plugins and bug fixes. 🎀

the Kwiki project would not be where it is now without their support. i thank them. 🫶

of particular note, Dave Rolsky and Chris Dent are two current Socialtext employees that have made significant contributions to Kwiki.

Iain Truskett was probably the most active Kwiki community hacker before his untimely death in December 2003. the underlying foundation of Kwiki has been named "Spoon" in his honor. rest in peace Spoon. 🕊️

Ian (what's with all these Iai?ns??) Langworth has become a new Kwiki warrior. he helped a lot with the maiden release. expect a lot of plugins to come from him! thanks Ian. 🔥

finally, big props to all the folks on http://www.kwiki.org and irc://irc.freenode.net/#kwiki. thanks for all the support!! 💖

👀 SEE ALSO 👀

Kwiki::Command

✍️ AUTHOR ✍️

Ingy döt Net <ingy@cpan.org>

Copyright (c) 2004. Brian Ingerson. All rights reserved. Copyright (c) 2007. Ingy döt Net. All rights reserved.

this program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 💅

see http://www.perl.com/perl/misc/Artistic.html

💀 POD ERRORS 💀

hey! the above document had some coding errors, which are explained below:

Around line 188:

Non-ASCII character seen before =encoding in 'döt'. Assuming UTF-8

and that's the whole page bestie!! this was generated by perl v5.42.0 on 2025-07-25 for Kwiki(3). mwah, love u, go build a wiki 💅✨🎀

📦 where this page comes from