Ikiwiki - Revision history

Eleni at 16:15, 17 June 2026

2026-06-17T16:15:21Z

← Older revision		Revision as of 18:15, 17 June 2026
Line 1:		Line 1:
			[[File:Ikiwikimeme.jpg\|thumb\|made by [[User:Barbs\|Barbs]]]]

	== About ==		== About ==
	Ikiwiki is a very lightweight wiki compiler that generates static html from markdown files through a git repository.		Ikiwiki is a very lightweight wiki compiler that generates static html from markdown files through a git repository.
Line 23:		Line 25:
	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:
	You can later change these settings in <code>/home/'''<u>$USER</u>'''/'''<u>$WIKI</u>'''.setup</code>[[File:Ikiwiki edit flow.jpg\|thumb\|ikiwiki edit flow]]		You can later change these settings in <code>/home/'''<u>$USER</u>'''/'''<u>$WIKI</u>'''.setup</code>

			[[File:Ikiwikiiii.jpg\|center\|frameless\|484x484px]]
			[[File:Ikiwiki edit flow.jpg\|thumb\|ikiwiki edit flow]]

	=== Variables ===		=== Variables ===
			[[File:Ikiwikiiii.jpg\|right\|frameless]]
	Two important variables in the ikiwiki universe are <code>$srcdir</code>, the source directory, and <code>$destdir</code>, the destination directory.		Two important variables in the ikiwiki universe are <code>$srcdir</code>, the source directory, and <code>$destdir</code>, the destination directory.

2026-05-31T21:20:29Z

Installing on Debian

← Older revision		Revision as of 23:20, 31 May 2026
Line 11:		Line 11:
	where '''<u>$USER</u>''' put the name of the local user</blockquote>		where '''<u>$USER</u>''' put the name of the local user</blockquote>
	sudo apt install ikiwiki		sudo apt install ikiwiki
	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>python3-docutils</code>

	=== Setup <ref>https://ikiwiki.info/setup/#index1h2</ref> ===		=== Setup <ref>https://ikiwiki.info/setup/#index1h2</ref> ===

2026-05-31T20:52:08Z

