Description
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
Captures d’écrans
Les blocs de code peuvent être ajoutés comme d’habitude, en surchargeant éventuellement la langue détectée automatiquement. Indiquez également les lignes à mettre en évidence, si les numéros de lignes doivent être affichés et si les lignes doivent avoir des retours à la ligne. Le bloc Code s’affiche avec une mise en évidence de la syntaxe sur l’interface publique sans qu’aucun JavaScript ne soit mis en file d’attente. Les feuilles de style ne sont ajoutées que lorsque le bloc est sur la page.
Avis
Contributeurs/contributrices & développeurs/développeuses
« Syntax-highlighting Code Block (with Server-side Rendering) » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
Contributeurs“Syntax-highlighting Code Block (with Server-side Rendering)” a été traduit dans 9 locales. Remerciez l’équipe de traduction pour ses contributions.
Traduisez « Syntax-highlighting Code Block (with Server-side Rendering) » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal des modifications
Pour le journal des modifications de l’extension, veuillez consulter la page des Modifications sur GitHub.