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

$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) هو مكتبة بلغة البايثون وتجميعة نصوص برمجية تعمل تلقائيًا على مواقع ميدياويكي. صُمم في الأصل ليعمل على ويكيبيديا، وهو الآن يُستخدَم خلال مشاريع مؤسسة ويكيميديا وعلى مواقع ويكي أخرى.
Originally designed for Wikipedia, it is now used throughout the Wikimedia Foundation's projects and on many other wikis.
{{-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	قد تستخدم كل متغيرات الإعداد العددية المعطاة على أنها خيارات وتعدلها بأمر سطري.