外部リンク集
ごきげんよう。わたくし Claudia が、本書の外で頼りになる「権威ある書庫」への道筋をご案内いたしますわ。 迷子になっても大丈夫。困ったときに開くべき扉は、ここにすべてまとめてございますの。 さあ、心強い味方を手元に揃えて参りましょう。
本マニュアルは利用者向けの平易な派生物であり、厳密な定義や言語仕様そのものを再録しない。 判断に迷ったとき、あるいは本書の記述だけでは足りないときは、本章のリンクから一次資料に当たること。
リンクはすべて絶対 URL で記載する。本書の外部（GitHub・外部サイト）を指すため、相対パスでは到達できない。
Lua 言語リファレンス
Pasta のランタイムは LuaJIT 2.1 であり、言語仕様としては Lua 5.1 系に独自拡張を加えたものに相当する。 したがって素の Lua 言語仕様を参照する場合は、この方言に対応する資料を用いる。本書は言語仕様本体を取り込まず、以下のリンク参照のみを案内する。
日本語リファレンス（milkpot 版）
日本語で Lua 言語を確認したい場合は、milkpot 版のマニュアル和訳が読みやすい。ランタイム方言（Lua 5.1 系）に近い版を参照すること。
| 版 | 用途 | リンク |
|---|---|---|
| Lua 5.2 リファレンスマニュアル（日本語訳） | 5.1 から拡張された挙動の確認・索引用途 | http://milkpot.sakura.ne.jp/lua/lua52_manual_ja.html |
| Lua 5.1 リファレンスマニュアル（日本語訳） | ランタイム方言（Lua 5.1 系）の基準 | http://milkpot.sakura.ne.jp/lua/lua51_manual_ja.html |
LuaJIT 公式ドキュメント（英語）
LuaJIT 固有の拡張機能・標準ライブラリの差分・実装上の注意は、公式サイトが一次情報である。英語だが、ランタイムの実体に最も忠実な資料となる。
| 対象 | 用途 | リンク |
|---|---|---|
| LuaJIT 公式トップ | LuaJIT 全体の概要・各種ドキュメントの入口 | https://luajit.org/ |
| LuaJIT 拡張機能 | Lua 5.1 からの拡張（5.2/5.3 由来の機能取り込みなど）の一覧 | https://luajit.org/extensions.html |
不採用とする資料
| 資料 | 採否 | 理由 |
|---|---|---|
| Lua 5.5 系リファレンス（lua55-manual-ja 等） | 言語リファレンスとして不採用 | ランタイム（LuaJIT 2.1 ＝ Lua 5.1 系＋拡張）と方言が離れており、構文・標準ライブラリの差異が利用者の誤読を招くため |
Lua 5.5 系の資料は、版が離れているため本書の言語リファレンスとしては案内しない。 最新版の知識は LuaJIT 2.1 上では動作しない構文・関数を含むため、参照先として混在させないこと。
doc/spec — Pasta の権威的仕様
Pasta DSL の文法・処理系の挙動について、最終的な正しさの基準となるのは doc/spec/ である。
本マニュアルはこの仕様の利用者向け派生物であり、doc/spec/ を置き換えるものではない。記述が食い違う場合は doc/spec/ を正とする。
| 対象 | 用途 | リンク |
|---|---|---|
| doc/spec ディレクトリ（全体） | Pasta 仕様の入口・章一覧 | https://github.com/ekicyou/pasta/tree/main/doc/spec |
| 文法モデル | 字句・構文の全体像 | https://github.com/ekicyou/pasta/blob/main/doc/spec/01-grammar-model.md |
| マーカー一覧 | 全マーカー・演算子・区切り文字 | https://github.com/ekicyou/pasta/blob/main/doc/spec/02-markers.md |
| ブロック構造 | 行種別・グローバル／ローカルブロック・インデント | https://github.com/ekicyou/pasta/blob/main/doc/spec/03-block-structure.md |
| Call 仕様 | シーン呼び出し・前方一致・スコープ解決 | https://github.com/ekicyou/pasta/blob/main/doc/spec/04-call-spec.md |
| 変数 | 変数・スコープの厳密仕様 | https://github.com/ekicyou/pasta/blob/main/doc/spec/09-variables.md |
| 単語定義 | 単語・スコープ解決の共通仕様 | https://github.com/ekicyou/pasta/blob/main/doc/spec/10-words.md |
各文法章の末尾にも、対応する doc/spec/ 章への「権威的仕様」リンクを用意している。より深い定義が必要な場合は、そちらの導線も活用すること。
これで、もう怖いものはございませんわね。本書で道に迷っても、ここに戻れば一次資料へ一直線。 ……フンッ、別にあなたを心配しているわけではございませんわよ。 さあ、確かな足場を得たのですから、胸を張って制作へ戻りましょう！