Blame view

doc/doc_rst/source/index.rst 3.26 KB
9d8c5b5c   Etienne Pallier   Toute premiere ve...
1
Welcome in the PyROS developer documentation
d9d66439   Etienne Pallier   sphinx doc autoge...
2
3
4
5
6
7
============================================

.. |br| raw:: html

   <br />

9d8c5b5c   Etienne Pallier   Toute premiere ve...
8
9
10
11
12

.. image:: ./doc_images/logo-irap-couleur-1024x386.png
	:height: 100px
	:align: center

d9d66439   Etienne Pallier   sphinx doc autoge...
13
14
15
|br|
|br|

9d8c5b5c   Etienne Pallier   Toute premiere ve...
16
17
18
19
20
21
22
+------------------------------+------------------------------------------------------------------+
| | IRAP                       | | Project Scientist (PI) : Alain Klotz - aklotz AT irap.omp.eu   |
| | 9 Avenue Colonel Roche     | | Project Manager : Etienne Pallier - epallier AT irap.omp.eu    |
| | 31028 Toulouse Cedex 4     | | Developper : Alexis Koralewski - akoralewski AT irap.omp.eu    |
| | FRANCE                     | | http://pyros.irap.omp.eu                                       |
+------------------------------+------------------------------------------------------------------+

d9d66439   Etienne Pallier   sphinx doc autoge...
23
.. warning:: This project is under active development.
9d8c5b5c   Etienne Pallier   Toute premiere ve...
24

d9d66439   Etienne Pallier   sphinx doc autoge...
25
26
.. note::
   This project is under active development.
9d8c5b5c   Etienne Pallier   Toute premiere ve...
27
28
29


1. PyROS files
d9d66439   Etienne Pallier   sphinx doc autoge...
30
--------------
9d8c5b5c   Etienne Pallier   Toute premiere ve...
31

fe9c9b42   Etienne Pallier   autogenerated sph...
32
See in the `Installation documentation - Project structure <https://docs.google.com/document/d/1DjT_rAzeVPl9SnQG3_20GFbDf67JEUAsOD1uhDMlOVw/edit#heading=h.19nwnkgoi5k>`_
9d8c5b5c   Etienne Pallier   Toute premiere ve...
33
34
35
36
37
38
39

.. comments
    .. toctree:: 
       :maxdepth: 3
        
       using_mount_classes

d9d66439   Etienne Pallier   sphinx doc autoge...
40
41
42

2. PyROS general configuration
------------------------------
9d8c5b5c   Etienne Pallier   Toute premiere ve...
43

fe9c9b42   Etienne Pallier   autogenerated sph...
44
See in the `Execution & Configuration documentation - General Configuration <https://docs.google.com/document/d/1Nj80hsvE9LQll4KehBpfXLC1QQMjUKoXb4U_VmNHnDI/edit#heading=h.q3s2zb7c303n>`_
9d8c5b5c   Etienne Pallier   Toute premiere ve...
45
46
47



d9d66439   Etienne Pallier   sphinx doc autoge...
48
49
3. Observatory configuration
----------------------------
9d8c5b5c   Etienne Pallier   Toute premiere ve...
50

fe9c9b42   Etienne Pallier   autogenerated sph...
51
See in the `Execution & Configuration documentation - Observatory Configuration <https://docs.google.com/document/d/1Nj80hsvE9LQll4KehBpfXLC1QQMjUKoXb4U_VmNHnDI/edit#heading=h.ec6uvlb3rto4>`_
9d8c5b5c   Etienne Pallier   Toute premiere ve...
52
53
54



d9d66439   Etienne Pallier   sphinx doc autoge...
55
56
4. PyROS API Source Code documentation
--------------------------------------
9d8c5b5c   Etienne Pallier   Toute premiere ve...
57

12ddccd6   Etienne Pallier   sphinx doc auto g...
58
.. The PyROS :doc:`Packages, Classes, and Methods<generated_api/pyros_django_package>`
9d8c5b5c   Etienne Pallier   Toute premiere ve...
59
60
61



d9d66439   Etienne Pallier   sphinx doc autoge...
62
63
5. Guitastro package documentation
----------------------------------
9d8c5b5c   Etienne Pallier   Toute premiere ve...
64

fe9c9b42   Etienne Pallier   autogenerated sph...
65
See in the `Guitastro documentation <../../../../vendor/guitastro/doc_rst/build/html/index.html>`_
9d8c5b5c   Etienne Pallier   Toute premiere ve...
66
67


d9d66439   Etienne Pallier   sphinx doc autoge...
68
69
70
71
72
6. PyROS Python source code style recommandations
-------------------------------------------------

:doc:`generated_api/codestyle_examples_package`

83cfb55c   Etienne Pallier   sphinx autodoc ge...
73
74
75
.. image:: doc_images/generated/packages_codestyle_examples.png
.. image:: doc_images/generated/classes_codestyle_examples.png

9d8c5b5c   Etienne Pallier   Toute premiere ve...
76
77


d9d66439   Etienne Pallier   sphinx doc autoge...
78
79
=====================================================================================

9d8c5b5c   Etienne Pallier   Toute premiere ve...
80
81
82
83
84
85


.. COMMENT: The toctree directive is mainly to let Sphinx be aware of the document hierarchy (the sidebar will reflect this understanding)


.. toctree:: 
d9d66439   Etienne Pallier   sphinx doc autoge...
86
    :maxdepth: 1
9d8c5b5c   Etienne Pallier   Toute premiere ve...
87
88
89
    :caption: Contents:

    generated_api/codestyle_examples_package
12ddccd6   Etienne Pallier   sphinx doc auto g...
90
91
92
93

.. generated_api/pyros_django_package


9d8c5b5c   Etienne Pallier   Toute premiere ve...
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

.. comment    guitastro

.. comment    `Guitastro documentation <../../../vendor/guitastro/doc_rst/build/html/index.html>`_

.. comment    ../../../vendor/guitastro/doc_rst/source/index

.. Generation doc guitastro API directement depuis ce script (EP) :
..    generated_api/guitastro_package

.. Autres modules :
..   device_controller_package
..   pyros_django_package
..   autodoc_pyros
..   pyros-doc-DEV
..   modules

d9d66439   Etienne Pallier   sphinx doc autoge...
111
112
=====================================================================================

9d8c5b5c   Etienne Pallier   Toute premiere ve...
113
114
115
116
117
118
119
120

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

* :ref:`genindex`
* :ref:`modindex`

.. * :ref:`search`