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.

  • 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

  • Link to my current WoW character: https://www.easyarmory.com/profile/nooreen-khaz%20modan-eu by Lilian Besson at 2023-11-24 13:15:50

  • résumé 2023: Magic, WoW, des copies à corriger, etc. by Lilian Besson at 2023-11-18 22:14:20

  • Typos et petits rajouts, relecture quasi complète du site. by Lilian Besson at 2023-10-11 17:32:30

  • Typo update situations administratives. by Lilian Besson at 2023-08-29 13:15:48

  • Résumé de mon année 2023 : bien avancée. by Lilian Besson at 2023-08-27 12:24:52

  • Update address: now back in Lycée Kléber in Strasbourg. by Lilian Besson at 2023-08-27 12:22:52

  • https://coryd.dev/posts/2023/i-block-ads/ by Lilian Besson at 2023-05-30 12:15:35

  • CIV is in Valbonne, not Strasbourg. by Lilian Besson at 2023-05-29 21:44:38

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.

$ echo -e "Citation aléatoire :" ; shuf /home/lilian/.quotes.txt 2>/dev/null | head -n 1 | fold -s -w 90
Citation aléatoire :
“Subotaï: Je n'ai pas mangé depuis des jours. Conan: Pourquoi mangerais-tu 
maintenant?” -- Gerry Lopez, Arnold Schwarzenegger, Conan le Barbare (1982), écrit par 
John Milius et Oliver Stone