Build documentation by default

.gitlab-ci.yml

@@ -2,6 +2,8 @@
   stage: build
   script:
      - apt-get update && apt-get -y dist-upgrade
+    # Workaround for bionic
+     - DEBIAN_FRONTEND=noninteractive apt-get -y install tzdata
      - ci-build-pkg
   artifacts:
     expire_in: 1 hour
@@ -43,6 +45,9 @@ build_centos_7:
   script:
      - rm -f /etc/yum.repos.d/CentOS-Sources.repo
      - yum -y install epel-release
+     - yum -y install python-pip
+     - pip install -U pip
+     - pip install sphinx==1.8.5 sphinx-rtd_theme==0.4.3
      - make rpm-dist
      - ci-build-pkg
   artifacts:

Makefile

@@ -258,7 +258,7 @@ CSSDSTFILES=$(CSSSRCFILES:.css=.min.css)
 #  - packaging targets
 #  - developper corner
 
-all:	configure common handler manager portal
+all:	configure common handler manager portal documentation
 	@echo
 	@echo "Building succeed. Now run :"
 	@echo " - 'make test' to verify your installation"
@@ -1132,9 +1132,13 @@ manager_cpan:	manager_conf
 	@mv ${SRCMANAGERDIR}/Lemonldap*.gz .
 
 documentation:
-	@sphinx-build -b html -d /tmp/doctrees \
-		-Dhtml_theme_path=. -Dhtml_theme=manager_doc_theme\
-		doc/sources/admin/ doc/pages/documentation/current/
+	@if [ "$(SKIP_DOCUMENTATION)" ] ; then \
+		echo "Skipped documentation building" ;\
+	else \
+		sphinx-build -b html -d /tmp/doctrees \
+			-Dhtml_theme_path=. -Dhtml_theme=manager_doc_theme \
+			doc/sources/admin/ doc/pages/documentation/current/ ;\
+	fi
 
 website_documentation:
 	sphinx-build -b html -d /tmp/doctrees \

debian/control

@@ -51,6 +51,8 @@ Build-Depends-Indep: libapache-session-perl <!nocheck>,
                      libxml-libxml-perl <!nocheck>,
                      libxml-libxslt-perl <!nocheck>,
                      libxml-simple-perl <!nocheck>,
+                     python3-sphinx,
+                     python3-sphinx-rtd-theme,
                      perl
 Standards-Version: 4.5.0
 Vcs-Browser: https://salsa.debian.org/perl-team/modules/packages/lemonldap-ng

doc/sources/admin/conf.py

@@ -37,7 +37,7 @@ templates_path = ['_templates']
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
-source_suffix = ['.rst' ]
+source_suffix = '.rst'
 
 # The encoding of source files.
 #