Add missing makefile so HTML docs can be generated
Also added instructions for generating the docs to README.rst Closes-bug: #1605678 Change-Id: I681a706e209308d29e1c04044ba7df702a8aea60
This commit is contained in:
parent
bc34c566ce
commit
77e875680c
|
@ -0,0 +1,12 @@
|
|||
|
||||
TOPDIR=$(CURDIR)
|
||||
SRCDIR=$(TOPDIR)/congressclient
|
||||
|
||||
all: docs
|
||||
|
||||
clean: rm -Rf $(TOPDIR)/doc/html/*
|
||||
|
||||
docs: $(TOPDIR)/doc/source/*.rst
|
||||
sphinx-build -b html $(TOPDIR)/doc/source $(TOPDIR)/doc/html
|
||||
|
||||
|
|
@ -24,7 +24,16 @@ To execute CLI commands to standalone congress set with noauth:
|
|||
$ cd python-congressclient
|
||||
$ python setup.py install
|
||||
|
||||
* Read the HTML documentation::
|
||||
Install python-sphinx and the oslosphinx extension if missing.
|
||||
$ sudo pip install sphinx
|
||||
$ sudo pip install oslosphinx
|
||||
|
||||
Build the docs
|
||||
$ make docs
|
||||
|
||||
Open doc/html/index.html in a browser
|
||||
|
||||
* To execute CLI commands::
|
||||
|
||||
$ cd python-congressclient
|
||||
|
|
Loading…
Reference in New Issue