Manual:Pywikibot/Installation/uk

Для встановлення чи оновлення версії compat див. Manual:Pywikibot/Installation/compat, для встановлення чи оновлення через SVN див. Manual:Pywikibot/Installation/SVN.

Початокове встановлення
Встановлення pywikibot складається з трьох основних кроків:
 * 1) Завантаження чи оновлення Python,
 * 2) Завантаження pywikibot,
 * 3) Налаштування основних параметрів pywikibot.

Завантаження Python

 * Системи Unix: зазвичай мають встановлену достатньо свіжу версію Python. Перевірте за допомогою.


 * Mac OS X 10.8+: мають версію Python, достатньо свіжу для запуску pywikibot. Якщо ви користуєтесь старішою OS X, або не впевнені, то завантажте та встановіть Python 2.7.10 з http://www.python.org/downloads/


 * Windows: завантажте і встановіть останній випуск Python 2.7.10 з http://www.python.org/downloads/


 * Версії Python: Підтримуються наступні версії Python:

Через помилку Unicode в основній бібліотеці Python, Core не може функціонувати в Python 2.7.0 та 2.7.1. Дивись також вимоги бо бота, де описано сумісність версій Python і версій Pywikibot.

Завантаження Pywikibot
Найлегший спосіб завантажити Pywikibot — використати останню нічну збірку. Просто завантажте zip-файл pywikibot до свого комп'ютера і розпакуйте його — встановлення завершено.

Завантаження Pywikibot за допомогою Git
Для встановлення за допомогою Git вам потрібно запустити: За допомогою опції  автоматично встановлюються необхідні підмодулі. Наразі існує один підмодуль (i18n), який потрібен навіть для ботів англійською.

Скорочення в командному рядку
Щоби виконати ваш код за межами директорії Pywikibot, додайте щось на зразок: у файл, який запускається при вході в систему, наприклад ~/.bashrc — це дозволить уникнути передруковування експорту PYTHONPATH кожного разу при вході. Звісно потрібно змінити шлях до розташування, щоби він відповідав вашій установці.

Аналогічно ви можете встановити змінне оточення PYWIKIBOT2_DIR, щоби вказати каталог, де зберігається інформація користувача (зокрема user-config.py, що містить дані реєстрації (login) бота).

Оновлення
The pywikibot framework is a perpetual beta software. Bugfixes, new options, new behavior and changes of the mediawiki software leads to frequently new releases and needs the working copy code to be up to date. Please update your branch regularly (daily period or at least once a week).

Updating nightly dump

 * If you are using a nightly version, the process is a bit more complicated. You have to re-download a full copy from here. Before installing it, backup your configuration files and scripts (user-config.py, any family file, or custom script that you might have created, and any current dump XML file you're using for a wiki). Replace your pywikibot directory by the new version you just downloaded. Restore your configuration files. If you're not sure of what you're doing, do not erase but keep a backup of your complete old pywikibot directory, to avoid losing any important files.

Updating git

 * If you used Git for downloading Pywikibot, you must go to the your directory and run the following command:


 * You may need to do  as well, if you need up-to-date i18n files.

Dependencies
Use  package management system to install dependencies. It is included by Python 2.7.9 and Python 3.4. To install all dependencies just run the following command (keeping in mind that some dependencies will require MySQL Connector C++ Libraries):

For a single package use:

To uninstall a single package use:

Creating user files
As a final step before using the bot scripts, you have to create user configuration files. The main one is. If you execute your favorite script after installation (for example, ) then pywikibot ask questions on how you want to configure your local copy and will create these files. You can also run generate user files.py to create these files.

Running Pywikibot under Windows
Please notice the instruction at Manual:Pywikibot/Windows.

Verifying your installation
With the core branch, entering in the command line python pwb.py login should prompt for the login password for your bot, and then report Logged in on somewiki:lang as bot username.