Utilisation concrète de JavaScript (pour des pages générées avec Sphinx)

À-propos

Cette page est là pour décrire les divers scripts JavaScript stockés dans le dépôt web-sphinx-scripts.

Mais aussi pour décrire chaque utilisation de JS pour de nombreuses petites fonctionnalités dans chacune des pages (afficher une information différente selon la localisation de la page ou encore afficher la résolution d'écran utilée pour afficher, par exemple).

Liste (non exhaustive) des autres utilisations de JS

Utilisation intelligente de Google Analytics (un seul script pour des pages hébergées en plusieurs endroits),
Pour afficher le nom de la page dans la barre supérieure,
Pour déterminer quel serveur est utilisé (afin d'afficher l'image de NGinx ou d'Apache) en bas,
Pour ajouter des alert dans gnuplot.html, ocaml.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 embed.html,
Pour un test dans sparkline.html,
Pour embarquer SquirtFR, via le raccourcis clavier "q",
Pour le changement de style, via le raccourcis clavier "s", pour changer le style de couleur (violet, orange, ou vert),
Pour tester des choses dans avoir.html,
Et pour plein d'autres choses, ce n'est pas toujours facile de garder une liste à jour ici.

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). Simplement mise à jour !
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.html et try-ocaml.html).
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,
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,
simpleimagetrail.js (désactivé par défaut),
nprogress.js et nprogress.ccs pour afficher une barre de progression dans le bas de la page (en :cyan:`cyan`),
forkit.js (la bannière "Sur Bitbucket?" qui bouge en haut à droite, :red:`désactivé désormais`) et fokus.min.js (la page donne le focus lors de la sélection d'un élément :red:`désactivé désormais`) viennent de hakim.se. Merci à lui !

Les miens

referrer.js utilisé par les pages de gestions d'erreur (404.html ou 403.html) pour éventuellement afficher des messages d'informations,
StrapDown.js un compilateur Markdown > HTML,
SquirtFR un signapplet pour lire rapidement une page web.

Et plein d'autres

Et encore plein d'autres que j'oublie de lister ici... La flemme !