jeudi 6 juin 2024 à 14h00

La session de Demandez le Programme! aura lieu le jeudi 6 juin de 14h à 15h en salle Henri Poincaré (bâtiment Alan Turing) et en visio, et sera animée par Nicolas Kielbasiewicz qui est ingénieur de recherche C.N.R.S. au sein du laboratoire POEMS. Il participe activement au développement de la librairie XLiFE++. L'exposé sera en français.


Pour documenter ma librairie (XLiFE++), j’utilisais un site fait maison avec Doxygen pour l’API, et tex4ht pour les docs HTML, avec un look un peu dépassé aujourd’hui. Quand nous avons souhaité refondre totalement les docs, la question de la technologie s’est alors posée pour répondre à ces nouveaux enjeux (look moderne et responsive, fonctionnalités complètes) et à une solution d’hébergement pérenne (Gitlab Pages).

C’est là que j’ai découvert et choisi Sphinx : un générateur de documentation multi-format (PDF, site web statique, ... à partir des mêmes sources) issu de la communauté python. Sphinx est capable de générer des sites très complets (gestionnaire d’événements, galeries d’exemples, systèmes de mots-clés, bibliographie), pour des codes variés (python, C, C++, FORTRAN, javascript, ...), ce qui lui confère un plus indéniable par rapport à ses concurrents.

L’objectif de cette présentation est donc de vous initier à Sphinx en vous montrant comment j’ai appris à l’utiliser.


Attention: En raison du plan Vigipirate renforcé, les visiteurs doivent:

Informations de visio: