:orphan:
This documentation web site is using Sphinx
(version 1.1.2) to generate HTML pages from reStructuredText
files.
To setup Sphinx locally, use easy_install
:
::
$ sudo easy_install "sphinx==1.1.3"
$ sudo easy_install pygments # required on some systems
To generate the files, use the makeSite
task in sbt:
::
$ sbt makeSite
To deploy the changes, use the ghpagesPushSite
task:
::
$ sbt makeSite ghpagesPushSite
.. _reStructuredText: http://docutils.sourceforge.net/rst.html .. _Sphinx: http://sphinx.pocoo.org/
ValueError: unknown locale: UTF-8 .................................
On Mac osX, it appears to have some 'local' problem. Running the following fixes it:
::
export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8