← Older revision		Revision as of 22:52, 31 May 2026
Line 181:		Line 181:
	* [https://eleni.fanon.radio/ Eleni's personal website hehe]		* [https://eleni.fanon.radio/ Eleni's personal website hehe]
	* [https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/ the Everything magazine archive]		* [https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/ the Everything magazine archive]
			* [https://www.cs.unb.ca/~bremner/ David Bremner' personal website (UNB professor)]
			* [https://gitlab.com/spi-inc/website Software in the Public Interest]

	== Links to sort ==		== Links to sort ==

2026-05-30T23:08:49Z

← Older revision		Revision as of 01:08, 31 May 2026
Line 135:		Line 135:

	'''Q:'''Did you define which template to use in your setup file or did you put ''<nowiki>[[plugins/pagetemplatename]]</nowiki>'' in every file you made and then rendered it??		'''Q:'''Did you define which template to use in your setup file or did you put ''<nowiki>[[plugins/pagetemplatename]]</nowiki>'' in every file you made and then rendered it??

			=== Emojis ===
			Because interepreting ikiwiki's official documentation can give you a headache, you can rest your mind by filling your pages with emojis.

			https://ikiwiki.info/smileys/

			Simply typing the text that is associated with an emoji illustrated at this link, will make it spawn on your page(s) once refreshed

			examples:
			<pre>
			/!\
			{OK}
			</pre>

	=== Customizing the header ===		=== Customizing the header ===

2026-05-30T22:43:36Z

← Older revision		Revision as of 00:43, 31 May 2026
Line 154:		Line 154:
	</syntaxhighlight>		</syntaxhighlight>

			== Plugins ==
			Some features of ikiwiki are not enabled by default.
			The documentation mentions that to enable a plugin you can edit your <code>$WIKI.setup</code> file, but there is a command that allows you to activate a plugin without editing the .setup file by hand:
			<pre>
			ikiwiki --changesetup $WIKI.setup --plugin calendar
			</pre>
			Next you should refresh or rebuild you wiki using the updated setup to see any changes.
	== Projects built on ikiwiki ==		== Projects built on ikiwiki ==

2026-05-30T17:05:25Z

← Older revision		Revision as of 19:05, 30 May 2026
Line 93:		Line 93:
	mkdir templates/		mkdir templates/
	</pre>and add a template there. '''For example,''' if you want a template for '''all pages''', copy <code>/usr/share/ikiwiki/templates/page.tmpl</code> in <code>/home/'''<u>$USER</u>'''/'''<u>$WIKI</u>'''/templates</code> and edit to your liking!!		</pre>and add a template there. '''For example,''' if you want a template for '''all pages''', copy <code>/usr/share/ikiwiki/templates/page.tmpl</code> in <code>/home/'''<u>$USER</u>'''/'''<u>$WIKI</u>'''/templates</code> and edit to your liking!!

			To render a new template in your wiki, you run <code>--rebuild</code> instead of <code>--refresh</code>

	==== Using custom templates ====		==== Using custom templates ====

2026-05-30T14:24:27Z

← Older revision		Revision as of 16:24, 30 May 2026
Line 87:		Line 87:
	to create nested linked pages, you can make directories in the <code>$srcdir</code>		to create nested linked pages, you can make directories in the <code>$srcdir</code>

	=== Using templates ===		=== Templates ===

			==== Using global templates ====
			Tou use the default ikiwiki templates found in <code>/usr/share/ikiwiki/templates</code> , you need to create a template folder in <code>/home/'''<u>$USER</u>'''/'''<u>$WIKI</u>'''/</code> <pre>
			mkdir templates/
			</pre>and add a template there. '''For example,''' if you want a template for '''all pages''', copy <code>/usr/share/ikiwiki/templates/page.tmpl</code> in <code>/home/'''<u>$USER</u>'''/'''<u>$WIKI</u>'''/templates</code> and edit to your liking!!

			==== Using custom templates ====
	When you make your first <code>index.mdwn</code> in your '''srcdir''', you can then run		When you make your first <code>index.mdwn</code> in your '''srcdir''', you can then run
	<pre>		<pre>

2026-05-27T10:22:38Z

← Older revision		Revision as of 12:22, 27 May 2026
Line 152:		Line 152:
	* [https://eleni.fanon.radio/ Eleni's personal website hehe]		* [https://eleni.fanon.radio/ Eleni's personal website hehe]
	* [https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/ the Everything magazine archive]		* [https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/ the Everything magazine archive]

			== Links to sort ==

			* [https://www.wikimatrix.org/show/ikiwiki#tabs A table of ikiwiki features]
			* [https://permacomputing.net/installing/ pmc installation guide]

	== References ==		== References ==

2026-05-27T10:14:06Z

Projects built on ikiwiki

← Older revision		Revision as of 12:14, 27 May 2026
Line 150:		Line 150:
	* [https://permacomputing.net/ Permacomputing]		* [https://permacomputing.net/ Permacomputing]
	* [https://wiki.fanon.radio/ Fanon Radio Wiki]		* [https://wiki.fanon.radio/ Fanon Radio Wiki]
	* [https://eleni.fanon.radio/ Eleni's personal website hehe]		* [https://eleni.fanon.radio/ Eleni's personal website hehe]
			* [https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/ the Everything magazine archive]

	== References ==		== References ==

2026-05-19T13:18:00Z

Using templates

← Older revision		Revision as of 15:18, 19 May 2026
Line 125:		Line 125:
	'''Question for Marloes >:)'''		'''Question for Marloes >:)'''

	'''Q:'''Did you define which template to use in your setup file or did you put ''<nowiki>[[plugins/pagetemplatename]]</nowiki>'' in every file you made??		'''Q:'''Did you define which template to use in your setup file or did you put ''<nowiki>[[plugins/pagetemplatename]]</nowiki>'' in every file you made and then rendered it??

	=== Customizing the header ===		=== Customizing the header ===