Jump to content

دليل:باي ويكي بوت/متوافق/استخدام بسيط

From mediawiki.org
This page is a translated version of the page Manual:Pywikibot/Compat/Basic use and the translation is 100% complete.

الاستخدام

انظر إنشاء اختصار لمستخدمي ويندوز.

اختيار وتشغيل نص برمجي للبوت

الآن بعد أن قمت بتثبيت بايثون وباي ويكي بوت، تحتاج إلى الحصول على واجهة نصية لنظام التشغيل الخاص بك.

الولوج إلى باي ويكي بوت

بعد أن أنشأت الملف المسمى user-config.py ، يمكن الولوج إلى باي ويكي بوت.

على ويندوز يمكن عمل ذلك بفتح قائمة ابدأ، ثم الضغط على 'Run'. ثم سيسألك لتعطيه اسم البرنامج، اكتب "cmd.exe".

  • قم بتغيير الجذر إلى C: عن طريق كتابة chdir C:\
  • اكتب chdir \"اسم المجلد الذي قمت بتحميل باي ويكي بوت فيه" "(على سبيل المثال: chdir \"pywikibot" إن كان الملف في مجلد C:.)"

الخطوات التالية قد تحتاج لاتباعها:

  • انقل المجلد httplib2 الذي في المجلد الفرعي externals إلى مستوى أعلى.
  • كل النصوص البرمجية التي ستستخدمها لا بد أن تُنسَخ من المجلد الفرعي scripts إلى المجلد الرئيسي. وهذا يتضمن login.py.

على ماك، اعثر على Terminal.app في /Applications/Utilities، انظر التثبيت على ماك.

على لينكس أو أي نظام يونكس، استخدام أي تطبيق طرفية مثل gnome-terminal أو konsole أو xterm أو ببساطة وحدة التحكم بنمط نصي.

في المتوافق، قم بتشغيل النص البرمجي login.py عن طريق كتابة "python login.py". إن لم تكن تمتلك user-config.py بعد، هذا الأمر سيقوم بإنشائه بشكل تبادلي.

في النواة، من مجلد النواة، قم بتشغيل النص البرمجي login.py عن طريق كتابة "python pwb.py login". إن لم تكن تمتلك user-config.py بعد، هذا الأمر سيقوم بإنشائه بشكل تبادلي.

لا يقوم pwb.py بإضافة مجلد النواع إلى متغير "المسار" حتى يتمكن البايثون من رؤية مجلد باي ويكي بوت. توجد طرق أخرى لحل هذا مثل إضافة مجلد النواة (أو أي مجلد يتضمن مجلد باي ويكي بوت) إلى "المسار" أو "PYTHONPATH".
إدخال كلمة مرور

سيعرض بايثون:

Password for user your_bot on your_site:en:

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

استخدام بوت

البوتات في مجلد باي ويكي بوت الرئيسي عند تحميلها.

إن كان الأمر ضروريًا، استخدم أمر cd للذهاب إلى المجلد حيث ملفات البوت محفوظة.

الآن قم بتشغيل أي بوت هنا عن طريق كتابة "python botname.py" (إن كنت تستخدم ويندوز، يمكنك إهمال "python").

النصوص البرمجية

الصفحة الرئيسية: Manual:Pywikibot/Scripts

وسائط سطر الأوامر

مع أن كثير من نصوص البوتات لها وسائط سطر الأوامر الخاصة بها، والتي يجب أن تُوثَّق على صفحاتها الخاصة (أو في نصها المصدري)، جميع البوتات إلا إذا ذُكر عكس ذلك تتعرف على وسائط سطر الأوامر الآتية:

(القائمة الكاملة هنا: دليل:باي ويكي بوت/خيارات عامة )

-help
يطبع قائمة من وسائط البوت العامة (هذه القائمة)، يليها مساعدة بوت مخصوصة إن كانت متاحة.
-lang:xx
يضبط لغة الويكي التي تريد العمل عليها إلى رمز اللغة xx، متجاوزًا الإعداد في user-config.py.
-family:xyz
يضبط عائلة الويكي التي تريد العمل عليها، "مثلاً" ويكيبيديا أو ويكاموس ويكي الرحلات... سيتجاوز الإعداد في user-config.py.
-user:xyz
سجل دخولك بمستخدم 'xyz' بدلاً من المستخدم الافتراضي.
-log
تفعيل ملف السجل. ستُخزن في مجلد السجلات الفرعي.
-log:xyz
تفعيل ملف السجل، مع تسمية الملف باسم xyz.
-nolog
تعطيل ملف السجل (إن كان مُفعَّلاً افتراضيًا).
-putthrottle:nn
يضبط أقل وقت (بالثواني) سينتظره البوت بين حفظ صفحتين. القيمة الافتراضية هي 10.

على سبيل المثال، python scriptname.py -family:wiktionary سيقوم بتشغيل بوت "scriptname" على مقالات ويكاموس، متجاوزًا العائلة الافتراضية المكتوبة في ملف الإعداد الخاص بالمستخدم.

الإذن على مشاريع ويكيميديا

تأكد أن البوت الخاص بك يوافق عليه مجتمع الويكي حيث ستستخدمه: انظر سياسة البوت العامة للإرشاد. تختلف الصرامة بشكل كبير بين المشاريع المختلفة.

باستخدام متصفحك العادي، قم بإنشاء اسم دخول وكلمة مرور للبوت. من الأفضل استخدام اسم يدل بشكل واضح على أنه بوت، ويُفضَّل أيضًا من يديره. الطريقة المنتشرة هي استخدام اسمك للدخول وإضافة كلمة "بوت" إليه، ولكن توجد أيضًا أشكال أخرى عديدة.