توضیح
PGN مخفف Portable Game Notation و قالبی متنی برای ثبت بازیهاست. فرمان تعبیهشده PGN دادهای قابلخواندن برای نرمافزار میافزاید و در عین حال با خوانندههایی که فقط توضیحات معمولی را میشناسند سازگار میماند. این فرمان درون توضیح آکولادی و مطابق قرار میگیرد. شکل کلی با [% آغاز میشود، با نام فرمان و پارامترهای آن ادامه مییابد و با ] پایان میگیرد.
در {[%clk 1:05:23]}، clk نام فرمان و 1:05:23 پارامتر آن است. متممی که این قرارداد را مستند میکند، clk را برای ثبت نمایش ساعت پس از یک حرکت پیشنهاد میدهد و چند فرمان دیگر مربوط به زمان را نیز شرح میدهد.
این قرارداد از متممی با وضعیت پیشنویس نهایی میآید، نه از مشخصات اصلی و اولیه PGN. آن متمم عمداً یک فهرست جهانی از همه فرمانهای ممکن تحمیل نمیکند. بنابراین قابلیت همکاری به این بستگی دارد که تولیدکننده و خواننده معنای یکسانی به نام فرمان بدهند.
نرمافزاری که فرمانی را نمیشناسد باید آن را بدون تغییر، بهعنوان بخشی از توضیح، حفظ کند. این با تفاوت دارد، زیرا جفت برچسب داده توصیفی را در بخش آغازین بازی ذخیره میکند، نه درون توضیحی مرتبط با حرکتها.
اشتباههای رایج
فرمان تعبیهشده در برابر PGN اصلی
شکل [%command ...] در یک متمم مستند شده و داخل توضیحات معتبر PGN قرار میگیرد، اما بخشی از مشخصات اصلی اولیه نیست.
فرمان تعبیهشده در برابر جفت برچسب
فرمان داخل توضیح متن حرکتها قرار دارد. جفت برچسب در سربرگ است و کل بازی را توصیف میکند.
مشاهده اصطلاحمنابع
- 1.Standard: Portable Game Notation Specification and Implementation Guide (Supplement), Alan Cowderoy et al. / pgn-spec-commented
- 2.Standard: Portable Game Notation Specification and Implementation Guide, Steven J. Edwards / ChessGML
