Skip to content

[READ ONLY] Build sphinx documentation for a Symfony project

License

Notifications You must be signed in to change notification settings

survos/SurvosDocBundle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DocBundle

Symfony Bundle that provides some utilities for creating Spinx documentation for a Symfony project.

First, setup Sphinx

sudo apt-get install python3-sphinx
pip install sphinx_rtd_theme
pip install sphinx_fontawesome
composer req survos/doc-bundle

Put the .rst.twig files in templates/docs.

{# index.rst.twig #}
{{ rst_h(1, 'Welcome to Jardinio!') }}

The goal of this project is to provide plant management for botanical gardens, primarily involving
inventory (including samples and seeds) and maybe visitor tours.  It uses QR codes throughout the system.

.. toctree::
    :maxdepth: 2
    :caption: Contents:

.. fa:: check

{{ rst_h(2,'Administration') }}

The administrative portal allows managers to gardens


.. toctree::
    :maxdepth: 1

    quick-start
    tutorial

Indices and tables
==================

* :ref:`genindex`
* :ref:`search`

cat tutorial.rst.twig

{{ rst_h(1, 'Tutorial') }}

{{ rst_h(2, 'create_account'|trans|title) }}
{{ rst_h(2, 'create_project'|trans|title) }}
{{ rst_h(2, 'add_a_plant'|trans|title) }}



{{ rst_h(3, 'add_a_plant'|trans|title) }}

.. fa:: check
bin/console survos:build-docs
cd docs
make html

About

[READ ONLY] Build sphinx documentation for a Symfony project

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages