תבנית:Pgn/תיעוד
תבנית זו מיועדת להצגת משחקי שחמט בעזרת שימוש בפורמט PGN (Portable Game Notation). ניתן להציג עד 40 משחקים בעזרת תבנית אחת.
השימוש בתבנית:
{{pgn
|1=משחק בפורמט PGN
|2=משחק שני בפורמט PGN (אופציונלי)
|3=
|... וכן הלאה, עד לכל היותר
|40=
}}
פרמטרים אופציונליים:
- גודל גודל המשבצת, בפיקסלים. ברירת מחדל: 26. ערך מינימלי - 20, מקסימלי - 60.
- השהיה: ההשהיה בין שני מסעים באנימציה, במילישניות. אם הפרמטר לא מוגדר, ההשהיה ההתחלתית היא 750 מילישניות, או ¾ שנייה, ויופיעו כפתורי "מהר יותר" ו"לאט יותר" משני צידי כפתור ה-Play: לחיצה על "לאט" מגדילה את ההשהיה, ולחיצה על "מהר" מקטינה.
יש לשים לב, אם ה-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). להצגת עמדת הפתיחה, אפשר להזין [FirstMove "0"]
- ניתן להזין תג FEN, לציון התחלת המשחק מעמדה שונה מהעמדה הסטנדרטית, למשל בשח 960, חידות שחמט, או הצגת משחק החל מנקודה מסוימת במהלכו. כאשר משתמשים בתג זה, ואם לא מזינים FirstMove, הלוח יוצג בעמדת הפתיחה ולא בעמדת הסיום.
מגבלות
[עריכת קוד מקור]סטנדרט PGN מאפשר להציג הערות משולבות בין המסעים. הסטנדרט מאפשר לסמן את ההערות בשתי דרכים: בעזרת נקודה-פסיק (ההערה נמשכת עד לסוף השורה), או בעזרת זוג סוגריים מסולסלים. התבנית תומכת רק בסוגריים מסולסלים. כמו כן, התבנית לא מאפשרת (כלומר לא תעבוד נכון) אם יש הערה בת יותר משורה אחת. השורה יכולה להיות ארוכה לפי הצורך, ובתצוגה היא תיראה נכון. בגוף ההערה לא ניתן להשתמש בקוד ויקי או html.
בהצגת המשחק, הערה שמופיעה כחלק מרשימת המסעים תוצג באופן זה: כך תיראה הערה בין המסעים במשחק.
דוגמה
[עריכת קוד מקור]לנוחיות הקריאה, קוד הוויקי מוצג משמאל לימין. (ראו גם עזרה:קיצורי דרך במצב עריכה). המשחק הראשון עושה שימוש בתגים המיוחדים שם, Direction ו-FirstMove, כך שהתאור מוצג מימין לשמאל, שם המשחק בתפריט מופיע כ"משחק גומלין", והלוח מוצג כפי שנראה אחרי המסע ה-33 של השחור. במשחק השני בדוגמה לא נעשה שימוש בתגים המיוחדים הללו, והוא מוצג בעזרת ברירות המחדל: יישור לשמאל, שם המשחק בתפריט הוא שרשור של ה-Event ושמות השחקנים, והלוח מוצג כפי שנראה בסוף המשחק.
| קוד ויקי של שני משחקי שחמט בפורמט pgn. במשחק הראשון מוגדר "FirstMove" - מסע 33 של השחור |
|---|
{{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
- עם השהיה מוגדרת (1000 מילישניות, כלומר שנייה)
| השהיה = 1000כפתורי "מהר יותר"/"לאט יותר" נעלמים.
| קוד הויקי של משחק אחד, השהיה=1000 |
|---|
{{pgn
| השהיה = 1000
|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
}}
|
[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
- אותו משחק, בגודל משבצת 40 פיקסלים
| גודל = 40
[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