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