אוצר:העלאה אוטומטית

From אוצר הספרים היהודי השיתופי
Jump to navigation Jump to search

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

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

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

רק לתת טקסט וללכת[edit]

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

אפשרות נוספת היא להוסיף קישור לדף או לכתובת האינטרנט שבהם נמצא הטקסט, בדף אוצר:העלאה אוטומטית/טקסטים#טסקטים הדורשים עריכה, ולקוות שמתנדבי האוצר יטפלו בהם בהקדם.

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

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

הפורמט[edit]

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

<תקציר עריכה> יש לכתוב כאן את תקציר העריכה
תחילתדףכאן שם הדף הראשון
תוכן הדף
תחילתדףכאן שם הדף השני
תוכן הדף

את הטקסט שיצרתם יש להעלות לדף אוצר:העלאה אוטומטית/טקסטים מוכנים/1. אם בדף יש כבר טקסט אחר, העלו את הטקסט שיצרתם לדף אוצר:העלאה אוטומטית/טקסטים מוכנים/2, וכן הלאה.

אם הסקטור הראשון בכל הדפים זהה (הסקטור הראשון זה מה שלפני הסלאש הראשון, למשל בדפים מהסוג דוגמא/א/א, דוגמא/א/ב, הסקטור הראשון הוא "דוגמא"), ניתן להשמיטו ולכתוב רק את הסקטורים הבאים, כמו בדוגמא שלהלן:

<תקציר עריכה> יש לכתוב כאן את תקציר העריכה
תחילתדףכאן א/א
תוכן הדף
תחילתדףכאן א/ב
תוכן הדף

בדוגמא זו, את הטקסט שיצרתם יש להעלות לדף אוצר:העלאה אוטומטית/טקסטים מוכנים/דוגמא.

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

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

  1. בהנחה שהתבנית {{ניווט כללי תחתון}} מונחת בדף. אם היא לא מונחת בדף מסיבה כלשהי, כגון שזהו דף אינדקס, הכניסו את הטקסט [[קטגוריה:אוצר - טקסטים מוכנים להעלאה אוטומטית]] לראש הדף

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

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

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


קוד סקריפט להעלאת דפים בפורמט הראשון
הוראות הפעלה
  • יש לכתוב את שם הדף שבו נמצא הטקסט, למשל אוצר:העלאה אוטומטית/טקסטים מוכנים/1, במקום המילים אוצר:העלאה אוטומטית/טקסטים מוכנים/מספר סידורי שבמשתנה 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: '[[אוצר:העלאה אוטומטית|העלאה אוטומטית של טקסטים]]'},
                    s[2].trim()
                ).done(function(){console.log([i,'created', s[1]])})
                .fail(function(e){console.log([i, 'failed', s[1],e])});
            }
        })
    } );
})();
קוד סקריפט להעלאת דפים שבפורמט השני (שהסקטור הראשון זהה והוא מושמט מכותרת הדפים)
הוראות הפעלה
  • יש לכתוב את שם הסקטור הראשון של הדף, במקום המילים שם הספר שבמשתנה var MAIN.
  • יש לכתוב את שם הדף שבו נמצא הטקסט, למשל אוצר:העלאה אוטומטית/טקסטים מוכנים/דוגמא, במקום המילים שם הדף שבו נמצא הטקסט שבמשתנה 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: '[[אוצר:העלאה אוטומטית|העלאה אוטומטית של טקסטים]]'},
                    s[2].trim()
                ).done(function(){console.log([i,'created', s[1]])})
                .fail(function(e){console.log([i, 'failed', s[1],e])});
            }
        })
    } );
})();
קוד סקריפט להעלאת דפים שבפורמט השני (שהסקטור הראשון זהה והוא מושמט מכותרת הדפים). מוסיף אוטומטית את תבניות הניווט, הועלה אוטומטית, ופורסם בנחלת הכלל
הוראות הפעלה
  • יש לכתוב את שם הסקטור הראשון של הדף, במקום המילים שם הספר שבמשתנה var MAIN.
  • יש לכתוב את שם הדף שבו נמצא הטקסט, למשל אוצר:העלאה אוטומטית/טקסטים מוכנים/דוגמא, במקום המילים שם הדף שבו נמצא הטקסט שבמשתנה var ORIGINAL.
  • יש לכתוב תקציר עריכה במקום המילים [[אוצר:העלאה אוטומטית|העלאה אוטומטית של טקסטים]].
  • הרצת הסקריפט מתבצעת ישירות דרך הקונסול שבדפדפן. לאחר שבטוח שהכל תקין, יש להיכנס לדף המשתמש שלכם או לאחד מדפי המשנה שלו, וללחוץ בו זמנית על מקשי המקלדת ctrl+shift+j. יפתח לכם חלון קטן בצד הדפדפן. הדביקו בו את טקסט הסקריפט ולחצו על אנטר.
(function(){
    var MAIN = 'שם הספר'
    var SUMMARY = 'העלאה אוטומטית'
    var ORIGINAL = 'שם הדף שבו נמצא הטקסט'
    var NIVUTELYON = '{{ניווט כללי עליון}}\n{{הועלה אוטומטית}}\n'
    var NIVUTTACHTON = '\n{{פורסם בנחלת הכלל}}\n{{ניווט כללי תחתון}}'

    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: '[[אוצר:העלאה אוטומטית|העלאה אוטומטית של טקסטים]]'},
                    NIVUTELYON+s[2].trim()+NIVUTTACHTON
                ).done(function(){console.log([i,'created', s[1]])})
                .fail(function(e){console.log([i, 'failed', s[1],e])});
            }
        })
    } );
})();

מעבר לתחילת הדף