תבנית:Pgn/תיעוד

תבנית זו מיועדת להצגת משחקי שחמט בעזרת שימוש בפורמט PGN ‏(Portable Game Notation). ניתן להציג עד 40 משחקים בעזרת תבנית אחת.

השימוש בתבנית:

{{pgn
|1=משחק בפורמט PGN
|2=משחק שני בפורמט PGN (אופציונלי)
|3=
|... וכן הלאה, עד לכל היותר 
|40=
}}

פרמטרים אופציונליים:

• ממוזער=. אם מוצג פרמטר זה עם ערך כלשהו (נהוג להשתמש בערך "כן", אבל למעשה כל ערך לא ריק מתפקד באותו האופן), הלוח לא יוצג, ובמקומו יופיע כפתור "הצג" בלבד.
• גודל גודל המשבצת, בפיקסלים. ברירת מחדל: 35. ערך מינימלי - 20, מקסימלי - 60
• הסתרה כל ערך לא ריק לפרמטר יגרום להצגת כפתור "הסתרה", שמאפשר לקורא "לקפל" את הלוח
• מוסתר כל ערך לא ריק לפרמטר יגרום להצגה במצב מוסתר, עם כפתור "הצגה". במילים אחרות, כמו פרמטר "הסתרה", כאילו הקורא כבר לחץ על הכפתור.
• ממוזער זהה לפרמטר "מוסתר". נתמך לטובת תאימות לאחור.

יש לשים לב, אם ה-pgn מכיל את התו | ("באר אנכי"), יש להחליפו ב {{!}}.

להסבר על פורמט PGN אפשר לקרוא בערך בוויקיפדיה האנגלית: Portable Game Notation.

יש מספר תגי PGN לא סטנדרטיים, שהתבנית מתייחסת אליהם באופן מיוחד (התגים הם Case sensitive, כלומר אי אפשר להשתמש ב-name או NAME במקום Name):

