From af9fc961b42807aa747060eaa2d97f3a78f67789 Mon Sep 17 00:00:00 2001
From: Gustav Eek <gustav.eek@fripost.org>
Date: Sun, 6 Oct 2019 01:54:59 +0200
Subject: Provide inital on instructions for development setup

---
 create-a-wiki/development.mdwn | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 create-a-wiki/development.mdwn

(limited to 'create-a-wiki')

diff --git a/create-a-wiki/development.mdwn b/create-a-wiki/development.mdwn
new file mode 100644
index 0000000..60c5f74
--- /dev/null
+++ b/create-a-wiki/development.mdwn
@@ -0,0 +1,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.*
+
-- 
cgit v1.2.3