ויקיפדיה

ויקיפדיה:מערכת בדיקת פרמטרים – הבדלי גרסאות

עיון אינטראקטיבי בהיסטוריה
→ העריכה הקודמתהעריכה הבאה ←
תוכן שנמחק תוכן שנוסף
חזותיקוד ויקי
אין תקציר עריכה
שורה 22:
 
== האופציות בשימוש המערכת בוויקיפדיה בעברית ==
בוויקיפדיה בעברית, הפרמטרים ליחידה, נמצאים ביחידה נוספת: [[יחידה:PV-options]]. הפרמטרים הללו נחלקים לשלוש קבוצות, לפי מרחב השם של הדף בו מוצבת התבנית הנבדקת: ברוב מרחבי השם, רשימת הפרמטרים ריקה, ותבנית שנמצאת במרחב שם כזה לא תיבדק כלל. מרחבי השם בהם כן מתבצעת בדיקה מתחלקים לשני סוגים, וההבדל ביניהם הוא בקטגוריה שתתווסף להודעה: בחלק ממרחבי השם הקטגוריה היא [[:קטגוריה:שגיאות פרמטריות מחוץ למרחב הערכים]], ובחלק, ייתווספו שלוש קטגוריות שונות: [[:קטגוריה:שגיאות פרמטריות]], [[:קטגוריה:שגיאות פרמטריות בתבנית XXXX]] (לפי התבנית), ו[[:קטגוריה:שגיאות פרמטריות <תיאור השגיאה>>]]. דוגמה לקטגוריה האחרונה היא [[:קטגוריה:שגיאות פרמטריות שימוש בפרמטר מיושן]]. נכון למאי 2018, מרחבי השם מהסוג הראשון (״מחוץ למרחב הערכים״) הם 2, 4, 12, 108, 118, 446, 828, 2300, 2302, 2600: משתמש, ויקיפדיה, עזרה, ספר, טיוטה, הוראה, יחידה, גאדג׳ט, הגדרת גאדג׳ט, ונושא.
{{לעדכן|סיבה=על ידי [[משתמש:קיפודנחש]], יש כבר <noinclude>{{ניהול פרמטרים/תוכן}}{{תיעוד/תבנית מידע|התחלה}}</noinclude><includeonly>{{#invoke:ParamValidator|validateparams|module_options=יחידה:PV-options}}</includeonly>}}
(יתכן שהסעיף לא מעודכן - בידקו את העריכה האחרונה של הסעיף מול העריכה האחרונה ב[[תבנית:Pv-options]]).
בוויקיפדיה בעברית האופציות נמצאות ב[[תבנית:Pv-options]], והיחידה נקראת או ישירות, בעזרת <syntaxhighlight lang="text" inline>{{#invoke:ParamValidator | validateParams | options = <options>}}</syntaxhighlight> או בצורה הנפוצה יותר <syntaxhighlight lang="text" inline>{{#invoke:פרמטרים | main | options = <options> }}</syntaxhighlight>. אין הבדל בין הצורות - אפשר לחשוב על הצורה השנייה כמו "הפניה" לצורה הראשונה. בשני המקרים מעבירים כפרמטר {{תב|Pv-options}} שמכילה את הקונפיגורציה להפעלה. כשלפעמים מעבירים במקומו את [[תבנית:Pv-options span]] שמכילה אופציות כמעט זהות, כשההבדל טכני, ותלוי בהתנהגות העיצובית של התבנית הנבדקת. התבנית הזו מחזירה מחרוזות שתלויות במרחב השם של הערך הנבדק:
* בכל [[עזרה:מרחב שם|מרחבי השיחה]] התבנית מחזירה אובייקט JSON ריק. כשזה קורה, מערכת הבדיקות לא מבצעת שום בדיקה (אפילו לא מנסה לקרוא את ה-TD), ומחזירה מחרוזת ריקה.
* במרחב הערכים, מרחב פורטל ובמרחב התבניות, המערכת מחזירה סדרת מחרוזות, אחת עבור כל סוג שגיאה שהתגלתה, ומחרוזת נוספת שמוחזרת כאשר יש שגיאה כלשהי. המחרוזות עבור השגיאות הספציפיות מכילות קטגוריה עבור סוג השגיאה, והודעת שגיאה שמכילה את תיאור השגיאה ורשימת הפרמטרים, ובמקרה המיוחד של פרמטרים מספריים שגויים (כלומר לא מוצהרים) עם ערך לא ריק, גם את רשימת הערכים. כמו כן יש הודעה כללית, שמכילה את שם התבנית בה נתגלו שגיאות, כולל קישור, ושתי קטגוריות כלליות: '''[[:קטגוריה:שגיאות פרמטריות]]''', ו"'''קטגוריה:שגיאות פרמטריות בתבנית <שם התבנית>'''". כשהמחרוזת המוחזרת אינה ריקה, היא עטופה באלמנט html ממחלקה מסוימת, שבדרך כלל יש לה מצב תצוגה "מוסתר". מצב התצוגה לא משפיע על הקטגוריות, וכל הקטגוריות שהמערכת מוסיפה הן [[ויקיפדיה:קטגוריות#קטגוריות מוסתרות]].
* בשאר המרחבים, הודעות השגיאה הן זהות, אבל הקטגוריות לא מופיעות, ואם יש שגיאה כלשהי, נוספת רק קטגוריה אחת: [[:קטגוריה:שגיאות פרמטריות מחוץ למרחב הערכים]].
 
מרחבי השם מהסוג השני (״כמו מרחב הערכים״) הם 0, 6, 10, 14, 100: מרחב הערכים, קובץ, תבנית, קטגוריה, ופורטל.
כאשר מערכת הבדיקה מחזירה מחרוזת לא ריקה, חלק מפעולת ה"הלחמה" שתוארה בסעיפים הקודמים היא עטיפת התוצאה באלמנט מסוים. בוויקיפדיה בעברית זה אלמנט מסוג div או span (תלוי באיזו תבנית משתמשים בקריאה ליחידה), עם מחלקת CSS בשם "paramvalidator-wrapper".
 
בכל מרחבי השם האחרים, ובפרט בכל מרחבי השיחה, כולל אלו הצמודים למרחבים שפורטו, היחידה לא בודקת דבר.
 
פרט לקטגוריה, במרחבים הנבדקים, היחידה מייצרת הודעה על השגיאה. ההודעה הזו ״מוסתרת״ ממשתמשים שלא הפעילו גאדג׳ט ״{{מדיה ויקי:מדיה ויקי:Gadget-validate-template-params}}״ (בסעיף ״ניטור״). עורכים שהפעילו את הגאדג׳ט יראו קופסה (או כמה קופסאות) עם הודעה על השגיאה, בפינה שמאלית עליונה של הדף. ההודעה מכילה הסבר על השגיאה שכולל את שם התבנית וסוג השגיאה, ורשימת הפרמטרים הרלוונטיים. כמו כן ההודעה מכילה כפתורים ל״הסתרה״ (הסתרת ההודעה), ו״סימון״. לחיצה על ״סימון״ בדרך כלל תגרום להקפת התבנית בה מופיעה השגיאה במסגרת אדומה, והקפצת הקופסה עם ההודעה למקום בדף בו מופיעה התבנית. זה שימושי בעיקר כאשר יש הודעה על שגיאה בתבנית שמופיעה יותר מפעם אחת בדף, והעורך רוצה לראות איזה מופע של התבנית מכיל את השגיאה.
 
כמה נקודות שיש לשים אליהם לב:
# אם התבנית עם השגיאה מוכלת באלמנט מוסתר (כלומר כזה: {{תבטה מוסתרת|כותרת=דוגמה לאלמנט מוסתר|תוכן = ואנוכי הוהו היהי, מי כאן יודע מה הוא שמי?}}), הודעת השגיאה עלולה לא להופיע. כאשר מגיעים לדף עם קטגוריית שגיאה אך בלי הודעה, כדאי לנסות לחפש בדף אלמנטים מוסתרים ולפתוח את כולם
# תבניות ויחידות אחרות יכולות גם הן להוסיף את אחת מקטגוריות השגיאה (אולי יותר מאחת), ובפרט, תבניות שמשתמשות ב[[יחידה:תבנית מידע]]. במקרים אלו, תופיע קטגוריה אבל לא תופיע הודעה, ובדרך כלל התבנית עצמה לא תוצג בדף (אם כי כמובן היא כן תופיע בדף במצב עריכה).
 
== תצוגה וגאדג'טים ==
אוחזר מתוך "https://he.wikipedia.org/wiki/ויקיפדיה:מערכת_בדיקת_פרמטרים"