README.md

docs

RackHD documentation source for http://rackhd.readthedocs.org

Setting up for editing and building the docs

create a Virtualenv and set up the requirements

virtualenv .venv
source .venv/bin/activate
pip install -r requirements.txt

build the docs

cd docs
make html

to auto-rebuild docs while you're editing

cd docs
sphinx-autobuild -H 0.0.0.0 -p <port> . _build/html

and the docs will be visible at the url http://<dev ip>:<port>
the default is http://127.0.0.1:8000

Setting up for editing and building the docs (Windows)

• download and install python: https://www.python.org/ftp/python/2.7.0/python-2.7.10.msi

  • install for all users
  • default location (c:\python27)
  • all default components

• clone these docs from github and open in a command prompt

• install and set up the virtualenv

c:\python27\scripts\pip install virtualenv
c:\python27\scripts\virtualenv .venv
.venv\scripts\activate
pip install -r requirements.txt

• make the docs

.venv\scripts\activate
cd docs
.\make.bat html

• open the docs in a browser

.venv\scripts\activate
cd docs
start .\_build\html\index.html

• to auto-rebuild the docs on editing with live updates

sphinx-autobuild -H 0.0.0.0 -p <port> . _build/html

and navigate to http://<dev ip>:<port> to see the docs
the default url is http://127.0.0.1:8080