From 30c17f4ae41265c5431c6b692e3e72963d2bbc77 Mon Sep 17 00:00:00 2001 From: Gustav Eek Date: Tue, 21 Oct 2014 20:53:29 +0200 Subject: Pages on wiki preview added There are two pages added that describes (1) how to set up an ikiwiki lab environment, and (2) how to create a preview version of the Fripost wiki. Naturally the content is related. Things to complement with - Charts drawn in some nice fashion - Explain how templates and styles are applied The index page is changed to reflect the above. --- wiki-preview.mdwn | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 wiki-preview.mdwn (limited to 'wiki-preview.mdwn') diff --git a/wiki-preview.mdwn b/wiki-preview.mdwn new file mode 100644 index 0000000..05757c7 --- /dev/null +++ b/wiki-preview.mdwn @@ -0,0 +1,45 @@ +Taking the [[Create a Wiki|create-a-wiki]] article as a starting point, this article describes how to set up preview of Friposts wiki. + +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-preview + +Where *~/git/fripost/wiki* is a local git repository with remote tracking of the main bare wiki repository *git.fripost.org:fripost-wiki.git*. A command will cause a local compiled version to be created, that is accessed by pointing the browser to *http\://localhost/~/fripost-wiki-preview/*. + +First the basics. According to [[Create a Wiki|create-a-wiki]] do the following: + +* Install and configure Git +* Install and configure Apache 2 +* Install Ikiwiki + +For the Ikiwiki configuration question, answer them as follows + + wikiname: fripost-wiki-preview + url: http://localhost/~/lab-wiki + srcdir: ~/git/fripost/wiki + destdir: ~/public_html/fripost-wiki-preview + settings: ~/public_html/fripost-wiki-preview/wiki.setup + +Where ** is the local user name and *~/git/fripost/wiki* is where the local wiki Git repository. This will generate a configuration file: *~/public_html/fripost-wiki-preview/wiki.setup*. Generate the first issue: + + $ ikiwiki --setup ~/public_html/fripost-wiki-preview/wiki.setup + +For to preview local edits, run: + + $ ikiwiki --setup ~/public_html/fripost-wiki-preview/wiki.setup --refresh + +and point your browser to *http\://localhost/~/fripost-wiki-preview/*. + +You can also create an alias for to refresh the preview command. + + $ alias fripost-wiki-preview-refresh='ikiwiki -setup /home/gustav/lab-wiki/fripost-wiki.setup -refresh' + -- cgit v1.2.1