Főmenü megnyitása

Wikipédia:Wikitelepítés a saját gépedre lépésről lépésre

Ez az útmutató azt írja le, hogyan telepíthetsz egy saját wikit az otthoni gépedre (esetleg egy pendrive-ra). Alapvetően windowsos környezetre készült, a linuxosok értelemszerű módosításokkal használhatják. Ahol többféle lehetőség is van, ott csak az egyiknek a leírása alapul a szerző tapasztalatain, a másik megemlíttetik. Az útmutató felhasznál részleteket a lap alján említett más útmutatókból, de azért azokat is érdemes elolvasni.

Miért?Szerkesztés

Mert a wiki nagyszerű eszköz az információk rendszerezésére. Két fő előnye a könnyű szerkeszthetősége és a fejlett kategóriarendszere (amit persze neked kell majd kialakítanod). A saját gépeden a saját dolgaidat igen áttekinthetően tudod tárolni, és még szócikkeket is írhatsz benne offline módban.

A szövegszerkesztődbe bármit leírhatsz, és tehetsz bele képeket meg táblázatokat, de nagyon nehéz megszervezni a különböző dokumentumok közötti kapcsolatot; a webböngésződ könyvjelzői nagyon jól szervezhetőek, de nem nagyon tudod járulékos információkkal, saját tartalommal ellátni őket; a weblapok pedig mindent tudnak, de nem lehet olvasás közben egy mozdulattal szerkeszteni őket a böngészőben. Gyakorlott wikipédistának a wiki a kézenfekvő megoldás, amely a három előnyeit egyesíti.

A kész wikiben tárolhatod a Wikipédiával kapcsolatos dolgaidat, linkeket, készülő szócikkeket éppúgy, mint a személyes és szakmai adataidat, szövegeidet, linkjeidet, képeidet (receptjeidet, naplóidat, ismerőseid folyton elfelejtett születésnapját…), és felhasználhatod a Wikipédia közössége által már kifejlesztett eszközöket és tartalmat is.

AlapfogalmakSzerkesztés

  • A wiki az informatikában általában a wikiwikiweb-rendszereket jelenti.
  • A MediaWiki a wikieszmét megvalósító egyik szoftver, amelyet a Wikipédián és társprojektjein használunk, és amelyet valószínűleg mindannyian a legjobban ismerünk.
  • A Wikipédia tulajdonnév, amely csak a Wikimédia Alapítvány által fenntartott online enciklopédiára használható; nincs tehát értelme saját wikipédiáról beszélni (hacsak nem akarod az egészet tükrözni a gépeden), helyette saját wikit mondhatunk.

Abból a gondolatból kiindulva, hogy az útmutató olvasói a Wikipédia szerkesztői, akik az itt megszokott rendszert szeretnék otthon is látni, az útmutató további részében e szavakat az általánostól kissé eltérő értelemben használjuk:

  • A wiki (kisbetűvel) a saját gépedre telepített MediaWiki-példányt fogja jelenteni, amelyről ez a leírás szól,
  • a Wikipédia pedig a magyar Wikipédiát.

ÁttekintésSzerkesztés

A MediaWiki egy PHP programnyelven írt, adatbázist használó szoftver. Ahhoz, hogy üzemeltetni tudd, először szükség lesz egy adatbázisszerverre és az azzal kommunikáló, PHP-t futtatni tudó webkiszolgálóra, hogy a wikit a böngésződben megjeleníthesd. Ne ijedj meg, a mai világban ez nagyon egyszerűen megy, és nem kell hozzá sok részletet tudni. Ha ez megvan, kapni fogsz egy nyers wikit, ami már működik és használható. A szerkesztőablakokban és a beállításaidnál még nem fogsz mindent megtalálni, amit itt megszoktál, ezek majd menet közben kerülnek oda. Viszont azonnal beszúrhatsz képeket a Commonsból!



A telepített wikiben automatikusan megerősített felhasználó, adminisztrátor és bürokrata leszel, így kipróbálhatod az adminisztrátorok és bürokraták eszközeit is, és megnézheted, milyen lehetőségeik vannak. (Ne lepődj meg, ha pontosan azt fogod látni – illetve bizonyos kiterjesztések híján még kevesebbet is –, mint ami nyilvánosan is le van írva a Wikipédiában; ez nem véletlen.  ) IP-ellenőr és adatvédelmi biztos nem leszel, mivel ahhoz további kiterjesztések telepítésére van szükség (aminek valószínűleg nincs értelme egy saját wikin). A különbség a Wikipédiához képest az, hogy a saját wikidben bürokrataként el is veheted a bürokratajogot. (Ne vedd el a fő felhasználótól se az admin-, se bürokratajogot!)

Testreszabás

Nyilvánvaló, hogy szeretnéd ugyanazt a kényelmet elérni a saját wikidben is, amit a Wikipédián megszoktál. Ehhez néhány további lépésre lesz szükség, de ezek menet közben folyamatosan is megtehetők, miközben már használod a wikit:

  • kategóriák kialakítása,
  • common.css/js és vector/monobook/stb.css/js adaptálása,
  • kiterjesztések telepítése,
  • segédeszközök telepítése,
  • sablonok másolása,
  • egyes lapok testreszabása.

Ez az útmutató azért készült, hogy mindez könnyű és egyszerű legyen.

Hozzáférés

Az útmutató fix háttértáras (merevlemezes vagy SSD-s) telepítéshez készült, de igen valószínű, hogy pendrive-os telepítéssel is működni fog, és így akár egy hordozható wikid is lehet!

A saját wikidet a hálózati beállításoktól függően a saját gépedről vagy akár a lakás többi gépéről és a kerti nyugágyból is elérheted. Az otthoni hálózat konfigurálása túlmegy ezen leírás keretein, szükség esetén kérjél meg egy hozzáértőt. A telepítés közben határozhatod meg a biztonsági szintet (kell-e bejelentkezés, lehet-e szabadon regisztrálni, a géphez hozzáférő más személyek tudjanak-e olvasni, illetve szerkeszteni).

Az is könnyen megoldható, hogy két vagy több különböző wikid legyen egymás mellett, ha szükségesnek látszik elkülöníteni a tartalmukat vagy a beállításaikat (akár minden családtagnak egy saját), és ezek interwikikkel hivatkozhatnak egymásra.

Offline wiki

A telepített wikinek túlnyomórészt működnie kell internetkapcsolat nélkül is, de előfordulhat, hogy egyes részei (pl. segédeszközök, amelyek más wikiből importálnak javascripteket, illetve a Commonsból betöltött képek) nem fognak rendesen működni. A szerző állandó internetkapcsolattal rendelkezik, az offline működésről nincs gyakorlati tapasztalata.

Mi az, ami hiányozni fog az élő Wikipédiából?
  • a szerkesztési háborúk és véleménykérések, valamint a tiédtől eltérő vélemények,
  • a licencekkel/szerkesztési összefoglalókkal/kategorizálással/forrásmegadással kapcsolatos problémák,
  • a trollok és vandálok,
  • a figyelőlista és a friss változtatások izgatott nézegetése – amíg alszol, senki nem fogja átírni a cikkeidet és bekékíteni a piros linkeket,
  • a botok, amelyek szóközöket tesznek a szakaszcímeid és az egyenlőségjel közé,
  • a narancssárga csík a képernyő tetején és a szerkesztési ütközés (ezeket azért ki lehet provokálni, ha nagyon nem bírod már),
  • az olvasók,
  • rengeteg megírt szócikk, útmutató és sablon – ezekre vagy hivatkozhatsz interwikivel, vagy átmásolhatod őket magadnak.

Mi, a szerkesztőtársaid viszont itt vagyunk, és továbbra is egy kattintással elérhetsz bennünket. És ha akarod, a Wikipédia, illetve az enwiki/dewiki/satöbbiwiki cikkeit is. Sőt, akár bemásolhatsz cikkeket a Pallasból, és kiemeltté nyilváníthatod őket. ;-)

Biztonsági másolatok

Végül megjegyzést érdemel, hogy a wikiben tárolt adataid biztonságáról ugyanúgy neked magadnak kell gondoskodnod, mint bármely más állományéról, amit a számítógépeden tárolsz!

Letöltések és előkészületekSzerkesztés

A portok felszabadítása

