mirror of
https://github.com/ae-utbm/sith.git
synced 2025-07-09 19:40:19 +00:00
documentation: update instructions, add down loadable files and add all pdf reports for download purpose
This commit is contained in:
1
doc/TO_Skia_LoJ/.gitignore
vendored
1
doc/TO_Skia_LoJ/.gitignore
vendored
@ -1,2 +1 @@
|
||||
Rapport.pdf
|
||||
_minted-Rapport/
|
||||
|
2
doc/TW_Skia/.gitignore
vendored
2
doc/TW_Skia/.gitignore
vendored
@ -1 +1 @@
|
||||
Rapport.pdf
|
||||
_minted-Rapport
|
BIN
doc/TW_Skia/Rapport.pdf
Normal file
BIN
doc/TW_Skia/Rapport.pdf
Normal file
Binary file not shown.
@ -1,7 +1,7 @@
|
||||
Introduction
|
||||
============
|
||||
|
||||
Le but de ce projet est de fournir à l'Association des Étudiants de l'UTBM une plate-forme pratique et centralisée de ses services. Le Sith de l'AE tiens à jour le registre des cotisations à l'association, prend en charge la trésorerie, les ventes de produits et services, la diffusion d’événements, la gestion de la laverie et bien plus encore.
|
||||
Le but de ce projet est de fournir à l'Association des Étudiants de l'UTBM une plate-forme pratique et centralisée de ses services. Le Sith de l'AE tiens à jour le registre des cotisations à l'association, prend en charge la trésorerie, les ventes de produits et services, la diffusion d’événements, la gestion de la laverie et bien plus encore. Il est conçu de manière suffisamment générique pour être facilement adaptable à une autre association.
|
||||
|
||||
C'est un projet bénévole qui tire ses origines des années 2000. Il s'agit de la troisième version du site de l'association initiée en 2015. C'est une réécriture complète en rupture totale des deux versions qui l'ont précédé.
|
||||
|
||||
|
@ -137,7 +137,7 @@ Sentry
|
||||
~~~~~~
|
||||
|
||||
| `Site officiel <https://sentry.io>`__
|
||||
| `Instance de l'AE <https://ae2.utbm.fr`__
|
||||
| `Instance de l'AE <https://ae2.utbm.fr>`__
|
||||
|
||||
Sentry est une plate-forme libre qui permet de se tenir informer des bugs qui ont lieu sur le site. À chaque crash du logiciel (erreur 500), une erreur est envoyée sur la plate-forme et est indiqué précisément à quelle ligne de code celle-ci a eu lieu, à quelle heure, combien de fois, avec quel navigateur la page a été visitée et même éventuellement un commentaire de l'utilisateur qui a rencontré le bug.
|
||||
|
||||
|
@ -28,5 +28,13 @@ Bienvenue sur la documentation du Sith de l'AE
|
||||
|
||||
apps/core
|
||||
|
||||
Documents téléchargeables
|
||||
-------------------------
|
||||
|
||||
* :download:`Rapport de la TW de Skia sur la création du site <TW_Skia/Rapport.pdf>`
|
||||
* :download:`Rapport sur la TO de Skia et LoJ <TO_Skia_LoJ/Rapport.pdf>`
|
||||
* :download:`Manuel du service E-transactions <Etransaction/Manuel_Integration_E-transactions_Internet_V6.6_FR.pdf>`
|
||||
* :download:`Guide de trésorerie <Guide de Tresorerie.pdf>`
|
||||
|
||||
.. include:: ../README.rst
|
||||
:start-after: body
|
||||
|
@ -26,7 +26,7 @@ Sur Ubuntu
|
||||
Sur MacOS
|
||||
~~~~~~~~~
|
||||
|
||||
Pour installer les dépendances, il est fortement recommandé d'installer le gestionnaire de paquets `homebrew <https://brew.sh/index_fr>`__.
|
||||
Pour installer les dépendances, il est fortement recommandé d'installer le gestionnaire de paquets `homebrew <https://brew.sh/index_fr>`_.
|
||||
|
||||
.. sourcecode:: bash
|
||||
|
||||
@ -70,15 +70,17 @@ Il faut toujours avoir préalablement activé l'environnement virtuel comme fait
|
||||
|
||||
./manage.py runserver
|
||||
|
||||
Le serveur est alors accessible à l'adresse `http://localhost:8000 <http://localhost:8000`__.
|
||||
.. note::
|
||||
|
||||
Le serveur est alors accessible à l'adresse http://localhost:8000.
|
||||
|
||||
Générer la documentation
|
||||
------------------------
|
||||
|
||||
La documentation est automatiquement mise en ligne sur readthedocs à chaque envoi de code sur GitLab.
|
||||
|
||||
Pour l'utiliser en local ou globalement pour la modifier, il existe une commande du site qui génère la documentation et lance un serveur la rendant accessible à l'adresse `http://localhost:8080 <http://localhost:8080>`__.
|
||||
Pour l'utiliser en local ou globalement pour la modifier, il existe une commande du site qui génère la documentation et lance un serveur la rendant accessible à l'adresse http://localhost:8080.
|
||||
|
||||
.. sourcecode:: bash
|
||||
|
||||
./manage.py documentation
|
||||
./manage.py documentation
|
||||
|
Reference in New Issue
Block a user