mirror of
https://github.com/zephyrproject-rtos/zephyr
synced 2025-08-20 22:45:21 +00:00
06ba8f7b34
Changes the labels to be consistent with the rest of the documentation. Fixed other minor markup and language issues. Adds the missing figures for apps_kernel_conf.rst Change-Id: I34a7650c04bb2d1f525eaad4efa7395f8272c88f Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com> |
||
|---|---|---|
| .. | ||
| application | ||
| collaboration | ||
| crypto | ||
| kernel | ||
| platform | ||
| quick_start | ||
| reference | ||
| scripts/genrest | ||
| themes/zephyr | ||
| about_zephyr.rst | ||
| conf.py | ||
| disclaimers.rst | ||
| documentation_license.rst | ||
| doxygen.config | ||
| index.rst | ||
| Makefile | ||
| README.rst | ||
| substitutions.rst | ||
Welcome to |codename| ##################### .. This document is in Restructured Text Format. More information at `<http://sphinx-doc.org/rest.html>`_. This is a comment that won't show up in formatted output Welcome to the |project|. Thank you for your interest in the |project|. These instructions are designed to walk you through generating the |project|'s documentation. Documentation Notes ******************* The project's documentation currently comprises the following items: * An Installation Guide for Linux host systems * A set of Collaboration Guidelines for the project. * Raw Doxygen output from the code base. Installing the documentation processors *************************************** Install the current version of :program:`Sphinx`, type: .. code-block:: bash $ git clone https://github.com/sphinx-doc/sphinx.git sphinx $ cd sphinx $ sudo -E python setup.py install $ cd .. $ git clone https://github.com/michaeljones/breathe.git breathe $ cd breathe $ sudo -E python setup.py install .. note:: Make sure that :program:`Doxygen` is installed in your system. The installation of Doxygen is beyond the scope of this document. Running the documentation generators ************************************ Assuming that the |project| tree with the doc directory is in :file:`DIRECTORY`, type: .. code-block:: bash $ cd DIRECTORY/doc $ make doxy html Find the output in :file:`DIRECTORY/doc/_build/html/index.html` Review the available formats with: .. code-block:: bash $ make -C DIRECTORY/doc doxy html If you want the LaTeX PDF output, you need to install all the Latex packages first. That installation is beyond the scope of this document.