ci: add auto doc generation with html_of_wiki

Author: leovalais

.howdocgen

@@ -0,0 +1,36 @@
+#!/bin/bash
+set -x
+
+wget https://raw.githubusercontent.com/ocaml/ocaml-travisci-skeleton/master/.travis-ocaml.sh
+export OCAML_VERSION=4.06
+bash -ex .travis-ocaml.sh
+
+eval $(opam env)
+
+git clone https://github.com/ocsigen/html_of_wiki.git
+opam pin add -y html_of_wiki html_of_wiki
+
+# wget https://raw.githubusercontent.com/ocsigen/ocsigen.github.io/master/template.wiki
+# TODO when every project's CI will run HOW for its docs, uncomment the line above,
+# remove the 5 following lines and `git rm' the file doc/template.wiki.
+wget https://raw.githubusercontent.com/ocsigen/ocsigen.github.io/e6b93e987b75be99e8ef30601460f60028c615fd/css/style.css
+wget https://raw.githubusercontent.com/ocsigen/ocsigen.github.io/e6b93e987b75be99e8ef30601460f60028c615fd/img/search.svg
+mkdir tmp
+mv style.css tmp
+mv search.svg tmp
+
+f=$(mktemp)
+cat >$f <<EOF
+{
+    "project": "ocsigen-toolkit",
+    "api": "api",
+    "menu": true,
+    "csw": true,
+    "templates": ["doc/template.wiki"],
+    "manual": "manual"
+}
+EOF
+quickdop -f doc _doc -t json -c $f -viu
+
+# TODO Also remove that line.
+mv tmp _doc

.travis.yml

@@ -0,0 +1,16 @@
+language: c
+
+install:
+    - true
+
+script:
+    - ./.howdocgen
+
+deploy:
+  provider: pages
+  keep-history: true
+  skip-cleanup: true
+  github-token: $GHP_TOKEN
+  local-dir: _doc
+  on:
+    branch: master

doc/template.wiki

@@ -0,0 +1,83 @@
+<<head-css href="https://ocsigen.org/ocsigen-toolkit/tmp/style.css">>
+<<head-css href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.9.0/themes/prism.min.css">>
+<<head-script src="https://ocsigen.org/js/client.js">>
+<<head-script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.9.0/components/prism-core.min.js">>
+<<head-script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.9.0/components/prism-ocaml.min.js">>
+<<head-script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.9.0/components/prism-clike.min.js">>
+<<head-script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.9.0/components/prism-reason.min.js">>
+<<head-script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.9.0/components/prism-javascript.min.js">>
+
+<<div class="project-page"|
+<<div class="page-header"|
+
+@@class="logo-ocsigen"@@[[site:/|{{site:/img/ocsigen-white.svg|Ocsigen}}]]
+
+<<when-project when="eliom"          | @@class="logo-subproject"@@Eliom>>
+<<when-project when="js_of_ocaml"    | @@class="logo-subproject"@@Js_of_ocaml>>
+<<when-project when="ocsigenserver"  | @@class="logo-subproject"@@Server>>
+<<when-project when="lwt"            | @@class="logo-subproject"@@Lwt>>
+<<when-project when="tyxml"          | @@class="logo-subproject"@@Tyxml>>
+<<when-project when="ocsigen-toolkit"| @@class="logo-subproject"@@Toolkit>>
+<<when-project when="ocsigen-start"  | @@class="logo-subproject"@@Start>>
+<<when-project when="ocsimore"       | @@class="logo-subproject"@@Ocsimore>>
+
+<<div class="mainmenu"|
+<<span class="mainmenu-home"|[[site:/|Home]]>>
+<<span class="mainmenu-doc" |[[wiki("tuto"):|Doc]]>>
+<<when-project   when="eliom"        | @@class="mainmenu-current"@@[[wiki("eliom"):|Eliom]]>>
+<<when-project unless="eliom"        |                             [[wiki("eliom"):|Eliom]]>>
+<<when-project   when="js_of_ocaml"  | @@class="mainmenu-current"@@[[wiki("js_of_ocaml"):|Js_of_ocaml]]>>
+<<when-project unless="js_of_ocaml"  |                             [[wiki("js_of_ocaml"):|Js_of_ocaml]]>>
+<<when-project   when="lwt"          | @@class="mainmenu-current"@@[[wiki("lwt"):|Lwt]]>>
+<<when-project unless="lwt"          |                             [[wiki("lwt"):|Lwt]]>>
+<<when-project   when="tyxml"        | @@class="mainmenu-current"@@[[wiki("tyxml"):|Tyxml]]>>
+<<when-project unless="tyxml"        |                             [[wiki("tyxml"):|Tyxml]]>>
+<<when-project   when="ocsigen-start"| @@class="mainmenu-current"@@[[wiki("ocsigen-start"):|Start]]>>
+<<when-project unless="ocsigen-start"|                             [[wiki("ocsigen-start"):|Start]]>>
+>>
+
+<<when-local  |<<googlesearch icon="https://ocsigen.org/img/search.svg" domain="ocsigen.org">>>>
+<<unless-local|<<googlesearch icon="https://ocsigen.org/ocsigen-toolkit/tmp/search.svg" domain="ocsigen.org">>>>
+
+<<drawer|
+*@@class="drawermainmenu"@class="drawermainmenu-home"@@[[site:/|Home]]
+*@@class="drawermainmenu-doc"@@[[wiki("tuto"):|Doc]]
+*@@class="drawermainmenu-project"@@[[wiki("eliom"):|Eliom]]
+*@@class="drawermainmenu-project"@@[[wiki("js_of_ocaml"):|Js_of_ocaml]]
+*@@class="drawermainmenu-project"@@[[wiki("ocsigenserver"):|Server]]
+*@@class="drawermainmenu-project"@@[[wiki("lwt"):|Lwt]]
+*@@class="drawermainmenu-project"@@[[wiki("tyxml"):|Tyxml]]
+*@@class="drawermainmenu-project"@@[[wiki("ocsigen-toolkit"):|Toolkit]]
+*@@class="drawermainmenu-project"@@[[wiki("ocsigen-start"):|Start]]
+*@@class="drawermainmenu-project"@@[[wiki("ocsimore"):|Ocsimore (//deprecated//)]]
+*@@class="drawermainmenu-page"@@[[site:/projects|Other projects]]
+*@@class="drawermainmenu-page"@@[[site:/papers|Research papers]]
+*@@class="drawermainmenu-page"@@[[site:/credits|Who does Ocsigen?]]
+*@@class="drawermainmenu-page"@@[[site:/blog|Blog]]
+*@@class="drawermainmenu-page"@@[[https://github.com/ocsigen|Source code]]
+
+<<doctree>>
+
+
+>> <<|drawer>>
+
+>> <<|page-header>>
+
+@@class="reasonwarning"@@Warning: Reason support is experimental.
+We are looking for beta-tester and contributors.
+
+<<reason-switch>>
+
+<<div class="twocols" |
+<<nav class="leftcol" |
+<<docversion>>
+
+<<doctree>>
+>> <<|leftcol>>
+
+<<article class="rightcol" |
+<<client-server-switch|>>
+<<content>>
+>> <<|rightcol>>
+>> <<|twocols>>
+>> <<|project-page>>