openstack/api-site
Code Issues Proposed changes

Updates to firstapp README including Prerequisites and more build detail

Browse Source 
Change-Id: I07c6c3611e8d27a07d19613ab555c5a825266a62
This commit is contained in:
Donovan Jones 2015-07-29 15:57:07 +12:00 committed by Diane Fleming
parent bde0eb5599
commit f34bc6414a
2 changed files with 30 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
firstapp/README.rst
View File

@ -1,32 +1,48 @@
======================================== ========================================
Writing your First OpenStack Application Writing your first OpenStack application
======================================== ========================================
This directory contains the "Writing your First OpenStack Application" This tutorial works with the `First App Application for OpenStack <https://github.com/stackforge/faafo/>`_.
tutorial.
The tutorials works with an application that can be found at: Prerequisites
https://github.com/stackforge/faafo =============
To build the documentation, install `Python Tox <https://tox.readthedocs.org/>`_.
To install Tox for Ubuntu 14.04 and later::
apt-get install python-tox python-dev libxml2-dev libxslt1-dev
Structure
=========
/source /source
~~~~~~~ ~~~~~~~
The :code:`/source` directory contains a playground for the actual tutorial The :code:`/source` directory contains the tutorial documentation as
documentation. It's reStructuredText (RST), built with Sphinx. `reStructuredText <http://docutils.sourceforge.net/rst.html>`_ (RST). The
documentation is built with `Sphinx <http://sphinx-doc.org/>`_.
The RST source includes conditional output logic, so specifying:: The RST source includes conditional output logic, so specifying::
tox -e firstapp-libcloud tox -e firstapp-libcloud
will invoke :code:`sphinx-build` with :code:`-t libcloud`, meaning sections will invoke :code:`sphinx-build` with :code:`-t libcloud`, meaning sections
marked :code:`.. only:: libcloud` in the RST will be built, while others marked :code:`.. only:: libcloud` in the RST are built, while others
won't. are not built.
Sphinx and the OpenStack docs.openstack.org Sphinx Theme (openstackdocstheme) To build the documentation, you need Sphinx and the OpenStack
are needed to build the docs. docs.openstack.org Sphinx Theme (openstackdocstheme). When you invoke tox,
these dependencies are automatically pulled in from the top-level :code:`test-requirements.txt`.
/samples /samples
~~~~~~~~ ~~~~~~~~
The code samples provided in the guide are sourced from files The code samples provided in the guide are sourced from files in this
in this directory. There is a sub-directory for each SDK. directory. Each SDK has its own subdirectory.
/build-libcloud
~~~~~~~~~~~~~~~
The HTML documentation is built in this directory. This directory is included
in the project :code:`.gitignore`.

2
firstapp/source/index.rst
View File

@ -1,5 +1,5 @@
======================================== ========================================
Writing your First OpenStack Application Writing your first OpenStack application
======================================== ========================================
Contents Contents