Langages

shikiphp intègre l'ensemble complet des langages Shiki : toutes les grammaires de tm-grammars 1.31.15, l'ensemble fourni par Shiki 3.23.0. Cela représente 235 langages, auxquels s'ajoutent 18 grammaires auxiliaires qu'ils intègrent, soit 253 grammaires au total. Ce sont les mêmes grammaires TextMate qu'utilisent VS Code et Shiki pour la tokenisation ; la couverture des langages, les alias et les noms de portée sont donc identiques.

Vous pouvez référencer un langage par son identifiant ou l'un de ses alias — par exemple ts ou typescript, js ou javascript, php, rust, python, html, yaml, json, etc. Les identifiants sont comparés à l'identique : utilisez-les donc en minuscules, comme indiqué ci-dessous. Si le bundle ne reconnaît pas un identifiant, il déclenche Shikiphp\Exceptions\Highlight avec le message Unknown language "…".

L'identifiant spécial 'ansi' n'est pas une grammaire ; il met en évidence la sortie du terminal. Consultez ANSI.

Les identifiants en texte brut de Shiki text, txt, plain et plaintext ne sont pas encore pris en charge et déclenchent Unknown language (#2).

Répertorier les langages intégrés

Depuis PHP, interrogez le surligneur syntaxique :

use Shikiphp\Shikiphp;

$highlighter = Shikiphp::highlighter();

$highlighter->bundledLanguages(); // list<string> — ids shipped in the box
$highlighter->loadedLanguages();  // list<string> — bundled plus any you registered

Les deux listes contiennent tous les identifiants résolus : ceux des grammaires 253, suivis des 97 alias, soit 350 entrées pour le bundle.

Ou depuis la ligne de commande, avec un identifiant par ligne :

vendor/bin/shikiphp langs

Catalogue

Les langages 235 intégrés, triés par nom. Tout identifiant ou alias d'une ligne sélectionne la même grammaire.

Grammaires auxiliaires

Ces 18 grammaires permettent à d'autres grammaires de les intégrer ou d'injecter leur contenu (Angular, Vue, macros C++, Jinja, Nix et littéraux de gabarit balisés dans ts-tags). Elles sont chargées automatiquement avec le langage qui en a besoin, et leurs identifiants figurent aussi dans bundledLanguages() et shikiphp langs :

angular-expression, angular-let-declaration, angular-template, angular-template-blocks, angular-inline-style, angular-inline-template, cpp-macro, jinja-html, markdown-nix, es-tag-css, es-tag-glsl, es-tag-html, es-tag-sql, es-tag-xml, markdown-vue, vue-directives, vue-interpolations, vue-sfc-style-variable-injection.

Ajouter les vôtres

Vous avez besoin d'un langage qui n'est pas fourni ou d'une grammaire privée ? Enregistrez-le avec loadGrammar. Consultez Langages et thèmes personnalisés.