# Creating and editing a website

## Ikiwiki

Ikiwiki is web development tool,
creating static content from markdown source.

Content is maintained
either by use of a git clone,
or via a web interface.

Styling is maintained
by use of a git clone,


### Minimal

Quick bootstrap and test build,
without git support for maintenance:

	git clone git://source.jones.dk/ikiwiki
	cd ikiwiki
	make init
	make

Result is then below build/ .

### Setup

Fork base Ikiwiki framework,
and pick a branch:

  * master: closest to Debian-released Ikiwiki
  * master-da: danish locale
  * plaintext: templates adapted for plaintext plugin
  * plaintext-da: plaintext adaptation + danish locale

	git clone --origin ikiwiki git://source.jones.dk/ikiwiki example
	cd example
	git reset --hard ikiwiki/plaintitle-da

Create separately tracked content and styling
(or fork from existing projects, similar to above):

	git init content
	git init styling

Initialize setup file and environment:

	make init

Adapt and extend setup skeleton file based on generated setup files,
and re-initialize
(changes directly to setup file are *not* preserved):

	$EDITOR config/ikiwiki.setup.in
	git commit -m "My changes." config/ikiwiki.setup.in
	rm config/ikiwiki.setup
	make init

(Publish)[src#publish] each git,
using subdirs (e.g. example example/content example/styling).

Make an initial full build:

	make -B


### Build

Gentle refresh:

	make

Forced full (re)build:

	make -B

In both cases,
result is then below build/ .


## Publish

Clone web account,
bootstrap,
and register to account the use of ikiwiki:

	ssh [[!template id=webuser]]@[[!template id=webhost]]
	git clone /srv/git/[[!template id=githost]]/example ~/private_webdata/example
	cd ~/private_webdata/example
	git clone /srv/git/[[!template id=githost]]/example/content
	git clone /srv/git/[[!template id=githost]]/example/styling
	mkdir build
	mkdir --parents ~/public_websites/www.example.org
	mkdir --parents ~/public_cgi/example
	ln --symbolic --relative -T ~/public_websites/www.example.org build/html
	ln --symbolic --relative -T ~/public_cgi/example build/cgi
	make init
	make -B
	mkdir -p ~/.ikiwiki
	echo [[!template id=webuser]] $PWD/config/ikiwiki.setup >> ~/.ikiwiki/wikilist
	logout

Tell your hostmaster to enable publishing of your website,
and to register centrally your use of ikiwiki.