diff options
author | Gustav Eek <gustav.eek@proceranetworks.com> | 2014-10-21 20:53:29 +0200 |
---|---|---|
committer | Gustav Eek <gustav.eek@proceranetworks.com> | 2014-10-21 20:53:29 +0200 |
commit | 30c17f4ae41265c5431c6b692e3e72963d2bbc77 (patch) | |
tree | 4860ea8efefeb67facfa8449feb7a9e2b1c3a3af /wiki-preview.mdwn | |
parent | ba87395ff11e63c1ede0a2c9af885eb50f7745d7 (diff) |
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.
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' + |