User Guide¶
Generation of documentation with the tool¶
The procedure for generating the documentation is the following
Create directory sphinxdocs.
Install packages you like to be documented
Run the command:
# crl_doc_generate_rst (builtin, api and crl documentation) # crl_doc_generate_rst -d builtin -d crl (only builtin and crl documentation)
The documentation reStructuredText source is generated under sphinxdocs directory in the following fashion:
- sphinxdocs/builtin: Robot Framework built-in reStructuredText source files
- sphinxdocs/crl: Common Robot Libraries Robot Framework keyword documentation reStructuredText source files.
Generation of HTML documentation¶
Please use the following procedure to generate HTML documentation:
- create Sphinx configuration conf.py and index.rst so that it links to the sources described above.
- Run sphinx-build.