לדלג לתוכן

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

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


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


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


מומלץ להפעיל אותו אחת לחודש.
הבוט מופעל על פי החלטות שהתקבלו על ידי כלל החב"דפדים. ניתן להציע הצעות לתיקון שגיאות ב[[חב"דפדיה:בוט/בוט החלפות/אולם דיונים|אולם הדיונים]]. הבוט מופעל אחת לחודש מחשבון שיע בוט.
 
==איך פועל הבוט?==
הבוט הוא בשפת פייתון, על בסיס תשתית pywikibot, עם התאמות לחב"דפדיה העברית על ידי ערן. הקוד נכתב על ידי [[משתמש:ערן|ערן]] והוא משוחרר תחת רישיון MIT.
 
הבוט פועל בשני שלבים. קודם כל הוא עובר על קובץ XML הכולל את מסד הנתונים של חב"דפדיה. תוצאת המעבר היא רשימת כל הערכים הכוללים את המילים או הביטויים שיש להחליף המוגדרים ב[[חב"דפדיה:בוט/בוט החלפות/רשימת החלפות נוכחית]], ומוסיף החרגות להחלפות שמשנות שמות של דפים ([[חב"דפדיה:בוט/בוט החלפות/דפים חריגים]]). לאחר מכן הבוט עובר על כל ערך שנמצא, מוריד את תוכנו העדכני מחב"דפדיה, מבצע את ההחלפה (כולל ביצוע החלפות שאושרו בעבר) ושומר. ההחלפה מבוססת על ביטויים רגולריים (Regex).
 
הבוט פועל על דפים ב[[עזרה:מרחב שם|מרחבי השם]] הבאים:
* מרחב הערכים
* מרחב שם תבנית
* מרחב שם קטגוריה
* מרחב שם פורטל
 
== סקריפט החלפות ==
מלבד פעולת הבוט, מתבצעות ההחלפות גם על ידי המשתמשים באמצעות [[שיחת מדיה ויקי:Gadget-Checkty|סקריפט המבצע פעולה זהה]] על פי אותה רשימה. בכדי להפעיל את הסקריפט יש להיכנס ל'''[[מיוחד:העדפות#mw-prefsection-gadgets|מיוחד:העדפות]]''' -> '''גאדג'טים''' -> '''הוספת כפתור לבדיקת בעיות סגנון ולשון נפוצות'''. כעת התווסף במצב עריכה כפתור בשם '''בדיקה''', לחיצה על כפתור זה תבצע בדיקה ותתקן את הטעון תיקון.


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


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


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


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

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

בוט ההחלפות

ראו גם:

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

  • תשפ"ה: 1

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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