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 — це дозволить уникнути набирання частини export PYTHONPATH кожного разу, як ви входите до системи. Звісно потрібно змінити шлях до розташування, щоби він відповідав вашому встановленню.

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

Оновлення
Інструментарій pywikibot є програмним забезпеченням, що вічно знаходиться у стані бета-версії. Виправлення помилок, нові параметри, нова поведінка та зміни програмного забезпечення mediawiki призводять до частих нових випусків, і вимагають того, щоби код робочої копії був актуальним. Будь ласка, регулярно оновлюйте гілку, яку використовуєте (щоденно, або щонайменше щотижня).

Оновлення нічного вивантаження

 * Якщо ви використовуєте нічну версію, то процес є дещо складнішим. Ви маєте знову завантажити повну копію звідси. Перед її встановленням зробіть резервну копію своїх файлів налаштувань та сценаріїв (user-config.py, будь-яких файлів сімейств або особливих сценаріїв, що ви могли створити, та поточного файлу XML вивантаження, що ви використовуєте для вікі). Замініть свій каталог pywikibot новою версією, що ви щойно завантажили. Відновіть свої файли налаштувань. Якщо ви не впевнені в тому, що робите, не видаляйте, а збережіть резервну копію всього свого старого каталогу pywikibot, щоби уникнути втрати якихось важливих файлів.

Оновлення git

 * Якщо для завантаження Pywikibot ви використовували Git, то ви мусите перейти до свого каталогу, і запустити наступну команду:


 * Вам також може бути потрібно виконати  в разі, якщо вам потрібні актуальні файли i18n.

Залежності
Для встановлення залежностей використовуйте систему керування пакунками. Її включено до Python 2.7.9 та Python 3.4. Для встановлення всіх залежностей виконайте наступну команду (пам'ятаючи, що деякі залежності вимагатимуть бібліотек C++ з'єднувача MySQL):

Для встановлення одного пакунку використовуйте (де package-name є назвою пакунку):

Для видалення одного пакунку використовуйте:

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.