diff options
| -rw-r--r-- | create-a-wiki-preview.mdwn | 101 |
1 files changed, 101 insertions, 0 deletions
diff --git a/create-a-wiki-preview.mdwn b/create-a-wiki-preview.mdwn new file mode 100644 index 0000000..61d42b4 --- /dev/null +++ b/create-a-wiki-preview.mdwn @@ -0,0 +1,101 @@ +--- +title: Create a wiki preview +... + +This article describes how to set up preview of Friposts wiki. + +**Table of contents** + +[[!toc]] + +The basic idea is something like the following: + + Bare Git Repository + git.fripost.org:fripost-wiki.git + | + | + Repository for Local Edits + ~/git/fripost/wiki + | + | + The Preview Ikiwiki Web Part + ~/public_html/fripost-wiki + +Where *~/git/fripost/wiki* is a local git repository with remote +tracking of the main bare wiki repository +*git.fripost.org:fripost-wiki.git*. I define an alias command for +recompilation of the local version of the. The local preview version +will reside in *~/public_html/fripost-wiki*. Eventually it +will be accessed by pointing the browser to +*http\://fripost.localhost* and *http://wiki.fripost.localhost* +respectively. + +Process overview: + +* Install and configure Git +* Install and configure Apache 2 +* Install Ikiwiki + +Install and configure Git +========================= + +Refer to [Git och Fripost](git_och_fripost) for installation +instructions. + +You will need the following repositories: + + * https://git.fripost.org/fripost-ansible + * https://git.fripost.org/fripost-wiki + +Clone with ssh if you want to edit, which will require you to provide +a public key to Fripost administrators. Below snippets assume: + + $ git clone https://git.fripost.org/fripost-ansible ~/git/fripost/ansible + $ git clone https://git.fripost.org/fripost-wiki ~/git/fripost/wiki + +Install and configure Ikiwiki and Pandoc +======================================== + +Refer to [ikiwiki setup](https://ikiwiki.info/setup/) at +[ikiwiki's official website](https://ikiwiki.info) for initial +install and configuration and +[an article on Git](https://ikiwiki.info/rcs/git/) for more details on +setting up Ikiwiki together with Git. + +Install packages referred to in the ansible configuration: + + sudo aptitude install \ + ikiwiki \ + libauthen-passphrase-perl \ + highlight-common libhighlight-perl libimage-magick-perl \ + libmail-sendmail-perl libnet-dns-sec-perl \ + fcgiwrap spawn-fcgi \ + pandoc + +Copy Ikiwiki configuration from Fripost ansible repository: + + mkdir -p ~/public_html/fripost-wiki ~/.ikiwiki + cp -r ~/git/fripost/ansible/roles/wiki/files/var/lib/ikiwiki/* ~/.ikiwiki + +Modify the configuration *~/.ikiwkik/fripost-wiki.setup* according to: + +``` +adminemail: <your mail> +adminuser: + - <your user> +srcdir: <your home>/git/fripost/wiki/ +destdir: <your home>/public_html/fripost-wiki +url: http://fripost.localhost/ # http://wiki.fripost.localhost/ +cgiurl: http://fripost.localhost/ikiwiki.cgi +cgi_wrapper: <your home>/public_html/fripost-wiki/ikiwiki.cgi +sslcookie: 0 +libdir: <your home>/.ikiwiki +# git_wrapper: /home/gustav/fripost/wiki/.git/hooks/post-update +#historyurl: +#diffurl: +gitorigin_branch: '' +``` + +*TODO investegate what to do with post update thing.* + + $ ikiwiki --setup ~/.ikiwkik/fripost-wiki.setup |