Ikiwiki: Difference between revisions

From XPUB & Lens-Based wiki
No edit summary
Line 1: Line 1:
== About ==
== About ==
[[File:Ikiwiki edit flow.jpg|thumb|ikiwiki edit flow]]
what is ikiwiki?
what is ikiwiki?


Line 21: Line 20:
  What wiki user (or openid) will be admin? <u>'''$USER'''</u>
  What wiki user (or openid) will be admin? <u>'''$USER'''</u>
  Choose a password:
  Choose a password:
once you fill them in, you're almost set!
[[File:Ikiwiki edit flow.jpg|thumb|ikiwiki edit flow]]
 
=== Variables ===
Two important variables in the ikiwiki universe are <code>$srcdir</code>, the source directory, and <code>$destdir</code>, the destination directory.
 
<big>by default, your <code>$srcdir</code> is <code>/home/'''<u>$USER</u>'''/'''<u>$WIKI</u>'''/</code></big>
 
<big>and your <code>$destdir</code> is <code>/home/'''<u>$USER</u>'''/public_html/'''<u>$WIKI</u>'''</code></big>


== Editing the wiki ==
== Editing the wiki ==

Revision as of 18:38, 30 April 2026

About

what is ikiwiki?

Installation

NOTE:

where $WIKI put the name of your wiki

where $USER put the name of the local user

sudo apt install ikiwiki

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:
ikiwiki edit flow

Variables

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

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

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

Editing the wiki

customizing CSS

add local.css in the git folder /home/USER/IKIWIKI/

use this as your ikiwikis css file

Making your ikiwiki public with nginx

Markdown syntax

Projects running ikiwiki

References