blob: 61d42b4fb84fdbb03749f80935bf6e02dd39bf66 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
---
title: Create a wiki preview
...
This article describes how to set up preview of Friposts wiki.
**Table of contents**
[[!toc]]
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
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
will reside in *~/public_html/fripost-wiki*. Eventually it
will be accessed by pointing the browser to
*http\://fripost.localhost* and *http://wiki.fripost.localhost*
respectively.
Process overview:
* Install and configure Git
* Install and configure Apache 2
* Install Ikiwiki
Install and configure Git
=========================
Refer to [Git och Fripost](git_och_fripost) for installation
instructions.
You will need the following repositories:
* https://git.fripost.org/fripost-ansible
* https://git.fripost.org/fripost-wiki
Clone with ssh if you want to edit, which will require you to provide
a public key to Fripost administrators. Below snippets assume:
$ git clone https://git.fripost.org/fripost-ansible ~/git/fripost/ansible
$ git clone https://git.fripost.org/fripost-wiki ~/git/fripost/wiki
Install and configure Ikiwiki and Pandoc
========================================
Refer to [ikiwiki setup](https://ikiwiki.info/setup/) at
[ikiwiki's official website](https://ikiwiki.info) for initial
install and configuration and
[an article on Git](https://ikiwiki.info/rcs/git/) for more details on
setting up Ikiwiki together with Git.
Install packages referred to in the ansible configuration:
sudo aptitude install \
ikiwiki \
libauthen-passphrase-perl \
highlight-common libhighlight-perl libimage-magick-perl \
libmail-sendmail-perl libnet-dns-sec-perl \
fcgiwrap spawn-fcgi \
pandoc
Copy Ikiwiki configuration from Fripost ansible repository:
mkdir -p ~/public_html/fripost-wiki ~/.ikiwiki
cp -r ~/git/fripost/ansible/roles/wiki/files/var/lib/ikiwiki/* ~/.ikiwiki
Modify the configuration *~/.ikiwkik/fripost-wiki.setup* according to:
```
adminemail: <your mail>
adminuser:
- <your user>
srcdir: <your home>/git/fripost/wiki/
destdir: <your home>/public_html/fripost-wiki
url: http://fripost.localhost/ # http://wiki.fripost.localhost/
cgiurl: http://fripost.localhost/ikiwiki.cgi
cgi_wrapper: <your home>/public_html/fripost-wiki/ikiwiki.cgi
sslcookie: 0
libdir: <your home>/.ikiwiki
# git_wrapper: /home/gustav/fripost/wiki/.git/hooks/post-update
#historyurl:
#diffurl:
gitorigin_branch: ''
```
*TODO investegate what to do with post update thing.*
$ ikiwiki --setup ~/.ikiwkik/fripost-wiki.setup
|
