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.  | 
