Merge branch 'hotfix/docs-check'

Docs build-chain

Author: weierophinney

.travis.yml

@@ -21,6 +21,7 @@ matrix:
     - php: 5.5
       env:
         - EXECUTE_CS_CHECK=true
+        - EXECUTE_DOC_CHECK=true
     - php: 5.6
       env:
         - EXECUTE_TEST_COVERALLS=true
@@ -36,15 +37,20 @@ notifications:
 before_install:
   - if [[ $EXECUTE_TEST_COVERALLS != 'true' ]]; then phpenv config-rm xdebug.ini || return 0 ; fi
   - composer self-update
+  - if [[ $EXECUTE_DOC_CHECK == 'true' ]]; then composer require --dev --no-update phly/bookdown2mkdocs ; fi
   - if [[ $EXECUTE_TEST_COVERALLS == 'true' ]]; then composer require --dev --no-update satooshi/php-coveralls ; fi
 
 install:
   - travis_retry composer install --no-interaction --ignore-platform-reqs
 
+before_script:
+  - if [[ $EXECUTE_DOC_CHECK == 'true' ]]; then cp mkdocs.yml mkdocs.yml.orig ; fi
+
 script:
   - if [[ $EXECUTE_TEST_COVERALLS == 'true' ]]; then ./vendor/bin/phpunit --coverage-clover clover.xml ; fi
   - if [[ $EXECUTE_TEST_COVERALLS != 'true' ]]; then ./vendor/bin/phpunit ; fi
   - if [[ $EXECUTE_CS_CHECK == 'true' ]]; then ./vendor/bin/phpcs ; fi
+  - if [[ $EXECUTE_DOC_CHECK == 'true' ]]; then make mkdocs ; diff mkdocs.yml mkdocs.yml.orig ; return $? ; fi
 
 after_script:
   - if [[ $EXECUTE_TEST_COVERALLS == 'true' ]]; then ./vendor/bin/coveralls ; fi

Makefile

@@ -0,0 +1,23 @@
+# zend-expressive Makefile
+#
+# Primary purpose is for generating the mkdocs.yml from the bookdown.json
+# sources.
+#
+# Configurable variables:
+# - BOOKDOWN2MKDOCS - specify the path to the executable; defaults to
+#   				  ./vendor/bin/bookdown2mkdocs
+#
+# Available targets:
+# - mkdocs   - regenerate mkdocs.yml
+# - all      - synonym for mkdocs target
+
+BOOKDOWN2MKDOCS?=$(CURDIR)/vendor/bin/bookdown2mkdocs.php
+
+.PHONY : all mkdocs bookdown2mkdocs
+
+all : mkdocs
+
+mkdocs : 
+	@echo "Generating mkdocs.yml from bookdown.json..."
+	-$(BOOKDOWN2MKDOCS) convert --site-name=zend-code --repo-url=https://github.com/zendframework/zend-code --copyright-url=http://www.zend.com/ --copyright-author="Zend Technologies USA Inc."
+	@echo "[DONE] Generating mkdocs.yml from bookdown.json"

doc/book/index.md

@@ -0,0 +1 @@
+../../README.md

mkdocs.yml

@@ -0,0 +1,12 @@
+docs_dir: doc/book
+site_dir: doc/html
+pages:
+    - index.md
+    - zend.code.generator.introduction.md
+    - zend.code.generator.reference.md
+    - zend.code.generator.examples.md
+    - zend.code.migrate.2.to.3.md
+site_name: zend-code
+site_description: Zend\Code
+repo_url: 'https://github.com/zendframework/zend-code'
+copyright: 'Copyright (c) 2016 <a href="http://www.zend.com/">Zend Technologies USA Inc.</a>'