עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
action=compare
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0-or-later
קבלת ההבדל בין 2 דפים.
יש להעביר מספר גרסה, כותרת דף או מזהה דף גם ל־"from" וגם ל־"to".
- fromtitle
כותרת ראשונה להשוואה.
- fromid
מס׳ זיהוי של הדף הראשון להשוואה.
- סוג: מספר שלם
- fromrev
גרסה ראשונה להשוואה.
- סוג: מספר שלם
- fromslots
דריסת תוכן הגרסה שצוינה ב־fromtitle, ב־fromid, או ב־fromrev.
הפרמטר הזה מציין את המשבצות שישונו. יש להשתמש ב־fromtext-{slot}, ב־fromcontentmodel-{slot}, וב־fromcontentformat-{slot} לציון תוכן עבור כל משבצת.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): main
- fromtext-{slot}
הטקסט של המשבצת שמצוינת. אם זה מושמט, המשבצת מוּסרת מהגרסה.
- זהו פרמטר בתבנית. בעת ביצוע הבקשה, יש להחליף את הטקסט {slot} (בשם הפרמטר) עם הערכים של הפרמטר fromslots.
- fromsection-{slot}
כאשר fromtext-{slot} הוא התוכן של פסקה אחת, זהו מספר הפסקה. הוא ימוזג לתוך הגרסה שמצוינת ב־fromtitle, ב־fromid, או ב־fromrev כמו בעריכת פסקה.
- זהו פרמטר בתבנית. בעת ביצוע הבקשה, יש להחליף את הטקסט {slot} (בשם הפרמטר) עם הערכים של הפרמטר fromslots.
- fromcontentformat-{slot}
תסדיר להסדרת תוכן של fromtext-{slot}.
- זהו פרמטר בתבנית. בעת ביצוע הבקשה, יש להחליף את הטקסט {slot} (בשם הפרמטר) עם הערכים של הפרמטר fromslots.
- אחד מהערכים הבאים: text/x-wiki, text/javascript, application/json, text/css, text/plain
- fromcontentmodel-{slot}
מודל התוכן של fromtext-{slot}. אם זה לא סופק, זה ינוחש לפי הפרמטרים האחרים.
- זהו פרמטר בתבנית. בעת ביצוע הבקשה, יש להחליף את הטקסט {slot} (בשם הפרמטר) עם הערכים של הפרמטר fromslots.
- אחד מהערכים הבאים: wikitext, javascript, json, css, text
- frompst
לעשות התמרה לפני שמירה ב־romtext-{slot}.
- סוג: בוליאני (פרטים)
- fromtext
- מיושן.
יש לציין fromslots=main ולהשתמש ב־fromtext-main במקום זה.
- fromcontentformat
- מיושן.
יש לציין fromslots=main ולהשתמש ב־fromcontentformat-main במקום זה.
- אחד מהערכים הבאים: text/x-wiki, text/javascript, application/json, text/css, text/plain
- fromcontentmodel
- מיושן.
יש לציין fromslots=main ולהשתמש ב־fromcontentmodel-main במקום זה.
- אחד מהערכים הבאים: wikitext, javascript, json, css, text
- fromsection
- מיושן.
יש להשתמש רק בפסקה שצוינה בתוכן של הפרמטר 'from'.
- totitle
כותרת שנייה להשוואה.
- toid
מס׳ מזהה של הדף השני להשוואה.
- סוג: מספר שלם
- torev
גרסה שנייה להשוואה.
- סוג: מספר שלם
- torelative
להשתמש בגרסה יחסית לגרסה שהוסקה מfromtitle, fromid או fromrev. לכל אפשריות ה־"to" האחרות לא תהיה השפעה.
- אחד מהערכים הבאים: prev, next, cur
- toslots
דריסת תוכן הגרסה שצוינה ב־totitle, ב־toid, או ב־torev.
הפרמטר הזה מציין את המשבצות שישונו. יש להשתמש ב־totext-{slot}, ב־tocontentmodel-{slot}, וב־tocontentformat-{slot} לציון תוכן עבור כל משבצת.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): main
- totext-{slot}
הטקסט של המשבצת שמצוינת. אם זה מושמט, המשבצת מוּסרת מהגרסה.
- זהו פרמטר בתבנית. בעת ביצוע הבקשה, יש להחליף את הטקסט {slot} (בשם הפרמטר) עם הערכים של הפרמטר toslots.
- tosection-{slot}
כאשר totext-{slot} הוא התוכן של פסקה אחת, זהו מספר הפסקה. הוא ימוזג לתוך הגרסה שמצוינת ב־totitle, ב־toid, או ב־torev כמו בעריכת פסקה.
- זהו פרמטר בתבנית. בעת ביצוע הבקשה, יש להחליף את הטקסט {slot} (בשם הפרמטר) עם הערכים של הפרמטר toslots.
- tocontentformat-{slot}
תסדיר להסדרת תוכן של totext-{slot}.
- זהו פרמטר בתבנית. בעת ביצוע הבקשה, יש להחליף את הטקסט {slot} (בשם הפרמטר) עם הערכים של הפרמטר toslots.
- אחד מהערכים הבאים: text/x-wiki, text/javascript, application/json, text/css, text/plain
- tocontentmodel-{slot}
מודל התוכן של totext-{slot}. אם זה לא סופק, זה ינוחש לפי הפרמטרים האחרים.
- זהו פרמטר בתבנית. בעת ביצוע הבקשה, יש להחליף את הטקסט {slot} (בשם הפרמטר) עם הערכים של הפרמטר toslots.
- אחד מהערכים הבאים: wikitext, javascript, json, css, text
- topst
לעשות התמרה לפני שמירה ב־totext.
- סוג: בוליאני (פרטים)
- totext
- מיושן.
יש לציין toslots=main ולהשתמש ב־totext-main במקום זה.
- tocontentformat
- מיושן.
יש לציין toslots=main ולהשתמש ב־tocontentformat-main במקום זה.
- אחד מהערכים הבאים: text/x-wiki, text/javascript, application/json, text/css, text/plain
- tocontentmodel
- מיושן.
יש לציין toslots=main ולהשתמש ב־tocontentmodel-main במקום זה.
- אחד מהערכים הבאים: wikitext, javascript, json, css, text
- tosection
- מיושן.
יש להשתמש רק בפסקה שצוינה בתוכן של הפרמטר 'to'.
- prop
אילו פריטי מידע לקבל.
- diff
- ה־HTML של ההשוואה.
- diffsize
- גודל ה־HTML של ההשוואה, בבתים.
- rel
- מזהי הגרסאות של הגרסאות לפני "from" ואחרי "to", אם יש כאלה.
- ids
- מזהי הדף והגרסה של גרסאות ה־"from" וה־"to".
- title
- כותרות הדפים של גרסאות ה־"from" וה־"to".
- user
- השם והמזהה של המשתמש של גרסאות ה־"from" וה־"to".
- comment
- התקציר על גרסאות ה־"from" וה־"to".
- parsedcomment
- התקציר המפוענח על גרסאות ה־"from" וה־"to".
- size
- הגודל של גרסאות ה־"from" וה־"to".
- ערכים (מופרדים באמצעות "|" או or תו חלופי): diff, diffsize, rel, ids, title, user, comment, parsedcomment, size
- ברירת מחדל: diff|ids|title
- slots
החזרת השוואות פרטניות למשבצות האלה, ולא השוואה אחת משולבת לכל המשבצות.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): main
- כדי לתת את כל הערכים, יש להשתמש ב־*.
- יצירת תיעוד שינוי בין גרסה 1 ל־2.
- api.php?action=compare&fromrev=1&torev=2 [פתיחה בארגז חול]