Sokféleképpen lehet webszervert, adatbázisszervert és PHP-t telepíteni egy gépre; itt most egy bevált módszert követünk végig. A webszervernek illik Apache-nak lennie. Windows alatt esetleg a beépített IIS szervert használtad idáig (amely a szócikke szerint a világ második legnépszerűbb webkiszolgálója); mostantól nem lesz rá szükséged, dobd el. Megkapod az elsőt.   Ha mégis meg akarod tartani, akkor ügyelj rá, hogy a két szervered közül csak az egyik használhatja a 80-as portot, a másik mondjuk a 8080-ast. Ha eddig nem volt webszervered, akkor ezzel nem kell foglalkoznod. Az adatbázisszervernek sem kötelező MySQL-nek lennie, de ez bevált és biztosan működik, egy egyszerű telepítéshez a legjobb.

Ha Skype fut a gépeden, a beállításainál választ ki a kapcsolat menüpontot, és vedd ki a pipát abból a négyzetből, hogy a Skype használhatja a 80-as és a 443-as portot. A frászt használhatja, az a webszerveré. ;-)[1]

Ahhoz, hogy legyen egy működő wikid, összesen két programot kell letöltened: az egyik a XAMPP (amely egyben tartalmazza az Apache-t, a MySQL-t és a PHP-t), a másik a MediaWiki. Ezen programok hardverigényéről nem sikerült információt találni a letöltőoldalakon; valószínűleg olyan csekély a mai gépekhez képest, hogy nem is érdemes foglalkozni vele.

Az alábbiakban leírt telepítésnek alternatívája lehet a Bitnami használata, amelyről a Wikipédia:Wikipédia-tükör telepítése lapon olvashatsz egy tömör leírást. A telepítés utáni konfigurálás ugyanúgy megy.

A XAMPP letöltése

Nagy levegő, és katt!. (Ha nem Windows van a gépeden, akkor ide.) A XAMPP / XAMPP Add-Ons / XAMPP USB Lite hármasból válaszd az elsőt, ha számítógépre akarod telepíteni, és az USB Lite verziót, ha pendrive-ra. A középső nem érdekes. A kívánt változatra kattintva kapsz egy telepítős változatot (a XAMPP-nál .msi, a XAMPP USB Lite-nál .exe), és kétféle tömörítettet. Itt most a .zip változat használatát mutatjuk be, ugyanis ehhez nem kell telepíteni, és amit nem telepítesz, az nem nyúl a registryhez, és nem kell később eltávolítani sem, csak egyszerűen letörölni a könyvtárat, ha meguntad; illetve telepítés nélkül sokkal hordozhatóbb lesz.

A MediaWiki letöltése

Ezt a mw:Download_from_SVN/hu oldalon teheted meg. A lap jelenleg még azonos a mw:Download_from_SVN lappal, de nincs ráírva, hogy nem fogja senki lefordítani. A legfrissebb verzió 2011 októberében az 1.17. Kétféleképpen lehet letölteni: vagy az SVN-nel (ez részletesen le van írva a lapon), vagy egyszerűen tömörített állományként az infoboxból. Ez utóbbi esetben jelenleg a mediawiki-1.17.0.tar.gz állományhoz jutunk, amelynek a kettős kiterjesztése kettős tömörítésre utal. Windows alatt a Total Commanderrel vagy a 7-zippel csomagolható ki. (Total Commanderben ne a kicsomagolást válaszd, hanem nyisd meg könyvtárként, mert két lépés mélységben van, amit keresel. Ezután egyszerűen másolni kell.)

A fenti letöltőoldalról a legfrissebb stabil verziót érheted el. 2011. október 9-i állapot: az 1.18-as MediaWikit a magyar Wikipédián is bekapcsolták, de még elég sok a hiba (ld. a műszaki kocsmafalat és a Pywikipedia levelezési listát). Az új verziót folyamatosan hegesztgetik, egyelőre nem nagyon érdemes telepíteni. Ha mégis szeretnéd, akkor a fenti oldalon leírt módon SVN-en keresztül érhető el.

Update: időközben áttértek az SVN-ről a gitre, a fenti oldal továbbra is kattintható, és az infoboxban megtalálod a legfrissebb letölthető változatot; ha szeretnéd a későbbiekben gittel frissíteni, ez az oldal továbbvezet (de ez valószínűleg nem fog érdekelni).

A logó elkészítése

Beláthatjuk, hogy saját logó nélkül nem wiki a wiki. Ugye nem akarod örökké a linkelt napraforgót nézegetni? Készíts a kedvenc grafikai programoddal bármilyen logót maximum 135*160 pixeles álló méretben. A Wikipédia a PNG formátumot részesíti előnyben, de lehet GIF vagy JPG is – nagyszerűen működik egy kis fényképpel is! (Ha mégis logó nélkül telepíted a wikit, akkor se bízz benne nagyon, hogy ez örökké így marad, mert bármikor rajtakaphatod magad, hogy éppen ezt a hiányosságot pótolod.)

A XAMPP telepítéseSzerkesztés

A telepítésekhez természetesen rendszergazdaként kell bejelentkezned.

Egyszerű telepítés a C: meghajtóraSzerkesztés

Miután tehát letöltötted a XAMPP tömörített változatát, egész egyszerűen csomagold ki. A legegyszerűbb a C: meghajtó gyökérkönyvtárába, de lehet máshova is; a Program Files Vistán biztosan nem jó, és talán máshol is célszerű elkerülni. Van benne egy setup_xampp.bat nevű program. Ezt futtasd le, ha nem a gyökérkönyvtárba csomagoltad ki, és ne futtasd le, ha oda. Ezzel a telepítés kész is van. (Hamis vírusriasztás elképzelhető közben.)

Ha pendrive-ra akarod telepíteni a XAMPP-ot (célszerű az USB Lite verziót letölteni), akkor ugyanúgy csomagold ki a gyökérkönyvtárba, de készülj fel rá, hogy a sok apró állomány miatt ez nem két perc lesz. Addig vacsorázz meg, vagy írj egy szócikket. A pendrive-ra telepített verzió nem feltétlenül fog működni egy olyan gépen, ahol nincsenek rendszergazdai jogaid! Ilyen esetben konzultálj a gép rendszergazdájával. Mégiscsak szervereket akarsz futtatni.

A xampp könyvtáron belül találod az apache, a mysql és a php alkönyvtárakat; ezekkel csak akkor lesz dolgod, ha valamit át akarsz állítani vagy parancssori SQL-re van szükséged. (Ha csak wikizni akarsz, akkor nem nagyon.) Viszont a jó hír, hogy most a wikitelepítéstől teljesen függetlenül is van egy webszervered meg egy adatbázisszervered, amit bármi másra is használhatsz… De még nem működnek.

A szerverek elindításaSzerkesztés

Keresd meg a xampp könyvtárban a xampp-control.exe nevű jószágot, és böködd meg az egereddel. Erre ő köteles a felső képen láthatóhoz hasonló arcot vágni (egyelőre zöld csík és pipa nélkül). Nincs más dolgod, mint a két első Start gombot az Apache és a MySQL mellett megnyomni, és már futnak is a szerverek. A többivel most nincs dolgunk, a dokumentáció ír róluk részletesebben.

Az első indításkor valószínűleg bejelentkezik a tűzfal, és engedélyt kér. Add meg, de csak az otthoni hálózatra, ne az internetre, mert akkor teljesen kiszolgáltatottá teheted a gépedet! Ha ez a lépés kimarad, akkor lehet, hogy ki van kapcsolva a tűzfalad, és akkor már amúgy is elég kiszolgáltatott vagy.

Most arasd le a győzelmi babérokat: kedvenc böngésződ címsorába írd be a http://localhost/ vagy a http://127.0.0.1 címet (vagy akár innen is rákattinthatsz), és ha minden sikerült, akkor az alsó képen látható szép weblap jelenik meg, ami a XAMPP kezdőoldala. Ez a két egyenértékű cím definíció szerint a saját gépeden futó webszerver URL-je, tehetsz rá könyvjelzőt is. A XAMPP-kezdőoldal bal oldali menüjéből a felső szekcióban ismerkedhetsz magával a XAMPP-pal, és alul a Tools szekcióban található a phpMyAdmin, amivel még lehet dolgod a későbbiekben. (Ha erre rákattintva baloldalt egy csomó adatbázisnév látszik, mint pl. information_schema, mysql, phpmyadmin, test, akkor a webszerver és a MySQL-szerver is rendben működik.)