• Direction: אם מופיע תג זה עם ערך "rtl", הפרטים יוצגו בראש המשחק מימין לשמאל (כמו בדוגמה למטה, ב"משחק גומלין")
• Name: אם מופיע פרמטר זה, זה יהיה הטקסט שמוצג עבור אותו משחק בתפריט במקרה והתבנית מכילה יותר ממשחק אחד. אם הפרמטר לא מוצג, התבנית בונה את שם המשחק על ידי שירשור שם האירוע (Event), ושמות השחקנים.
• FirstMove: אם מופיע תג זה, המושחק יוצג במצב הלוח לאחר המסע הזה. אם הפרמטר לא מופיע, יוצג הלוח בסיום המשחק. הערך של התג צגיך להופיע במספר ואחריו האות l או d. למשל, כדי שהלוח יוצג במצבו לאחר המסע ה-21 של השחור, יש להוסיף את התג [FirstMove "21d", וכדי להציג את הלוח לאחר המסע השביעי של הלבן - [FirstMove "7l" (שימו לב שמדובר באות הלטינית L קטנה, כלומר l, ולא בספרה 1)

מגבלות

סטנדרט PGN מאפשר להציג הערות משולבות בין המסעים. הסטנדרט מאפשר לסמן את ההערות בשתי דרכים: בעזרת נקודה-פסיק (ההערה נמשכת עד לסוף השורה), או בעזרת זוג סוגריים מסולסלים. התבנית תומכת רק בסוגריים מסולסלים. גוף ההערה יכול להיות גם בעברית, אך לא ניתן להשתמש בתגי HTML.

בהצגת המשחק, הערה שמופיעה כחלק מרשימת המסעים תוצג באופן זה: כך תיראה הערה בין המסעים במשחק.

בגלל שרשימת המסעים כתובה משמאל לימין, הערה בעברית עלולה להראות קטועה בצורה משונה אם היא מתפרסת על מספר שורות. אם כוללים כחלק מההערה בעברית תבנית {{כ}}, ההערה תופיע כפסקה נפרדת, הכתובה מימין לשמאל.

דוגמה

לנוחיות הקריאה, קוד הוויקי מוצג משמאל לימין. (ראו גם עזרה:קיצורי דרך במצב עריכה). המשחק הראשון עושה שימוש בתגים המיוחדים שם, Direction ו-FirstMove, כך שהתאור מוצג מימין לשמאל, שם המשחק בתפריט מופיע כ"משחק גומלין", והלוח מוצג כפי שנראה אחרי המסע ה-33 של השחור. במשחק השני בדוגמה לא נעשה שימוש בתגים המיוחדים הללו, והוא מוצג בעזרת ברירות המחדל: יישור לשמאל, שם המשחק בתפריט הוא שרשור של ה-Event ושמות השחקנים, והלוח מוצג כפי שנראה בסוף המשחק.

קוד הויקי של שני משחקי שחמט בפורמט pgn

{{pgn |ממוזער=כן |כותרת=שני משחקי שחמט |1= [Direction "rtl"] [שם "משחק גומלין"] [אתר "Belgrade, Serbia Yugoslavia{{!}}JUG"] [תאריך "1992.11.04"] [סיבוב "29"] [לבן "פישר"] [שחור "ספסקי"] [תוצאה "1/2-1/2"] [FirstMove "33d"] 1. e4 e5 2. Nf3 Nc6 3. Bb5 {This opening is called the Ruy Lopez.} 3... a6 4. Ba4 Nf6 5. O-O Be7 6. Re1 b5 7. Bb3 d6 8. c3 O-O 9. h3 Nb8 10. d4 Nbd7 11. c4 c6 12. cxb5 axb5 13. Nc3 Bb7 14. Bg5 b4 15. Nb1 h6 16. Bh4 c5 17. dxe5 Nxe4 18. Bxe7 Qxe7 19. exd6 Qf6 20. Nbd2 Nxd6 21. Nc4 Nxc4 22. Bxc4 Nb6 23. Ne5 Rae8 24. Bxf7+ Rxf7 25. Nxf7 Rxe1+ 26. Qxe1 Kxf7 27. Qe3 Qg5 28. Qxg5 hxg5 29. b3 Ke6 30. a3 Kd6 31. axb4 cxb4 32. Ra5 Nd5 33. f3 Bc8 34. Kf2 Bf5 35. Ra7 g6 36. Ra6+ Kc5 37. Ke1 Nf4 38. g3 Nxh3 39. Kd2 Kb5 40. Rd6 Kc5 41. Ra6 Nf2 42. g4 Bd3 43. Re6 1/2-1/2 |2= [Event "approx"] [Site "Europe"] [Date "1625.??.??"] [Round "?"] [White "Greco, Gioacchino"] [Black "Analysis\ Analyse"] [Result "1-0"] [ECO "C54"] 1. e4 e5 2. Nf3 Nc6 3. Bc4 Bc5 4. c3 Nf6 5. d4 exd4 6. cxd4 Bb4+ 7. Nc3 Nxe4 8. O-O Nxc3 9. bxc3 Bxc3 10. Qb3 {Greco invented free play with the pieces. Free pieces will win: free diagonals for the bishops, free files for the rooks!! Greco propagiert in seinen veröffentlichten Übungsbeispielen das Spiel mit den Figuren. Die Kraft der langschrittigen Läufer und Türme zu demonstrieren, lag ihm besonders am Herzen.} Bxa1 {Black is intent on winning by capturing more material. Der Schwarze ist auf Beraubungssieg aus.} 11. Bxf7+ {White is aiming for mate. Der Weiße will matt setzten.} Kf8 12. Bg5 Ne7 13. Ne5 Bxd4 { Black tries to capture as much as possible, and White tries to mate.} 14. Bg6 { aha! If the king has not yet castled, the weakest square is always f7. Hat der König noch nicht rochiert, ist das schwächste Feld immer f7.} d5 {He is still defending. Er wehrt sich noch.} 15. Qf3+ {No mate, but..} Bf5 16. Bxf5 Bxe5 17. Be6+ Bf6 18. Bxf6 Ke8 {18... gxf6 19. Qxf6+ Ke8 20. Qf7#} 19. Bxg7 { Powerful bishops, discovered by Greco. This sample game is an impressive demonstration of the power of well developed bishops. Dieses Übungsbeispiel demonstriert eindrucksvoll die Kraft der frei entfalteten Läufer.} 1-0 }}

והתוצאה:

[Direction "rtl"] [שם "משחק גומלין"] [אתר "Belgrade, Serbia Yugoslavia|JUG"] [תאריך "1992.11.04"] [סיבוב "29"] [לבן "פישר"] [שחור "ספסקי"] [תוצאה "1/2-1/2"] [FirstMove "33d"]

1. e4 e5 2. Nf3 Nc6 3. Bb5 {This opening is called the Ruy Lopez.} 3... a6 4. Ba4 Nf6 5. O-O Be7 6. Re1 b5 7. Bb3 d6 8. c3 O-O 9. h3 Nb8 10. d4 Nbd7 11. c4 c6 12. cxb5 axb5 13. Nc3 Bb7 14. Bg5 b4 15. Nb1 h6 16. Bh4 c5 17. dxe5 Nxe4 18. Bxe7 Qxe7 19. exd6 Qf6 20. Nbd2 Nxd6 21. Nc4 Nxc4 22. Bxc4 Nb6 23. Ne5 Rae8 24. Bxf7+ Rxf7 25. Nxf7 Rxe1+ 26. Qxe1 Kxf7 27. Qe3 Qg5 28. Qxg5 hxg5 29. b3 Ke6 30. a3 Kd6 31. axb4 cxb4 32. Ra5 Nd5 33. f3 Bc8 34. Kf2 Bf5 35. Ra7 g6 36. Ra6+ Kc5 37. Ke1 Nf4 38. g3 Nxh3 39. Kd2 Kb5 40. Rd6 Kc5 41. Ra6 Nf2 42. g4 Bd3 43. Re6 1/2-1/2

[Event "approx"] [Site "Europe"] [Date "1625.??.??"] [Round "?"] [White "Greco, Gioacchino"] [Black "Analysis\ Analyse"] [Result "1-0"] [ECO "C54"]

1. e4 e5 2. Nf3 Nc6 3. Bc4 Bc5 4. c3 Nf6 5. d4 exd4 6. cxd4 Bb4+ 7. Nc3 Nxe4 8. O-O Nxc3 9. bxc3 Bxc3 10. Qb3 {Greco invented free play with the pieces. Free pieces will win: free diagonals for the bishops, free files for the rooks!! Greco propagiert in seinen veröffentlichten Übungsbeispielen das Spiel mit den Figuren. Die Kraft der langschrittigen Läufer und Türme zu demonstrieren, lag ihm besonders am Herzen.} Bxa1 {Black is intent on winning by capturing more material. Der Schwarze ist auf Beraubungssieg aus.} 11. Bxf7+ {White is aiming for mate. Der Weiße will matt setzten.} Kf8 12. Bg5 Ne7 13. Ne5 Bxd4 { Black tries to capture as much as possible, and White tries to mate.} 14. Bg6 { aha! If the king has not yet castled, the weakest square is always f7. Hat der König noch nicht rochiert, ist das schwächste Feld immer f7.} d5 {He is still defending. Er wehrt sich noch.} 15. Qf3+ {No mate, but..} Bf5 16. Bxf5 Bxe5 17. Be6+ Bf6 18. Bxf6 Ke8 {18... gxf6 19. Qxf6+ Ke8 20. Qf7#} 19. Bxg7 { Powerful bishops, discovered by Greco. This sample game is an impressive demonstration of the power of well developed bishops. Dieses Übungsbeispiel demonstriert eindrucksvoll die Kraft der frei entfalteten Läufer.} 1-0

תבנית שחמט

בוויקיפדיה העברית נעשה שימוש בתבנית:שחמט להצגת מצבים בדידים במשחקי שחמט. עורכים יכולים להיעזר בתבנית PGN כדי לייצר תבנית שחמט עבור מצבים במשחקים. כדי לעשות זאת, עליכם להיות עורכים רשומים, ולהוסיף לדף מיוחד:הדף שלי/common.js את השורה:

window.makeChessTemplate = 1;

זה יגרום להופעת כפתור חדש בשורת הכפתורים, שמסומן באות T. לחיצה על הכפתור הזה תקפיץ תיבה עם תבנית:שחמט המתאימה למצב הלוח הנוכחי. בעזרת העתק/הדבק ניתן להעתיק את התבנית לערך.