summaryrefslogtreecommitdiffstats
path: root/create-a-wiki/development.mdwn
blob: 21149ddfa909e54ed433ffba29c7d7c1f3fe3feb (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
---
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.** Pandoc has recent releases of deb-packages. Follow
instructions
on [Installing pandoc](https://pandoc.org/installing.html). In
summary,
identify
[latest release](https://github.com/jgm/pandoc/releases/latest),
scroll down to find link to package. Download and install:

```
URL=https://github.com/jgm/pandoc/releases/download/2.7.3/pandoc-2.7.3-1-amd64.deb

DEST=/opt/deb
DEB=$DEST/${URL##*/}
sudo true
sudo mkdir -p
sudo wget -P "$DEST" "$URL"
sudo dpkg -i $DEB
```