ויקיפדיה:מערכת בדיקת פרמטרים/תיקון שגיאות

בוויקיפדיה העברית נעשה שימוש נרחב בתבניות. מערכת בדיקת פרמטרים בודקת שהפרמטרים שהועברו לתבנית תואמים את הגדרתה, ומאתרת שימוש שגוי בתבנית (מספר לא נכון של פרמטרים, השמטה של פרמטר שחובה לדווחו ועוד), כדי לאפשר את תיקונו.

הפעלת המערכת

לשם הפעלת מערכת בדיקת הפרמטרים, כך שתציג לכם הודעות שגיאה, הולכים להעדפות ← גאדג'טים, גוללים למטה ומדליקים את "הראה הודעות שגיאה ממערכת בדיקת פרמטרים" שתחת הכותרת "ניטור". זה הכול.

דוגמה להודעת שגיאה

דוגמה נוספת להודעת שגיאה

מרגע זה, בכל ערך שיש בו שגיאת פרמטרים, תוצג לכם הודעה, בצד שמאל למעלה, המפרטת את מהות השגיאה שאותה יש לתקן. הדוגמאות כאן משמאל מציגות שתי וריאציות של הודעת שגיאה: הראשונה בפרמטר שמשמעותו נקבעת לפי מיקומו בתבנית, והשנייה בפרמטר מסוג מילת מפתח. לחיצה על המילה "סגירה" תסגור את ההודעה ללא טיפול. לחיצה על המילה "סימון" מקפיצה את מסגרת ההודעה למקום שבו נמצאת התבנית השגויה. זוהי תכונה שמקלה מאוד על העורכים לזיהוי מקום התקלה, בייחוד אם התבנית השגויה נמצאת בין שלל הערות שוליים או תבניות רבות באותו שם. כאשר בערך יש קריאות שגויות אחדות לאותה תבנית, מופיעה הודעת שגיאה אחת משותפת לכולן, עם אפשרות לסימון כל המופעים השגויים. בהודעת השגיאה יש קישור להגדרה של התבנית השגויה, שקליק ימני עליו מאפשר לראות את הגדרת התבנית ולתקן את השגיאה בהתאם להגדרה.

בדוגמה להלן, בתבנית:הארץ פרמטר 3 חייב להיות נומרי, וההודעה מצביעה על כך שניתן פרמטר שאינו נומרי ("סוג לא תואם"). כעת ניתן לעבור למצב עריכה, ולתקן את הקריאה השגויה לתבנית.

הודעת שגיאה בצמוד לטקסט השגוי

שימו לב שלעיתים יש פרמטר שגוי שמצריך עיון בגרסאות הקודמות של הערך כדי להבין את מקור השיבוש ואולי גם לחפש בגוגל או לפנות לאתר או לספר הרלוונטי.

בסיום תיקון השגיאה מומלץ להשתמש בתקציר העריכה "תיקון פרמטרים" (מופיע בתיבת תקצירי העריכה), ובכך לתייג את התיקון. התיוג עוזר לאסוף מידע באשר לתיקוני השגיאות ובכך יכול לעזור להבין ממה נגרמות שגיאות.

טיפול בשגיאות

בדף יכולה להופיע שגיאה אחת, או מספר שגיאות. כאשר בדף יש מספר תבניות עם שגיאה פרמטרית, תופיע הודעה לכל תבנית כזו, כשכל הודעה מפרטת את שם התבנית, עם קישור לתבנית עצמה, ואת השגיאות - אחת או יותר. הקישור לתבנית מועיל כדי לקרוא את התיעוד וההסבר לשימוש נכון בתבנית שבדף הנוכחי יש בה שגיאה.

תיקון תבניות נעשה בדרך כלל בעורך קוד מקור, והצעד הראשון בדרך לתיקון שגיאה, הוא מציאת התבנית בקוד המקור.

איתור התבנית עם השגיאה

לעתים קרובות השגיאה היא בתבנית מסוג "תבנית מידע", למשל {{אישיות}} ונגזרותיה, שמופיעה בדיוק פעם אחת בדף, וקל ופשוט למצאה, לפי שם התבנית שמופיע בהודעת השגיאה. לעומת זאת, תבניות כמו {{הערה}}, {{קישור כללי}}, ואחרות, יכולות להופיע פעמים רבות בדף, ואיתור התבנית המסוימת בה מופיעה השגיאה אינו מיידי.

