Sprachen

shikiphp enthält das vollständige Shiki-Sprachpaket: alle Grammatiken aus tm-grammars 1.31.15, also genau jene, die in Shiki 3.23.0 enthalten sind. Das sind 235 Sprachen und 18 eingebettete Hilfsgrammatiken, insgesamt also 253 Grammatiken. Es handelt sich um dieselben TextMate-Grammatiken, die VS Code und Shiki zum Tokenisieren verwenden. Daher stimmen Sprachabdeckung, Aliase und Scope-Namen überein.

Du kannst eine Sprache über ihre ID oder einen Alias angeben — zum Beispiel ts oder typescript, js oder javascript, php, rust, python, html, yaml, json und so weiter. IDs werden exakt abgeglichen. Verwende sie daher wie unten aufgeführt in Kleinbuchstaben. Ist eine ID dem Paket unbekannt, wird Shikiphp\Exceptions\Highlight mit der Meldung Unknown language "…" ausgelöst.

Die spezielle ID 'ansi' ist keine Grammatik, sondern hebt Terminalausgaben hervor. Siehe ANSI.

Shikis IDs für Klartext text, txt, plain und plaintext werden noch nicht unterstützt und lösen Unknown language aus (#2).

Mitgelieferte Sprachen auflisten

Frage den Highlighter unter PHP ab:

use Shikiphp\Shikiphp;

$highlighter = Shikiphp::highlighter();

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

Beide Listen enthalten alle IDs, die aufgelöst werden: die 253 Grammatik-IDs gefolgt von den 97 Aliasen, insgesamt 350 Einträge im Paket.

Oder über die Befehlszeile, eine ID pro Zeile:

vendor/bin/shikiphp langs

Katalog

Die 235 mitgelieferten Sprachen, nach Namen sortiert. Jede ID und jeder Alias in einer Zeile verweist auf dieselbe Grammatik.

Hilfsgrammatiken

Diese 18 Grammatiken ermöglichen es anderen Grammatiken, sie einzubetten oder zu injizieren (Angular, Vue, C++-Makros, Jinja, Nix und getaggte Template-Literale in ts-tags). Sie werden automatisch mit der Sprache geladen, die sie benötigt. Ihre IDs erscheinen außerdem in bundledLanguages() und 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.

Eigene hinzufügen

Brauchst du eine Sprache, die nicht enthalten ist, oder eine private Grammatik? Registriere sie mit loadGrammar. Siehe Benutzerdefinierte Sprachen und Themes.