ANSI出力
langを'ansi'に設定すると、文法でトークン化する代わりに、ANSIエスケープシーケンスを含むターミナル出力テキストをハイライトします。shikiphpはエスケープコードを解析し、テーマのANSIパレットから色を付けます。これはShikiのlang: 'ansi'トークナイザーの移植版であり、4つのオラクルシナリオでShiki 3.23.0とのHTMLを検証しています。
use Shikiphp\Shikiphp;
echo Shikiphp::codeToHtml("\e[31merror\e[0m: something broke", [
'lang' => 'ansi',
'theme' => 'github-dark',
]);
テストランナーやビルドログ、gitの出力など、取得したCLI出力を元の色のまま表示する自然な方法です。エスケープシーケンスは出力から取り除かれ、テキストだけが色付きスパンで囲まれます。
二重引用符で囲まれたPHP文字列に注意してください。"\e"はエスケープ文字です。プロセスから取得した出力（たとえばshell_execやproc_openを使う場合）を表示するとき、エスケープ文字はすでに文字列に含まれています。
対応する内容
トークナイザーはSGR（Select Graphic Rendition）シーケンスESC [ … mを読み取ります。;で区切られたコードは任意の個数を指定できます。
| コード | 効果 |
|---|---|
0 |
色と属性をすべてリセット |
1, 3, 4, 9 |
太字、斜体、下線、取り消し線 |
2 |
減光：前景色を半透明で描画 |
7 |
反転：前景色と背景色を入れ替え |
21, 23, 24, 27, 29 |
対応する属性をオフ |
22 |
通常の強度：減光と太字をオフ |
30–37, 90–97 |
前景色：標準8色と明るい8色 |
40–47, 100–107 |
背景色：標準8色と明るい8色 |
38;5;n, 48;5;n |
256色テーブルから前景色または背景色を指定 |
38;2;r;g;b, 48;2;r;g;b |
24ビットのトゥルーカラーで前景色または背景色を指定 |
39, 49 |
前景色または背景色をデフォルトに戻す |
非表示（8）と上線（53）は解析されますが、出力は変わりません。その他のコードは無視されます。ターミナルと同様に、スタイルはリセットされるまで改行を越えて引き継がれます。
色
名前付きの16色はテーマのterminal.ansi*カラーから取得されます（terminal.ansiRed、terminal.ansiBrightBlueなど）。テーマに定義がない場合は、VS Codeのデフォルトパレットが使われます（赤には#cd3131、青には#2472C8など）。色が設定されていないテキストにはテーマの前景色が使われ、ブロックの背景には文法ベースのハイライトと同様にテーマの背景色が使われます。256色テーブルの0〜15番目の項目は同じ16色で、16〜255番目の項目（6×6×6のカラ―キューブとグレースケールランプ）およびトゥルーカラー値はテーマに依存しません。
colorReplacementsはANSIカラーにも適用されます。
デュアルテーマ
ANSIは文法ベースのハイライトと同様にthemesマップに対応し、デフォルト以外のテーマではCSS可変のバリアントを出力します。
use Shikiphp\Shikiphp;
$log = "\e[32mPASS\e[0m tests/Unit\n\e[31mFAIL\e[0m tests/Integration";
echo Shikiphp::codeToHtml($log, [
'lang' => 'ansi',
'themes' => ['light' => 'github-light', 'dark' => 'github-dark'],
]);
名前付きの各色はテーマごとのパレットで解決されるため、ライトテーマの赤とダークテーマの赤は異なる場合があります。
文法状態なし
ANSIはTextMate文法を使用しないため、引き継ぐ文法状態はありません。
getLastGrammarStateはlang: 'ansi'に対して例外をスローし、codeToTokensResultは
null grammarStateを返します。