Syntax-highlighting Code Block (with Server-side Rendering)
Cette extension étend le bloc Code dans le cœur de WordPress pour ajouter la coloration syntaxique, laquelle rendue sur le serveur. Les blocs Code préexistants sur un site sont automatiquement étendus pour inclure la coloration syntaxique. La mise en évidence de la syntaxe côté serveur élimine le besoin de mettre en file d’attente tout JavaScript sur l’interface publique (par exemple Highlight.js ou Prism.js) et cela garantit qu’il y aucun flash de code non mis en évidence (FOUC ?). La réduction du nombre de scripts sur l’interface publique améliore les performances de ce dernier et permet également au code mis en évidence par la syntaxe d’apparaître correctement dans les pages AMP telles qu’elles sont rendues par l’extension AMP officiel (voir également ampproject/amp-wp#972) ou lorsque JavaScript est inactif dans le navigateur.
Ce bloc Code étendu utilise la détection automatique du langage pour ajouter la coloration syntaxique, mais vous pouvez surcharger le langage dans la colonne latérale des réglages du bloc (il n’y a actuellement aucune mise en évidence de la syntaxe du bloc Code dans l’éditeur, mais voyez #8). L’extension prend en charge tous les langages de programmation que highlight.php prend en charge (étant un portage de highlight.js). Le bloc Code est également étendu pour prendre en charge la spécification des lignes à mettre en évidence qui sont marquées par des éléments mark (y compris dans les flux RSS). Une case à cocher permet également d’afficher ou non les numéros de ligne sur l’interface publique (les numéros n’étant pas sélectionnables). Enfin, étant donné les incohérences entre les thèmes quant à savoir si les lignes d’un bloc Code doivent être renvoyées à la ligne, cette extension ajoute un style pour les forcer à ne pas utiliser de retour chariot par défaut, avec une case à cocher pour opter pour forcer le retour à la ligne si vous le souhaitez.
Pour une utilisation avancée, veuillez consulter le wiki de l’extension.
Cette extension est développée sur GitHub. Voir la liste des problèmes actuels avec l’extension. N’hésitez pas à nous faire part de tout problème ou demande supplémentaire que vous pourriez rencontrer. Les pull requests sont les bienvenues. Voir les informations sur la contribution.
Crédits
C’est un fork de Code Syntax Block par Marcus Kazmierczak (mkaz), qui est également disponible sur WordPress.org. Copyright (c) 2018 Marcus Kazmierczak. Sous licence GPL 2.0 ou ultérieure.
highlight.php est publié sous la licence BSD 3-Clause. Copyright © 2006-2013, Ivan Sagalaev (maniac@softwaremaniacs.org), highlight.js (auteur original). Copyright © 2013, Geert Bergman (geert@scrivo.nl), highlight.php