From 21172a592f34d2581575a76ef6190121db1cf82b Mon Sep 17 00:00:00 2001 From: Rotzbua Date: Wed, 3 Oct 2018 06:11:42 +0200 Subject: [PATCH] create travis build script for doc Edited by Florian Festi --- .travis.yml | 29 +++++++++++++++++++++++++++++ documentation/src/Makefile | 3 ++- documentation/src/conf.py | 1 + documentation/src/index.html | 15 +++++++++++++++ 4 files changed, 47 insertions(+), 1 deletion(-) create mode 100644 .travis.yml create mode 100644 documentation/src/index.html diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 0000000..b5638e1 --- /dev/null +++ b/.travis.yml @@ -0,0 +1,29 @@ +language: python +python: + - "2.7" + +# Cache PlatformIO packages using Travis CI container-based infrastructure +sudo: false +cache: + - pip +branches: + only: + - master +install: + - pip install sphinx pycairo +script: + #- python setup.py install + - cd ./documentation/src/ && make html #linkchecker + - cd ../build/ && ls && ls html/ + - rm -rf doctrees + - touch .nojekyll + +deploy: + provider: pages + # see https://docs.travis-ci.com/user/deployment/pages/ + skip-cleanup: true + github-token: $GITHUB_TOKEN # Set in the settings page of your repository, as a secure variable + keep-history: true + local-dir: ./documentation/build/ + on: + branch: master diff --git a/documentation/src/Makefile b/documentation/src/Makefile index fc9e903..7cbfdce 100644 --- a/documentation/src/Makefile +++ b/documentation/src/Makefile @@ -3,7 +3,7 @@ # You can set these variables from the command line. SPHINXOPTS = -SPHINXBUILD = sphinx-build-3 +SPHINXBUILD = sphinx-build PAPER = BUILDDIR = ../build @@ -51,6 +51,7 @@ clean: html: $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html + cp index.html $(BUILDDIR)/ @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." diff --git a/documentation/src/conf.py b/documentation/src/conf.py index 9c3da69..6333ca3 100644 --- a/documentation/src/conf.py +++ b/documentation/src/conf.py @@ -36,6 +36,7 @@ extensions = [ 'sphinx.ext.coverage', 'sphinx.ext.ifconfig', 'sphinx.ext.viewcode', + 'sphinx.ext.githubpages', ] # Add any paths that contain templates here, relative to this directory. diff --git a/documentation/src/index.html b/documentation/src/index.html new file mode 100644 index 0000000..ba3f5a6 --- /dev/null +++ b/documentation/src/index.html @@ -0,0 +1,15 @@ + + + + + + + Page Redirection + + + + If you are not redirected automatically, follow the link to example + +