summaryrefslogtreecommitdiffstats
path: root/create-a-wiki/development.mdwn
blob: 60c5f7498a2b0246bcee0da7343859b3783081b3 (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
---
title: Adoptions for taking part of function development
...

Here follows again configuration and upgrades for those that take part
in development of Fripost's wiki; that is the actual wiki, not the
contents.

What is development of actual wiki? That can of course be many, but
some examples contains:

 * Templates that are part of site generations
 * Styles, CSS, etc. that will change the look
 * Plugins that extract data from the original text content, e.g. the
   Pandoc plugin
 * User side JavaScript and other front end aspects that enriches the
   reading experience

The prerequisites for good development are (1)
a [local setup](/create-a-wiki-preview) of the wiki, (2) library
components (plugins) from the repository and (3) recent version of the
software components.

**Local wiki preview.** Follow instructions in the
article [Create a Fripost wiki preview](/create-a-wiki-preview).

**Libraries from the Fripost wiki repository.** Change the wiki
library path to point to directory *.ikiwiki* in the Git repository
(which happen to be `srcdir`):

```
setup="$HOME/.ikiwiki/fripost-wiki.setup"
srcdir=$(sed -n '/^srcdir:/ {s/.*: //; p}' "$setup")
sed "/^libdir:/ s|:.*$|: $srcdir/.ikiwiki|" -i "$setup"
```

**Upgrade Ikiwiki.** *TODO fill in how to do this.*

**Upgrade Pandoc.**  *TODO fill in how to do this.*