עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API
action=parse
- יחידה זו דורשת הרשאות קריאה.
- מקור: MediaWiki
- רישיון: GPL-2.0+
מפענח את התוכן ומחזיר פלט מפענח.
ר' את יחידת ה־prop השיונות של action=query כדי לקבל מידע על הגרסה הנוכחית של הדף.
יש מספר דרכים לציין טקסט לפענוח:
- ציון דף או גרסה באמצעות page, pageid, או oldid.
- ציון התוכן במפורש, באמצעות text, title, ו־contentmodel.
- ציון רק של התקציר לפענוח. ל־prop צריך לתת ערך ריק.
- title
שם הדף שהטקסט שייך אליו. אם זה מושמט, יש לציין את contentmodel, ו־API ישמש ככותרת.
- text
הטקסט לפענוח. יש להשתמש ב־title או ב־contentmodel.
- summary
התקציר שצריך לפענח.
- page
פענוח תוכן הדף הזה. לא יכול לשמש יחד עם text ו־title.
- pageid
לפענח את התוכן של הדף הזה. דורס את page.
- סוג: מספר שלם
- redirects
אם page או pageid מוגדרים להפניה, לפתור אותה.
- סוג: בוליאני (פרטים)
- oldid
לפענח את התוכן של הגרסה הזאת. דורס את page ואת pageid.
- סוג: מספר שלם
- prop
אילו פריטי מידע לקבל:
- text
- נותן טקסט מפוענח של קוד הוויקי.
- langlinks
- נותן קישורי שפה בקוד הוויקי המפוענח.
- categories
- נותן קטגוריות בקוד ויקי מפוענח.
- categorieshtml
- נותן את גרסת ה־HTML של הקטגוריות.
- links
- נותן קישורים פנימיים בקוד הוויקי המפוענח.
- templates
- נותן תבניות בקוד הוויקי המפוענח.
- images
- נותן תמונות בקוד הוויקי המפוענח.
- externallinks
- מתן קישורים חיצוניים בקוד הוויקי המפוענח.
- sections
- מתן הפסקאות בקוד הוויקי המפוענח.
- revid
- הוספת מזהה הגרסה של הדף המפוענח.
- displaytitle
- הוספת הכותרת של קוד הוויקי המפוענח.
- headitems
- לא בשימוש. נותן פריטים לשים ב־
<head>של הדף. - headhtml
- נותן את ה־
<head>המפוענח של הדף. - modules
- מתן יחידות ResourceLoader שמשמשות בדף. כדי לטעון, יש להשתמש ב
mw.loader.using(). יש לבקש את jsconfigvars או את encodedjsconfigvars יחד עם modules. - jsconfigvars
- נותן משתני הגדרות של JavaScript שייחודיים לדף הזה. כדי להחיל, יש להשתמש ב
mw.config.set(). - encodedjsconfigvars
- נותן משתני הגדרות של JavaScript שייחודיים לדף הזה בתור מחרוזת JSON.
- indicators
- נותן את ה־HTML של מחווני מצב דף שמשמשים בדף.
- iwlinks
- מתן קישורי בינוויקי בקוד הוויקי המפוענח.
- wikitext
- מתן קוד הוויקי המקורי שפוענח.
- properties
- נותן מאפיינים שונים שמוגדרים בקוד הוויקי המפוענח.
- limitreportdata
- נותן דו"ח הגבלות בדרך מובנית. לא נותן שום נתונים כאשר מוגדר disablelimitreport.
- limitreporthtml
- נותן את גרסת ה־HTML של דו"ח ההגבלות. לא נותן שום נתונים כאשר מוגדר disablelimitreport.
- parsetree
- עץ פענוח XML של תוכן הגרסה (דורש מודל תוכן
wikitext) - parsewarnings
- נותן אזהרות שאירעו בזמן פענוח התוכן.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): text, langlinks, categories, categorieshtml, links, templates, images, externallinks, sections, revid, displaytitle, headitems, headhtml, modules, jsconfigvars, encodedjsconfigvars, indicators, iwlinks, wikitext, properties, limitreportdata, limitreporthtml, parsetree, parsewarnings
- ברירת מחדל: text|langlinks|categories|links|templates|images|externallinks|sections|revid|displaytitle|iwlinks|properties|parsewarnings
- pst
לעשות התמרה לפני שמירה על הקלט לפני פענוחו. תקין רק בשימוש עם טקסט.
- סוג: בוליאני (פרטים)
- onlypst
לעשות התמרה לפני שמירה (pre-save transform, PST) על הקלט, אבל לא לפענח אותו. מחזיר את אותו קוד הוויקי אחרי החלת PST. תקף רק בשימוש עם text.
- סוג: בוליאני (פרטים)
- effectivelanglinks
כולל קישור שפה שמספקות הרחבות (לשימוש עם prop=langlinks).
- סוג: בוליאני (פרטים)
- section
לפענח רק את התוכן של הפסקה שזה מספרה.
כשצוין new, לפענח את text ואת sectiontitle כאילו נוספת פסקה חדשה לדף.
מותר להשתמש ב־new רק בעת שימוש ב־text.
- sectiontitle
כותרת פסקה חדשה כאשר section הוא new.
בניגוד לעריכת דף, זה לא מתגבה ל־summary כשזה מושמט אם ריק.
- disablepp
- מיושן.
יש להשתמש ב־disablelimitreport במקום.
- סוג: בוליאני (פרטים)
- disablelimitreport
להשמיט את דו"ח הקדם־מעבד ("NewPP limit report") מפלט המפענח.
- סוג: בוליאני (פרטים)
- disableeditsection
להשמיט את קישורי עריכת הפסקאות מפלט המפענח.
- סוג: בוליאני (פרטים)
- disabletidy
לא להריץ ניקוי HTML (למשל tidy) על פלט המפענח.
- סוג: בוליאני (פרטים)
- generatexml
- מיושן.
יצירת עץ פענוח של XML (נדרש מודל תוכן
wikitext; מוחלף ב־prop=parsetree).- סוג: בוליאני (פרטים)
- preview
לפענח במצב תצוגה מקדימה.
- סוג: בוליאני (פרטים)
- sectionpreview
לפענח במצב תצוגה מקדימה של פסקה (מדליק גם את מצב תצוגה מקדימה).
- סוג: בוליאני (פרטים)
- disabletoc
להשמיט את תוכן העניינים בפלט.
- סוג: בוליאני (פרטים)
- contentformat
תסדיר הסדרת תוכן שישמש לטקסט הקלט. תקף רק עם text.
- אחד מהערכים הבאים: text/x-wiki, text/javascript, application/json, text/css, text/plain
- contentmodel
מודל התוכן של טקסט הקלט. אם זה מושמט, יש לציין את title והערך ההתחלתי יהיה המודל של הכותרת שצוינה. תקין רק כאשר משמש עם text.
- אחד מהערכים הבאים: wikitext, javascript, json, css, text
- לפענח דף.
- api.php?action=parse&page=Project:Sandbox [פתיחה בארגז חול]
- לפענח קוד ויקי.
- api.php?action=parse&text={{Project:Sandbox}}&contentmodel=wikitext [פתיחה בארגז חול]
- לפענח קוד, עם ציון כותרת דף.
- api.php?action=parse&text={{PAGENAME}}&title=Test [פתיחה בארגז חול]
- לפענח תקציר.
- api.php?action=parse&summary=Some+[[link]]&prop= [פתיחה בארגז חול]