Repository navigation
VSCode 拡張 v0.4.2 — 日本語と英語で使えるようにする
日本語と英語のどちらでも使えるようにしました。 既定は日本語のままで、日本語の出力は 1 文字も変わりません。
切り替え方
| 入口 | やり方 |
|---|---|
| VSCode | 設定 pli.language(auto / ja / en)。既定の auto は VSCode の表示言語に合わせます |
| ブラウザ版 | 画面上部の言語の選択(書いていた内容は残ります) |
| CLI | --lang ja|en、または環境変数 PLI_LANG |
npm run pli -- examples/tests/arith_test.pli --lang en
PLI_LANG=en npm run plitest -- examples/tests環境の言語には追従しません。 LANG もブラウザの言語設定も見ません。同じコマンド・同じ URL が機械の設定で違う言葉を出すと、出力を固定したテストも画面の説明も成り立たなくなるためです。
VSCode のコマンド名(「PL/I: 実行」など)と設定の説明だけは VSCode 自身の仕掛け(package.nls.json / package.nls.en.json)で決まるので、VSCode の表示言語に従います。既定の auto なら両者が揃います。
何が英語になるか
実行時のメッセージ・診断・Linter の指摘・テストの報告・画面(MFS)の表示・Snippet の名前と説明・ブラウザ版のサンプル名とその中の注釈・CLI の使い方。合わせて 784 件の文字列です。
line 3: Only a pointer can be assigned to a pointer
tests 12 / passed 12 / failed 0 / errors 0 / skipped 0 / 52ms
line 2: unused is declared but not used. [unused-variable]
ついでに直した不具合
いずれも英語で動かさないと表に出ないものです。
| 何が起きていたか | |
|---|---|
| 実行時エラーの行の接頭辞 | RuntimeError が 3行: をメッセージに埋め、受け取る側が正規表現で剥がしていました。接頭辞は言語で形が変わるので、英語では剥がし損ねて診断に二重に出ます。行は例外の属性から取るようにしました |
| ブラウザ版の大きさの検査 | 「素のバイト数で見る」と書きながら UTF-16 の単位で測っており、304KB を 261KB と見ていました。バイト数で測るよう直しています |
engine/web/README.md |
「端末」の説明が「無限ループ対策」の節に紛れていました |
文書
英語版を追加しました。README.en.md / docs/en/(ブラウザ・VSCode・テスト・Linter・DL/I・MFS)/ engine/README.en.md。
どう担保しているか
訳は日本語の文そのものを鍵にして engine/src/i18n/en.ts に置き、TypeScript の構文木から鍵を集めて検査しています。m で包み忘れた日本語(差し込みの中の裸の文字列も)、訳の抜け、使われなくなった鍵、差し込みの数の不一致、そして英語で実際に走らせて英語で出ることまでテストが見ます。
既存の日本語のテストは書き換えていません。日本語のときは素の文字列連結と完全に同じものを返すので、日本語を直接見ている 167 箇所の表明がそのまま安全網になります。
engine 1174 件 / vscode-pli 96 件が緑です。
インストール
下の pli-lang-0.4.2.vsix を落として、VSCode の拡張ビュー → 右上の … → 「VSIX からのインストール」。code コマンドが使えるなら:
code --install-extension pli-lang-0.4.2.vsixこの vsix は GitHub Actions がビルドしたものです(手元のビルドは配っていません)。