diff options
Diffstat (limited to 'wiki-preview.mdwn')
-rw-r--r-- | wiki-preview.mdwn | 45 |
1 files changed, 45 insertions, 0 deletions
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/~<name>/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/~<name>/lab-wiki + srcdir: ~/git/fripost/wiki + destdir: ~/public_html/fripost-wiki-preview + settings: ~/public_html/fripost-wiki-preview/wiki.setup + +Where *<name>* 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/~<name>/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' + |