Manual:Pywikibot/Compat/Basic use/ar

الاستخدام

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

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


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

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

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


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

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


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

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

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

في المتوافق، قم بتشغيل النص البرمجي عن طريق كتابة "python login.py". إن لم تكن تمتلك user-config.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").

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

 * الصفحة الرئيسية: 

Command-line arguments
Although many bot scripts have their own command line arguments, which should be documented on their respective pages (or in their source code), all bots unless specifically stated to the contrary recognize the following command line arguments:

(full list here: )


 * -help
 * Print a list of global bot arguments (this list), followed by bot-specific help if available.


 * -lang:xx
 * Set the language of the wiki you want to work on to language code, overriding the configuration in.


 * -family:xyz
 * Set the family of the wiki you want to work on, e.g., wikipedia, wiktionary, wikitravel, ... This will override the configuration in.


 * -user:xyz
 * Log in as user 'xyz' instead of the default username.


 * -log
 * Enable the logfile. Logs will be stored in the logs subdirectory.


 * -log:xyz
 * Enable the logfile, using  as the filename.


 * -nolog
 * Disable the logfile (if it's enabled by default).


 * -putthrottle:nn
 * Set the minimum time (in seconds) the bot will wait between saving pages. The default value is 10.

For example,  will run the "scriptname" bot on wiktionary articles, overriding the default family setting in your user configuration.

Permission on Wikimedia projects
Make sure that your bot is approved by the wiki community where you are going to use it: see the global Bot policy for guidance. Strictness differs greatly between various projects.

Using your normal browser, create a login name and password for the bot. It is best to use a name that makes clear that it is a bot, and preferably also who is operating it. A common method is to use your own login name and add the word 'bot' to it, but several other forms also exist.