Doc fixes + some tags for testing

Add new LAYERS.org generator [WIP]

.ci/spacedoc-cfg.edn

@@ -0,0 +1,43 @@
+{:spacetools.spacedoc.config/layers-org-query
+ [{"lang" [
+           "pure" {"general" [
+                              "imperative"
+                              "multi-paradigm"
+                              ]
+                   }
+           ]
+   }
+  "markup"
+  ]
+ :spacetools.spacedoc.config/valid-tags
+ {"lang" "Programming languages"
+  "js" "JavaScript"
+  "dsl" "Domain-specific"
+  "e-mail" "E-mail"
+  "distribution" "Distributions"
+  "os" "Operating systems"
+  "chat" "Chats"
+  "misc" "Misc"
+  "framework" "Frameworks"
+  "markup" "Markup languages"
+  "tagging" "Tags"
+  "i18n" "internationalization"
+  "pairing" "Pair programming"
+  "web service" "Web services"
+  "versioning" "Source control"
+  "fun" "Fun"
+  "script" "Scripting"
+  "imperative" "Imperative"
+  "general" "General-purpose"
+  "pure" "Purely functional"
+  "emacs" "Emacs"
+  "vim" "Vim"
+  "completion" "Completion"
+  "tool" "Tools"
+  "extra" "Extra"
+  "lisp" "Lisp dialects"
+  "layer" "layers"
+  "theme" "Themes"
+  "multi-paradigm" "Multi-paradigm"
+  "checker" "Checkers"
+  }}

.circleci/validoc/validate

@@ -30,8 +30,7 @@ do
 done </tmp/changed_files
 
 if [ ${#changed_f_as_args[@]} -ne 0 ]; then
-
-    spacedoc validate /tmp/exported/
+    spacedoc validate -c"./.ci/spacedoc-cfg.edn" /tmp/exported/
     if [ $? -ne 0 ]; then
         echo "Documentation validation failed."
         exit 1

.travisci/pub_prep.sh

@@ -25,7 +25,9 @@ printf  "  StrictHostKeyChecking no\n" >> ~/.ssh/config
 printf  "  UserKnownHostsFile=/dev/null\n" >> ~/.ssh/config
 
 fold_start "FORMATTING_DOCUMENTATION"
-docker run --rm -v "${TRAVIS_BUILD_DIR}":/tmp/docs/ \
+docker run --rm \
+       -v "${TRAVIS_BUILD_DIR}/.ci/spacedoc-cfg.edn":/opt/spacetools/spacedoc-cfg.edn \
+       -v "${TRAVIS_BUILD_DIR}":/tmp/docs/ \
        jare/spacetools docfmt /tmp/docs/
 if [ $? -ne 0 ]; then
     echo "Formatting failed."

layers/+lang/asm/README.org

@@ -1,6 +1,6 @@
 #+TITLE: asm layer
 
-#+TAGS: layer|general|lang|imperative
+#+TAGS: general|imperative|lang|layer
 
 [[file:img/asm.png]]
 

layers/+lang/forth/README.org

@@ -1,6 +1,6 @@
 #+TITLE: Forth layer
 
-#+TAGS layer|general|imperative|lang
+#+TAGS: general|imperative|lang|layer
 
 * Table of Contents                     :TOC_4_gh:noexport:
 - [[#description][Description]]

layers/+tools/xclipboard/README.org

@@ -2,14 +2,18 @@
 
 * Table of Contents                     :TOC_4_gh:noexport:
 - [[#description][Description]]
-  - [[#requirements][Requirements]]
   - [[#features][Features:]]
+- [[#requirements][Requirements]]
 - [[#key-bindings][Key bindings]]
 
 * Description
 =xclipboard= integration layer.
 
-** Requirements
+** Features:
+- adds copy support to the X-clipboard from the terminal.
+- adds paste support to the X-clipboard from the terminal.
+
+* Requirements
 This layer depends on a few platform-specific command-line tools:
 - on OSX, this layer calls =pbcopy=
 - on Windows, this layer calls =clip.exe=
@@ -17,10 +21,6 @@ This layer depends on a few platform-specific command-line tools:
 
 Note that =xsel= might not be installed by default on e.g. Ubuntu systems.
 
-** Features:
-- adds copy support to the X-clipboard from the terminal.
-- adds paste support to the X-clipboard from the terminal.
-
 * Key bindings
 
 | Key binding | Description                                 |