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.

Nouveau 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

Nouveau 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.

  • Finally using a virtualenv/ to build this website… by Lilian Besson at 2024-03-25 09:56:03

  • Magic judge: j’ai adoré arbitré hier ce joli tournoi de 42 joueurs. by Lilian Besson at 2024-03-25 09:30:31

  • PGP/GPG: outdated. by Lilian Besson at 2024-02-24 17:37:10

  • Update index, callme, mes-outils-preferes by Lilian Besson at 2024-02-24 17:29:56

  • Typos and add magic-judge.fr.rst to index.fr.rst by Lilian Besson at 2024-02-24 17:05:58

  • Maaaagic by Lilian Besson at 2024-02-24 16:55:44

  • Mon expérience naissante en tant que Judge Magic. by Lilian Besson at 2024-02-24 16:39:39

  • Résumé 2023, 2024. by Lilian Besson at 2024-02-24 15:52:59

  • Résumé 2023 fini, résumé 2024 presque fini. by Lilian Besson at 2024-02-17 13:12:23

  • https://worldofwarcraft.blizzard.com/fr-fr/character/eu/khaz-modan/Nooreen by Lilian Besson at 2023-11-24 13:20:31

sphinxcontrib.bitbucket

Citation random !

Nouveau 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.