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

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

אנא בדקו אם הטקסט לא נמצא כבר במחסן.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הפורמט של Pywikibot

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

לדוגמה:

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

דוגמה אחרת:

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

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

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

• shalomori123 (שיחה | תרומות | מונה)

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

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

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

קוד הסקריפט

הוראות הפעלה

• יש לכתוב את שם הדף שבו נמצא הטקסט, למשל משתמש:חיים/ארגז חול, במקום המילים שם הדף שבו נמצא הטקסט שבמשתנה 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 -lang:he -family:wikisource -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 -lang:he -family:wikisource -showdiff -notitle -appendbottom -autosummary -begin:'סתם משפט שאני רוצה לבחור לתחילת דף' -end:'End of page' -titlestart:&&& -titleend:₪₪ -file:"/path/to/the/text/file.txt"

התקנת PyWikiBot

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

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

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

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

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

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

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

cd /path/to/pywikibot/directory

python pwb.py generate_user_files