Manuaali:Pywikibot/Asennus

This page will help you get started with Pywikibot, either on your own computer, on Toolforge, or using PAWS: A Web Shell.

On PAWS

Pywikibot: A Web Shell on helpoin tapa päästä alkuun Pywikibotin käytössä.

Se ei vaadi asentamista ja voit käyttää web-käyttöliittymää komentojen syöttämiseen.

Running Pywikibot on PAWS

Omalla tietokoneellasi

Tämä sivu auttaa sinua asentamaan ja ajamaan Pywikibotin omalla tietokoneellasi. Tämä prosessi sisältää neljä kohtaa:

• Pythonin asennus
• Pywikibotin asennus
• Pywikibotin konfigurointi
• Skriptin ajaminen

Toolforgeissa

Jos haluat käyttää bottia Wikimedian wikin ylläpitoon, niin harkitse Toolforge:n käyttämistä. Toolforge tarjoaa vakaan alustan, joka mahdollistaa bottien ajamisen jatkuvasti tai tietyn aikataulun mukaan.

Pywikibotin ajaminen Toolforgeissa

Manuaali:Pywikibot
Quick overview Installation (Windows ) Running on Toolforge user-config.py Wikidata Non-Wikimedia wikis Global options i18n Scripts Development Further help More... »

Asenna Python

Imuroi ja asenna Python osoitteesta https://www.python.org/downloads/.

Jos sinulla on jo Python asennettuna, niin tarkista, että sen versio on riittävän uusi ajamalla python --version komentoikkunassa. Jos sinulla on Python 2.7.4 tai uudempi tai Python 3.4 tai uudempi asennettuna, niin versio on riittävän uusi.

Riippuvuuksien asentaminen

An additional package named requests is required to run Pywikibot. Use pip, which is already installed if you have Python 2.7.9 or higher, or Python 3.4 or higher. Run the following command to install this package:

pip install requests

On Ubuntu, additionaly,

sudo apt install python3-distutils

Asenna Pywikibot

Imuroi Pywikibot master branch: .tar.gz, .zip.

Pura tämä ladattu paketti esimerkiksi /home/username/pywikibot- tai c:\users\username\pywikibot-kansioon.

Alternatively, you may retrieve the latest version using git or svn client from Gerrit, see Manual:Pywikibot/Gerrit#For users . This is the recommended way for active bot operators and developers to use Pywikibot.

Older versions are available at http://tools.wmflabs.org/pywikibot/.

Pywikibotin päivittäminen

Vakaan version julkaisu tapahtuu suunnilleen kolmen kuukauden välein ja on saatavilla samasta osoitteesta.

Ennen Pywikibotin päivityksen asentamista ota varmuuskopio Pywikibotin konfigurointi-tiedostoistasi ja skripteistäsi (user-config.py, mikä tahansa perhe (family) -tiedosto tai itse mahdollisesti luomasi skripti sekä mikä tahansa XML-tiedosto dumppi, jota käytät wikiä varten).

Pura uusi versio vanhan version päälle eli ylikirjoita vanhan version tiedostot.

Pywikibotin konfigurointi

Avaa komentoikkuna ja vaihda hakemistoa (cd) mihin purit Pywikibotin.

Linux: Käynnistä komentoikkuna (Terminal) (tyypillisesti järjestelmätyökalujen (System Tools) valikossa) ja aja:

cd ~/pywikibot

Windows:

c:
cd "\Users\username\pywikibot"

Tietenkin hakemiston paikalle tulee sijainti, johon purit Pywikibot-paketin.

Continue with the following command to generate user configuration file:

python pwb.py generate_user_files

Seuraa kehotteita pywikibotin konfiguroimiseksi ja kun olet kirjoittanut salasanan, suoritetaan sisäänkirjautuminen.

Finally run the following command to log in to your wiki:

python pwb.py login

Hyödyntäminen kolmansien osapuolien wikien kanssa

Pywikibot on esikonfiguroitu toimimaan suuren joukon wikejä kanssa mutta ei välttämättä sen kanssa, jonka kanssa haluat työskennellä. Katso Manual:Pywikibot/Use on third-party wikis Pywikibotin konfiguroimiseksi haluamasi wikin kanssa.

Lisää konfigurointi-asetuksia

Pywikibot tarjoaa suuren määrän konfigurointi-asetuksia, joilla voit vaihtaa bottisi käyttäytymistä. Voit vaihtaa näitä asetuksia muokkaamalla 'user-config.py'-tiedostoa. Katso lista kaikista parametreista, joita voit käyttää, config2.py -tiedostosta.

Skriptin ajaminen

Pywikibotin mukana tulee suuri määrä skriptejä "scripts"-hakemistossa. Voit ajaa nämä kaikki seuraavasti:

python pwb.py [name of the script]

Listaus kaikista skripteistä löytyy Manual:Pywikibot/Scripts -sivulta.

Riippuvuudet

Suurin osa skripteistä ei vaadi lisäpakkauksia, mutta jotkut niistä eivät toimi ilman.

Nämä pakkaukset on listattu requirements.txt -tiedostossa.

Pakkausten asentamiseen voit käyttää $pip -komentoa, joka on valmiiksi asennettuna, jos sinulla on Pythonin tuore versio asennettuna. Paketin asentaminen tapahtuu komennolla:

pip install [name of the package]

Alternatively, run the following command to install all dependencies for all scripts at once:

pip install -r requirements.txt

If you need more help on setting up your Pywikibot visit the IRC channel #pywikibot^connect @ freenode server or Pywikibot mailing list.