Térjünk vissza az előbb látott XAMPP-vezérlőpulthoz. Bár a szervereid most üzemelnek, de csak amíg ki nem kapcsolod a gépet. Ha újraindítod, újból be el kell indítani a xampp-control.exe-t, és azon belül a szervereket. Hogy ezt elkerüld, kattints mindkét szerver neve mellett az SVC négyzetbe, ami Windows-szolgáltatásként telepíti a szervereket, azaz elvileg most már maguktól kell indulniuk minden alkalommal (ezt a localhost megnyitásával ellenőrizheted). A vezérlőpultból most már akár ki is léphetsz. (Windows 7-ben az Exit teljesen kilép, a kis x a jobb felső sarokban pedig a tálca jobb szélén az értesítési terület rejtett ikonjai közé helyezi a vezérlőpult ikonját.)

Windows 7 alatt az automatikus indítás kicsit bonyolultabb, bár a pipát itt is beteheted a négyzetekbe, de az eredmény csak látszólagos lesz, a szerverek nem indulnak el a következő bekapcsolásnál. Hogy ne kelljen mindig vacakolod az indítással, a következőket lehet csinálni:

  1. Nyisd ki a Start menüt, és alul a keresés/futtatás ablakába írd a cmd betűket (ez a parancssor neve). Fontos, hogy ctrl shift entert nyomjál utána!
  2. Ha jól csináltad, feljön a Windows pajzsos üzenőablaka, és megkérdezi, hogy a program végrehajthat-e módosításokat a számítógépen. Miután engedélyezted, elindul a parancssor. Most nem a megszokott C:\Windows\system32\cmd.exe feliratot fogod látni az ablak címsorában, hanem a Rendszergazda: C:\Windows\system32\cmd.exe szöveget.
  3. Gépeld vagy másold be a következő parancsokat, és mindegyik után nyomd meg az entert. Ha megváltoztattad a telepítés könyvtárát, akkor értelemszerűen módosulnak a parancsok is:
    1. cd \xampp\apache
    2. apache_installservice
    3. cd \xampp\mysql
    4. mysql_installservice

A második parancs után efféle kimenetet kell látnod:

Installing Apache2.2 as an Service
Installing the Apache2.2 service
The Apache2.2 service is successfully installed.
Testing httpd.conf....
Now we Start Apache2.2 :)
A szolgáltatás (Apache2.2) elindul..
A szolgáltatás (Apache2.2) sikeresen elindult.

Ez azt jelenti, hogy mostantól magától fog indulni, ha bekapcsolod a gépet. A negyedik parancs után valami hasonlót látsz majd a MySQL-lel kapcsolatosan is:

Service successfully installed.
Try to start the MySQL deamon as service ...
A szolgáltatás (mysql) elindul.
A szolgáltatás (mysql) sikeresen elindult.

Ha pendrive-ra telepítetted a XAMPP-ot, akkor természetesen hagyd ki ezt a lépést!

Most már készen állsz a wiki telepítésére.

A webszerver használata egyéb célokraSzerkesztés

A webszerveredet nemcsak a telepítendő wikihez használhatod, hanem bármilyen más webtartalmat is elhelyezhetsz rajta (beleértve a PHP vagy a Perl programozás gyakorlását is). A fenti egyszerű telepítés esetén a C:\xampp\htdocs könyvtárban lesz a weblapod. Alapértelmezés szerint mindig az index.php, ennek híján pedig az index.html állomány lesz a kezdőlap. Ha átírod a meglévőt, a XAMPP kezdőlapját továbbra is eléred a xampp alkönyvtárban.

Biztonsági kérdésekSzerkesztés

  • A telepített szerverek alapértelmezett jelszavát (beleértve azt a tényt is, hogy a MySQL-szervernek root az adminfelhasználója, jelszó nélkül) a xampp könyvtárban a passwords.txt és a readme_en/de.txt is tartalmazza, valamint az interneten is több helyen megtalálható.
  • Bárki, aki a gépedet eléri, és el tud indítani egy webböngészőt, láthatja a webkiszolgáló kezdőlapját, ezen keresztül a phpMyAdmint a teljes adatbázissal (ahol jelszó nélkül admin lehet, ha nem adtál jelszót a rootnak), valamint a wikid teljes tartalmát is, ha nem privátra állítottad. Kicsit lehet nehezíteni a dolgán, ha a XAMPP-kezdőlapot a phpMyAdminnal és a wikid kezdőlapját egy kicsit elrejted, és nem teszed egy kattintással elérhetővé a kezdőlapról.
  • A XAMPP kezdőlapján találsz egy security linket, azt is érdemes tanulmányozni. Ugyanott állíthatod át a MySQL root jelszavát is és védheted le a xampp könyvtárat a webes elérés ellen. Olvasd el az útmutatót is.
    Frissítés, 2014. december: a jelenleg legfrissebb 1.24-es MediaWiki megakad a telepítés közepén, ha nincs jelszava a rootnak, és nem hajlandó folytatni. A fenti security linken a táblázat alatt kattints a http://localhost/security/xamppsecurity.php linkre (innen is megnyithatod, csak akkor nem a keretben nyílik meg), és állítsd be. Sajnos onnantól fogva a phpMyAdmin folyton ki fog dobálni, ha úgy gondolja, hogy számára túl régen kattintottál, ezellen is beállításokkal kell védekezni.
  • A próba során sikerült a webszerver teljes tartalmát, a phpMyAdmint és a wikit interneten elérhetővé tenni külső felhasználó számára a routeren beállított port forwardinggal. Ilyen beállítást véletlenül úgy lehet felejteni, ha valamiért szükség volt rá, vagy létrejöhet a tudtunkon kívül trójai program, könnyen feltörhető wifi-router vagy más ok miatt. Jobb a többszörös védelem.

Összetettebb telepítés: a programok és az adatok elválasztásaSzerkesztés

Bölcs gondolat elválasztani a programokat az adatoktól; egyrészt könnyebb látni, hogy mit érdemes archiválni, másrészt egy rendszerösszeomlás kevesebb kárt okoz. Manapság terjed az SSD használata az operációs rendszer és a fontosabb programok tárolására, de nem biztos, hogy a drága és jellemzően nem túl nagy kapacitású meghajtót érdemes az adatainkkal is telepakolni. Magát a XAMPP-ot azonban érdemes SSD-re tenni, mert szervereket tartalmaz, és nagyon sok kicsi állomány van benne.

Jelen esetben a C:\xampp\htdocs helyett jelölünk ki egy másik dokumentumkönyvtárat a webszerver számára. Egyszerűen helyezd át máshová a könyvtárat alkönyvtáraival együtt, majd nyisd meg szerkesztésre a C:\xampp\apache\conf\httpd.conf állományt, és keresd meg benne a DocumentRoot változót, és írd át. Ne feledd, hogy az elérési útban \ helyett / karakterek vannak (az Apache-ot nem windowsosok találták fel). Ha másik meghajtón van az új könyvtár, akkor a betűjelet is eléírhatod. Ugyanott a <Directory "/xampp/htdocs"> sorban is végezd el a javítást. Ha az Apache újraindítása után ugyanúgy bejön a localhost, akkor a siker teljes.

Ha pendrive-on van a XAMPP, akkor természetesen a megfelelő betűvel helyettesítsd a C-t; áthelyezni ilyenkor csak meghajtón belül érdemes, hogy pl. könnyebben tudd az asztali gépedre menteni az adatokat. Betűjelet ilyenkor nagyon nem érdemes írni, mert az gépről gépre más és más lesz.

Ha megváltoztattad a meghajtót is, nem csak a könyvtárat, akkor lesz még egy teendőd: a C:\xampp\php\php.ini-t is szerkeszteni kell. Keresd meg benne a session.save_path változót. Valami ilyesmit látsz: \xampp\tmp. Ez baj, mert nem tartalmaz meghajtóbetűt, és így nem mindig azon a meghajtón keresi a PHP, ahol a XAMPP települt. Konkrétan a wikibe való bejelentkezést fogja megakadályozni ez a hiba (nem találja a HTTP-sütiket a PHP, és nem tudsz bejelentkezni). Tehát írd elé a C: meghajtóbetűt, ha ott van a XAMPP. Elképzelhető, hogy most kell újraindítani az Apache-ot. A php.ini a hordozhatóság érdekében nem tartalmazza ezeket a betűket, pendrive-on például kifejezett hiba volna rögzíteni. Lehetséges, hogy ha más problémád támad, akkor további változókkal is meg kell ismételni ezt a műveletet. A php.ini beállításairól a http://www.php.net/manual/en/ini.list.php címen olvashatsz többet, ha érdekel (de a wikitelepítéshez ez általában nem szükséges).

