Permalink
Fetching contributors…
Cannot retrieve contributors at this time
113 lines (80 sloc) 2.4 KB

Insérer automatiquement des données Excel dans un fichier reStructuredText

:awesome:`fa-history` Modifications récentes

.. git_changelog::
   :detailed-message-pre: True
   :revisions: 3

Il est fréquent que les données d'entreprise se trouvent dispersées dans différents référentiels, bases de données, fichiers de traitement de texte ou feuilles de calcul.

Plutôt que de dupliquer l'information pour générer la documentation utilisateur, il est largement préférable de puiser à la source et de l'extraire directement des divers référentiels.

Supposons que nous disposions d'un fichier Excel contenant des noms de produits avec leurs versions :

.. exceltable::
   :file: code/produits.xls
   :header: 1
   :selection: A1:C4

Le contenu ci-dessus est directement extrait d’un fichier Excel, mais nous souhaitons le présenter sous forme de sous-sections et de listes à puces.

Nous pouvons générer le fichier source de la documentation via le script Python suivant :

.. literalinclude:: code/populate-xlsx.py
   :language: python3

À l'exécution, le contenu suivant s'affiche :

Produits et versions
====================

Dianthus
--------

- 1.0
- 1.1
- 1.2

Geum
----

- 1.5
- 1.7
- 3.5

Prunus
------

- 2.3
- 2.5
- 2.7

Une fois compilé via Sphinx, ce code source produit un affichage HTML similaire à celui-ci :

Produits et versions

Dianthus

  • 1.0
  • 1.1
  • 1.2

Geum

  • 1.5
  • 1.7
  • 3.5

Prunus

  • 2.3
  • 2.5
  • 2.7
.. seealso::

   - :ref:`inserer-automatiquement-des-donnees-dans-un-fichier-dita-xml`
   - :ref:`inserer-automatiquement-des-donnees-dans-un-fichier-restructuredtext`
   - :ref:`inserer-automatiquement-des-donnees-sql-dans-un-fichier-restructuredtext`

.. toctree::
   :hidden:

   diminuer-les-couts-ameliorer-la-satisfaction-client
   redaction-technique-un-processus-industriel
   format-structure-dita-xml
   le-coin-du-geek
   a-propos-de-ce-blog
   contact