Jazyky

shikiphp obsahuje úplnou sadu jazyků Shiki: všechny gramatiky z tm-grammars 1.31.15, tedy sadu, kterou distribuuje Shiki 3.23.0. Jde o 235 jazyků a 18 pomocných gramatik, které vkládají, celkem 253 gramatik. Jsou to stejné gramatiky TextMate, s nimiž pracují VS Code a Shiki, takže pokrytí jazyků, aliasy i názvy rozsahů odpovídají.

Na jazyk odkazujete pomocí jeho ID nebo aliasu — například ts či typescript, js či javascript, php, rust, python, html, yaml, json a další. ID se porovnávají přesně, proto je používejte malými písmeny, jak jsou uvedena níže. Neznámé ID vyvolá Shikiphp\Exceptions\Highlight se zprávou Unknown language "…".

Speciální ID 'ansi' není gramatika; zvýrazňuje výstup terminálu. Viz ANSI.

Textová ID text, txt, plain a plaintext z Shiki zatím nejsou podporována a vyvolají Unknown language (#2).

Výpis jazyků obsažených v balíčku

Ve vrstvě PHP se zeptejte zvýrazňovače:

use Shikiphp\Shikiphp;

$highlighter = Shikiphp::highlighter();

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

Oba seznamy obsahují všechna ID, která lze rozpoznat: ID gramatik 253 a po nich 97 aliasů; celkem 350 položek z balíčku.

Nebo z příkazového řádku, jedno ID na řádek:

vendor/bin/shikiphp langs

Katalog

Jazyky 235 obsažené v balíčku, seřazené podle názvu. Každé ID nebo alias v řádku vybere stejnou gramatiku.

Pomocné gramatiky

Těchto 18 gramatik slouží k tomu, aby je jiné gramatiky mohly vkládat nebo vkládat jako injekci (Angular, Vue, makra C++, Jinja, Nix a tagované šablonové literály v ts-tags). Načítají se automaticky s jazykem, který je potřebuje, a jejich ID se také objevují v bundledLanguages() a 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.

Přidání vlastních

Potřebujete jazyk, který není součástí balíčku, nebo soukromou gramatiku? Zaregistrujte ji pomocí loadGrammar. Viz Vlastní jazyky a motivy.