Mike Perez 3ffa49c7c5 Adding tool chain documentation for IRC
This adds documentation for using IRC with Linux and Mac OS.

Change-Id: Ic41e7040d6980fceb07e9bdba84ab74dae40ff90
2016-03-22 16:24:12 -07:00

84 lines
3.4 KiB
INI

[tox]
minversion = 1.6
envlist = checkbuild
skipsdist = True
[testenv]
basepython = python2
setenv = VIRTUAL_ENV={envdir}
install_command = pip install -U {opts} {packages}
deps = -r{toxinidir}/test-requirements.txt
whitelist_externals =
mkdir
rm
rsync
[testenv:venv]
commands = {posargs}
[doc8]
# Settings for doc8:
# File extensions to use
extension = .rst,.txt
ignore-path = doc/upstream-training/build/*,doc/training-guides/build/*
[testenv:checkbuild]
commands =
# Niceness test
doc8 doc/upstream-training
doc8 doc/training-guides
# Build upstream-training slides
sphinx-build -b slides doc/upstream-training/source/ doc/upstream-training/build/slides
# Build upstream landing page
sphinx-build -b html doc/upstream-training doc/upstream-training/build/slides doc/upstream-training/index.rst doc/upstream-training/upstream-details.rst doc/upstream-training/upstream-archives.rst doc/upstream-training/irc.rst
# Build training-guides slides
sphinx-build -b slides doc/training-guides/associate-guide/ doc/training-guides/build/slides/associate-guide
# Build training-guides landing page
sphinx-build -b html doc/training-guides doc/training-guides/build/slides doc/training-guides/index.rst
# Publish for check site
mkdir -p publish-docs/upstream-training
mkdir -p publish-docs/training-guides
rsync -av doc/upstream-training/build/slides/ publish-docs/upstream-training/
rsync -av doc/training-guides/build/slides/ publish-docs/training-guides/
[testenv:publishdocs]
commands =
# Build upstream-training slides
sphinx-build -b slides doc/upstream-training/source/ doc/upstream-training/build/slides
# Build upstream landing page
sphinx-build -b html doc/upstream-training doc/upstream-training/build/slides doc/upstream-training/index.rst doc/upstream-training/upstream-details.rst doc/upstream-training/upstream-archives.rst doc/upstream-training/irc.rst
# Build training-guides slides
sphinx-build -b slides doc/training-guides/associate-guide/ doc/training-guides/build/slides/associate-guide
# Build training-guides landing page
sphinx-build -b html doc/training-guides doc/training-guides/build/slides doc/training-guides/index.rst
# Publish as draft
mkdir -p publish-docs/draft/training-guides
rsync -av doc/training-guides/build/slides/ publish-docs/draft/training-guides/
# Publish
mkdir -p publish-docs/upstream-training
rsync -av doc/upstream-training/build/slides/ publish-docs/upstream-training/
# Publish translated guides
{toxinidir}/tools/buildlang.sh
[testenv:upstream-slides]
commands =
# Niceness test
doc8 doc/upstream-training
# Build upstream-training slides
sphinx-build -b slides doc/upstream-training/source/ doc/upstream-training/build/slides
# Build upstream landing page index.html
sphinx-build -b html doc/upstream-training doc/upstream-training/build/slides doc/upstream-training/index.rst doc/upstream-training/upstream-details.rst
[testenv:training-slides]
commands =
# Niceness test
doc8 doc/training-guides
# Build training-guides slides
sphinx-build -b slides doc/training-guides/associate-guide/ doc/training-guides/build/slides/associate-guide
# Build training-guides landing page index.html
sphinx-build -b html doc/training-guides doc/training-guides/build/slides doc/training-guides/index.rst
[testenv:generatepot-training]
# Generate POT files for translation
commands = {toxinidir}/tools/generatepot-training.sh