Wikipédia

„Wikipédia:Pywikibot” változatai közötti eltérés

Laptörténet interaktív böngészése
← Régebbi szerkesztésÚjabb szerkesztés →
Tartalom törölve Tartalom hozzáadva
VizuálisWikiszöveges
→‎A bot beindítása: Most Python 2.6 a minimum, de hamarosan az is megszűnik
némi frissítés (compat helyett core), de messze nem teljes
15. sor:
 
A bot szoftverének legfrissebb változata GitHubról érhető el.
# Telepítsd a [httphttps://codetortoisegit.google.com/p/tortoisegit/wikiorg/Downloaddownload TortoiseGit-et]
# hozz létre egy könyvtárat a botnak
# nyisd meg az adott könyvtár contexthelyi menüjét (jobb egérgomb a könyvtár nevén)
# Git Clone...
# URL: https://github.com/wikimedia/pywikibot-compatcore.git, OK
# másold át a kapott könyvtárba a régi <code>user-config.py</code> fájlodat (és a <code>user-fixes.py</code>-t, ha használsz olyat)
# a jövőben időnként (pár naponta) futtasd a context menüből a Git Sync... parancsot
26. sor:
 
=== Beállítás ===
 
A bot csak a „Monobook” skint támogatja.
 
==== Beállítás a Wikipédiához ====
 
