summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGustav Eek <gustav@fripost.org>2015-04-24 21:58:19 +0200
committerGustav Eek <gustav@fripost.org>2015-04-24 22:03:14 +0200
commit4bdcc9c1d9e22958d0ee208280f8099204941f20 (patch)
treeeb69d4bfffdb4bec35ae35dc556e54e6366039ce
parent21bf78ac7720167b895164af494d4317a199789f (diff)
Wiki-preview discriptions completed with some notes
The descritpion on how to set up a wiki preview is completed with how to handle the need for to test absolute links through update the */etc/hosts* file.
-rw-r--r--create-a-wiki.mdwn2
-rw-r--r--wiki-preview.mdwn35
2 files changed, 35 insertions, 2 deletions
diff --git a/create-a-wiki.mdwn b/create-a-wiki.mdwn
index 14fb760..f47a881 100644
--- a/create-a-wiki.mdwn
+++ b/create-a-wiki.mdwn
@@ -7,7 +7,7 @@ with git.
The components needed are
* Ikiwiki
-* Apache2 web server
+* Apache2 or Nginx web server
* Git
**Table of Contents**
diff --git a/wiki-preview.mdwn b/wiki-preview.mdwn
index 05757c7..6334217 100644
--- a/wiki-preview.mdwn
+++ b/wiki-preview.mdwn
@@ -13,7 +13,12 @@ The basic idea is something like the following:
. 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/*.
+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 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:
@@ -43,3 +48,31 @@ 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'
+Many links on the Fripost wiki are absolute. That means that you
+sometimes will not be able to follow homepage page and wiki page links
+between your local preview wiki. For testing purposes, that can
+sometimes be necessary. The best strategy is to edit your */etc/hosts*
+table and make *fripost.org* and *wiki.fripost.org* point to
+*localhost*. Of course your web server need to be configured to serve
+those pages. This is my Nginx configuration:
+
+ # fripost.org
+ server {
+ server_name fripost.org;
+ location / {
+ root /home/gustav/public_html/fripost-wiki/website;
+ location /static { root /home/gustav/public_html/fripost-wiki; }
+ }
+ }
+
+ # wiki.fripost.org
+ server {
+ server_name wiki.fripost.org;
+ location / {
+ root /home/gustav/public_html/fripost-wiki;
+ }
+ }
+
+You might experience strange effects from that the web-browser has
+cached DNS information. Search Internet for how to flush your
+browser's DNS cache.