כדי לסייע, יש בהודעות כפתור "סימון". בלחיצה עליו, הודעות השגיאה מתמקמות בדף מעל התבנית, והתבנית עצמה מוקפת במסגרת אדומה. יש לאתר טקסט לפני או אחרי התבנית, ובעורך קוד מקור למצוא את הטקסט הזה, והתבנית ה"סוררת" בדרך כלל תימצא לידו.

איתור הערת שוליים שמכילה תבנית עם שגיאה

הדברים מסתבכים מעט כאשר השגיאה נמצאת בתבנית שבעצמה מוכלת בהערת שוליים - ההודעה והמסגרת האדומה תופענה בסעיף "הערות שוליים", בעוד השגיאה נמצאת בגוף הטקסט, במקום בו מופיעה {{הערה}} או תג ref. כדי לאתר את קוד הוויקי שבו השגיאה, נקיש בתחילה "סימון". הערת השוליים שיש לתקן תנומן בסעיף "הערות שוליים". כעת יש להקיש על המספר שמופיע ליד ההערה עם השגיאה - מספר זה מקשר לגוף הטקסט. מוצאים את הקישור להערת השוליים, בצורת [16], ושוב, מוצאים טקסט בסביבה הקרובה, עוברים למצב עריכה, ומאתרים את הערת השוליים, ובתוכה את התבנית שמכילה שגיאות.

אוטומציה

בטיפול בשגיאות פרמטריות, אשף התבניות לא מספק אוטומציה ברמה של צ'קטי, אבל הוא כלי רב ערך בתיקון שגיאות פרמטריות. השימוש בו הוא כדלהלן:

• מאתרים ומסמנים את התבנית בה מופיעה השגיאה בדף. אם תבנית זו מכילה או מוכלת בתבנית אחרת, יש לשים לב לסמן בדיוק החל ב- {{ הפותחים את התבנית, ועד ל- }} שסוגרים אותה.
• בסרגל הכלים, לחצו על כפתור האשף, שנראה כך: {{}}
• אשף התבניות ימצא את ההגדרות של התבנית המתאימה, ויטען את התבנית הנוכחית.

כמה מהשגיאות הנפוצות ביותר הן פרמטר חובה חסר ושם פרמטר שגוי. האשף עוזר כאן בכך שהוא מסמן את שדות הקלט של פרמטרי חובה במסגרת אדומה, ופרמטרים עם שם שגוי מופיעים ברשימה אחרי שמות הפרמטרים האחרים.

דוגמה לטעות אפשרית והסבר על התיקון: נאמר שלתבנית יש פרמטר חובה בשם "משקל כולל". בדף מופיע "משכל כולל = 47 טון". עקב התקלדה בשם הפרמטר, תיווצרנה שתי שגיאות: פרמטר חובה חסר, ופרמטר בשם שגוי. באשף התבניות נוכל למצוא את הערך הנכון עבור הפרמטר בשם שגוי, שיופיע באדום, בעוד הפרמטר בשם הנכון ריק מתוכן. העברת הערך הנכון לפרמטר הנכון מתבצעת בכמה הנפות עכבר. יש אפילו מספר טעויות פחות נפוצות, שהאשף מתקן באופן אוטומטי, פשוט על ידי סימון התבנית, פתיחתו והקשה על "אישור".

סוגי שגיאות נפוצות והטיפול בהן

פרמטרים [1] לא מופיעים בהגדרת התבנית"

(או מספר אחר; וכן שני מספרים)

בתבנית שבה הפרמטרים מבוססי שם

פרמטר מבוסס שם צריך להכיל קו ניצב (|) להבדיל בינו לבין הפרמטר הקודם, שם הפרמטר המדויק (כל שינוי משמו המדויק בהגדרת התבנית כפי שמופיעה בדף התבנית לא יעבוד) וסימן השווה (=) לאחר שם הפרמטר כדי להבדיל בין שם הפרמטר לתוכן הממולא.