TODO: a MySQL adatai is áthelyezhetők?

A wiki telepítéseSzerkesztés

  megjegyzés: Az alábbi telepítési folyamat végén keletkező wiki URL-jei effélék lesznek: http://localhost/wiki/index.php/Kezdőlap. Ez valószínűleg nem nagy baj, mert úgyis interwikivel fogsz hivatkozni rájuk, és a csúnya URL csak külső hivatkozásnál lenne probléma. Ha téged mégis zavar, akkor már a telepítés előtt olvasd el a mw:Manual:Short URL lapot, és annak megfelelően válasszál könyvtárnevet.

  megjegyzés: A lenti leírás a MediaWiki 1.17-es verziójához készült. A 2014 decemberében legfrissebb 1.24-es már csak akkor hajlandó települni, ha beállítottál jelszót a MySQL rootnak. Ha még nem tetted meg, lapozz vissza a Biztonsági kérdések szakaszhoz.

A fentiek szerint kicsomagolva a letöltött MediaWikit – 1.17-es változat esetén – egy mediawiki-1.17.0 nevű könyvtárat kapsz. Ezt kell átmásolni valamilyen értelmes néven a webszervered dokumentumkönyvtárába (alapértelmezés szerint ez a C:\xampp\htdocs). Valószínűleg működni fog ékezetes könyvtárnévvel is, de jobb a békesség, inkább adjál neki ékezet és szóköz nélkülit. (Ezeknél a méheknél sohase lehessen tudni, ahogy Micimackó mondta.[2]) A példában most Wiki lesz a könyvtár neve. Ha két vagy több wikit szeretnél (mondjuk minden családtagnak egyet), akkor egyszerűen másold be több példányban, különböző neveken, és végezd el a következő lépéseket mindegyikre.

Gépeld be a böngésződbe a http://localhost/wiki/ címet (vagy másold át innen). Ekkor a képen látható oldal fog megjelenni, és felszólít a telepítés megkezdésére. Találd ki, hova kell kattintani! ;-) (Ha már van egy korábbi telepítésből visszamaradt LocalSettings.php állományod, akkor nemes egyszerűséggel másold be a wiki könyvtárába, és frissítsd a lapot.)

1. lépés, amelyben megkérdezik a nyelvünket

Ha minden jól megy, akkor a telepítő felismeri a magyar környezetet. Ha nem, állítsd át a nyelvet magyarra, és nyomd meg a Folytatás gombot.

2. lépés, amelyben üdvözölnek bennünket

Mindenféle ellenőrzések eredményéről szóló tájékoztató, licencek és más olvasnivalók. A lényeg a barátságos nagy zöld betűkkel megjelenő A környezet ellenőrzése befejeződött. A MediaWiki telepíthető. felirat. Néhány pontban arról tájékoztatnak, hogy a wikink lassabb lesz a lehetséges világok legjobbikánál, de ez nem túl nagy baj, mert a saját gépünkön így is elsősorban a gép sebességétől fog függeni a wikié is. Szívleljük meg a figyelmeztetést: „a feltöltésekhez használt alapértelmezett könyvtárban tetszőleges külső szkript futtatható.” Ez csak akkor probléma, ha bárki hozzáférhet a feltöltéshez vagy közvetlenül a webszerver könyvtárához – egyébként nem.

3. lépés, amelyben már komolynak látszó kérdéseket tesznek fel, de jogunk van nem válaszolni

A harmadik lapon csúnyának látszó kérdéseket kapunk, de általában elég egyszerűen megnyomni a Folytatás gombot. A kitöltendő rovatokhoz helyes kis lokális súgó tartozik.

  • Az adatbázis típusánál hagyjuk meg a MySQL-t,
  • az adatbázis hostneve maradjon localhost,
  • az adatbázisnév maradhat a felajánlott my_wiki vagy lehet egyszerűen wiki (csak olyat válassz, amilyen nevű adatbázisod még nincs – a phpMyAdmin megmutatja őket. Nem kell azonosnak lennie sem a wiki, sem a könyvtár nevével. Ha több wikid lesz, válassz különböző neveket),
  • a táblanevek előtagjával általában nem kell foglalkozni (még akkor sem, ha két wikit telepítesz, ugyanis a látszat ellenére nem egy adatbázisban lesznek, csak egy adatbázisszerveren – egy adatbázis inkább egyes internetes tárhelyeken fordulhatna elő).
  • A lap alján az adatbázisodhoz használt rendszergazdanevet és -jelszót kell megadni (nem a wikin választott nevet, az később jön!). Alapértelmezésben ez root, jelszó nélkül; csak akkor kell átírni, ha megváltoztattad a XAMPP telepítése után.
4. lépés, amelyről nem akarjuk tudni, micsoda

InnoDB, Bináris, folytatás.

5. lépés, amelynél széles mosoly terül az arcunkra, mert végre érthető dolgokat kérdeznek

Annyira érthetőket, hogy még a képernyőképet is ki lehet tenni a közfelháborodás veszélye nélkül. Elsőként a wiki nevét kell megadni. A képen látható példában ez hirtelen felindulásból Kakukk Marci lett (demonstrálandó, hogy különbözhet a telepítési könyvtár és az adatbázis nevétől is, és lehet benne akár szóköz is). Utána a projektnévtér nevét kell megadni (ami itt a Wikipédián a Wikipédia-névtérnek felel meg.) Alapból a wiki nevét kínálja fel a telepítő, de változtathatunk. Még az is könnyen lehet, hogy soha az életben nem fogod használni ezt a névteret a saját wikidben, hacsak nincsenek elvonási tüneteid a törlési viták miatt.

Most végre kiválaszthatod a szerkesztőnevedet (született usernév). Ez lesz a wikid adminisztrátora és bürokratája. Ne felejtsd el a jelszavát, inkább írd fel (ha már internetről elérhetik a rosszarcúak a wikidet, úgyis régen rossz). Az e-mailnek a saját gépen egyetlen értelme volna, hogy új jelszót kérhessél, ha elfelejtenéd a beállítottat; azonban nincs rá bizonyíték, hogy a levél valaha is eljut hozzád. Ha a XAMPP telepítése után elindítottad a Mercury szervert is, akkor talán. De egyszerűbb üresen hagyni.

Ezen a ponton választhatsz a további konfigurálás és az eddigi adatok alapján történő azonnali telepítés között. Ha bírod még, akkor jelöld be a További információk megadása gombot. Ha nem bírod, akkor igyál egy kávét, és utána jelöld be a További információk megadása gombot. Semmiképpen nem érdemes itt félbehagyni, már nincs sok hátra!

6. lépés, amelyben jogos kérdések merülnek fel

Itt kell eldöntenünk, hogy ki szerkeszthesse a wikinket. A teljes nyitottság („hagyományos wiki”) nem túl indokolt, ha tényleg saját wikit akarsz, bár elvileg idegenek nem is férhetnek hozzá. A fél képernyőnyi magyarázat eligazít a jogosultsági szintekben. A privát wiki jó választás, ha többen is hozzáférhetnek a gépedhez, és nem mindenkinek kell látnia a wiki tartalmát. (Ne feledd, hogy a wikit a webszervered szolgáltatja, ezért a nyilvános wikit az is láthatja, aki a könyvtáradat nem – elég a webböngészőbe beírnia a localhost/wiki címet.) Tegyük fel, hogy a vendégeid időnként megkérnek, hogy megnézhessék a leveleiket a gépedről, amit szeretnél megengedni nekik, de a wikidet már nem akarod megmutatni. Bejelentkezhetnek a Vendég fiók használatával, és a privát wikit nem tudják olvasni. Ugyanez a helyzet, ha munkahelyi gépre teszed a magánwikit. Ha viszont az a cél, hogy a munkahelyi információkat rendszerezd, és a kollégáidat akarod meggyőzni a módszer hasznosságáról, és rávenni őket a közös wikis munkára, akkor válaszd a Felhasználói fiók létrehozása szükséges lehetőséget. Így be kell jelentkezniük, és látható lesz, melyik változtatást ki csinálta.

