עריכת הדף "חב"דפדיה:בוט/בוט החלפות"

{{בוט החלפות}}
בוט ההחלפות משמש ליצירת [[חב"דפדיה:אחידות|אחידות]] כתיב ותעתיק בחב"דפדיה, ובפרט לתקן אוטומטית שגיאות כתיב נפוצות. הבוט מאפשר לבצע שינויים בערכים רבים בצורה פשוטה וללא צורך במעבר ידני.

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

==מה זה עושה?==
בוט ההחלפות מסוגל לחפש מחרוזת כלשהי (למשל "כהיום") בכל הערכים בחב"דפדיה, ולהחליף אותה במחרוזת אחרת (למשל "כיום").

==מתי מפעילים את הבוט?==
הבוט הנוכחי מופעל על ידי [[משתמש:שיע.ק|שיע.ק]].

הבוט מופעל על פי החלטות שהתקבלו על ידי כלל החב"דפדים. ניתן להציע הצעות לתיקון שגיאות ב[[חב"דפדיה:בוט/בוט החלפות/אולם דיונים|אולם הדיונים]]. הבוט מופעל אחת לחודש מחשבון שיע בוט.

==איך פועל הבוט?==
הבוט הוא בשפת פייתון, על בסיס תשתית pywikibot, עם התאמות לחב"דפדיה העברית על ידי ערן. הקוד נכתב על ידי [[משתמש:ערן|ערן]] והוא משוחרר תחת רישיון MIT.

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

הבוט פועל על דפים ב[[עזרה:מרחב שם|מרחבי השם]] הבאים:
* מרחב הערכים
* מרחב שם תבנית
* מרחב שם קטגוריה
* מרחב שם פורטל

== סקריפט החלפות ==
מלבד פעולת הבוט, מתבצעות ההחלפות גם על ידי המשתמשים באמצעות [[שיחת מדיה ויקי:Gadget-Checkty|סקריפט המבצע פעולה זהה]] על פי אותה רשימה. בכדי להפעיל את הסקריפט יש להיכנס ל'''[[מיוחד:העדפות#mw-prefsection-gadgets|מיוחד:העדפות]]''' -> '''גאדג'טים''' -> '''הוספת כפתור לבדיקת בעיות סגנון ולשון נפוצות'''. כעת התווסף במצב עריכה כפתור בשם '''בדיקה''', לחיצה על כפתור זה תבצע בדיקה ותתקן את הטעון תיקון.

==בעיות שיכולות להתעורר==
אם הבוט החליף ביטוי שלא היה צריך להיות מוחלף - ייתכן שהביטוי ו/או הקשרו מהווים מקרה קצה שלא נחזה מראש על ידי מפעיל הבוט או על ידי המשתתפים בדיון ההחלפה. במקרה כזה יש לגשת ל[[חב"דפדיה:בוט/בוט החלפות/תקלות]] ולדווח.

במקרה שהביטוי יוצא דופן ולא צפוי להופיע בערכים רבים, ניתן למנוע מקומית את ההחלפה באחת מהדרכים הבאות:
# במקרה שהשינוי נעשה בהפניה ביבליוגרפית למאמר, כתב עת, ספר וכו' ניתן להשתמש ב[[:קטגוריה:תבניות ציטוט|תבנית מתאימה]] להפניה הביבליוגרפית. הבוט לא עושה החלפות בהפניות ביבליוגרפיות, ויתרון נוסף של שימוש בתבנית הוא שמירה על אחידות בהפניות הביבליוגרפיות.
# במקרה שהשינוי נעשה בציטוט - הבוט לא אמור לשנות ציטוטים שמסומנים ככאלו בתבניות ציטוט ({{תב|ציטוט}}, {{תב|ציטוטון}}, {{תב|""}}). ניתן לסמן את הציטוט בתבנית והבוט לא יחליף אותו יותר.
# התבנית {{תב|ללא החלפה}} מאפשרת לסמן קטע שבו אין להפעיל את בוט ההחלפות.
# ניתן להשתמש בתבנית {{תב|ללא בוט}} וב[[חב"דפדיה:בוט/בוט החלפות/רשימת החלפות נוכחית|רשימת ההחלפות הקיימות]] כדי לגרום לבוט לא לבצע החלפה מסוימת בערך. לדוגמה, החלפה 10 מחליפה את "פיסיק" ל"פיזיק", על מנת למנוע החלפה זו בדף יש להוסיף <nowiki>{{ללא בוט|10}}</nowiki>.

יש להעדיף את הדרך הראשונה או השנייה כאשר זה מתאים, שכן הגנה בצורה זו תבטיח שהבוט יוכל לבצע החלפות בערך מלבד חלק נקודתי שסומן ככזה. (לדוגמה: בערך גאולוגי שמפנה לספר "ג<!---->י<!---->אולוגיה, יסודות ותהליכים", עדיין תתבצע החלפה ג<!---->י<!---->אולוגיה=>גאולוגיה)

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

==קישורים חיצוניים==
*[github.com/eranroz/hewiki-ReplaceBot קוד המקור של הבוט] והוראות הפעלה

[[קטגוריה:חב"דפדיה: בוטים|החלפות]]