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

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

مستودع جت لويكيميديا به هذا الملف: scripts/listpages.py

listpages.py هو نص برمجي من باي ويكي بوت يُستخدم لطباعة قائمة الصفحات، كما هو معرف بوسائط مولد الصفحات.

اختياريًا، قد يطبع محتوى الصفحة إلى STDOUT أو يحفظها في ملف في المجلد الحالي.

وسائط معينة

الوسيط الوصف

-format

يقوم بتعريف صيغة الخرج.

قد يكون نصًا مخصصًا طبقًا لتدوين دالة بايثون string.format() أو قد يكون مُختارًا برقم من القائمة التالية (1 هو الصيغة الافتراضية):

1	`'{num:4d} {page.title}'`	`10 PageTitle`
2	`'{num:4d} [[{page.title}]]'`	`10 [[PageTitle]]`
3	`'{page.title}'`	`PageTitle`
4	`'[[{page.title}]]'`	`[[PageTitle]]`
5	`'{num:4d} \03{{lightred}}{page.loc_title:<40}\03{{default}}'`	10 localised_Namespace:PageTitle (*) (ملون بالأحمر الفاتح)
6	`'{num:4d} {page.loc_title:<40} {page.can_title:<40}'`	`10 localised_Namespace:PageTitle canonical_Namespace:PageTitle`
7	`'{num:4d} {page.loc_title:<40} {page.trs_title:<40}'` (*) يتطلب ضبط "$outputlanglang".	`10 localised_Namespace:PageTitle outputlang_Namespace:PageTitle`

num هو الرقم التسلسلي للصفحة المسردة.

صيغة فارغة تساوي -notitle وتعرض فقط العدد الكلي للصفحات.

-outputlang لغة ترجمة النطاقات.

-notitle عنوان الصفحة غير مطبوع.

-get محتوى الصفحة مطبوع.

-save حفظ محتوى الصفحة إلى ملف يسمى $title. يمكن ضبط المجلد باستخدام $savedir_name. إن لم يتحدد المجلد، المجلد الحالي سوف يُستخدَم. Directory can be set with -save:dir_name. If no dir is specified, current directory will be used.

-encode ترميز الملف يمكن تحديده باستخدام '$encodename' (الاسم يجب أن يكون بترميز بايثون صحيح: utf-8، إلخ...). إن لم يكن محددًا، فإن الافتراضي $config. If not specified, it defaults to config.textfile_encoding.

-put: يحفظ القائمة إلى الصفحة المحددة من الويكي. بشكل افتراضي لا يستبدل صفحة موجودة.

-overwrite يستبدل الصفحة إن وُجِدت. يمكن تطبيقه باستخدام $put. Can only by applied with -put.

-summary: نص الملخص عند كتابة الصفحة. إن كانت كلمة واحدة تحتوي فقط على حروف وشرطات وسطية وسفلية فإنه يستخدم ذلك مفتاحًا للترجمة.

يمكن تطبيق صيغة مخصصة على العناصر التالية بالاستقراء من كائن صفحة:

site - obtained from page._link._site.
title - obtained from page._link._title.
loc_title - obtained from page._link.canonical_title().
can_title - obtained from page._link.ns_title(). based either the canonical namespace name or on the namespace name in the language specified by the -trans parameter; a default value '******' will be used if no ns is found.
onsite - obtained from pywikibot.Site(outputlang, self.site.family).
trs_title - obtained from page._link.ns_title(onsite=onsite). If selected format requires trs_title, outputlang must be set.

المولدات والمرشحات متاحة

