# Ikiwiki system configuration

This website is powered by Ikiwiki. But instead of the normal Ikiwiki setup,
each edit results in 2 parallel websites being built - one served purely static
and one password-protected serving the static pages + CGI to edit them.

Here's a graph of the interaction between the various parts of ikiwiki itself
and different kinds of users:

[[graph src="""
{
//	rankdir=LR
//	rotate=90
	center=1

	subgraph cluster_user {
		label="Any user"
		style=dashed
		browser_user
	}
	subgraph cluster_author {
		label="Author"
		style=dashed
		browser_author
	}
	subgraph cluster_designer {
		label="Web designer"
		style=dashed
		browser_designer
		vcs_tmpl_local
		vcs_txt_local
		fs_local
	}

	search_query [shape=plaintext, label="Search query"]
	txt [shape=plaintext, label="Markdown text"]
	media [shape=plaintext, label="Graphics"]
	tmpl [shape=plaintext, label="Html templates"]

	browser_user [label="Web browser"]
	browser_author [label="Web browser"]
	browser_designer [label="Web browser"]
	vcs_txt_local [shape=egg, label="Git repository"]
	vcs_tmpl_local [shape=egg, label="Git repository"]
	fs_local [shape=egg, label="Filesystem"]

	txt_form [shape=box, label="Web text editor (Ikiwiki)"]
	search_form [shape=box, label="Search form (Ikiwiki)"]
	search_db [shape=egg, label="Search index (Hyper Estraier)"]
	vcs_txt [shape=egg, label="VCS repository (Git)"]
	vcs_tmpl [shape=egg, label="VCS repository (Git)"]
	fs [shape=egg, label="Filesystem"]
	iki_engine [shape=box, label="Html renderer (Ikiwiki)"]
	search_engine [shape=box, label="Search engine (Hyper Estraier)"]
	webpages [label="Plain web pages"]
	webpages_admin [label="Wiki pages"]
	webpages_searchresult [label="Search results", style=dotted]

	browser_user -> search_form -> search_query -> search_engine -> webpages_searchresult
	search_db -> search_engine [weight=0]
	search_db -> iki_engine [dir=back]

	browser_author -> txt_form -> vcs_txt -> txt -> iki_engine -> webpages
	iki_engine -> webpages_admin

	browser_designer -> txt_form

	vcs_txt_local -> vcs_txt [dir=both]

	vcs_tmpl_local -> vcs_tmpl [dir=both]
	vcs_tmpl -> tmpl -> iki_engine

	fs_local -> fs [dir=both]
	fs -> media -> iki_engine

	{rank=same; search_db vcs_txt vcs_tmpl fs}
	{rank=same; search_query txt media tmpl}
	{rank=same; txt_form search_form}
	{rank=same; webpages webpages_admin webpages_searchresult}
}
"""]]