A szerzői jogoknál válaszd a Nincs licencjelzés lehetőséget (nagy kő, egy gonddal kevesebb).

Az e-maileknél akár ki is veheted a pipát az első négyzetből, amitől a többi rögtön el is tűnik, és nem kell tovább gondolkodni rajtuk.

Most néhány érdekesebb döntés következik. A képfeltöltést engedélyezd, ha szükséged van olyan képek beszúrására a cikkekbe, amelyeket nem tudsz feltölteni a Commonsba (vagy internetkapcsolat nélkül használod a wikit). A feltöltött képek a wikid images alkönyvtárába kerülnek, és ott is foglalják a helyet. (Meg kell jelölni a törölt képek alkönyvtárát is.) (A súgóban olvasható szöveg a webszerver írási jogáról Linuxon érdekes.)

A már elkészített logódat bemásolhatod a következő rovatban megadott alkönyvtárba. Ha nem wiki.png a neve, akkor itt átírhatod (más képtípus is jó). Ha jól csináltad, hamarosan látni fogod a bal felső sarokban, ahol a földgömb szokott lenni!

És most jön egy igazi varázslat: ha kipipálod az Instant Commons engedélyezése négyzetet, akkor közvetlenül illeszthetsz be képeket a Commonsból – pont, mintha a Wikipédiát szerkesztenéd! Már persze ha állandó internetkapcsolatod van. Ez sokat segít a szócikkírásban is.

Alul a nincs gyorsítótárazás opcióhoz ezt a véleményt fűzi a telepítő: „minden funkció működik, de nagyobb wiki esetében lassabb működést eredményezhet”. Mivel a tied nem lesz nagy wiki, ennél akár meg is maradhatsz, és máris jöhet a

7. lépés, amelyben már csaknem wikit teremtünk, és hamarosan megpihenhetünk

Csak a folytatás és a visszalépés között választhatsz, több döntés nincs…

8. lépés, amelyben elénk tárják a leltárat

Elolvashatjuk, hogy mennyi minden van kész, és majdnem értelmes mondatban figyelmeztetnek, hogy a készülő LocalSettings.php két változója nem teljesen biztonságos (de nem is kell nagy jelentőséget tulajdonítani a dolognak egy saját wikin). Kérdés most sincs, a munkát mi már elvégeztük, most a gép forog, az alkotó meg nyomja a folytatás gombot.

9. lépés, amelyben a postás meghozza a LocalSettings.php-t

A gép elkészíti a beállításainkat tartalmazó állományt, amelyet a wiki telepítési könyvtárába kell letöltenünk (és érdemes másolatot is készíteni róla). A türelmetlenek kattintsanak a „beléphetsz a wikibe” linkre, a mazochisták a telepítés újraindítására. A telepítés során beállított biztonsági szinttől függően vagy rögtön megjelenik a wikink kezdőlapja a saját logóval, vagy kapunk egy hibaüzenetet (privát wikinél), hogy előbb be kell jelentkezni.

Kész!  

…és tedd ki a userlapodra a {{Userbox/Saját wikije van}} sablont.  

A LocalSettings.phpSzerkesztés

Az imént letöltött LocalSettings.php teljes leírása a mw:LocalSettings.php lapon olvasható. Érdemes nézegetni, mert ez az állomány a wikid lelke. A szerkesztésére a kezdeti időkben többször is szükséged lesz, például a kiterjesztések telepítéséhez és más célokra is. Tartsd szem előtt a következőket:

  • Sose szerkeszd olyan szövegszerkesztővel, amely BOM-jeleket helyez el a szövegben – tipikusan ilyen a Windows jegyzettömbje. Célszerű a Notepad++ használata.
      megjegyzés: ez a figyelmeztetés a fenti leírás tetején áll nagy piros betűkkel. Azonban a Notepad++-szal megnyitva az látszik a Kódolás menüben, hogy a file ANSI kódolású, amely esetben a BOM kérdése fel sem merül; tehát nem elképzelhetetlen, hogy mégis szerkeszthető a jegyzettömbbel, csak előtte másold az eredetit biztonságos helyre. De sok örömöd nem lesz benne, mert linuxos stílusú sorvégjeleket használ, és így a jegyzettömbben ömlesztve jelenik meg. Érdemes telepíteni a Notepad++-t, meg fogod szeretni.
  • Készíts róla biztonsági másolatot. Sok munka lesz rekonstruálni, ha baja esik.
  • Ne mutogasd illetékteleneknek. A LocalSettings.php kódolatlanul tartalmazza az adatbázisod root jogú felhasználójának azonosítóját és jelszavát.
  • A saját beírásaidat a végére tedd, a „gyári” beállítások után (kivéve, ha egy már ott lévő sort akarsz módosítani).

Ha zavarnak a túl hosszú URL-ek az „index.php” részlettel, akkor járj el a mw:Nice url lapon leírtak szerint.

Alapvető testreszabás, beállításokSzerkesztés

Ha az eddigi lépéseket elvégezted, a wikid már működik és szerkeszthető, de még nem olyan otthonos, ahogy megszoktad. Lépten-nyomon hiányokba botlasz – ezeket igyekszünk felszámolni a továbbiakban, de innentől már nyugodtan használatba veheted a wikit, és működés közben is buherálhatod tovább, tehát szerkessz bátran!   A beállítások akkor sem tehetnek kárt a szócikkeidben, ha később szakítasz időt rájuk.

KategóriákSzerkesztés

Mindenekelőtt célszerű kialakítanod a kategóriarendszeredet. Szükség lesz egy gyökérkategóriára, amit nem kategorizálsz sehova (a Wikipédián ez a Tartalom), és akár a kezdőlapodra is belinkelheted. Ha nem használsz kategóriákat (amivel máris lemondtál a wiki egyik előnyéről), akkor a Speciális:Az összes lap listája lapon tekintheted át, mi van a wikiden. (Ne feledd, az ékezetes betűk még egy kis ideig az ábécé végén keresendők!)

Stíluslapok és javascriptekSzerkesztés

Kimondani is szörnyű, de akár nyolc állomány is lehet, amely a Wikipédia kinézetét és működését megszabja a számodra: négy stíluslap és négy script. De kettő-kettő mindenképpen. Ezeket azonos néven másold át a saját wikidbe. Az eredetinél, ha nem vagy admin, a szerkesztés helyett a Lapforrás fület válaszd a másoláshoz, a saját wikidben viszont szabadon létrehozhatod a céllapot a MediaWiki névtérben is.

Az alábbi táblázatban a speciális lapok akkor is kékek, ha valójában pirosak, de a beállításaidnál a Lapok megjelenítése fülön láthatod őket saját valójukban. (Vannak, akik pár év alatt el is felejtik, hogy ilyen lapokat hoztak létre valamikor valamiért…) Itt csak a két leggyakrabban használt skin van felírva, de a többire ugyanúgy vonatkozik. (Vigyázat, az apát a perjel után már nem mindegy, kis- vagy nagybetűvel kezdesz valamit!)

  Az összes szerkesztőre vonatkozik A saját beállításaidat tartalmazza
Az összes skinre vonatkozik MediaWiki:Common.js

MediaWiki:Common.css

Speciális:Lapom/common.js

Speciális:Lapom/common.css

Az általad használt skinre vonatkozik

Ha nem használsz saját beállításokat, akkor csak a bal oldali oszlopból érdemes átmásolnod a felső sorban levőket és az alsó sorból a saját skinednek megfelelőt. Célszerű az eredetit a Wikipédián figyelőlistára venni, hogy lássad, milyen módosításokat érdemes később átvezetni a sajátodba! (Ha nem akarod egyenként másolni őket, próbálkozhatsz a Lapok átvétele a Wikipédiáról szakaszban leírt módszerekkel is.)

Nem biztos, hogy az átmásolt lapok minden változtatás nélkül működnek! E sorok írásakor, 2011 októberében a Wikipédia még a 200 000-es ünnepi logót használja; a Common.css (nem commons, hanem common!) átmásolása után vicces módon a saját wikiben is megjelent az ünnepi logó, eltakarva a beállítottat. Az imént linkelt részt kellett kivenni belőle.

A Common.js telepítésekor a jó hír az volt, hogy megjelentek az ablak fölött a szerkesztőgombok, a rossz meg, hogy elromlott a kereső. A javítás a következő: a

function SubSearch(f,i,x)

