doc: initial sphinx-based documentation support
The release-notes script now produces Markdown compatible with
pandoc to help convert it into RST for sphinx.
Actual documentation is fairly limited currently.
We use intersphinx to link to various sub-projects' docs.
A .travis.yml file is added to build+publish documentation
when new code is pushed to github.
Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
diff --git a/.travis.yml b/.travis.yml
new file mode 100644
index 0000000..88bc180
--- /dev/null
+++ b/.travis.yml
@@ -0,0 +1,38 @@
+sudo: false
+dist: trusty
+
+cache:
+ apt: true
+
+git:
+ depth: false
+
+addons:
+ apt:
+ packages:
+ - python-pip
+ - latexmk
+ - libalgorithm-diff-perl
+ - texlive
+ - texlive-latex-extra
+ - texlive-humanities
+ - texlive-generic-recommended
+ - graphviz
+ - texlive-generic-extra
+
+
+language: python
+python:
+ - "2.7"
+install:
+ - "pip install -r doc/requirements.txt"
+script:
+ - cd doc/; make latexpdf html
+
+deploy:
+ provider: pages
+ skip-cleanup: true
+ github-token: $GITHUB_TOKEN # Set in travis-ci.org dashboard, marked secure
+ local_dir: "doc/_build/html"
+ on:
+ branch: master