دليل:باي ويكي بوت/pagefromfile.py

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Pywikibot/pagefromfile.py and the translation is 100% complete.

Other languages:
English • ‎français • ‎italiano • ‎polski • ‎čeština • ‎العربية • ‎日本語
Git logo
مستودع جت لويكيميديا به هذا الملف: scripts/pagefromfile.py

pagefromfile.py هو نص برمجي يُستخدم في باي ويكي بوت لرفع الصفحات إلى ويكي من ملف نصي.

هذا البوت يأخذ دخله من ملف نصي بترميز UTF-8 يحتوي على عدد من الصفحات سوف تُوضَع على الويكي. ينبغي أن يكون بالصفحات نفس نص البداية ونص النهاية (واللذان قد لا يتداخلان). نصا البداية والنهاية لن يُرفعا مع محتوى الصفحة افتراضيًا.

بما أنه اسم صفحة يُؤخَذ افتراضيًا من أول كتلة نصية من محتوى الصفحة وهو نص غليظ (محصور بين ''' و '''). إن كنت تتوقع أن عنوان الصفحة ليس موجودًا في النص أو مُعلَّما بعلامات مختلفة، استخدم وسائط -titlestart و-titleend و-notitle.

وسائط معينة

الوسيطالوصف
-file:xxx اسم الملف الذي سنجلب منه المحتوى، القيمة الافتراضي هي "dict.txt"
-begin:xxx النص الذي يحدد بداية صفحة، القيمة الافتراضي هي "{{-start-}}"
-end:xxx النص الذي يحدد نهاية الصفحة، القيمة الافتراضية هي "{{-stop-}}"
-include يتضمن علامتي بداية الصفحة ونهايتها
-textonly النص معطى بدون علامات. صفحة نصية واحدة معطاة. يتجاهل اختياريّ -begin و-end.
-titlestart:xxx النص المستخدم بدلاً من ''' لتعريف بداية عنوان صفحة
-titleend:xxx النص المستخدم بدلاً من ''' للتعريف بنهاية عنوان الصفحة
-notitle لا يتضمن عنوان الصفحة، بما فيه titlestart وtitleend، للصفحة. يمكن استخدامه لتحديد عنوان صفحة فريد فوق محتوى الصفحة.
-title:xxx عنوان الصفحة معطى مباشرةً. يتجاهل اختيارات -titlestart و-titleend و-notitle
-nocontent:xxx إن كانت الصفحة الموجودة تتضمن جملة معينة، فإنه سيتجاهل الصفحة من التحرير
-noredirect لا ترفع على صفحات تحويل
-summary:xxx النص المستخدم لملخص التعديل في الرفع. إن كانت الصفحة موجودة، الرسائل القياسية للتعليق المسبق أو التذييل أو الاستبدال تُضاف بعدها.
-autosummary يستخدم ملخص ميدياويكي التلقائي عن إنشاء صفحة جديدة، متجاوزًا -summary
-minor يضع علامة تعديل طفيف على تعديلات الصفحة
-showdiff يُظهر الاختلاف بين الصفحة الحالية والصفحة التي سوف تُرفَع، وأيضًا يُجبر البوت لطلب التأكيد عند كل تعديل

إن كانت الصفحة التي ستُرفَع موجودة بالفعل، فإنه سيتخطاها افتراضيًا. ولكن يمكنك تجاوز هذا التصرف إن كنت تريد:

الوسيطالوصف
-appendtop يُضيف النص أعلى الصفحة الموجودة
-appendbottom يُضيف النص أسفل الصفحة الموجودة
-force يُعيد كتابة الصفحة الموجودة

من المحتمل تعريف فاصل بعد أنماط 'append' والذي يُضاف بين النص القديم والجديد. على سبيل المثال وسيط -appendtop:foo سيُضيف 'foo' بينهما. سطر جديد يمكن إضافته بينهما بتحديد '\n' على أنها قيمة.

أمثلة

مثال بسيط

بالصيغة الأبسط، يأخذ pagefromfile ملف نصي وحيد به عدة صفحات على أنها مدخلات. على سبيل المثال، المحتويات قد تكون:

{{-start-}}
'''باي ويكي بوت''' (Pywikibot) هو مكتبة بلغة البايثون وتجميعة نصوص برمجية تعمل تلقائيًا على مواقع ميدياويكي. صُمم في الأصل ليعمل على ويكيبيديا، وهو الآن يُستخدَم خلال مشاريع مؤسسة ويكيميديا وعلى مواقع ويكي أخرى.
{{-stop-}}
{{-start-}}
'''أوتو ويكي براوزر''' (أحيانًا يُختصَر إلى '''أوب''') هو محرر ميدياويكي شبه تلقائي مصمم ليجعل مهمات التعديل الممل أو المتكرر أسرع وأسهل.
{{-stop-}}