szövegrészt kell megkeresni (ctrl F-fel, nem szabad szemmel, mert az 1700. sor környékén van!), és közvetlenül alatta a kapcsos zárójelek közötti részt éles késsel eltávolítani. Tehát ennyi maradjon:

function SubSearch(f,i,x) {
}

Az egészet nem lehet eltávolítani, mert van rá hivatkozás máshonnan. (Ez egy speciális funkciót valósít meg a Wikipédián, aminek a saját wikidben úgysincs értelme, cserében viszont nem is működik, és lehetetlenné teszi a keresést.)

A Monobook.js hatására megjelent a bevezető szerkesztése link, és a jobb szélről a cím mellé soroltak be a szakaszokat szerkesztő linkek (van, aki talán még emlékszik, hogy ezek nem gyári alapértékek), de hatalmas betűkkel; a Monobook.css másolása aztán ezt is megoldotta.

Tegyük fel például, hogy nincs szükséged minden lap tetején „A Wiki wikiből” vagy „A Kakukk Marci wikiből” feliratra. Nyisd meg szerkesztésre a Common.css-t, és írd a végére ezt (ne felejtsd el frissíteni mentés után):

/* "A Wiki wikiből" felirat eltüntetése */
div#siteSub {
  display:none;
}

Sajnos nincs rá garancia, hogy a jövőben nem kerülhetnek be olyan részek ezekbe a a lapokba, amelyek a saját wikin hibásan működnek, és egy kicsit barkácsolni kell velük. (Ld. még lent a gyors előnézet segédeszközzel kapcsolatos problémát.)

A LocalSettings.php beállításaiSzerkesztés

A LocalSettings.php végén ezt a két sort kell látnod:

# End of automatically generated settings.
# Add more configuration options below.

Tedd meg, amire kérnek, és nyiss egy új rovatot a saját beállításaidnak (a fenti figyelmeztetések átolvasása után):

#Saját beírások:
$wgLocalTZoffset = date("Z")/60;

Ennek hatására nem kell évente kétszer átállítani az időzónát, amikor bejön meg kimegy a nyári időszámítás. Mindjárt írhatsz még ide, amikor a kiterjesztéseket telepíted.

Ha nem a Vectort szeretnéd alapértelmezett skinnek, akkor keresd meg a

$wgDefaultSkin

változót, és írd át. (Egyedileg a beállításaidnál lehet változtatni.)

Ha még eddig nem tetted meg, kattints a beállításaidra, és végezd el a testreszabást. Most már az időzónát is be tudod állítani. Néhány fület viszont nem fogsz látni, amelyekhez a Wikipédián hozzászoktál: ilyen a Jelölt lapváltozatok, a Segédeszközök és a Témák, amelyekhez kiterjesztéseket kell telepíteni.

A mw:Manual:Configuration settings lapon láthatod, miket tud még ez az állomány.

Interwikik készítéseSzerkesztés

A wikidből interwikikkel a szokott módon elérheted a Wikipédiát vagy bármely más MediaWiki wikit, illetve a saját gépeden telepített más wikiket. Ehhez kattints a http://localhost/phpmyadmin/ linkre (ez csak akkor fog működni, ha már feltelepítetted a XAMPP-ot – ha még csak olvasgatsz, nem!). Kezdheted azzal, hogy a nyitólap közepén magyarra állítod a felület nyelvét.

  1. Baloldalt látod a MySQL-szervered adatbázisait. Keresd meg a wikidhez tartozót, és kattints rá. Tedd azt, amit a papagáj a macska szájában, vagyis ne ijedj meg!
  2. Még mindig a bal oldali sávot nézd, most a saját wikid adatbázisának a tábláit sorolja fel. Keresd ki az interwiki nevűt! Az iw_prefix oszlopban láthatóak a „gyári” interwikik, amelyek többsége jelentősen különbözni fog a Wikipédián megszokottól. (Ez a lépés akár ki is hagyható, de tanulságos.)
  3. Kattints felül az ikonok között az SQL-re, és töröld ki az ott megjelenő SELECT utasítást! (Ha az előző lépést átugrottad, akkor üres az ablak.)
  4. Írd a helyére a következő SQL-utasítást, és nyomd meg az OK-t:
INSERT INTO `interwiki` (iw_prefix, iw_url, iw_local, iw_trans) VALUES ('hu', 'http://hu.wikipedia.org/wiki/$1', 0, 0)

Ennek hatására az interwiki táblában az iw_prefixek között megjelenik a hu érték, és mostantól fogva a hu interwikivel hivatkozhatsz a magyar Wikipédia cikkeire (a [[hu:]] a kezdőlapra visz). Értelemszerűen írhatsz huwikit vagy mást is a hu helyére, és megcsinálhatod ugyanezt az enwikivel is. A változtatás rögtön életbe lép, nem kell semmit újraindítani. :-) Ha több saját wikit telepítettél, azoknak is készíthetsz interwikit; ekkor az URL-ben a localhost fog állni a hu.wikipedia.org helyén.

Hasznos interwikik, amelyek külön beállítás nélkül is működni fognak
  • commons: Commons (akárcsak a Wikipédián)
  • mw: MediaWiki (akárcsak a Wikipédián)
  • metawikipedia: a Meta (ez már eltér a megszokottól!)
  • wikipedia, wikt, wikiquote, wikisource, wikibooks, wikinews, wikispecies, wikiversity: az ismert WikiMedia-projektek angol változatai.
Interwikik készítése csellel

A WikiMedia Alapítvány projektjeire, így a magyar Wikipédia cikkeire is tudsz hivatkozni akkor is, ha az egész fenti lépéssort kihagyod. A trükk az, hogy bármely projekt interwikije után írhatunk egy nyelvi kódot is, például a hu-t, ami átirányít a megfelelő projektbe. Ha tehát a magyar Wikipédia Triatlon cikkére akarsz linkelni a wikidből (vagy azt akarod elérni a saját wikid keresőjéből), akkor erre kétféle módod van:

  • hu:Triatlon (ezt csak akkor használhatod, ha megcsináltad a fent leírt lépéseket),
  • wikipedia:hu:Triatlon (ez hosszabb, de minden előkészület nélkül működni fog).

Természetesen interwikik híján külső hivatkozást is használhatsz akár a Wikipédia, akár a saját másik wikid cikkeire.

Egyéb beállítási lehetőségekSzerkesztés

A kiterjesztések telepítéseSzerkesztés

A wiki teljes funkcionalitását az úgynevezett kiterjesztésekkel éri el. Ezek nem részei az alapcsomagnak, hanem külön telepíthetjük őket. Ez lehetővé teszi, hogy a fejlesztőkön kívül mások is adjanak újabb funkciókat a wikihez, ezek könnyen eltávolíthatóak legyenek, ha nem olyan jól működnek, illetve a különböző MediaWiki-alapú weboldalak más és más funkciókkal is rendelkezzenek.

Első lépésként látogasd meg a Wikipédián a Speciális:Névjegy lapot, és nézz körül rajta. Az itt felsorolt kiterjesztések érhetőek el a magyar Wikipédián. Amit itt látsz, azt nem tudja magától az új wikid. Ha ugyanezt a lapot a saját wikidben is megnézed, egyelőre majdnem üresnek fogod látni. A névjegyoldalon minden kiterjesztés mellett rövid leírás van, a nevükre kattintva pedig bejön az angol nyelvű leírás a MediaWiki weboldalon. Válaszd ki, hogy melyikre lesz szükséged. Valószínűleg kevés haszna van például a jelölt lapváltozatoknak, a vandálszűrőnek, a globális blokkolónak vagy a felhasználói fiókok egyesítésének egy háziasított wikiben. Ezzel szemben a kategóriabeszúró, az input- és createbox vagy a SyntaxHighlight nagyon hasznos lehet; a CharInsert és a Gadgets pedig nélkülözhetetlen, ha a Wikipédián megszokott munkakörnyezetet akarod reprodukálni a saját gépeden. A Cite nélkül meg nem lesznek lábjegyzeteid.

A telepítés meneteSzerkesztés

