ויקיטקסט:הזנה אוטומטית

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

רק לתת טקסט וללכת

יש לכם טקסט בתוך קובץ אבל אין לכם זמן להתעסק איתו ואתם פשוט רוצים שמישהו ידאג לו?

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

• עמד (שיחה | תרומות | מונה)
• מושך בשבט (שיחה | תרומות | מונה)
• שלום אורי (שיחה | תרומות | מונה)

רוצים לעזור ולתרום בתהליך

רוצים שהטקסט יוזן מהר ללא התעכבויות אצל משתמשים אחרים?

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

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

הפורמט של הסקריפט

הפורמט הוא כמו בדוגמה להלן:

הזנהאוטומטית שם הדף
תוכן הדף
הזנהאוטומטית שם הדף
תוכן הדף

שימו לב הזנהאוטומטית היא מילה שמורה ואין בה רווחים. את הקובץ עליכם להעלות לדף כלשהו במרחב המשתמש שלכם.

לעדכן על הדף המוכן

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

• מושך בשבט (שיחה | תרומות | מונה)
• עמד (שיחה | תרומות | מונה)

הפורמט של Pywikibot

הפורמט הזה גמיש יותר ומאפשר לבחור בעצמך את המילים השמורות, כלומר את רצף התווים שמחלק בין הדפים. צריכה להיות מילה לתחילת דף ומילה לסיומו. ברירת המחדל היא {{-start-}} להתחלה ו-{{-stop-}} לסיום של כל דף, אבל אפשר לבחור כל סימון אחר ולהודיע על כך לבוט או למשתמש שמריץ אותו. הכותרת של הדף תהיה הטקסט הראשון בתוך הדף שמודגש באמצעות שלושה תגים (''') בתחילתו ובסופו, אבל גם את זה אפשר לבחור.

לדוגמה:

{{-start-}}
 '''שם הדף'''
 תוכן הדף
 {{-stop-}}
 {{-start-}}
 '''שם הדף'''
 תוכן הדף
 {{-stop-}}

דוגמה אחרת:

סתם משפט שאני רוצה לבחור לתחילת דף
&&&שם הדף₪₪
תוכן הדף
End of page
סתם משפט שאני רוצה לבחור לתחילת דף
&&&שם הדף₪₪
תוכן הדף
End of page

לשלוח את הקובץ המוכן

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

• שלום אורי (שיחה | תרומות | מונה)

אפשרות שלישית - בוט הפיצולים

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

כאשר אתם מעוניינים בפיצול ניתן לפנות ל:

• שלום אורי (שיחה | תרומות | מונה)

הרצת הסקריפט באופן עצמאי

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

חשוב להבין שמדובר בפעולות שקשה מאוד לבטל ולכן חייבים להיות בטוחים שהכול תקין!

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

קוד הסקריפט

הוראות הפעלה

• יש לכתוב את שם הדף שבו נמצא הטקסט, למשל משתמש:חיים/ארגז חול, במקום המילים שם הדף שבו נמצא הטקסט שבמשתנה var ORIGINAL.
• יש לכתוב תקציר עריכה לכל ההעלאות במקום המילים [[ויקיטקסט:הזנה אוטומטית|העלאה אוטומטית של טקסטים]].
• הרצת הסקריפט מתבצעת ישירות דרך הקונסול שבדפדפן. לאחר שבטוח שהכל תקין, יש להיכנס לדף המשתמש שלכם או לאחד מדפי המשנה שלו, וללחוץ בו זמנית על מקשי המקלדת ctrl+shift+j. יפתח לכם חלון קטן בצד הדפדפן. הדביקו בו את טקסט הסקריפט ולחצו על אנטר.

(function(){
    var MAIN = ''
    var SUMMARY = 'הזנה אוטומטית'
    var ORIGINAL = 'שם הדף שבו נמצא הטקסט'
    var api = new mw.Api()

    api.get( {
        action: 'parse',
        page: ORIGINAL,
        prop: 'wikitext',
    } ).done( function ( o ) {
        var text = o.parse.wikitext['*']
        text.split(/הזנהאוטומטית/).forEach(function(p,i){
            var s = p.match(/^\s+(.*?)\n(.*)$/s); // fixed
            if (s){
                api.create(MAIN+s[1],
                    { summary: '[[ויקיטקסט:הזנה אוטומטית|הזנה אוטומטית של טקסטים]]', bot:true},
                    s[2].trim()
                ).done(function(){console.log([i,'created', s[1]])})
                .fail(function(e){console.log([i, 'failed', s[1],e])});
            }
        })
    } );
})();

הרצת PyWikiBot באופן עצמאי

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

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

ההעלאה מתבצעת באמצעות הסקריפט המובנה של הבוט pagefromfile. כדי להשתמש בו יש לכתוב בטרמינל (CMD) של המחשב את הקוד הבא:

cd /path/to/pywikibot/directory
 
python pwb.py pagefromfile -site:wikisource:he -showdiff -notitle -appendbottom -autosummary -file:"/path/to/the/text/file.txt"

יש להחליף את שתי הכתובות שמופיעות, לכתובת התיקייה שבה התקנתם את הבוט, ולכתובת התיקייה שבה ממוקם קובץ הטקסט בהתאמה.

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

-begin:xxx
-end:xxx
-titlestart:xxx
-titleend:xxx

בדוגמה לפורמט שהובאה לעיל יש לכתוב:

cd /path/to/pywikibot/directory
 
python pwb.py pagefromfile -site:wikisource:he -showdiff -notitle -appendbottom -autosummary -begin:'סתם משפט שאני רוצה לבחור לתחילת דף' -end:'End of page' -titlestart:&&& -titleend:₪₪ -file:"/path/to/the/text/file.txt"

התקנת PyWikiBot

יש אפשרות לדלג על ההתקנה ולהריץ את הבוט דרך כלי של מדיה ויקי שנקרא paws. צריך רק להתחבר עם החשבון שלכם ולהריץ את הבוט. קישור: https://hub.paws.wmcloud.org/hub/login

במקרה שמשתמשים בpaws, השורה הראשונה של הרצת הבוט המתחילה ב-cd צריכה להיות:

cd /srv/paws/pwb

אחרת, להתקנת הבוט יש בעיקרון 3 שלבים:

א. התקנת שפת פייתון.

ב. הורדת הבוט.

ג. קביעת התצורה שלו.

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

השלב השני הוא הורדת התיקייה של הבוט של ויקי. ניתן למצוא קובץ zip שלה כאן.

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

cd /path/to/pywikibot/directory

python pwb.py generate_user_files

ראו גם

• מחסן - קבצי טקסט שמחכים להעלאה.