Manual:Pywikibot/Installation/fi

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

  On PAWS PAWS: 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.

 Omalla tietokoneellasi Tämä sivu auttaa sinua asentamaan ja ajamaan Pywikibotin omalla tietokoneellasi. Tämä prosessi sisältää neljä kohtaa:  Toolforgeissa Toolforge tarjoaa vakaan alustan, joka mahdollistaa bottien ajamisen jatkuvasti tai tietyn aikataulun mukaan.
 * * Pythonin asennus
 * * Pywikibotin asennus
 * Pywikibotin konfigurointi
 * Skriptin ajaminen

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  komentoikkunassa. Jos sinulla on Python 2.7.4 tai uudempi tai Python 3.4 tai uudempi asennettuna, niin versio on riittävän uusi. However, Python versions below 3.5 can be dropped in near future. It is strictly recommended to use Python 3.5 or higher.

Modify the path
On Windows systems, even after installing python, the command line interface may not initially know where the python installation is located (although the installer has an option to make it know). In other words, if you enter the command

C:\Users\Joe>python

it may result in the following error:

'python' is not recognized as an internal or external command, operable program or batch file.

To fix this, you need to modify the environment variable named "path" and add the folder which contains "python.exe". On Windows 10, this is under Settings > System > About > System info > Advanced System Settings > Environment Variables. Closing and re-opening the command line, entering "python" should give some information about your current python installation. This same process can be repeated for pip. If you enter the command

C:\Users\Joe>pip

and it displays an error, also add the folder containing "pip.exe" to the path.

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:

Asenna Pywikibot
Imuroi Pywikibot stable branch: .tar.gz, .zip.

Pura tämä ladattu paketti esimerkiksi - tai  -kansioon.

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

Other versions are available at https://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:




 * Windows:



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

Continue with the following command to generate user configuration file:

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

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

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 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.

Proxy configuration
Pywikibot relies on  for communicating with the web. You can use  and   environment variables to make requests use a proxy server. Refer to requests' documentation for more info.

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

Listaus kaikista skripteistä löytyy -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:

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