Mindegyik le van írva a megfelelő MediaWiki-lapon, általában

  1. letöltjük a kiterjesztést tar.gz-ben valahova,
    Többnyire az infoboxban vagy a szövegben van egy Download snapshot vagy extension distributor link, de ha nem találod meg, akkor a mw:Special:ExtensionDistributor lapról kiválasztható. Megkérdezi a MediaWiki verziószámát, aztán pár másodperc gondolkodás után elkészít egy letölthető állományt. A másik módszer az SVN-en keresztüli letöltés lenne, azt itt nem részletezzük. A tar.gz kibontása fent le van írva a MediaWIki letöltésénél.
  2. kicsomagoljuk a saját wikink extensions alkönyvtárába (linuxosoknak a letöltőoldalon van a mintaparancs),
  3. bemásoljuk a leírólapon található sort vagy sorokat a LocalSettings.php végére (Notedpad++-szal! de csak miután az előző lépés megvolt, különben szerkeszthetetlen lesz a wiki, minden kattintásra hibaüzenetet kapunk!),
  4. és ellenőrizzük a Speciális:Névjegy lapon (újraindítás nélkül is megjelenik!)

A leírásokban a $IP azt a könyvtárat jelöli, ahova a wikit telepítettük. Nem kell behelyettesíteni, így is működik. Lásd: mw:Manual:$IP.

Néhány hasznos kiterjesztésSzerkesztés

A legfontosabbak közül háromról már szó volt, tegyük hozzá még a ParserFunctionst és a Wikidatát:

Kiterjesztés Leírás
mw:Extension:CharInsert Ez kell a szerkesztőablak alatt megjelenő karakterbeszúróhoz, meg még a MediaWiki:Edittools is. A {{tooltip}} sablont is át kell másolni, különben néhány gomb hiányolni fogja.
mw:Extension:Cite Ez kell a lábjegyzetekhez. Két része van:
  • mw:Extension:Cite/Cite.php – ez jeleníti meg a lábjegyzeteket (ref, references), normál használatra elég
  • mw:Extension:Cite/Special:Cite.php – ez hozza létre a speciális lapot a szócikkekhez, amivel irodalmi hivatkozást lehet készíteni (otthoni gépen csak akkor van rá szükséged, ha folyton saját magadat akarod idézgetni, hogy növeld a hivatkozási indexedet)
mw:Extension:Gadgets Ez kell a segédeszközök telepítéséhez. Részletesen lásd a következő fejezetben.
mw:Extension:ParserFunctions Az elemzőfüggvények használatát teszi lehetővé. Ha sablonokat akarsz átvenni a Wikipédiából, nagyon valószínű, hogy szükséged lesz rá, érdemes telepíteni.
mw:Extension:Wikibase Client Ez a Wikidata kliensprogramja, ezzel válnak elérhetővé a Wikidata szolgáltatásai. (Legalább 1.20-as MediaWiki verzió kell hozzá, nem teszteltem.)

További hasznos vagy érdekes kütyük:

Kiterjesztés Leírás
mw:Extension:Drafts Piszkozatok mentésére (nincs a Wikipédián)

Még nem működik igazán tökéletesen, de lehet vele kísérletezni (ld. itt).

mw:Extension:CategoryTree Kategóriafa megjelenítése

Például ha a Tartalom a gyökérkategóriád, és beilleszted a kezdőlapodra a <categorytree>Tartalom</categorytree> kódot, akkor látni fogod az egész kategóriafádat; ha pedig a <categorytree mode=pages>Tartalom</categorytree> kódot, akkor az összes kategóriát és dőlt betűkkel a bennük levő lapokat is. Nem muszáj a gyökérkategóriát választani, bármelyik alkategóriával is működik, és kipróbálhatod itt a Wikipédián is a saját userlapodon.

mw:Extension:InputBox Űrlapmezőket hozhatsz létre vele, pl. kereséshez vagy új cikk létrehozásához.
mw:Extension:CreateBox Hasonlít az előzőhöz, közvetlenül készíthetünk létre vele cikklétrehozó mezőt.

Próbáld ki pl. a következőt a kezdőlapodon:

<createbox>
break=yes
buttonlabel=Új cikk létrehozása
preload=MediaWiki:Wikipreload
width=100
</createbox>

A MediaWiki:Wikipreload lapodra készítheted el az új cikkek állandó elemeit, pl. szakaszcímet, kategóriát; ezeket minden új cikkbe be fogja tölteni, ha ezzel a gombbal hozod létre (vagy ki is hagyhatod ezt a sort, nem kötelező).

mw:Extension:Poem A <poem> tagek használatát teszi lehetővé a sorok <br> nélküli tördelésére. Aristide Bruant szócikkében láthatsz egy példát a használatára.
mw:Extension:SyntaxHighlight Ez egy varázslatos dolog, ha programkódokat akarsz színesen és áttekinthetően megjeleníteni; a <syntaxhighlight> (régebben <source>) taget implementálja. Lásd pl. lejjebb A wikid felkészítése a Pywikibot használatára szakaszban.
mw:Extension:TitleKey Lehetővé teszi a kis és nagy kezdőbetűk megkülönböztetése nélküli keresést.
mw:Extension:Vector A Vector felülethez ad hozzá kiegészítőket.
mw:Extension:Math A matematikai képletek (<math> tag) implementálására való. Csak a MW 1.18-as verziótól kell, 1.17-ig a telepített alapwiki része![m 1]
mw:Extension:WikiHiero Hieroglifákat készíthetsz Miskolcról szóló szócikkekhez.
mw:Extension:DumpHTML Parancssori hozzáférést igényel, és HTML kimenetet készít a wikidből, így wikimotor nélkül is megjelenítheted weblapként. (Nincs a Wikipédián.)
mw:Extension:SubPageList3 Allaplistázó, akkor érdekes, ha sok allapot használsz. (Nincs a Wikipédián.)
mw:Extension:WikimediaIncubator A „wiki a wikiben” funkciót teszi lehetővé (alternatívája lehet a több saját wiki párhuzamos telepítésének; nincs a Wikipédián).
mw:Extension:DynamicPageList (Wikimedia) Fejlettebb kategóriaműveleteket tesz lehetővé (több szempontú rendezés, kategóriametszetek, a cikkek be- és kikerülésének követése; nincs a Wikipédián).
mw:Extension:Darnedodoser Az ismert betűkeverő játékot valósítja meg, csak a játék kedvéért. Lásd a mintaképet a leírólapján. (Naná, hogy nincs a Wikipédián.)
  1. A matematikai jelölőnyelvet ennek ellenére nem egy pálcasuhintás működésre bírni, mert elég sok segédprogram kell hozzá. Részletesen lásd: mw:Texvc és mw:Manual:Enable TeX.

A segédeszközök (gadgetek) telepítéseSzerkesztés

Miután a fentiek szerint telepítetted a Gadgets kiterjesztést, megnyílik az út a Wikipédiában megszokott segédeszközök használatához. Ehhez néhány állományt kell szerkesztési/forrás nézetben átmásolni a Wikipédiából a saját wikidbe, ugyanolyan néven (beleértve a MediaWiki előtagot is!). Ha nem akarod egyenként másolni őket, próbálkozhatsz a Lapok átvétele a Wikipédiáról szakaszban leírt módszerekkel is. (Ezeket érdemes lehet a Wikipédián figyelőlistára tenni, hogy követni tudd a változásaikat).

Itt van a Wikipédia gadgets-oldalainak listája. Innen kell másolgatni a következőképpen:

  • A MediaWiki:Gadgets-definition tartalmazza a felsorolást, ami a beállításoknál meg fog jelenni, leírás|gadget alakban (ez nélkülözhetetlen, de szerkeszthető). Ennek átmásolása után rögtön megjelenik a Segédeszközök fül a beállításoknál, de egyelőre használhatatlanul; a felesleges sorok nem okoznak gondot. A lapot összevetve a wikipédiás beállításaiddal kiderül, hogy milyen néven kell keresni a kívánt segédeszközt. Amelyiknek a leírását már átmásoltuk, az normálisan jelenik meg, a többi meg nem normálisan, így rögtön látjuk, hova kell pipálni. Ha átmásoltuk a kívánt scriptet vagy stíluslapot, és kipipáltuk a beállításoknál, azonnal működni kezd. (Arra még nem sikerült rájönni, hogy a Segédeszközök fül elsőre miért ugrik el az egér elől, mint egy huncut leány a legény elől, és sikerül csak másodikra eltalálni.)
  • A .js vagy .css végű maga a gadget. Erre mindenképpen szükséged lesz. Ez van a Gadgets-definition listán a vonal után.
  • A „végtelen” (aminek a neve a vonal előtt van) a leírása, a /en végű az angol leírása. Ebből elég az előbbit átmásolni.
  • A Speciális:Segédeszközök lapon (már persze a saját wikidben) láthatod a wikibe telepített segédeszközöket, amelyek közül a a saját beállításaidnál felhasználóként választhatsz (illetve a többi felhasználó is választhat).
  • A MediaWiki:Gadgets-prefstext a beállító lapon, a MediaWiki:Gadgets-pagetext pedig az imént említett speciális lapon megjelenő magyarázatok, a Gadget-section-akármi címűek pedig ezeknek a szakaszcímei magyarul. Ha ezeket kihagyod, működni fog, csak ronda lesz.

