לדלג לתוכן

חב"דפדיה:בוט/בוט החלפות: הבדלים בין גרסאות בדף

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


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


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


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


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


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


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


רשימת החלפות תהיה בדף [[חב"דפדיה:בוט/רשימת החלפות]]. ניתן להוסיף החלפות אך ורק על ידי התבנית {{תב|החלפת טקסט}}!
הבוט פועל על דפים ב[[עזרה:מרחב שם|מרחבי השם]] הבאים:
* מרחב הערכים
* מרחב שם תבנית
* מרחב שם קטגוריה
* מרחב שם פורטל


ההחלפות שיוספו לדף זה הם '''רק''' החלפות שדנו עליהם ב[[חב"דפדיה:בוט/אולם דיונים]] במשך שבוע. לאחר שבוע, אם תהיה את הסכמת רוב המשתתפים להחלפה, הדיון יאורכב וההחלפה תיכנס לרשימה בדף זה כשלידה יכנס הסבר וקישור לדיון המאורכב.
== סקריפט החלפות ==
:::'''סימני פיסוק'''
מלבד פעולת הבוט, מתבצעות ההחלפות גם על ידי המשתמשים באמצעות [[שיחת מדיה ויקי:Gadget-Checkty|סקריפט המבצע פעולה זהה]] על פי אותה רשימה. בכדי להפעיל את הסקריפט יש להיכנס ל'''[[מיוחד:העדפות#mw-prefsection-gadgets|מיוחד:העדפות]]''' -> '''גאדג'טים''' -> '''הוספת כפתור לבדיקת בעיות סגנון ולשון נפוצות'''. כעת התווסף במצב עריכה כפתור בשם '''בדיקה''', לחיצה על כפתור זה תבצע בדיקה ותתקן את הטעון תיקון.
{{החלפת טקסט|“|"}}
 
{{החלפת טקסט|”|"}}
==בעיות שיכולות להתעורר==
{{החלפת טקסט|״|"}}
אם הבוט החליף ביטוי שלא היה צריך להיות מוחלף - ייתכן שהביטוי ו/או הקשרו מהווים מקרה קצה שלא נחזה מראש על ידי מפעיל הבוט או על ידי המשתתפים בדיון ההחלפה. במקרה כזה יש לגשת ל[[חב"דפדיה:בוט/בוט החלפות/תקלות]] ולדווח.
{{החלפת טקסט|″|"}}
 
{{החלפת טקסט|׳|'}}
במקרה שהביטוי יוצא דופן ולא צפוי להופיע בערכים רבים, ניתן למנוע מקומית את ההחלפה באחת מהדרכים הבאות:
{{החלפת טקסט|′|'}}
# במקרה שהשינוי נעשה בהפניה ביבליוגרפית למאמר, כתב עת, ספר וכו' ניתן להשתמש ב[[:קטגוריה:תבניות ציטוט|תבנית מתאימה]] להפניה הביבליוגרפית. הבוט לא עושה החלפות בהפניות ביבליוגרפיות, ויתרון נוסף של שימוש בתבנית הוא שמירה על אחידות בהפניות הביבליוגרפיות.
{{החלפת טקסט|‘|'}}
# במקרה שהשינוי נעשה בציטוט - הבוט לא אמור לשנות ציטוטים שמסומנים ככאלו בתבניות ציטוט ({{תב|ציטוט}}, {{תב|ציטוטון}}, {{תב|""}}). ניתן לסמן את הציטוט בתבנית והבוט לא יחליף אותו יותר.
{{החלפת טקסט|’|'}}
# התבנית {{תב|ללא החלפה}} מאפשרת לסמן קטע שבו אין להפעיל את בוט ההחלפות.
{{החלפת טקסט|`|'}}
# ניתן להשתמש בתבנית {{תב|ללא בוט}} וב[[חב"דפדיה:בוט/בוט החלפות/רשימת החלפות נוכחית|רשימת ההחלפות הקיימות]] כדי לגרום לבוט לא לבצע החלפה מסוימת בערך. לדוגמה, החלפה 10 מחליפה את "פיסיק" ל"פיזיק", על מנת למנוע החלפה זו בדף יש להוסיף <nowiki>{{ללא בוט|10}}</nowiki>.
{{החלפת טקסט|....|...}}
 
#:'''מילים מהתנ"ך'''
יש להעדיף את הדרך הראשונה או השנייה כאשר זה מתאים, שכן הגנה בצורה זו תבטיח שהבוט יוכל לבצע החלפות בערך מלבד חלק נקודתי שסומן ככזה. (לדוגמה: בערך גאולוגי שמפנה לספר "ג<!---->י<!---->אולוגיה, יסודות ותהליכים", עדיין תתבצע החלפה ג<!---->י<!---->אולוגיה=>גאולוגיה)
{{החלפת טקסט|תהילים|תהלים}}
 
#:'''דקדוק'''
הבוט מיועד לטיפול בטקסט בעברית הכתוב בכתיב מלא לא מנוקד. עשויים להיות מקרים יוצאי דופן של צורך לכתוב בכתיב חסר, צורך בניקוד וכו' שלא תואמים הנחה זו, ובמקרים אלו ניתן להשתמש בשיטות לעיל על מנת להחריג החלפות.
{{החלפת טקסט|כסליו|כסלו}}
{{החלפת טקסט|תפלה|תפילה}}
{{החלפת טקסט|חבד"י|חב"די}}
{{החלפת טקסט|חבדיי"ם|חב"דיים}}
{{החלפת טקסט|חבדי"ם|חב"דיים}}
{{החלפת טקסט|אדמורי"ם|אדמו"רים}}
{{החלפת טקסט|אדמורו"ת|אדמו"רות}}
{{החלפת טקסט|עכב|עקב}}
#:'''תקלדות נפוצות'''
{{החלפת טקסט|התוועדיות|התוועדויות}}
{{החלפת טקסט|{{רווח}} |{{רווח}}}}
#:'''שם או משפחה'''
{{החלפת טקסט|מישלובין|מישולובין}}
{{החלפת טקסט|מישולבין|מישולובין}}
{{החלפת טקסט|וילישאנסקי|וילשאנסקי}} ([[שיחה:וילשאנסקי (פירושונים)|דיון]])
#:'''אחידות'''
{{החלפת טקסט|{{רווח}}<nowiki>{{הערה|</nowiki>|<nowiki>{{הערה|</nowiki>}}
{{החלפת טקסט| <nowiki>}}</nowiki>|<nowiki>}}</nowiki>}}
{{החלפת טקסט|<nowiki><ref></nowiki>|<nowiki>{{הערה|</nowiki>}}
{{החלפת טקסט|<nowiki></ref></nowiki>|<nowiki>}}</nowiki>}}
#:'''ראשי תיבות'''
{{החלפת טקסט|ע"י|על ידי}} (מלבד ערך [[פרצוף]])


==קישורים חיצוניים==
==קישורים חיצוניים==
* [https://www.mediawiki.org/wiki/Extension:Replace_Text הוראות שימוש בדף ההרחבה במדיה ויקי]
*[github.com/eranroz/hewiki-ReplaceBot קוד המקור של הבוט] והוראות הפעלה
 
[[קטגוריה:חב"דפדיה: בוטים|החלפות]]

גרסה אחרונה מ־09:25, 7 בדצמבר 2025

בוט ההחלפות

ראו גם:

ארכיון דיוני בוט ההחלפות:

  • תשפ"ה: 1

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

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

מה זה עושה?[עריכת קוד מקור]

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

מתי מפעילים את הבוט?[עריכת קוד מקור]

הבוט הנוכחי מופעל על ידי שיע.ק.

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

איך פועל הבוט?[עריכת קוד מקור]

הבוט הוא בשפת פייתון, על בסיס תשתית pywikibot, עם התאמות לחב"דפדיה העברית על ידי ערן. הקוד נכתב על ידי ערן והוא משוחרר תחת רישיון MIT.

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

הבוט פועל על דפים במרחבי השם הבאים:

  • מרחב הערכים
  • מרחב שם תבנית
  • מרחב שם קטגוריה
  • מרחב שם פורטל

סקריפט החלפות[עריכת קוד מקור]

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

בעיות שיכולות להתעורר[עריכת קוד מקור]

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

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

  1. במקרה שהשינוי נעשה בהפניה ביבליוגרפית למאמר, כתב עת, ספר וכו' ניתן להשתמש בתבנית מתאימה להפניה הביבליוגרפית. הבוט לא עושה החלפות בהפניות ביבליוגרפיות, ויתרון נוסף של שימוש בתבנית הוא שמירה על אחידות בהפניות הביבליוגרפיות.
  2. במקרה שהשינוי נעשה בציטוט - הבוט לא אמור לשנות ציטוטים שמסומנים ככאלו בתבניות ציטוט ({{ציטוט}}, {{ציטוטון}}, {{""}}). ניתן לסמן את הציטוט בתבנית והבוט לא יחליף אותו יותר.
  3. התבנית {{ללא החלפה}} מאפשרת לסמן קטע שבו אין להפעיל את בוט ההחלפות.
  4. ניתן להשתמש בתבנית {{ללא בוט}} וברשימת ההחלפות הקיימות כדי לגרום לבוט לא לבצע החלפה מסוימת בערך. לדוגמה, החלפה 10 מחליפה את "פיסיק" ל"פיזיק", על מנת למנוע החלפה זו בדף יש להוסיף {{ללא בוט|10}}.

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

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

קישורים חיצוניים[עריכת קוד מקור]

  • [github.com/eranroz/hewiki-ReplaceBot קוד המקור של הבוט] והוראות הפעלה