قم بتخزين هذا الملف النص بترميز UTF-8، مثلاً على أنه 'pages.txt'. يمكنك بعدئذٍ تشغيل python pwb.py pagefromfile -showdiff -file:pages.txt. هذا سيسمح للبوت بإنشاء باي ويكي بوت وأوتو ويكي براوزر -- أول عنصران '''غليظان''' في كلتا الصفحتين. -showdiff سيمنح الفرص لمراجعة التغييرات قبل تنفيذها.

عناوين صحفات مختلفة

أحيانًا، العنصر الغليظ الأول ليس بالضروروة عنوان الصفحة الصحيح. على سبيل المثال، قد نريد وضع المقالة عن أوتو ويكي بروازر على أوب بدلا من ذلك. لفعل ذلك، قم بإضافة سطر في بداية كل مقالة، بعنوان الصفحة الصحيح بين علامات اقتباس ثلاثية (بمعنى، غليظة):

{{-start-}}
'''باي ويكي بوت'''
 '''باي ويكي بوت''' (Pywikibot) هو مكتبة بلغة البايثون وتجميعة نصوص برمجية تعمل تلقائيًا على مواقع ميدياويكي. صُمم في الأصل ليعمل على ويكيبيديا، وهو الآن يُستخدَم خلال مشاريع مؤسسة ويكيميديا وعلى مواقع ويكي أخرى.
{{-stop-}}
{{-start-}}
'''أوب'''
'''أوتو ويكي براوزر''' (أحيانًا يُختصَر إلى '''أوب''') هو محرر ميدياويكي شبه تلقائي مصمم ليجعل مهمات التعديل الممل أو المتكرر أسرع وأسهل.
{{-stop-}}

وقم بإضافة وسيط -notitle إلى الاستدعاء، بمعنى: python pwb.py pagefromfile -showdiff -file:pages.txt -notitle.

الخيارات العامة متاحة

هذه الخيارات ستتجاوز ملف الإعداد في إعدادات user-config.py .

خيارات عامة
المتغيرالوصفمتغير الإعداد
-dir:المسار يقرأ بيانات الإعداد للبوت من المجلد المعطى من المسار، بدلاً من المجلد الافتراضي.  
-lang:xx يضبط لغة الويكي التي تريد العمل عليها، متجاوزًا الإعداد في user-config.py. ينبغي أن تكون xx هي رمز اللغة. mylang
-family:xyz يضبط عائلة الويكي التي تريد العمل عليها، مثل ويكيبيديا أو ويكاموس ويكي الرحلات... هذا سيتجاوز الإعدادات في user-config.py. family
-user:xyz سجل دخولك بمستخدم xyz بدلاً من المستخدم الافتراضي. usernames
-daemonize:xyz يُعيد السيطرة فورًا إلى الطرفية ويعيد تحويل stdout وstderr إلى الملف xyz. (تستخدم فقط للبوتات التي لا تتطلب دخلاً من stdin).  
-help إظهار نص المساعدة.  
-log تفعيل ملف السجل، باستخدام سجلات اسم الملف الافتراضي 'script_name-bot.log' وستُخزن في مجلد السجلات الفرعي. log
-log:xyz تفعيل ملف السجل، مع تسمية الملف باسم 'xyz'. logfilename
-nolog تعطيل ملف السجل (إن كان مُفعَّلاً افتراضيًا).  
-maxlag يضبط متغير تأخير أقصى جديد بعدد من الثواني. تأجيل تعديلات البوت أثناء فترات التأخير لخادم قاعدة البيانات. القيمة الافتراضية مضبوطة بملف config.py maxlag
-putthrottle:n
-pt:n
-put_throttle:n
يضبط أقل وقت (بالثواني) سينتظره البوت بين حفظ صفحتين. put_throttle
-debug:item
-debug
تفعيل ملف السجل وتضمين بيانات معالجة شاملة للمكون "item" (لجميع المكونات إن كان الشكل الثاني مستخدمًا). debug_log
-verbose
-v
جعل البوت يوفر خرج إضافي من وحدة التحكم قد يكون مفيدًا في المعالجة. verbose_output
-cosmeticchanges
-cc
ترجيح إعداد cosmetic_changes المحرر في config.py أو user-config.py إلى معكوسه وإلغائه. جميع الإعدادات الأخرى والقيود تبقى كما هي. cosmetic_changes
-simulate تعطيل الكتابة إلى الخادم. مفيد للاختبار والمعالجة للنص البرمجي الجديد (إن كان معطى، فإنه لا يقوم بأي تغيير حقيقي، ولكنه يعرض ما كان سيتغير). simulate
-<متغير إعداد>:n قد تستخدم كل متغيرات الإعداد العددية المعطاة على أنها خيارات وتعدلها بأمر سطري.