This is the official documentation repository of the Developer Cloud Sandboxes service.
This documentation is live at: http://docs.terradue.com/developer-sandbox
You are encouraged to fork this repo and send us pull requests!
Here's the procedure to install the required packages on a CentOS 6.x
# Install RHEL EPEL repository
$ wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
$ wget http://rpms.famillecollet.com/enterprise/remi-release-6.rpm
$ sudo rpm -Uvh remi-release-6*.rpm epel-release-6*.rpm
# Install sphinx
$ sudo yum install python-sphinx10
$ sudo yum install python-pip
$ sudo pip install sphinx_bootstrap_theme
$ sudo ln -s /usr/bin/sphinx-1.0-build /usr/bin/sphinx-build
Patch: Open the file /usr/lib/python2.6/site-packages/sphinx_bootstrap_theme/bootstrap/globaltoc.html and substitute:
maxdepth=theme_globaltoc_depth|toint
with:
maxdepth=theme_globaltoc_depth
# Install plantuml
$ wget --no-check-certificate https://pypi.python.org/packages/source/s/sphinxcontrib-plantuml/sphinxcontrib-plantuml-0.3.tar.gz
$ tar xvzf sphinxcontrib-plantuml-0.3.tar.gz
$ cd sphinxcontrib-plantuml-0.3
$ sudo pip install sphinxcontrib-plantuml
$ cat << EOF > /usr/bin/plantuml
#!/bin/sh -e
java -jar /usr/lib/plantuml.7997.jar "$@"
EOF
$ chmod +x /usr/bin/plantuml
# Clone the git repository
$ git clone git@github.com:Terradue/doc-developer-sandbox.git
If needed, set your github information
$ git config --global user.name <github username>
$ git config --global user.email <email address>
Build the documentation by running make html.
make html creates a build folder in the doc-developer-sandbox local repository.
As root, do:
$ sudo cd /var/www/html
$ ln -s $GIT_CLONE_DIR/doc-developer-sandbox/build/html/ developer-sandbox
$ chown -R apache:apache developer-sandbox
$ chmod -R g+w developer-sandbox
Replace $GIT_CLONE_DIR with the path to the folder where you have cloned the repository
Open you browser at the address http://127.0.0.1/developer-sandbox