diff options
author | Gustav Eek <gustav.eek@fripost.org> | 2019-10-04 10:22:57 +0200 |
---|---|---|
committer | Gustav Eek <gustav.eek@fripost.org> | 2019-10-04 10:36:45 +0200 |
commit | 53bd927e5ea4286d90cbb4ccc6da694d586f0782 (patch) | |
tree | 3aa5d2dbf92dbd7b845887796dd1ea0b96f7de70 | |
parent | fc1b4261751d9ee6578a7119a41a70c5af5c0982 (diff) |
[create-a-wiki] Move old descriptions
Drop the guide *wiki-preview.mdwn*. The content is now fully covered
and updated in *create-a-wiki-preview.mdwn*
and *create-a-wiki/additional.mdwn*.
Also move the dated *create-a-wiki.mdwn*
-> *create-a-wiki/create-a-wiki.mdwn*. Closing that content needs more
attention.
-rw-r--r-- | create-a-wiki/create-a-wiki.mdwn (renamed from create-a-wiki.mdwn) | 0 | ||||
-rw-r--r-- | wiki-preview.mdwn | 99 |
2 files changed, 0 insertions, 99 deletions
diff --git a/create-a-wiki.mdwn b/create-a-wiki/create-a-wiki.mdwn index b6736f1..b6736f1 100644 --- a/create-a-wiki.mdwn +++ b/create-a-wiki/create-a-wiki.mdwn diff --git a/wiki-preview.mdwn b/wiki-preview.mdwn deleted file mode 100644 index 71cf7d1..0000000 --- a/wiki-preview.mdwn +++ /dev/null @@ -1,99 +0,0 @@ -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*. 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: - -* 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' - - -Public www locations (userdir) ------------------- - -For to be able to access `http://localhost/~user` the "userdir" -functionality is needed. For Nginx, put the following in e.g. -*/etc/nginx/sites-available/localhost*: - -``` -server { - location ~ ^/~(.+?)(/.*)?$ { - alias /home/$1/public_html$2; - index index.html index.htm - autoindex on; - } -} -``` - -Relative paths --------------- - -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. |