Utilisation concrète de JavaScript (pour des pages générées avec Sphinx)¶
À-propos¶
Cette page décrit les divers scripts JavaScript stockés dans le dépôt web-sphinx-scripts.
Mais elle décrit aussi chaque utilisation de JS pour des fonctionnalités dans certaine des pages de ce site.
Liste des utilisations de JS¶
Utilisation intelligente de Google Analytics (un seul script pour des pages hébergées sur plusieurs serveurs différents),
Pour ajouter des
alert
dans gnuplot.html, ocaml.fr.html ou encore python.html,Pour embarquer un graphique de progression de la traduction de Bitbucket.org sur transifex.fr.html et transifex.en.html,
Pour embarquer un fichier hébergé sur Bitbucket dans bitbucket-features.fr.html,
Pour tester des choses dans avoir.html,
Pour les terminaux dans try-ocaml.html, skulpt.html, python.html, gnuplot.html et gnuplot_embed.html.
Pour afficher la qualité de l’air à Paris dans plume-air-paris.fr.html,
J’ai supprimé ces autres fonctionnalités en décembre 2017 pour adopter un style plus léger.
(supprimé) Pour déterminer quel serveur est utilisé (afin d’afficher en bas l’image de NGinx ou d’Apache HTTPD),
(supprimé) Pour embarquer SquirtFR, via le raccourcis clavier « q »,
(supprimé) Pour le changement de style, via le raccourcis clavier « s », pour changer le style de couleur (violet, orange, ou vert),
Liste des scripts du dépôt¶
Pas les miens¶
jQuery, la célèbre librairie JS. Incluse par défaut par Sphinx (pour la gestion de la barre latérale et d’autres trucs).
ace, un éditeur de texte en JS, intégré aux toplevels Python (python.html et skulpt.html) ou en solo (ace.html).
gnuplot.js et gnuplot_api.js pour le terminal GNUPlot embarqué.
skulpt.js et python.js pour les terminaux Python embarqués (skulpt.html et python.html).
toplevel.js et try-ocaml pour les terminaux OCaml embarqués (ocaml.fr.html et try-ocaml.fr.html).
(supprimé) mousetrap.min.js pour définir des raccourcis clavier (Allez-y, essayez ! Appuyez sur “h” ou “i” ou “→” ou “←” ou “n” ou “p”, ou “u” par exemple).
Les plugins jQuery¶
jquery.scrollUp.min.js pour ajouter un bouton pour remonter au sommet de la page, dans la barre latérale (en bas à gauche !),
jquery.smooth-scroll.min.js pour permettre le défilement fluide lors du clic d’un lien interne à une page,
(supprimé) jquery.timeago.js pour afficher la date de dernier changement via le raccourcis clavier « u ».
Pas les miens mais adaptés¶
horloge.js pour time.html,
(supprimé) simpleimagetrail.js (désactivé par défaut),
(supprimé) nprogress.js et nprogress.ccs pour afficher une barre de progression dans le bas de la page (en cyan),
(supprimé) forkit.js (la bannière « Sur Bitbucket? » qui bouge en haut à droite, désactivé désormais) et fokus.min.js (la page donne le focus lors de la sélection d’un élément désactivé désormais) viennent de hakim.se. Merci à lui !
Les miens¶
(supprimé) referrer.js utilisé par les pages de gestions d’erreur (404.html ou 403.html) pour éventuellement afficher des messages d’informations,
(utilisé pour les dossiers) StrapDown.js un compilateur Markdown > HTML,
(utilisé pour les dossiers) SquirtFR un signapplet pour lire rapidement une page web.