Add "docs" service to for generating documentation with Sphinx

docker-compose.yml

@@ -4,6 +4,13 @@ services:
   php:
     build:
       context: .
-      dockerfile: ./docker/Dockerfile
+      dockerfile: ./docker/php/Dockerfile
     volumes:
       - .:/usr/local/src/wellrested
+
+  docs:
+    build:
+      context: .
+      dockerfile: ./docker/docs/Dockerfile
+    volumes:
+      - .:/usr/local/src/wellrested

docker/docs/Dockerfile

@@ -0,0 +1,7 @@
+FROM python:3-jessie
+
+RUN pip install sphinx sphinx_rtd_theme
+
+WORKDIR /usr/local/src/wellrested
+
+CMD ["make", "html", "-C", "docs"]

docker/php/Dockerfile

@@ -15,7 +15,7 @@ RUN yes | pecl install xdebug \
   && echo "zend_extension=$(find /usr/local/lib/php/extensions/ -name xdebug.so)" > /usr/local/etc/php/conf.d/xdebug.ini
 
 # Download and install Composer
-COPY ./docker/install-composer.sh /tmp/install-composer.sh
+COPY ./docker/php/install-composer.sh /tmp/install-composer.sh
 RUN chmod +x /tmp/install-composer.sh; sync && \
   /tmp/install-composer.sh && \
   rm /tmp/install-composer.sh

docs/source/conf.py

@@ -6,7 +6,6 @@ from pygments.lexers.web import PhpLexer
 
 lexers['php'] = PhpLexer(startinline=True, linenos=1)
 lexers['php-annotations'] = PhpLexer(startinline=True, linenos=1)
-primary_domain = 'php'
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom