sbt/sbt-site — pull request #39 by harrah (2013-08-12 15:34:24+00:00)
Title: Add sphinxEnv to set environment variables for sphinx-build process.

Usage would be to pass values from build to sphinx. The -D option to
sphinx doesn't apply within conf.py, so the values provided in this
way cannot be used there.

Alternatives to using environment variables are to duplicate values in
the build and in conf.py, to preprocess conf.py, preprocess sphinx sources,
postprocess generated files, generate files for conf.py to read from, ...

With this approach:

`build.sbt`:

```scala
sphinxEnv in Sphinx ++= Map(
"key" -> "value"
)
```

`conf.py`

```python
key = os.environ["key"]
```

NOTE: this is a binary and source incompatible change due to changing `SphinxInputs`. Review by @jsuereth.