Nem biztos, hogy minden segédeszköz azonnal hibamentesen működni fog. A példatelepítés során a kategóriabeszúró, a listaszámozó, a szakaszcímmásoló és s fejlettebb diff pöccre indult, ezzel szemben a gyors előnézet javításra szorult, amit csak némi nyomozás árán sikerült megtenni. (A megoldás a MediaWiki-vita:Gadget-QPreview.js lapon látható.)

A népszerű segédeszközök közé tartozik a WikEd és a HotCat; ezeket is az itt leírt módon telepítheted.

A wikid felkészítése a Pywikibot használatáraSzerkesztés

Ez a szakasz azoknak hasznos, akik a Pywikibotot használják. (Különben lapozd át.) Ahhoz, hogy botozni tudjál a wikidben, négy dologra lesz szükséged:

1. lépés: a family file elkészítéseSzerkesztés

Ezt elvileg a generate_family_file.py végzi el. A próbatelepítés során nem sikerült működésre bírni, és mire kiderült, mi volt a hiba, már kézi szerkesztéssel elkészült a konfigurációs állomány. Ez egy működő minta, amit a families könyvtárba kell elmenteni local_family.py néven, UTF-8 kódolással (azaz pl. Notepad++-szal). (Természetesen mutatis mutandis, ha pl. más neve van a wikidnek vagy a projectnévtérnek, vagy ha nem a local nevet választod hivatkozásként.)

# -*- coding: utf-8  -*-

import family

# A saját wikim

class Family(family.Family):
    def __init__(self):
        family.Family.__init__(self)

        self.name = 'local'

        self.langs = {
                'hu': 'localhost/wiki',
        }
        self.namespaces[4] = {
            '_default': [u'Wiki', self.namespaces[4]['_default']],
        }
        self.namespaces[5] = {
            '_default': [u'Wiki-vita', self.namespaces[5]['_default']],
        }

    def version(self, code):
        return "1.17.0"

    def scriptpath(self, code):
        return '/'

    def apipath(self, code):
            return '/api.php'

2. lépés: a botuser létrehozásaSzerkesztés

Úgy tűnik, a frissen telepített wiki valamilyen beállítás híján nem szereti a regisztrálatlan botokat. Ezért célszerű létrehozni egy usert (lehet egyszerűen csak Bot a neve), amelynek botjogot adsz. Ezt a Speciális:Szerkesztők jogai lapon teheted meg, hiszen bürokrata vagy. Ha törölni is akarsz a bottal, akkor adjál neki adminjogokat is. A saját felhasználói azonosítódra azért nem célszerű botflaget tenni, mert akkor a friss változtatásokban csak külön kattintással fogod látni a szerkesztéseidet.

3. lépés: a user-config.py kitöltéseSzerkesztés

A user-config.py-t egészítsd ki az alábbi sorokkal:

#A saját wikimhez valók:
usernames['local']['hu'] = 'Bot'
sysopnames['local']['hu'] = 'Bot'

A második sor természetesen csak akkor érvényes, ha adminjogot adtál a botodnak. Különben a saját felhasználónevedet kell odaírni.

4. lépés: futtatásSzerkesztés

Azokat a botscripteket, amelyek erre fel vannak készítve, a -family:local paraméterrel futtatva tudod rábírni, hogy a saját wikidet szerkesszék. Ha csak a sajátodban vagy főleg a sajátodban akarsz dolgozni, akkor a user-config.py-ba írd bele ezt a sort is:

family='local'

Ebben az esetben a Wikipédia szerkesztéséhez kell majd külön paramétert megadni a futtatáskor.

A wikid nyelve a beállítás során magyar lett, így ezzel már nincs tennivalód futtatás közben.

Előfordulhat (privát wikiben fordult elő, de máshol is megtörténhet), hogy a kiválasztott script első futtatásakor a bot nem kéri a jelszót, és emiatt hibaüzenettel leáll. Ilyen esetben előbb futtasd le a login.py -family:local parancsot, ami biztosan kéri a jelszót, és utána már jól kell működnie a botnak.

Lapok átvétele a WikipédiárólSzerkesztés

Szükséged lehet lapok tömeges átvételére a Wikipédiából, legvalószínűbben a sablonokéra és a MediaWiki-névtérbeli lapokéra (lásd fent a segédeszközök telepítését). Ennek egyik módja, hogy a Wikipédián a Speciális:Lapok exportálása lapon exportálod őket egy állományba, majd a saját wikiden adminként bejelentkezve a Speciális:Lapok importálása segítségével beolvasod őket. A másik az importálás a dumpból (lásd: Wikipédia:Wikipédia-tükör telepítése), a harmadik valami efféle script használata. És természetesen van még az egyenkénti másolás puszta kézzel. :-)

Biztonsági másolatok készítéseSzerkesztés

A wikid két részletben terül el a számítógépen:

  • a lényeges részei, a wiki tartalma (a képek kivételével) a MySQL adatbázisban,
  • a beállításai pedig a webszervered dokumentumkönyvtárában (alapértelmezés szerint ez a C:\xampp\htdocs\<A te wikid neve>).

Az utóbbit egyszerűen tudod biztonságba helyezni, ha tömörítve lemásolod valahová. Igazából elegendő a LocalSettings.php másolása is, mert ebben vannak a beállításaid. Az extension könyvtárban pedig a kiterjesztések. Ha tudod, milyen kiterjesztéseket telepítettél, elegendő ezeknek az eredeti letöltött változatát menteni (sőt, akár azt se, ha vállalod, hogy szükség esetén újra letöltöd őket). Az images könyvtár is érdekes lehet még, ahol a feltöltött képeid vannak.

Az adatbázisról exportálással készíthetsz másolatot, legegyszerűbb a phpMyAdmin segítségével exportálni SQL formátumban. Ugyanitt lehet importálni, ha mentésből kell helyreállítani vagy másik gépre akarod átvinni.

Az export-importról a http://gyumolcstarhely.hu/tudasbazis/mysql_adatbazis_koltoztetes címen olvashatsz egy részletes magyar nyelvű leírást. (Az adatbázis exportálása/importálása nem azonos az egyes szócikkek exportálásával és importálásával, amelyről az előző szakaszban volt szó.)

Lásd még

Karbantartás, frissítésSzerkesztés

A wikidet nem feltétlenül kell folyton frissítgetni a MediaWiki legújabb verziójára, általában a régebbi is jól fog működni. Indokolt a frissítés, ha olyan új fejlesztés jelenik meg, amire szükséged van, ha egy hasznos új kiterjesztés nem működik a régebbi verzióval vagy ha olyan botot akarsz futtatni, amely nem működik a te verzióddal.

A frissítésnek a mw:Manual:Upgrading lapon lehet utánanézni. (Akinek van gyakorlati tapasztalata, nyugodtan egészítse ki ezt a fejezetet.)

A wiki törléseSzerkesztés

Ha meg akarod szüntetni a wikit, ugyanazon a két helyen teheted meg. mint a biztonsági másolat készítésénél: töröld a wiki könyvtárát és a hozzá tartozó adatbázist (legegyszerűbben a phpMyAdminnal). Vigyázat, az adatbázis törlését nem lehet visszavonni! Előfordulhat, hogy a Windows 7 az állományok egy részét csak rendszergazdaként engedi törölni.

JegyzetekSzerkesztés

  1. Itt van egy felsorolás, hogy milyen portokat szeretne használni a XAMPP – ezeknek csak egy részére lesz szükséged, a 80-asra és a 3306-osra mindenképpen. Ha minden működik, és semmi nem akad össze, akkor nem kell értened, mit jelent ez. Ha nem, akkor kérdezz a kocsmafalon.
  2. http://mek.niif.hu/00400/00449/00449.htm#1

Lásd mégSzerkesztés