Ikiwiki: Difference between revisions

Revision as of 18:53, 30 April 2026

Ikiwiki is a very lightweight wiki engine, that generates static html from markdown files through a git repository.

It is a very cool project with terrible documentation, so let's compile what we know and learn in this page!

NOTE:
where $WIKI put the name of your wiki
where $USER put the name of the local user

sudo apt install ikiwiki

make sure you also have librpc-xml-perl and python-docutils

You run the following command:

ikiwiki --setup /etc/ikiwiki/auto.setup

If you get this error:

/etc/ikiwiki/auto.setup: Only one Term::ReadLine::Gnu instance is allowed. at /usr/share/perl5/IkiWiki/Setup/Automator.pm line 17.

then add PERL_RL=Perl before ikiwiki ^[2]

you will then get a series of prompts:

What will the wiki be named? $WIKI
What revision control system to use? git
What wiki user (or openid) will be admin? $USER
Choose a password:

You can later change these settings in /home/$USER/$WIKI.setup

ikiwiki edit flow

Two important variables in the ikiwiki universe are $srcdir, the source directory, and $destdir, the destination directory.

You make changes in $srcdir only! Ikiwiki does the rest.

by default, your $srcdir is /home/$USER/$WIKI/

and your $destdir is /home/$USER/public_html/$WIKI

heh

heh

Claudio pls add here <3

add local.css in the git folder /home/$USER/$WIKI/

that way you can fully customize your wiki!

@@ Line 39: / Line 39: @@
 heh
-=== Ikiwiki under a subdomain ===
+=== Ikiwiki as a subdomain ===
 heh