Add documentation checks to be executed in Travis CI

- Validate all internal references
- Validate parse errors
- Validate external links

Signed-off-by: Michal Čihař <[email protected]>

.travis.yml

@@ -56,6 +56,8 @@ matrix:
       env: CI_MODE=selenium
     - php: "7.0"
       env: CI_MODE=release
+    - php: "7.0"
+      env: CI_MODE=docs
 cache:
   directories:
     - $HOME/.composer/cache/

test/ci-docs

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+set -e
+
+travis_retry() {
+  local result=0
+  local count=1
+  while [ $count -le 3 ]; do
+    [ $result -ne 0 ] && {
+      echo -e "\n${ANSI_RED}The command \"$@\" failed. Retrying, $count of 3.${ANSI_RESET}\n" >&2
+    }
+    "$@"
+    result=$?
+    [ $result -eq 0 ] && break
+    count=$(($count + 1))
+    sleep 1
+  done
+
+  [ $count -gt 3 ] && {
+    echo -e "\n${ANSI_RED}The command \"$@\" failed 3 times.${ANSI_RESET}\n" >&2
+  }
+
+  return $result
+}
+
+# Build documentation with warnings treated as errors
+make -C doc html SPHINXOPTS='-n -W -a'
+
+# Check external links
+travis_retry make -C doc linkcheck

test/ci-install-docs

@@ -0,0 +1,6 @@
+#!/bin/sh
+
+# We use 1.5 to be able to deal with gzip only sites in linkcheck (such as tcpdf.org)
+
+pip install --user 'Sphinx>=1.5a2'
+