دليل:باي ويكي بوت/متوافق/استخدام بسيط
 | This page is documentation for Pywikipedia Compat, which is no longer supported. This page is kept for historical interest. It may document scripts and features that are obsolete and/or no longer supported. Do not rely on the information here being up-to-date. |
الاستخدام
- انظر إنشاء اختصار لمستخدمي ويندوز.
اختيار وتشغيل نص برمجي للبوت
الآن بعد أن قمت بتثبيت بايثون وباي ويكي بوت، تحتاج إلى الحصول على واجهة نصية لنظام التشغيل الخاص بك.
- الولوج إلى باي ويكي بوت
بعد أن أنشأت الملف المسمى 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 بعد، هذا الأمر سيقوم بإنشائه بشكل تبادلي.
- إدخال كلمة مرور
سيعرض بايثون:
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" على مقالات ويكاموس، متجاوزًا العائلة الافتراضية المكتوبة في ملف الإعداد الخاص بالمستخدم.
الإذن على مشاريع ويكيميديا
تأكد أن البوت الخاص بك يوافق عليه مجتمع الويكي حيث ستستخدمه: انظر سياسة البوت العامة للإرشاد. تختلف الصرامة بشكل كبير بين المشاريع المختلفة.
باستخدام متصفحك العادي، قم بإنشاء اسم دخول وكلمة مرور للبوت. من الأفضل استخدام اسم يدل بشكل واضح على أنه بوت، ويُفضَّل أيضًا من يديره. الطريقة المنتشرة هي استخدام اسمك للدخول وإضافة كلمة "بوت" إليه، ولكن توجد أيضًا أشكال أخرى عديدة.