خيارات المولد
الوسيط	الوصف
`-cat`	يعمل على كل الصفحات التي توجد في تصنيف محدد. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-cat:categoryname» أو «-cat:categoryname\|fromtitle» (استخدام # بدلاً من \| مسموح به أيضًا في هذا الوسيط والتالي)
`-catr`	مثل -cat، ولكن يتضمن الصفحات المتكررة أيضًا في التصنيفات الفرعية، والفرعية منها إلخ... من التصنيف المعطى. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-catr:categoryname» أو «-catr:categoryname\|fromtitle».
`-subcats`	يعمل على كل التصنيفات الفرعية من تصنيف معين. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-subcats:categoryname» أو «\|:categoryname\|fromtitle».
`-subcatsr`	مثل -subcats، ولكن يتضمن تصنيفات فرعية من التصنيفات الفرعية إلخ... من التصنيف المعطى. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-subcatsr:categoryname» أو «-subcatsr:categoryname\|fromtitle».
`-uncat`	يعمل على كل الصفحات غير المصنفة.
`-uncatcat`	يعمل على كل التصنيفات غير المصنفة.
`-uncatfiles`	يعمل على كل الملفات غير المصنفة.
`-file`	يقرأ قائمة صفحات ليتعامل من الملف النصي المسمى. عناوين الصفحات في الملف قد تكون محاطة بأقواس (مثال: `[[Page]]`)، أو مفصولة عن بعضها البعض بسطور جديدة. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-file:filename».
`-filelinks`	يعمل على كل الصفحات التي تستخدم ملف صورة أو ملف وسائط معين. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-filelinks:filename».
`-search`	يعمل على كل الصفحات الموجودة في بحث ميدياويكي عبر كل النطاقات .
`-logevents`	يعمل على المقالات الموجودة على خاص:سجل معين. القيمة قد تكون قائمة مفصولة عن بعضها بفاصلة من هذه القيم: logevent,username,start,end أو بالنسبة للتوافقية الخلفية: logevent,username,total لاستخدام القيمة الافتراضية، استخدم نصًا فارغًا. لديك خيارات لكل نوع من السجلات المعطاة من وسيط حدث السجل الذي قد يكون الآتي: spamblacklist, titleblacklist, gblblock, renameuser, globalauth, gblrights, gblrename, abusefilter, massmessage, thanks, usermerge, block, protect, rights, delete, upload, move, import, patrol, merge, suppress, tag, managetags, contentmodel, review, stable, timedmediahandler, newusers يستخدم رقم الصفحات الافتراضي 10. أمثلة: -logevents:move gives pages from move log (usually redirects) -logevents:delete,,20 gives 20 pages from deletion log -logevents:protect,Usr gives pages from protect by user Usr -logevents:patrol,Usr,20 gives 20 patroled pages by Usr -logevents:upload,,20121231,20100101 gives upload pages in the 2010s, 2011s, and 2012s -logevents:review,,20121231 gives review pages since the beginning till the 31 Dec 2012 -logevents:review,Usr,20121231 gives review pages by user Usr since the beginning till the 31 Dec 2012 في بعض الحالات يجب أن يكون معطى بصيغة `-logevents:"move,Usr,20"`
`-interwiki`	يعمل على الصفحة المعطاة وكل الصفحات المناظرة باللغات الأخرى. يمكن استخدام - على سبيل المثال - هذا لقتال المواقع المتعددة غير المرغوبة. انتباه: سيتسبب هذا بتعديل البوت للصفحات على عدة مواقع ويكي، وهذا غير مُختبَر بدقة، لذا تفحص تعديلاتك!
`-links`	يعمل على كل الصفحات المتصلة بصفحة معينة. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-links:linkingpagetitle».
`-liverecentchanges`	يعمل على صفحات من أحدث التغييرات المباشرة. إن كان يُستخدَم بصيغة -liverecentchanges:x، فإنه يعمل على أحدث التغييرات x.
`-imagesused`	يعمل على كل الصور الموجودة بصفحة معينة. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-imagesused:linkingpagetitle».
`-newimages`	يعمل على أحدث الصور. If given as -newimages:x, will work on x newest images.
`-newpages`	يعمل على أحدث الصفحات. إن كان يُستخدَم بصيغة -newpages:x، فإنه سيعمل على أحدث الصفحات x.
`-recentchanges`	يعمل على الصفحات بأحدث التغييرات. إن كان معطى بصيغة `-recentchanges:x`، فإنه سيعمل على أحدث تغييرات صفحات x. إن كان معطى بصيغة `-recentchanges:offset,duration` فإنه سيعمل على الصفحات المتغيرة للفترة الزمنية من دقائق الإزاحة 'offset' لدقائق 'duration'. أيضًا: `-recentchanges:20` - gives the 20 most recently changed pages `-recentchanges:120,70` - will give pages with 120 offset minutes and 70 minutes of timespan `-recentchanges:visualeditor,10` - gives the 10 most recently changed pages marked with 'visualeditor' `-recentchanges:"mobile edit,60,35"` - will retrieve pages marked with 'mobile edit' for the given offset and timespan rctags are supported, and the rctag must be the very first parameter part.
`-unconnectedpages`	يعمل على أحدث الصفحات غير المتصلة بمستودع قاعدة ويكي. إن كان معطى بصيغة -unconnectedpages:x، فإنه سيعمل أحدث صفحات x غير متصلة.
`-ref`	يعمل على كل الصفحات المتصلة بصفحة معينة. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-ref:referredpagetitle».
`-start`	يحدد إذا ما كان ينبغي على الروبوت أن يفحص كل الصفحات على الويكي الأصل أبجديًا، ابتداءً من الصفحة المسماة. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-start:pagetitle». يمكنك أيضًا تضمين نطاق. على سبيل المثال، «-start:Template:!» سيجعل البوت يعمل على كل الصفحات في نطاق القالب. القيمة الافتراضي هي start:!
`-prefixindex`	يعمل على الصفحات التي تبدأ ببادئة مشتركة.
`-transcludes`	يعمل على كل الصفحات التي تستخدم قالب معين. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-transcludes:Title».
`-unusedfiles`	يعمل على كل صفحات الوصف لملفات الصور والوسائط التي ليست مستخدمة في أي مكان. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-unusedfiles:n» حيث أن n هو أقصى عدد للمقالات.
`-lonelypages`	يعمل على كل المقالات التي لا تصل إليها أي مقالة أخرى. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-lonelypages:n» حيث أن n هو أقصى عدد للمقالات.
`-unwatched`	يعمل على كل المقالات التي لا يراقبها أي أحد. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-unwatched:n» حيث أن n هو أقصى عدد للمقالات.
`-property:name`	يعمل على كل الصفحات باسم خاصية معطاة من خاص:صفحات بخاصية
`-usercontribs`	يعمل على كل المقالات التي قام بتعديلها مستخدم معين. (مثال: -usercontribs:DumZiBoT)
`-weblink`	يعمل على كل المقالات التي تحتوي أي وصلة خارجية لمسار معطى؛ قد يكون معطى بصيغة «-weblink:url»
`-withoutinterwiki`	يعمل على كل الصفحات التي لا تحتوي على وصلات لغات. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-withoutinterwiki:n» حيث أن n هو العدد الكلي لجلب الصفحات.
`-mysqlquery`	يأخذ نص استعلام ماي إس كيو إل مثل "SELECT page_namespace, page_title, FROM page WHERE page_namespace = 0" ويعمل على الصفحات الناتجة. انظر دليل:باي ويكي بوت/ماي إس كيو إل .
`-sparql`	يأخذ نص استعلام SPARQL SELECT متضمنًا ?item ويعمل على الصفحات الناتجة.
`-sparqlendpoint`	يخصص نقطة نهاية SPARQL للمسار (اختياري). (مثال: -sparqlendpoint:http://myserver.com/sparql)
`-searchitem`	يأخذ نص بحث ويعمل صفحات قاعدة ويكي التي تحتوي عليه. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-searchitem:text»، حيث أن text هو النص المبحوث عنه، أو «-searchitem:lang:text»، حيث أن lang هي اللغة التي سيبحث بها عن العناصر.
`-random`	يعمل على صفحات عشوائية تجلبها خاص:صفحة عشوائية. يمكن أن يكون أيضًا معطى بصيغة «-random:n» حيث n هو عدد الصفحات التي ستُجلَب.
`-randomredirect`	يعمل على صفحات تحويل عشوائية تجلبها خاص:تحويلة عشوائية. يمكن أن يكون أيضًا معطى بصيغة «-randomredirect:n» حيث n هو عدد الصفحات التي ستُجلَب.
`-google`	يعمل على كل الصفحات المعثور عليها في بحث غوغل. أنت بحاجة مفتاح ترخيص واجهة برمجة التطبيقات (API) لغوغل ويب. لاحظ أن غوغل لم تعد تمنح مفاتيح ترخيص. انظر google_key في config.py لأجل التعليمات. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-google:searchstring».
`-yahoo`	يعمل على كل الصفحات المعثور عليها في بحث ياهو. Depends on python module pYsearch. See yahoo_appid in config.py for instructions.
`-page`	يعمل على صفحة وحيدة. الوسيط يمكن أن يكون أيضًا معطى بصيغة «-page:pagetitle»، ومزود عدة مرات لعدة صفحات.
`-pageid`	يعمل على معرف صفحة وحيدة. Argument can also be given as "-pageid:pageid1,pageid2,." or "-pageid:'pageid1\|pageid2\|..'" and supplied multiple times for multiple pages.
`-linter`	يعمل على الصفحات التي تحتوي أخطاء ألياف. Extension Linter must be available on the site. -linter select all categories. -linter:high, -linter:medium or -linter:low select all categories for that prio. Single categories can be selected with commas as in -linter:cat1,cat2,cat3 Adding '/int' identifies Lint ID to start querying from: e.g. -linter:high/10000 -linter:show just shows available categories.

خيارات المرشح
الوسيط	الوصف
`-catfilter`	يرشح مولد الصفحات إلى الصفحات العائدة في التصنيف المحدد. انظر مولد -cat لصيغة الوسيط.
`-grep`	تعبير نمطي يحتاج لمطابقة المقالة وإلا فإن الصفحة لن يرجع بها. العديد من -grep:regexpr يمكن توفيرها وسيرجع بالصفحة إن كان المحتوى مطابقًا لأي regexpr متوفر. التعابير النمطية غير الحساسة لحالة الأحرف ستُستخدم وستطابق أي حرف، من ضمنها الأسطر الجديدة.
`-grepnot`	Like -grep, but return the page only if the regular expression does not match.
`-intersect`	يعمل على تقاطع كل المولدات المتوفرة.
`-limit`	عندمام يُستخدم مع أي وسيط آخر فإن -limit:n يحدد مجموعة من الصفحات، ولا يعمل على أكثر من عدد إجمالي n من الصفحات.
`-namespaces` `-namespace` `-ns`	يرشح مولد الصفحات إلى الصفحات الراجعة من النطاق المحددة. يفصل أرقام أو أسماء عدة نطاقات بفاصلة. أمثلة: -ns:0,2,4 -ns:Help,MediaWiki يمكنك استخدام البادئة «not» لاستثناء النطاق. أمثلة: -ns:not:2,3 -ns:not:Help,File If used with -newpages/-random/-randomredirect/-linter generators, -namespace/-ns must be provided before -newpages/-random/-randomredirect/-linter. If used with -recentchanges generator, efficiency is improved if -namespace is provided before -recentchanges. If used with -start generator, -namespace/-ns shall contain only one value.
`-onlyif`	ادعاء تحتاجه الصفحة للاحتواء، وإلا فلن ترجع. The format is property=value,qualifier=value. Multiple (or none) qualifiers can be passed, separated by commas. Examples: `P1=Q2` (property P1 must contain value Q2) `P3=Q4,P5=Q6,P6=Q7` (property P3 with value Q4 and qualifiers: P5 with value Q6 and P6 with value Q7) Value can be page ID, coordinate in format: latitude,longitude[,precision] (all values are in decimal degrees), year, or plain string. The argument can be provided multiple times and the item page will be returned only if all claims are present. Argument can be also given as "`-onlyif:expression`".
`-onlyifnot`	ادعاء يجب ألا تحتويه الصفحة، وإلا فإن العنصر لا يرجع. للاستخدام والأمثلة، انظر `-onlyif` بالأعلى.
`-ql`	يرشح الصفحات بناءً على جودة الصفحة. هذا قابل للتطبيق فقط إن كان contentmodel يساوي 'proofread-page'، وإلا فلن يكون له آثار. القيم الصالحة في مدى 0-4. يمكن فصل القيم المتعددة بفاصلة.
`-subpage`	-subpage:n يرشح الصفحات إلى صفحات تحتوي على عمق n أي أن عمق 0 يرشح كل الصفحات الفرعية، وعمق 1 يرشح كل الصفحات الفرعية المتصلة بصفحات فرعية أخرى.
`-titleregex`	تعبير نمطي يحتاج لمطابقة المقالة وإلا فإن الصفحة لن يرجع بها. العديد من -titleregex:regexpr يمكن توفيرها وسيرجع بالصفحة إن كان المحتوى مطابقًا لأي regexpr متوفر. التعابير النمطية غير الحساسة لحالة الأحرف ستُستخدم وستطابق أي حرف، من ضمنها الأسطر الجديدة.
`-titleregexnot`	مثل `-titleregex`، ولكن يرجع بالصفحة إن كان التعبير النمطي غير متطابق.

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

هذه الخيارات ستتجاوز ملف الإعداد في إعدادات 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`	قد تستخدم كل متغيرات الإعداد العددية المعطاة على أنها خيارات وتعدلها بأمر سطري.