Expériences faites et à faire (dans des pages web faites avec Sphinx)

Avertissement

Javascript est requis !

Cette page embarque des scripts écrits en javascript. À priori, cela devrait fonctionner sur n’importe quel navigateur assez récent, pour peu qu’il supporte javascript (et que javascript ne soit pas désactivé).

Note

Page de démos (faites et à faire)

Cette page est là pour montrer quelques démos supplémentaires à propos de Sphinx.

Quelques idées ou démos

Liens externes

L’extension sphinx.ext.extlinks permet de définir des rôles rST pour rapidement insérer un lien externe. Quelques exemples des alias définis dans mon conf.py :

Meilleur thème ?

Réduire les dépendances inutiles

Une extension Sphinx pour Youtube

Voici, par exemple, la première vidéo du concert du Trio ELM donné à l’ENS Cachan en 2014 :

Une expérimentation : ajouter facilement des couleurs en rST ?

J’utilise la balise .. raw:: html pour embarquer des définitions de rôles dans les fichiers .rst écrits pour ces pages webs, et ces rôles sont mis en relation avec des styles CSS définis dans .templates/layout.html le template Jinja qui contrôle l’apparence et le rendu de toutes mes pages produites avec Sphinx. C’est une question courante concernant Sphinx.

Notamment, les différentes couleurs suivantes sont disponibles : black gray silver white maroon red magenta fuchsia pink orange yellow lime green olive teal cyan aqua blue navy purple.

Ceci est rendu possible avec:

Liste des couleurs rajoutées :

  • la couleur black;

  • la couleur gray;

  • la couleur silver;

  • la couleur white (white);

  • la couleur maroon;

  • la couleur red;

  • la couleur magenta;

  • la couleur fuchsia;

  • la couleur pink;

  • la couleur orange;

  • la couleur yellow;

  • la couleur lime;

  • la couleur green;

  • la couleur olive;

  • la couleur teal;

  • la couleur cyan;

  • la couleur aqua;

  • la couleur blue;

  • la couleur navy;

  • la couleur purple.

Ajouté dans la version 1.4: Autres styles rajoutés :

  • souligné, avec :under:`texte`;

  • surligné, avec :over:`texte`;

  • barré, avec :line:`texte`;

  • italique, avec :it:`texte`;

  • oblique, avec :ob:`texte` (comme italique semble-t-il);

  • clignotant, avec :blink:`texte` (pas toujours supporté !).

Tests JavaScript avec TimeAgo

Affiche des dates avec un <abbr class="timeago"> :

Fin des écrits de l'ENS en MP* : 10 Mai 2011.

Valideurs CSS et HTML

Ajouté dans la version 1.5.

Deux liens vers les valideurs CSS et HTML du W3C étaient intégrés dans la barre latérale de chaque page.

Ils n’y sont plus, mais ils sont encore accessibles ici :

Une des deux images était codée en base64, pour essayer.

L’autre est :

_images/.valid-xhtml10.png

Résultats attendus :

  • aucune erreur sérieuse pour les feuilles CSS !

  • aucune erreur grave pour les pages XHTML 1.0 Transitional !

  • aucune erreur pour le flux RSS !

Avertissement

Mes pages ne sont plus correctes sémantiquement …

Aucunes pages ne passent désormais le test XHTML, à cause de bout de code écrits par des extensions non officielles de Sphinx (sphinx.ext.gnuplot par exemple).

Aucunes pages ne passent désormais le test CSS, à cause de la feuille buttons.css.

Mais j’y travaille ! J’essaie de nétoyer au mieux les modèles de pages, et le code de chaque pages. Dans ce but, tout retour est le bienvenu ! Le traqueur de bug est là pour ça : https://bitbucket.org/lbesson/web-sphinx/issues/new/.

D’autres ajouts

sphinx_git

Une liste des dernières modifications. Une liste plus complète peut-être consultée avec le flux rss.

  • Bug on the pages: by Lilian Besson at 2026-01-12 10:06:23

    - https://perso.crans.org/besson/resume-de-mon-annee-2025.html - https://perso.crans.org/besson/resume-de-mon-annee-2026.html

  • 2026 too by Lilian Besson at 2026-01-12 09:53:10

  • Almost finished summing up 2025. by Lilian Besson at 2026-01-12 09:45:50

  • :pencil: Merci à Matthieu G. pour cette typo trouvée si rapidement. by Lilian Besson at 2025-04-04 15:54:00

  • Remove the « Informations sur la pandémie de coronavirus, et comment elle m’affecte moi, et mes enseignements : veuillez consulter la page : coronavirus.fr.html, je la mets à jour deux fois par jour (à partir du 13/03/2020). » message. by Lilian Besson at 2025-03-17 07:46:01

  • Update header for main pages. by Lilian Besson at 2025-03-17 07:41:05

  • Update header for main pages. by Lilian Besson at 2025-03-17 07:40:59

  • Fixed https://perso.crans.org/besson/time.html by manually adding jquery.js, which was removed since recent updates in Sphinx (>= v8 ?). by Lilian Besson at 2025-03-17 07:12:34

  • Update homepage. by Lilian Besson at 2025-03-17 07:01:17

  • Update worked! by Lilian Besson at 2025-03-17 06:58:48

sphinxcontrib.bitbucket

Citation random !

Ajouté dans la version 1.8.

Cette ligne Bash affiche une citation aléatoire. Actuellement, ~/.quotes.txt est une liste (très) complète des meilleures citations de Kaamelott.

Cette liste est obtenue à partir des deux scripts suivants, depuis les données du superbe projet WikiQuote :

  • quotes.sh pour télécharger et analyser les citations,

  • makequotes.sh pour construire un fichier quotes.txt.