הודעה השגיאה מוצגת במקרים אחדים:

• כאשר ניתן ערך הפרמטר בלי שצוין שמו. התיקון הוא הוספת שם הפרמטר והסימן שווה (=). דוגמה: הודעת השגיאה ותיקונה.
• כאשר מופיע קו ניצב מיותר, התבנית קוראת דרישה לפרמטר; אך כשהוא לא מופיע מיד אחריו, המערכת מזהה את שגיאה. במקרה כזה יש להסיר את הקו המיותר. לעיתים הקו מופיע בתמונה שהוכנסה לתבנית כדי לשלוט בגודל התמונה: אם הגודל הוא גודל סטנדרטי, יש להסיר את ה־|250px (דוגמה לשגיאה ותיקונה); אם הגודל הוא לא סטנדרטי – יש לקשר את התמונה בקישור פנימי, כך: [[קובץ:aaa.jpg|150px]]
• אפשרות נוספת היא שסימן השווה לא הוכנס אחרי שם הפרמטר, לדוגמה: |תאריך לידה עברי ט"ו באדר ב' תשכ"זבמקום |תאריך לידה עברי=ט"ו באדר ב' תשכ"ז. במקרה כזה יש להוסיף שווה בין שם הפרמטר לתוכן הממולא.

בתבנית שבה הפרמטרים מבוססים מיקום

ייתכן שיש יותר פרמטרים ממה שהתבנית מקבלת. לדוגמה: הפרמטרים של תבנית ynet הם אלו: {{Ynet|שם הכתב|כותרת הכתבה|מזהה הכתבה|תאריך פרסום}}, אם נמלא את התבנית {{Ynet|שם הכתב|כותרת הכתבה|מזהה הכתבה|תאריך פרסום||}} נקבל את ההודעה פרמטרים [5, 6] לא מופיעים בהגדרת התבנית משום שאין לתבנית פרמטר חמישי ושישי.

"פרמטרים [מאכל אהוב] לא מופיעים בהגדרת התבנית"

זו שגיאה שמופיעה כאשר מוכנס שם של פרמטר שלא מופיע בהגדרת התבנית. נסו לבדוק בהיסטוריית הגרסאות מתי הוא הוסף – לעיתים מדובר בשינוי לא נכון שנגרם מחוסר ידיעה ואז כדאי פשוט לתקן לשם הנכון. אם מדובר בהוספה של פרמטר חדש, נסו לבדוק בדף התבנית אם יש פרמטר דומה שיכול להתאים.

"שימוש בפרמטרים מיושנים"

בגדול – לא לגעת. זוהי שגיאה זמנית שנוצרת במהלך הסבה של תבניות. היא ידועה למתעסקים בתבנית, והיא בטיפול.

"פרמטרי חובה [3] חסרים"

השגיאה היא בכך שפרמטר אחד, או יותר (תוכן הסוגריים מלמד על מיקום הפרמטר או שמו) שמוגדר בתבנית כחובה (למשל: מזהה כתבה באתר חדשות; ללא מזהה הכתבה אין תועלת בקישור לדף הבית של האתר) לא הוזן. הפתרון – למלא אותו. לרוב נדרש חיפוש בגוגל כדי למצוא את הכתבה ולהעתיק משם – ידנית או עם בוקמרקלט – את המספר הנכון.

"תבנית ריקה מתוכן. יש להזין פרמטרים בערך או בוויקינתונים"

תבניות רבות שואבות את הנתונים שלהן מוויקינתונים, כך שלפעמים די בציון שם התבנית, ללא פרמטרים, כדי שיוצג כל או רוב המידע שהתבנית נועדה להציג. זהו יתרון בולט של השימוש בוויקינתונים. כאשר הולכים בדרך זו, אם אין בוויקינתונים אף אחד מהנתונים הנחוצים לתבנית, מתקבלת הודעת שגיאה. לטיפול בהודעה משמשות שתי דרכים:

• הסרת התבנית מהערך, שהרי אינה תורמת לו דבר.
• השלמת הפרמטרים החסרים, ישירות בתבנית או דרך ויקינתונים, כך שלתבנית יינתן תוכן להצגה.