Ikiwiki: Difference between revisions
| Line 1: | Line 1: | ||
== | == about == | ||
Ikiwiki is a very lightweight wiki engine, that generates static html from markdown files through a git repository. | 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! | It is a very cool project with terrible documentation, so let's compile what we know and learn in this page! | ||
== | == installation on Debian == | ||
<blockquote>'''NOTE:''' | <blockquote>'''NOTE:''' | ||
| Line 13: | Line 13: | ||
make sure you also have <code>librpc-xml-perl</code> and <code>python-docutils</code> | make sure you also have <code>librpc-xml-perl</code> and <code>python-docutils</code> | ||
=== | === setup <ref>https://ikiwiki.info/setup/#index1h2</ref> === | ||
You run the following command: | You run the following command: | ||
<code>ikiwiki --setup /etc/ikiwiki/auto.setup</code> | <code>ikiwiki --setup /etc/ikiwiki/auto.setup</code> | ||
| Line 36: | Line 36: | ||
<big>and your <code>$destdir</code> is <code>/home/'''<u>$USER</u>'''/public_html/'''<u>$WIKI</u>'''</code></big> | <big>and your <code>$destdir</code> is <code>/home/'''<u>$USER</u>'''/public_html/'''<u>$WIKI</u>'''</code></big> | ||
== | == publishing your ikiwiki with nginx == | ||
heh | heh | ||
| Line 42: | Line 42: | ||
heh | heh | ||
== | == hosting on a phone server == | ||
Claudio pls add here <3 | Claudio pls add here <3 | ||
== | == editing the wiki == | ||
=== customizing CSS === | === customizing CSS === | ||
| Line 52: | Line 52: | ||
that way you can fully customize your wiki! | that way you can fully customize your wiki! | ||
== | == markdown syntax == | ||
== | == projects built on ikiwiki == | ||
* [https://damaged.bleu255.com/ Damaged Earth Catalogue] | * [https://damaged.bleu255.com/ Damaged Earth Catalogue] | ||
Revision as of 18:53, 30 April 2026
about
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!
installation on Debian
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
setup [1]
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
Variables
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
publishing your ikiwiki with nginx
heh
Ikiwiki on a subdomain
heh
hosting on a phone server
Claudio pls add here <3
editing the wiki
customizing CSS
add local.css in the git folder /home/$USER/$WIKI/
that way you can fully customize your wiki!