Manual:Pywikibot/Installation/uk

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

Початокове встановлення
There are the following basic steps to installing pywikibot:
 * 1) Download or update Python,
 * 2) Download pywikibot,
 * 3) Configure pywikibot's basic settings.

Завантаження 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:

Due to a Unicode bug in the underlying python library, Python 2.7.0 and 2.7.1 are not supported using the Core branch. See also the requirements for a bot, which describes needed python version and pywikibot branches.

Завантаження 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, щоби уникнути втрати якихось важливих файлів.

If you have changed some scripts of the framework, you have to merge the differences by yourself. Version control systems like git or svn does it automatically.

Оновлення git

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


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

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

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

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

Створення файлів користувача
В якості завершального кроку перед початком застосування своїх сценаріїв ви маєте створити користувацькі файли налаштувань. Головним є. Якщо після встановлення ви запустите свій улюблений сценарій (наприклад, ), то pywikibot задасть питання про те, як ви хочете налаштувати свою локальну копію, і створить ці файли. Для створення цих файлів ви також можете запустити generate user files.py.

Запуск Pywikibot під Windows
Будь ласка, зверніть увагу на інструкцію з Посібник:Pywikibot/Windows.

Перевірка свого встановлення
Для гілки core введення у командному рядку python pwb.py login має спричинити запит імені користувача та паролю вашого бота, і потім повідомити Logged in on somewiki:lang as bot username.