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

This page is a translated version of the page Manual:Pywikibot/pagefromfile.py and the translation is 64% complete.

$filename هو نص برمجي يُستخدم في Template:$pywikibot لرفع الصفحات إلى ويكي من ملف نصي.

هذا البوت يأخذ دخله من ملف نصي بترميز UTF-8 يحتوي على عدد من الصفحات سوف تُوضَع على الويكي. ينبغي أن يكون بالصفحات نفس نص البداية ونص النهاية (واللذان قد لا يتداخلان). نصا البداية والنهاية لن يُرفعا مع محتوى الصفحة افتراضيًا. The pages should all have the same beginning and ending text (which may not overlap). The beginning and ending text is not uploaded with the page content by default.

بما أنه اسم صفحة يُؤخَذ افتراضيًا من أول كتلة نصية من محتوى الصفحة وهو نص غليظ (محصور بين $boldOpen و $boldOpen). إن كنت تتوقع أن عنوان الصفحة ليس موجودًا في النص أو مُعلَّما بعلامات مختلفة، استخدم وسائط $titlestart و$titleend و$notitle. If you expect the page title not to be present in the text or marked by different markers, use -titlestart, -titleend, and -notitle parameters.

وسائط معينة

الوسيطالوصف
-file:xxx اسم الملف الذي سنجلب منه المحتوى، القيمة الافتراضي هي "dict.txt" Notice that if the source file name contains any space character, you should wrap it with double quotations (i.e. -file:"Page title").
-begin:xxx النص الذي يحدد بداية صفحة، القيمة الافتراضي هي "{{-start-}}"
-end:xxx النص الذي يحدد نهاية الصفحة، القيمة الافتراضية هي "{{-stop-}}"
-include يتضمن علامتي بداية الصفحة ونهايتها
-textonly النص معطى بدون علامات. صفحة نصية واحدة معطاة. يتجاهل اختياريّ $begin و$end. Only one page text is given. -begin and -end options are ignored.
-titlestart:xxx النص المستخدم بدلاً من $boldAgain لتعريف بداية عنوان صفحة
-titleend:xxx النص المستخدم بدلاً من ''' للتعريف بنهاية عنوان الصفحة
-notitle لا يتضمن عنوان الصفحة، بما فيه titlestart وtitleend، للصفحة. يمكن استخدامه لتحديد عنوان صفحة فريد فوق محتوى الصفحة. Can be used to specify unique page title above the page content
-title:xxx عنوان الصفحة معطى مباشرةً. يتجاهل اختيارات $titlestart و$titleend و$notitle Ignores -titlestart, -titleend and -notitle options
-nocontent:xxx إن كانت الصفحة الموجودة تتضمن جملة معينة، فإنه سيتجاهل الصفحة من التحرير
-noredirect لا ترفع على صفحات تحويل
-summary:xxx النص المستخدم لملخص التعديل في الرفع. إن كانت الصفحة موجودة، الرسائل القياسية للتعليق المسبق أو التذييل أو الاستبدال تُضاف بعدها. If the page exists, standard messages for prepending, appending, or replacement are appended after it
-autosummary يستخدم ملخص ميدياويكي التلقائي عن إنشاء صفحة جديدة، متجاوزًا -summary
-minor يضع علامة تعديل طفيف على تعديلات الصفحة
-showdiff يُظهر الاختلاف بين الصفحة الحالية والصفحة التي سوف تُرفَع، وأيضًا يُجبر البوت لطلب التأكيد عند كل تعديل

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


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

من المحتمل تعريف فاصل بعد أنماط '$append' والذي يُضاف بين النص القديم والجديد. على سبيل المثال وسيط $appendtopfoo$code سيُضيف 'foo' بينهما. سطر جديد يمكن إضافته بينهما بتحديد '$newline' على أنها قيمة. For example a parameter -appendtop:foo would add 'foo' between them. A new line can be added between them by specifying '\n' as a value.

أمثلة

مثال بسيط

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

{{-start-}}
'''باي ويكي بوت''' (Pywikibot) هو مكتبة بلغة البايثون وتجميعة نصوص برمجية تعمل تلقائيًا على مواقع ميدياويكي. صُمم في الأصل ليعمل على ويكيبيديا، وهو الآن يُستخدَم خلال مشاريع مؤسسة ويكيميديا وعلى مواقع ويكي أخرى.
<span lang="en" dir="ltr" class="mw-content-ltr">Originally designed for Wikipedia, it is now used throughout the Wikimedia Foundation's projects and on many other wikis.</span>
{{-stop-}}
{{-start-}}
'''أوتو ويكي براوزر''' (أحيانًا يُختصَر إلى '''أوب''') هو محرر ميدياويكي شبه تلقائي مصمم ليجعل مهمات التعديل الممل أو المتكرر أسرع وأسهل.
{{-stop-}}

قم بتخزين هذا الملف النص بترميز UTF-8، مثلاً على أنه '$pages'. يمكنك بعدئذٍ تشغيل $example. هذا سيسمح للبوت بإنشاء باي ويكي بوت وأوتو ويكي براوزر -- أول عنصران '''غليظان''' في كلتا الصفحتين. $showdiff سيمنح الفرص لمراجعة التغييرات قبل تنفيذها. You can then run python pwb.py pagefromfile -showdiff -file:pages.txt. This will let the bot create Pywikibot and AutoWikiBrowser -- the first '''bolded''' elements in both pages. -showdiff will give you the opportunity to review changes before they are being made.

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

أحيانًا، العنصر الغليظ الأول ليس بالضروروة عنوان الصفحة الصحيح. على سبيل المثال، قد نريد وضع المقالة عن أوتو ويكي بروازر على أوب بدلا من ذلك. لفعل ذلك، قم بإضافة سطر في بداية كل مقالة، بعنوان الصفحة الصحيح بين علامات اقتباس ثلاثية (بمعنى، غليظة): For example, we might want to place the article about AutoWikiBrowser on AWB instead. To do so, add a line in front of each article, with the correct page title between triple quotes (i.e., bolded):

{{-start-}}
''''''باي ويكي بوت'''
 '''باي ويكي بوت''' (Pywikibot) هو مكتبة بلغة البايثون وتجميعة نصوص برمجية تعمل تلقائيًا على مواقع ميدياويكي. صُمم في الأصل ليعمل على ويكيبيديا، وهو الآن يُستخدَم خلال مشاريع مؤسسة ويكيميديا وعلى مواقع ويكي أخرى.'''
'''Pywikibot''' is a Python library and collection of scripts that automate work on MediaWiki sites.
Originally designed for Wikipedia, it is now used throughout the Wikimedia Foundation's projects and on many other wikis.
{{-stop-}}
{{-start-}}
''''''أوب'''
'''أوتو ويكي براوزر''' (أحيانًا يُختصَر إلى '''أوب''') هو محرر ميدياويكي شبه تلقائي مصمم ليجعل مهمات التعديل الممل أو المتكرر أسرع وأسهل.'''
'''AutoWikiBrowser''' (often abbreviated '''AWB''') is a semi-automated MediaWiki editor designed to make tedious or repetitive editing tasks quicker and easier.
{{-stop-}}

وقم بإضافة وسيط $notitle إلى الاستدعاء، بمعنى: $example.


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

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

خيارات عامة
المتغير الوصف متغير الإعداد
-dir:المسار يقرأ بيانات الإعداد للبوت من المجلد المعطى من المسار، بدلاً من المجلد الافتراضي.  
-config:file The user config filename. Default is user-config.py. user-config.py
-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 قد تستخدم كل متغيرات الإعداد العددية المعطاة على أنها خيارات وتعدلها بأمر سطري.