summaryrefslogtreecommitdiffstats
path: root/wiki-preview.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'wiki-preview.mdwn')
-rw-r--r--wiki-preview.mdwn45
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'
+