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.

  • I’ve finally seen « Raya and the last Dragon », it’s an awesome movie. by Lilian Besson at 2021-08-24 11:35:12

  • Change this fake sentence about my randomizer and its consequences. by Lilian Besson at 2021-08-09 23:11:42

  • Résumé avril/mai 2021. by Lilian Besson at 2021-08-04 18:06:22

  • .. by Lilian Besson at 2021-05-06 01:16:46

  • A faire aavnt 30 ans. by Lilian Besson at 2021-05-06 01:13:52

  • oh oh okay, so three critical failures on Friday 2021-04-16 @01:42. How unlikely? Let’s go full random, NOW. MATLAB:tic() by Lilian Besson at 2021-04-18 15:22:26

  • Lots by Lilian Besson at 2021-04-18 15:22:01

  • Twitch.tv/Naereen was for video-games and Pokémon only. by Lilian Besson at 2021-04-18 15:20:55

  • oh oh okay, so three critical failures on Friday 2021-04-16 @01:42. How unlikely? Let’s go full random, NOW. MATLAB:tic() by Lilian Besson at 2021-04-18 15:20:29

  • Lots of awesome Jazz players, most of whom I saw in person when the concert was accessible enough. by Lilian Besson at 2021-04-18 15:19: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 :
“Vous vous rendez compte que vous amenez des boucs dans ma chambre?” -- Caroline 
Pascal, Kaamelott , Livre II, 45: Le Cadeau , écrit par Alexandre Astier.