pasta マニュアル
Claudia et Anthony — à votre service


pasta のマニュアルへ、ようこそいらっしゃいまし。わたくし Claudia が、このマニュアルの案内役を務めますわ。
お嬢様にお仕えしております、執事のアンソニーでございます。失礼ながらお嬢様、ゴーストづくりが初めての方でも、読み通せるものでございましょうか。
ふふん、心配なさらなくてよろしくてよ。手順から文法、Lua の書き方まで、わたくしが最後まできっちりお付き合いいたしますもの。さあ、肩の力を抜いて、最初の一歩を踏み出しましょう。
pasta は、「伺か」のようなデスクトップマスコットを動かすための対話スクリプトエンジンである。 作者が書いた Pasta DSL の辞書を Lua にトランスパイルし、「ゴースト」の頭脳として動作させる。 本マニュアルは、ゴースト作者が pasta で辞書を書けるようになることを目的とした利用者向けガイドである。
Pasta DSL の文法・公開 Lua API・pasta.toml の設定について、利用者向けの権威的な記述は本マニュアルである。ほかの文書と記述が食い違う場合は、本マニュアルを正とする。
関連リンク
| リンク | 内容 |
|---|---|
| GitHub リポジトリ(ekicyou/pasta) | ソースコード・ビルド方法などの開発者向け情報。README も参照 |
このマニュアルが対象とするバージョン
| 項目 | 内容 |
|---|---|
| 対象 pasta バージョン | v0.6.2 |
| Lua 方言(ランタイム) | LuaJIT 2.1(Lua 5.1 系+有効化された拡張) |
| 対象プラットフォーム | Windows |
本マニュアルは、上表の版の pasta を対象として記述する。対象バージョンはリリースのたびに更新される。 これより古い版の pasta を使っている場合は、ダウンロードのページから 新しい版を入手すること。
ランタイムの Lua 方言は LuaJIT 2.1 である。これは Lua 5.1 系の言語仕様を基礎とし、
LuaJIT 独自の拡張(goto/ラベルや一部の 5.2 互換機能など)が有効化されたものである。
そのため、Lua のコードを書く際は Lua 5.1 系+ LuaJIT 拡張の文法・標準ライブラリを前提とすること。
バージョンの離れた Lua 5.5 等の他バージョンの仕様と混同しないよう注意する。外部 Lua リファレンスを
参照するときも、LuaJIT 2.1 / Lua 5.1 系に対応した資料を用いること(詳細は外部リンク集)。
安定機能と「将来変更あり」の区別について
本マニュアルは、現行の版で実装されている文法・API だけを記述する。まだ実装されていない機能や 実装予定の機能は記述しない。一方で pasta は開発が継続しており、現行の挙動のなかには将来の版で 変わり得る箇所もある。そうした箇所は本文中で次のように明示し、安定機能と視覚的・記述的に区別する。
⚠ 将来変更あり このように引用ブロックと「将来変更あり」の見出しを付した箇所は、現行の版で記述どおりに動作するが、 将来の版で挙動が変わる可能性がある。安定版として依存する前に、最新の情報を確認すること。
注記のない通常の本文は、現行の版で安定して利用できる機能として記述している。
準備はよろしくて? どこから読み始めても構いませんけれど、ゴーストづくりが初めてなら、まずは入門ガイドから順にお読みなさいな。
お嬢様は、皆さまが迷わぬようにと、昨晩から目次を何度も見直しておいででした。
な、なにを言っていますの! フンッ、別に、あなたのためを思って言っているわけではありませんわよ! ……さ、さあ、熱く参りましょう!
顔アイコン・意匠: ponapalt/claudia(Unlicense)/ 参考: ponadocs.shillest.net/claudia