Nyiss meg egy [[UTF-8]]-kompatibilis szövegszerkesztő programot (pl. [http://notepad-plus.sourceforge.net/hu/site.htm Notepad++]), és írd be ezt a pár sort:
<source lang="python">
# -*- coding: utf-8 -*-
use_api = True
family = 'wikipedia'
mylangfamily = 'huwikipedia'
mylang = 'hu'
usernames['wikipedia']['hu'] = u<nowiki>'</nowiki>''Bot neve''<nowiki>'</nowiki>
ahol ''Bot neve'' az a felhasználónév, ami alatt a bot szerkesztései megjelennek majd a Wikipédián (ne felejtsd le az első aposztróf elől az <tt>u</tt> betűt!). Ha több wikin is használni akarod a botot, az utolsó sorhoz hasonló alakban add meg az ottani felhasználóneveidet is, pl:▼
</source>
usernames['wikipedia']['hu'] = u'Botorkáló'▼
▲ahol ''Bot neve'' az a felhasználónév, ami alatt a bot szerkesztései megjelennek majd a Wikipédián (ne felejtsd le az első aposztróf elől az <tt>u</tt> betűt!). Ha több wikin is használni akarod a botot, az utolsó sorhoz hasonló alakban add meg az ottani felhasználóneveidet is, pl.:
usernames['wikipedia']['en'] = u'Botológus'▼
<source lang="python">
usernames['wiktionary']['de'] = u'Botladozó'▼
▲ usernames['wikipedia']['hu'] = u'Botorkáló'
▲ usernames['wikipedia']['en'] = u'Botológus'
▲ usernames['wiktionary']['de'] = u'Botladozó'
</source>
Ilyenkor a 2. és 3. sor átírásával befolyásolhatod, hogy éppen melyik wikin fog futni a bot (vagy felülírhatod az itteni beállításokat parancssori paraméterekkel is).
 
Mentsd el a szövegfájlt <code>user-config.py</code> néven, ugyanabba a mappába,pywikibot főmappájába (ahol a többi letöltött <tt>pwb.py</tt> kiterjesztésű fájlis található). Ügyelj rá, hogy UTF-8 módban mentsd el (Notepad++ esetén mentés előtt használd a menü ''Format/Convert to UTF-8 without BOM'' parancsát)! Ha nem tudsz vagy akarsz UTF-8-at használni, módosítsd az első sorban a kódolást megfelelően. (Magyar Windows alatt <tt>cp1250</tt> a legesélyesebb.)
 
Windows alatt általában az a karakterkódolás lesz a nyerő, amit a <tt>chcp</tt>, illetve a <tt>mode</tt> parancs kiír. Továbbá arra is érdemes figyelni, hogy a parancssori ablak beállításainál ne a raszteres, hanem a ConcolasConsolas vagy Lucida betűtípus legyen megadva (Windows 7).
 
Ha a bot üzenetei nem jelennek meg rendesen a képernyőn, hanem az ékezetek helyén csak krikszkrakszokat látsz, írd az alábbi sort is a <code>user-config.py</code>-ba (ha így sem működik, próbálkozz ''cp1250'' helyett mással, pl. ''utf8'' vagy ''iso-8859-2''):
<source lang="python">console_encoding = 'cp1250'</source>
 
Ha ez utóbbi be van kapcsolva, akkor viszont a bevitelnél sem lehet DOS-os ékezetes betűket használni, hanem pl. ''Ausztráliá''t ilyenformán viheted be: <tt>Ausztr%C3%A1lia</tt> (az ily módon kódolt szöveget az egyes lapok ''szerkesztés'' fülére kattintva elérhető címből lehet kimásolni). Ha a <code>user-config.py</code> hibaüzenetet ad parancssorból való futtatáskor (pl. nem fogadja el a <code>usernames</code> utasítást), érdemes parancssoron kívülről, egy windowsos fájlkezelőből futtatni.
 
Ha egy wikin adminisztrátor vagy, és szeretnéd, hogy a bot az adminjoggal bíró azonosítódat használja, amikor szüksége van rá (például egy védett lapot kell szerkesztenie), akkor add meg azt a felhasználónevedet is ilyenformán:
<source lang="python">sysopnames['wikipedia']['hu'] = u<nowiki>'</nowiki>''Admin neve''<nowiki>'</nowikisource>
([http://hu.wikipedia.org/w/index.php?title=Speci%C3%A1lis%3ARendszernapl%C3%B3k&type=delete&user=&page=Kateg%C3%B3ria%3ASz%C3%A1z%C3%A9ves+h%C3%A1bor%C3%BA+csat%C3%A1i&year=&month=-1&tagfilter=&hide_patrol_log=1&hide_review_log=1 Ebben a példában] [[Szerkesztő:BinBot|BinBot]] a [[mw:Manual:Pywikipediabot/category.py|category.py]] használata közben [[Szerkesztő:Bináris|Bináris]] nevében törölte a kiürített kategóriát. A szerkesztés tehát ilyenkor az adminisztrátor neve alatt jelenik meg.)
 
'''Tipp:''' A procedúrát egyszerűsítheted a <tt>generate_user_files.py</tt> futtatásával, amely létrehozza a <code>user-config.py</code> első változatát.
 
Ha saját scripteketszkripteket is akarsz írni, és nem a bot főkönyvtárában tartanád őket, hozzá kell adnod a bot könyvtárát a Python-modulok betöltési útjához. Windows alatt ezt úgy érheted el, hogy a <code>HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore\''<verziószám>''\PythonPath</code> [[registry]] kulcs alá létrehozol egy új kulcsot <code>pywikipedia</code> néven, és értékül a pywikipediabot könyvtárát adod neki. Linux alatt egyszerűen csak be kell állítani a <code>PYTHONPATH</code> [[környezeti változó]]t (pl. az <code>export PYTHONPATH=''<pywikipedia elérési út>''</code> paranccsal).
 
== Engedély kérése ==
{{fő|Wikipédia:Botok}}
 
A bot számára érdemes készíteni egy normál felhasználói nevet. Legjobb, ha olyat választasz, amely utal arra, hogy a felhasználó egy bot, és arra is, hogy te üzemelteted. Általában a saját felhasználói név és a 'Bot'„Bot” szó összevonásából készítik, de ez nincs megkötve.
 
Ha gyakran futtatsz egy botot, érdemes botstátuszt kérni a [[Wikipédia:BotokBürokraták üzenőfala/JelentkezésBotjelentkezés]] oldalon (illetve más wiki esetén az illető wiki megfelelő oldalán) néhány próbaszerkesztés után. Ekkor egy [[Wikipédia:BürokrataBürokraták|bürokrata]] elbírálja a kérelmedet, és ha nincsenek a botnak hibás szerkesztései és jogosnak találja azt, beállítja a botstátuszt. Ez azért hasznos, mert ekkor a bot nem árasztja el a friss változtatásokat gyors egymás utáni szerkesztéseivel, és a szerkesztései automatikusan megtekintettek lesznek (mintha megerősített szerkesztő lenne), nem kell egy járőrnek minden változtatást ellenőrizni.
 
== Használat ==
 
=== Botszkript kiválasztása és futtatása ===
 
Ha a fentiekkel megvagy, készen állsz a bot futtatására. Ehhez be kell hoznod az operációs rendszeredhez tartozó szöveges felületet (parancssort, terminált).
 
'''Windows'''on a Start menü → Futtatás (angolul ''Run'') pontjával tehető meg. A bejövő ablakban be kell írnod a futtatandó program nevét, „cmd”-t írj be (7 vagy újabb rendszer esetén egyszerűen a Start menüben/Kezdőképernyőn is be lehet gépelni, az Enter lenyomására ugyanúgy megjelenik a parancssor).
 
* Menj a C: meghajtóra a <code>cd C:\</code> paranccsal
* Ezután írd be a <code>cd \"a pywikipedia letöltésének helye"</code> parancsot
82 ⟶ 79 sor:
'''Linux'''on vagy bármelyik '''Unix'''-alapú rendszeren egy terminálra lesz szükséged.
 
Először futtasd le a ''login.py'' szkriptet a „<code>python loginpwb.py login</code>” beírásával. Kérni fogja a jelszót, add meg azt, amit a botnak beállítottál. Erre azért van szükség, mivel a bot nem dolgozik névtelenül. Ha nem változtatod meg a jelszavadat, erre egyetlenegyszer lesz szükséged, mert a bot általában nem jelentkezik ki.
 
Ezután már bármelyik bot futtatható a „<code>python szkriptnevepwb.py szkriptneve</code>” parancs beírásával (Windowson a „python” elhagyható).
 
=== Szkriptek ===
146 ⟶ 143 sor:
 
=== További szkriptek ===
A [[Magyar Wikipédia]] botgazdái által írt modulokat az [[:Kategória:Egyedi fejlesztésű Pywikipedia-kódok|Egyedi fejlesztésű Pywikipedia-kódok]] kategóriában találod meg, ahonnan az interwikik mentén más projektek scriptjeiszkriptjei is elérhetőek. Ha saját készítésű szkripttel szeretnél dolgozni, te is ehhez hasonlóan teheted közzé.▼
 
▲A [[Magyar Wikipédia]] botgazdái által írt modulokat az [[:Kategória:Egyedi fejlesztésű Pywikipedia-kódok|Egyedi fejlesztésű Pywikipedia-kódok]] kategóriában találod meg, ahonnan az interwikik mentén más projektek scriptjei is elérhetőek. Ha saját készítésű szkripttel szeretnél dolgozni, te is ehhez hasonlóan teheted közzé.
 
Vedd figyelembe, hogy a régóta távollevő botgazdák programjai esetenként elavultak lehetnek, és nem biztos, hogy változtatás nélkül együttműködnek a Pywikipedia jelenlegi verziójával.
154 ⟶ 150 sor:
 
=== Parancssori argumentumok ===
 
Habár a botszkriptek rendelkeznek saját argumentumokkal, mindegyikkel használható a következő néhány:
 
162 ⟶ 157 sor:
: ezzel lehet beállítani, hogy melyik wikiben szeretnél dolgozni, ha nem a <code>user-config.py</code>-ban beállítotton szeretnél.
; <nowiki>-family:xyz</nowiki>
: ezzel állíthatod be, hogy mely wiki-típuson dolgozol, pl. ''wikipedia, wiktionary, wikitravel, ...'' (ez is felülírja a <code>user-config.py</code>-ban megadottakat).
; -log
: naplózás engedélyezése. A naplók a logs alkönyvtárban tárolódnak.
174 ⟶ 169 sor:
Például a <code>python szkriptneve.py -family:wiktionary</code> a Wikiszótárban futtatja a botot, az alapértelmezett konfigurációt figyelmen kívül hagyva.
 
A különböző scriptekszkriptek parancssori argumentumait megtalálod az egyes fájlokban, ha azokat jegyzettömbbel vagy más szövegszerkesztővel megnyitod, illetve a <code>-help</code> argumentummal indítva a szkripteket kiírják azokat a képernyőre.
 
== Átállás a 2.0 változatra ==
195 ⟶ 190 sor:
A bot használatával kapcsolatban jelenleg négy angol nyelvű levelezőlista üzemel:
 
* [https://lists.wikimedia.org/mailman/listinfo/pywikipedia-lpywikibot pywikipedia-lpywikibot]: felhasználók eszmecseréje (normál forgalommal)
* [https://lists.wikimedia.org/mailman/listinfo/pywikipediapywikibot-announce pywikipediapywikibot-announce]: fontos közlemények (csekély forgalommal). Minden angolul beszélő botgazdának javasolt feliratkoznia rá!
* [https://lists.wikimedia.org/mailman/listinfo/pywikipediapywikibot-svncommits pywikipediapywikibot-svncommits]: automata üzenetek a programkód változásairól (nagy forgalommal). A reakciók a pywikipedia-l listára érkeznek.
* [https://lists.wikimedia.org/mailman/listinfo/pywikipediapywikibot-bugs pywikipediapywikibot-bugs]: automata üzenetek a hibákról (nagy forgalommal)
 
A korábbi levelezőlistát 2009 áprilisában osztották négy részre, hogy áttekinthetőbb legyen. ([http://lists.wikimedia.org/pipermail/pywikipedia-l/2009-April/005787.html Részletek itt.])
 
== Lásd még ==
* {{en}} [[mw:Manual:Pywikibot/Basic use]]
 
* {{en}} [[meta:Using the python wikipediabot]]
 
== Jegyzetek ==
A lap eredeti címe: „https://hu.wikipedia.org/wiki/Wikipédia:Pywikibot”