Voit itse lisätä ja muuttaa sisältöä muokkaa-painikkeiden avulla
Ennen tallennusta suositellaan ottamaan kopio muokkausruudusta (ctrl-a -> ctrl-c)
Olet itse vastuussa tämän teoksen käytöstä aiheutuvista vahingoista Lue lisää.
MediaWiki
Johdanto[muokkaa]
Ohjeita[muokkaa]
- http://www.mediawiki.org/wiki/Manual:$wgDefaultUserOptions
- http://www.mediawiki.org/wiki/Manual:FAQ
- http://www.mediawiki.org/wiki/Manual:Configuration_settings
- https://www.mediawiki.org/wiki/Manual:Maintenance_scripts
- https://www.mediawiki.org/wiki/Manual:Upgrading
- https://www.mediawiki.org/wiki/Manual:Moving_a_wiki
/w -hakemisto viittaa siihen hakemistoon, joka on mediawikin juurihakemisto. MediaWikin hakemisto tulisi olla w, eikä ainakaan wiki, koska se vaikeuttaa osoteriville muodostettavan url:n luomista.
Vinkkejä[muokkaa]
Cron[muokkaa]
Ks. sivu Cron#Mediawiki.
Debug[muokkaa]
- Seuraavalla saa näkyviin esimerkiksi laajennuksiin liittyviä ongelmia. Lisää LocalSettings.php -tiedoston alkuun:
error_reporting( -1 ); ini_set( 'display_errors', 1 ); $wgShowExceptionDetails = True; $wgDebugToolbar = True;
Edittools[muokkaa]
Kyseessä on wikisivun muokkauksen aikana muokkausruudun alaosaan ilmestyvästä palkista, jossa on esimerkiksi välimerkit, wiki-koodia, symbolit, erikoismerkit, kreikkalaiset aakkoset, kyrilliset aakkoset ja IPA. Myös muiden kielien merkkejä voidaan asettaa. Klikattaessa merkkiä, se ilmestyy muokkausruutuun kursorin kohdalle. Verkkoselaimessa täytyy olla käytössä JavaScript.
1. Asennsa MediaWikin laajennus CharInsert.
2. Luo seuraavat sivut kirjoittamalla oheinen teksti Hae-ruutuun ja lisää sinne seuraava sisältö.
2.1 MediaWiki:Gadget-Edittools
Edittools: Enhance the edittools section (grouping into section with a dropdown menu and converting static links to buttons)
2.2 MediaWiki:Gadget-Edittools.js
Valmis koodi löytyy esimerkiksi sivulta Wikimedia MediaWiki:Gadget-Edittools.js
2.3. MediaWiki:Edittools
Lisää MediaWiki:Edittools -sivulle ne merkit, jotka alas ilmestyvät. Voit avata esimerkiksi olemassa olevan wikin muokkaustilaan ja kopioimalla suoraan merkkejä charinsert-tagien sisäpuolelle. Merkit voi lajitella kappaleisiin. Kun käytät esimerkiksi [] tai tai jonkin tagin joka sisältää välilyönnin, välilyönti tulee tehdä pitämällä alt-näppäintä samanaikaisesti alhaalla! Valmis koodi löytyy esimerkiksi sivulta MediaWiki:Edittools. Merkkikappaleita saa näkyviin poistamalla kyseiseltä merkkikokonaisuudelta style="display: none;"
<!-- Tässä oleva teksti näytetään muokkauskentän alla. --> <!-- Common.css voi sisältää muotoiluja. --> <div id="mw-edittools-charinsert" class="mw-charinsert-buttons" title="Klikkaa valitsemaasi merkkiä."> <small> <p class="mw-edittools-section" data-section-title="osionimi"> '''Välimerkit:''' <charinsert> – ” ≠ ≤ ≥</charinsert> </p> <hr> </small> </div>
4. Tekstin ulkoasua voi muuttaa asettamalla MediaWiki:Common.css -sivulle css-koodia ja viittaamalla siihen MediaWiki:Edittools -sivulla <div class="mw-edittools-section"> muu sivun koodi <div>. Esimerkiksi oheinen tyylikoodi inline asettaa kaikki MediaWiki:Edittools -sivun kappaleet peräkkäin yhdeksi kappaleeksi.
/* Edittools -muotoilu */ .client-js .mw-edittools-section { display: inline; }
4.1. Saata Common.css-sivun tyylimuutokset voimaan painamalla käytetyn verkkoselaimen mukaisia päivityspainikkeita. Jos muutat tätä sivua, päivitä aina uudestaan. Päivittäminen täytyy suorittaa myös niillä avoinna olevilla MediaWiki-sivuilla, joissa muutokset halutaan voimaan.
Firefox ja Safari: Napsauta Shift-näppäin pohjassa Päivitä, tai paina Ctrl-F5 tai Ctrl-R (⌘-R Macilla) Google Chrome: Paina Ctrl-Shift-R (⌘-Shift-R Macilla) Internet Explorer ja Edge: Napsauta Ctrl-näppäin pohjassa Päivitä tai paina Ctrl-F5 Opera: Paina Ctrl-F5.
Excel tai muu taulukko Mediawiki taulukoksi[muokkaa]
Seuraavan ohjelman voi asentaa myös omaan tietokoneeseen, jos yksityisyys epäilyttää. Vaatii php:n.
Favicon.ico[muokkaa]
Lähtökohtaisesti hakee wiki-hakemistosta eli public_html/w. Netistä löytyy generaattoreita, joita voi käyttää sen muodostamiseen kuvasta. Tarvittaessa määritellään:
$wgFavicon = 'https://mediawikiosoite.pääte/polku/favicon.ico'; $wgFavicon = "$wgScriptPath/resources/assets/favicon.ico";
- Ensimmäisessä vaihtoehdossa etsi selaimessa suora polku kuvaan, joka näyttää ikonin selaimen ikkunassa ja käytä kyseistä url-osoitetta.
Historian poistaminen ja siivous[muokkaa]
- Maintenance-hakemistossa komento
- Historiatietojen poistaminen: php deleteOldRevisions.php --delete
- Arkistoidut sivut poistaminen eli archive-taulun tyhjentäminen: Ei vaikuta tauluihin slots, content. Vaikuttaa tauluun text, jos teksti on käyttämätön: Ensin php purgeOldText.php ja sitten php deleteArchivedRevisions.php --delete
- Vain tietyt sivut poistaminen: nukePage.php
- Arkistoidut kuvat poistaminen: php deleteArchivedFiles.php --delete
- Poistaa vanhat versiot, jotka viittaavat sivuun jota ei enää ole: deleteOrphanedRevisions.php
- text-taulusta tiedot, jotka eivät ole linkitetty mihinkään olemassaolevaan tai arkistoituun versioon. Skriptin deleteOrphaneRevisions ajaminen tekee tämän automaattisesti: php purgeOldText.php
- Rikkoutuneet kuvalinkit: php cleanupImages.php
- Tietokannan pakkaus: maintenance/storage-hakemistossa: php compressOld.php
- Vaikuttaa searchindex ja revision -tauluihin: php rebuildall.php
- Lopuksi: phpMyAdmin > SQL-välilehti > OPTIMIZE TABLE text, archive;
- Jos komento ei mene läpi, voi antaa yksitellen OPTIMIZE TABLE text; ja OPTIMIZE TABLE archive;
- Jos palvelin on InnoDB, edellinen komento korvautuu automaattisesti, ensin tulee ilmoitus "Table does not support optimize, doing recreate + analyze instead" ja sen jälkeen onnistuneesta suorituksesta OK
- Tietokannassa voidaan tyhjentää myös objectcache-taulun rivit.
- Katso lisää maintenance-hakemistossa skriptejä
- DeleteHistory poisti vanhemmissa MediaWiki-versioissa historiatiedot. Sisälsi myös tietokannan optimointitoiminnon.
- Fatal error: Call to undefined function wfMsg() in /../extensions/DeleteHistory/DeleteHistory_body.php
- korvaa em. tiedostossa wfMsg komennolla wfMessage ja muuta $dbw = wfGetDB( DB_MASTER );
- Fatal error: Call to undefined function wfMsg() in /../extensions/DeleteHistory/DeleteHistory_body.php
text-taulu gigatavuja[muokkaa]
- page-taulu sisältää ohjauksen viimeisimpään sivuun.
- text-taulu sisältää kaikki viimeisimmät sivut ja kaikki sivujen aiemmat versiot ja voi viedä palvelintilasta gigatavuja wikissä, joka on palvellut vuosia.
- revision-taulu sisältää...
- archive-taulu sisältää poistetut versiot, jotka eivät siis ole text-taulussa.
Ohje 1. (TEHOKAS)
- 2.7.2023 MediaWiki 1.39.3
- Jos esimerkiksi text-taulun koko on gigatavuja ja edellä olevat keinot eikä ohje 2 auta, tässä eräs keino saada esimerkiksi 3,7 gigatavun text-taulu pienenennettyä 14,5 megatavuun!
- Anna MediaWikin maintenance-hakemistossa komento: php dumpBackup.php --current --filter=namespace:0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15 > tiedostonimi.xml
- Tiedostoon viedään vain sivujen viimeisin versio eli ei sivujen aikaisempia versioita.
- Numerot viittaaavat nimiavaruuteen. Ohessa tuodaan kaikki -1 ja -2 lukuunottamatta. Voit valita ne, jotka haluat viedä uuteen MediaWikiin.
- Perusta täysin uusi MediaWiki esimerkiksi cPanelin Installatronin avulla.
- Sirrä tiedostonimi.xml uuden MediaWikin maintenance-hakemistoon
- Anna MediaWikin maintenance-hakemistossa seuraavat komennot:
- php importDump.php < tiedostonimi.xml
- php rebuildrecentchanges.php
- php initSiteStats.php --update
- php update.php
- Tuo kuvat vanhasta MediaWikistä esimerkiksi tämän sivun 'Kuvien vienti ja tuonti images-hakemistosta'-ohjeen mukaisesti.
- Tarkista 'Luokka:Sivut, joissa on toimimattomia tiedostolinkkejä', jossa saattaa ilmetä sivuja, joilla on toimimattomia tiedostolinkkejä, esimerkiksi .xls ja .zip -tiedostot eivät välttämättä "ole siirtyneet".
- Tarkista Toimintosivut/Median tilastotiedot, xls, .zip -tiedostot eivät välttämättä "ole siirtyneet".
- Tarkista Toimintosivut/Suojatut sivut. Suojatut sivut täytyy mahdollisesti asettaa uudestaan.
- Asenna tarvittaessa lisäosat.
- Tee tarvittavat muutokset LocalSettings.php -tiedostoon, esimerkiksi logo.
- Aseta tarvittaessa uusi salasana vanhasta MediaWikistä tuodulle ylläpitäjälle ja käyttäjän asetukset.
- Estä tarvittaessa käyttäjä 'MediaWiki default', jos käytät vanhasta tuotua ylläpitäjää.
- Katso lisää tehtäviä tältä sivulta MediaWikin asentaminen, MediaWikin siirtäminen ja MediaWikin päivittäminen kohdista.
Ohje 2. (EPÄVARMA)
- Mediawikissä vaikuttaa yhä (11/2021) olevan "bugi" siivousskripteissä, jotka jättävät siivoamatta text-taulun (https://phabricator.wikimedia.org/T271635) ja (https://www.mediawiki.org/wiki/Topic:Vuex8d5m1kc441wo).
- Sivulla https://www.mediawiki.org/wiki/Manual:Page_table on SQL-skriptejä, joilla text-taulua voi tarkastella ja puhdistaa.
- Ohessa sivulta modifioidut versiot, jotka toimivat
-- -- Listing page titles and related relationships to other tables (revision, text, page) -- SELECT `p`.`page_id` AS "page_id", CAST(`p`.`page_title` AS CHAR(10000) CHARACTER SET utf8) AS "page_title", `r`.`rev_id` AS "revision_id", -- Modified rev_text_id to rev_id `t`.`old_id` AS "text_id" FROM page p INNER JOIN revision r ON `p`.`page_id` = `r`.`rev_page` INNER JOIN `text` t ON `r`.`rev_id` = `t`.`old_id` -- Modified rev_text_id to rev_id WHERE `p`.`page_title` LIKE '%otsikko%' -tunnistaa otsikot joka sisältää sanan otsikko
-- -- Making a comma separated list of each table ids to delete, Will be used in a delete transaction -- SELECT CONCAT(GROUP_CONCAT(`p`.`page_title` SEPARATOR '\n')) AS 'title', -- Added this line CONCAT(GROUP_CONCAT(`p`.`page_id` SEPARATOR '\n')) AS 'page', -- Added line breaks CONCAT(GROUP_CONCAT(`r`.`rev_id` SEPARATOR '\n')) AS 'revision', -- Modified rev_text_id to rev_id CONCAT(GROUP_CONCAT(`t`.`old_id` SEPARATOR '\n')) AS 'text' FROM page p INNER JOIN revision r ON `p`.`page_id` = `r`.`rev_page` INNER JOIN text t ON `r`.`rev_id` = `t`.`old_id` WHERE `p`.`page_title` LIKE '%otsikko%'
- Poistaminen ks. seuraavan sivun lopusta https://www.mediawiki.org/wiki/Manual:Page_table
Ilmoitusbanneri[muokkaa]
Lisää seuraava teksti mediawikiin seuraavaan osoitteeseen: http://wikindomain.fi/wiki/MediaWiki:Sitenotice
<blockquote style="background-color: #DFF5DA; border: solid thin grey;"> HUOM! Tähän ilmoitus. </blockquote>
Korostus[muokkaa]
- Korostustoiminnon lisääminen:
- Kirjoita hakuruutuun Template:Highlight
- Paina Luo sivu "Malline:Highlight" tähän wikiin.
- Lisää sivulle koodi: <span style="background-color:{{{2|yellow}}}">{{{1}}}</span>
- Korostustoiminnon käyttäminen:
- {{highlight|Korostustoiminnon käyttäminen:}}
- highlight-sanan jälkeen tulee alt-7 merkistä pystyviiva.
Kuvat eivät näy[muokkaa]
- Tallennettaessa tiedosto, kuva näkyy isona mutta ei pienoiskuvina (thumbnail).
- Tarkista, että LocalSettings.php -tiedostossa on asetus seuraavasti. Jos asetus on ollut false, MediaWiki osaa muuttaa sen asetuksen aikana tallennetuista tiedostoista pienoiskuvan kun sivun lataa uudestaan.
$wgGenerateThumbnailOnParse = true;
Kuvien massatuonti[muokkaa]
Useamman kuvan tuontiin mediawiki sisältää valmiin skriptin. Se sijaitsee hakemistossa /w/maintenance. Siirry antamaan komento siellä kansiossa tai määrittele polku kansioon imporImages.php -tiedoston enteen.
- Jos Apache asetuksesta riippuen, kuvan omistajaksi saattaa tulla sellainen, johon et pääse käsiksi MediaWikin sisältä. Tällöin kannattaa käyttää --user -parametria, jolla voit määritellä kenelle käyttäjälle kuvat kuuluvat.
- Jos esm. edellisestä Apache asetuksesta kuvat tallentuivat väärin voit ylikirjoittaa kuvat käyttämällä parametria --overwrite lisänä.
- Jos haluat lisätä suoraan esimerkiksi Luokan, käytä --comment. Huomaa tällöin että välilyöntejä ei saa olla vaan käytä niiden sijalla esm. alavivaa.
- Ääkkösiä sisältäväien tiedostonimien kanssa saattaa esiintyä ongelmia.
php importImages.php /polkukuvakansioon --user=käyttäjänimi php importImages.php /polkukuvakansioon svg png jpg jpeg gif bmp SVG PNG JPG JPEG GIF BMP php importImages.php ~/Downloads --user=käyttäjänimi php importImages.php ~/Downloads --user=käyttäjänimi --comment=[[Luokka:Luokan_nimi]]
- Could not open input file: importImages.php tarkoittaa että et ole oikeassa hakemistossa.
- Ohje parametreistä
Kuvien vienti ja tuonti images-hakemistosta[muokkaa]
Kuvien vienti
- Olemassaolevan MediaWikin images-hakemiston voi kopioida normaalisti tai käyttää maintenance-hakemiston dumpUploads.php. Antamalla seuraava komento maintenance-hakemistossa, muodostuu maintenance-hakemistoon pakattu tiedosto:
php dumpUploads.php | tar -cf tiedostonimi.tar ../images
Kuvien tuonti
- Tätä ei tarvitse käyttää päivitettäessä MediaWikiä, vaan esimerkiksi jos asennetaan täysin uusi MediaWiki, johon tuodaan tekstitiedostoon viety MeadiaWikin tietokanta. Tällöin ei riitä, että images-kansio ainoastaan kopioitaisiin uuden MediaWikin järjestelmään. MediaWiki ei löydä kuvia vaan esittää ainoastaan niistä punaisen linkin. Kuvat voidaan tuoda esimerkiksi seuraavasti importImages.php avulla:
- Kopioidaan images-kansio tai käytetään em. DumpUploads.php-skriptiä kuvien kopioimiseen tiedostoksi tuotavan MediaWikin tiedostojärjestelmästä.
- Kopioidaan ainoastaan hakemistot 0 - 9 ja a - f. Ei siis kopioida archive, lockdir, thumb, .htaccess, README -hakemistoja ja tiedostoja.
- Siirretään ja puretaan kyseinen tar-tiedosto uuden MediaWikin images-hakemistoon.
- php maintenance/importImages.php images --user="tähän olemassaoleva uuden MediaWikin käyttäjätunnus" --search-recursively
- Edellä olev komento annetaan MediaWikin juurihakemistossa. Komennon images tarkoittaa hakemistoa, jossa kuvahakemistot 0–9 ja a–f sijaitsevat.
- Annetaan juurihakemistossa komento php maintenance/update.php
- Annetaan juurihakemistossa komento php maintenance/rebuildall.php
Käyttöoikeuksien muuttaminen[muokkaa]
Esimerkiksi 'käyttöliittymän ylläpitäjä' (Interface-admin) tarvitaan kun halutaan muokata Common.css -sivua.
- https://osoite.fi/wiki/Toiminnot:UserRights
- Ladataan käyttäjänimen käyttäjäryhmät, jonka oikeuksia muutetaan
- Valitaan käyttöoikeudet ja tallennetaan.
Linkit[muokkaa]
- Ulkoisen linkin saa avautumaan uudessa ikkunassa lisäämällä LocalSettings.php -tiedostoon $wgExternalLinkTarget = '_blank';
- Linkki oman tietokoneen tiedostoihin
- OSX: Lisää tiedosto tai hakemisto Sites -hakemistoon, jossa on myös paikallinen mediawiki. Linkitys normaalisti kuten ulkoinen linkki: [http://localhost/~käyttajänimi/alihakemisto/tiedostonimi.pdf Selite]
- Kts. mhyös kohta FileProtocolLinks
Mallinne (Template)[muokkaa]
Mallinne on "toinen wikisivu", joka sijoitetaan toiselle wikisivulle {{Mallinnenimi}} -merkinnällä.
- Mallinne on helpointa lisätä kun kohdesivulle kirjoittaa tulevan mallinneen sen nimellä seuraavasti: {{Mallinnenimi}} ja esikatselee tai tallentaa sivun. Tällöin mallinne muuttuu punaiseksi ja sitä avaamalla pääsee luomaan varsinaisen mallinnesivun.
- Mallinneeseen voi lisätä muuttujia kohdesivulla. Tällöin muuttujat lisätään osaksi mallinnetta {{Mallinnenimi | muuttuja1 | muuttuja2}}
- Mallinnesivulla taas ensimmäiseen muuttujaan viitataan seuraavasti: {{{1}}}
Maintenance-skriptit[muokkaa]
Version 1.40 jälkeen täytyy SSH-komento antaa seuraavasti eli sisällyttää run.php jota ei aiemmin tarvinnut lisätä.
php run.php maintenanceskripti.php php run.php generateSitemap.php --fspath /home/omapalvelintunnus/public_html/sitemap
Monikielisyys[muokkaa]
Vaihtoehto 1[muokkaa]
Tämä vaihtoehto tukee monikielisyyttä saman mediawikin sisällä eli samassa tietokannassa ja yhdessä asennetussa mediawiki ohjelmassa.
- Lataa sivustolta http://www.mediawiki.org/wiki/Extension:ParserFunctions tiedosto ParserFunctions. Wikisi versionumero, joka tarvitaan oikean tiedoston lataamiseen löydät Toimintosivuilta kohdasta Versio.
- Pura latautunut tiedosto kansioksi tiedostoineen
- Tee purkaminen suoraa MediaWiki kansioon Extensions tai siirrä se kovalevyltä sinne jollain ftp-ohjelmalla
- Lisää MediaWikin päähakemistoon tiedostoon LocalSettings.php seuraava rivi esimerkiksi riviksi 23:
require_once("$IP/extensions/ParserFunctions/ParserFunctions.php");
- Onnistunut asennus voidaan katsoa Toimintosivut ja kohdasta Versio
- Sivulle josta sinulla on jonkin muunkielinen käännös, aseta
{{#ifexist:sivunnimi/en|[[sivunnimi/en|English]]}}
- Tällaisia lauseita siis tarpeen mukaan niin monta kuin eri käännöksiä on olemassa.
- Tee sivu, jolla on sama otsikko, mutta se päättyy esim. /en Esimerkiksi cars/en kun sivu suomeksi olisi esimerkiksi autot
Pienoiskuvat[muokkaa]
- Tiedostoluetteloon saattaa tulostua virhe, ettei convert –komentoa löydy. Tällöin esimerkiksi .png –pienoiskuvat eivät näy tiedostoluettelossa kuvina vaan niiden sijaan on virheilmoitus.
- Testaa ensimmäisenä, löytyykö convert –komento antamalla Pääte-ohjelmassa: convert -version
- Jos tiedosto on olemassa, anna komento, jolla näet polun missä convert sijaitsee: which convert
- Vertaa onko tämä polku sama kuin LocalSettings.php –tiedostossa. Tarvittaessa muuta esim. $wgImageMagickConvertCommand = "/usr/bin/convert"; --> $wgImageMagickConvertCommand = "/opt/local/bin/convert";
Pywikibot[muokkaa]
Botti on tässä tapauksessa yksi MediaWikin käyttäjä, jolla on botti-käyttöoikeus. Pywikibot ohjelma sisältää erinäisiä skriptejä, joita ajetaan komentoriviltä ja niiden avulla voidaan huoltaa MediaWikiä ja tehdä isoja muutoksia wikiin. Osa skripteistä ei tee muutoksia, antaa vain tietoa, esimerkiksi toimimattomat ulkoiset linkit.
Asennus omalle palvelimelle[muokkaa]
Pywikibottia voi käyttää yhtenä vaihtoehtona omalta palvelimelta. Jos MediaWikiä, johon aiot kohdistaa bottiskriptejä ei ole jo valmiiksi Pywikibot-ohjelmassa, on kyseessä "third-party" wiki. Tällöin joudut tekemään tiedoston, jolla yhdistät Pywikibotin ja oman wikisi.
- Asennus tehty 10.9.2016 Siteground-palvelimelle, GoGeek host package.
- Asennus tehdään komentoriviltä SSH-yhteydellä palvelimeen. Apuna voi hyvin käyttää myös esim. cPanelin File Manageriä tiedostojen siirrossa, avaamisessa ja muokkaamisessa.
- Tarkista, että käytössä on vähintään Python-ohjelmointikieli versio 2.7.2.
- python --version
- pythonista saattaa palvelimella olla useita versioita. Esim. Siteground-palvelimella on annettava komento muodossa: python2.7 --version ja jatkossa kaikkiin komentoihin on sisällytettävä tuo 2.7
- Lataa ja pura Pywikibot palvelimelle johonkin hakemistoon. Esim. /public_html/pywikibot. Sen ei tarvitse olla MediaWikihakemisto, eikä ainakaan tule olla wikin LocalSettings.php-tiedoston hakemisto. Se ei saa myöskään olla mikään sellainen, johon netistä pääsee avoimesti käsiksi.
- huomaa, että pywikibot hakemisto tulee sisältämään myös pywikibot-hakemiston.
- Tehdään bottikäyttäjätunnus wikiin. Pywikibot kirjautuu tänä käyttäjänä wikiisi ja toimii sen nimissä. Käytä riittävän turvallista salasanaa.
- lisää wikissä normaalisti uusi käyttäjä
- anna käyttäjälle botti -oikeudet
- Tehdään home/pywikibot/user-config.py -tiedosto. Sen voi tehdä manuaalisesti tekstieditorilla tai seuraavan login-toiminnon avulla (muistaakseni). Vähintään seuraavat neljä riviä tulee olla. Huomaa, jos asetukset ovat väärin, yhteyttä ei tietystikään synny.
- family = 'wikinimi' # Nimen "pitäisi" ohjeen mukaan olla ilmeisesti sama kuin LocalSettings.php-tiedoston $wgSitename, mutta ei tarvitse olla.
- mylang = 'fi'
- usernames['wikinimi']['fi'] = u'bottikäyttäjätunnus' # tarkkana isojen ja pienien kirjaimien kanssa käyttäjätunnuksessa
- console_encoding = 'utf-8'
- Tehdään family-tiedosto
- python2.7 generate_family_file.py
- Please insert URL to wiki: wikidomain.pääte
- Please insert a short name (eg: freeciv): wikinimi
- tiedostossa tulisi olla esim. seuraavankaltaisia rivejä:
- self.name = 'wikinimi' # Set the family name; this should be the same as in the filename
- 'fi': 'wikindomain.pääte', # ei siis www. -edessä
- 'fi': '/w', # kts. tarvittaessa wikisi Toimintosivut > Versio, mikä on skriptipolkusi
- 'fi': u'1.27.1', # wikin versionumero
- uudelleennimeä tiedosto tarvittaessa /home/pywikibot/pywikibot/families/wikinimi_family.py
- python2.7 generate_family_file.py
- Ensimmäisellä kerralla pywikibottiin tulee kirjautua ja tarvittaessa myöhemminkin.
- cd pywikibot
- python2.7 pwb.py login
- Password for user bottikäyttäjätunnus on wikinimi:fi (no characters will be shown):
- Logged in on wikinimi:fi as bottikäyttäjätunnus.
- Jos saat virheilmoituksen: pywikibot.exceptions.NoUsername: ERROR: Username for wikinimi:fi is undefined. If you have an account for that site, please add a line to user-config.py: usernames['wikinimi']['fi'] = 'myUsername' <class 'pywikibot.exceptions.NoUsername'>
- yhteyttä ei login-komennon aikana synny, voit kokeilla lisätä user-config.py -tiedostoon: authenticate['www.wikidomain.pääte'] = ('bottikäyttäjätunnus','bottisalasana')
- Jos saat virheilmoituksen: File "/home/käyttäjätunnus/public_html/pywikibot/pywikibot/family.py", line 899, in load assert(all(x in NAME_CHARACTERS for x in fam)) AssertionError <type 'exceptions.AssertionError'>
- /pywikibot/pywikibot/family.py -tiedostossa laita # -merkki rivin 899 eteen.
- Jos saat virheilmoituksen: pywikibot.exceptions.UnknownFamily: Family omawiki nimi jatkuu tässä
- vaihda user-config.py tiedostoon family sama kuin /families -tiedoston nimessä, kuten edellä on kerrottu.
- Testaa botin toimivuus, esimerkiksi wikisi Hiekkalaatikko -sivulla
- ota tietokannasta varmuuskopio kaiken varalta. Muutoinkin on erittäin hyödyllistä ottaa varmuuskopioita ennen merkittäviä muutoksia botilla!
- tyhjennä Hiekkalaatikko -sivu ja kirjoita sinne Testi
- python2.7 pwb.py replace.py -page:Hiekkalaatikko -regex "Testi" "Toimii"
- eli korvauskomento on muotoa: python2.7 pwb.py replace.py -page:Sivunnimi -regex "korvattavateksti" "uusi teksti"
- tarkista wikissä tapahtuiko em. sivulla muutos. Komentorivillä näkyy myös toiminnon eteneminen.
- wikin tuoreet muutokset -sivulla täytyy painaa yläriviltä linkkiä Näytä botit, jotta botin muutokset näkyvät
Päivitys[muokkaa]
- user-config.py -tiedosto sisältää asetukset, pävittäiessäsi pywikibottia, muista siirtää tämä uuteen!
- samoin tarvittaessa wikinimi_family.py
Skriptien ajaminen[muokkaa]
cd public_html/pywikibot python pwb.py skriptinnimi.py -mahdollinenparametri -mahdollinentoinenparametri python2.7 pwb.py skriptinnimi.py -mahdollinenparametri -mahdollinentoinenparametri
- skrpitit on koottu sivulle: https://www.mediawiki.org/wiki/Manual:Pywikibot/Scripts ja sijaitsevat /scripts -hakemistossa.
- tarvittaesa täytyy asentaa lisäosia pip-toiminnolla. Kts. sivulta https://www.mediawiki.org/wiki/Manual:Pywikibot/Installation
Pywikibotin versio[muokkaa]
python pwb.py version.py python2.7 pwb.py version.py
Weblinkchecker.py[muokkaa]
Etsii wikistä kaikki wikin ulkoisiin verkkosivuihin viittaavat linkit ja tarkistaa, ovatko ne käytössä. Tekee ensimmäisessä ajossa /deadlinks/deadlinks-wikinimi-fi.dat -tiedoston. Ohjeen mukaan tulisi odottaa viikko ja ajaa sitten toiseen kertaan, jolloin vertaa ensimmäisen ajon .dat tiedoston linkkejä uuteen ajoon ja muodostaa linkeistä, jotka eivät vieläkään toimi .txt -tiedoston.
- Ensimmäinen ajokerta
python2.7 pwb.py weblinkchecker.py -start:!
- Jos saat virheilmoituksen: File "/chroot/python27/lib/python2.7/threading.py", line 743, in start _start_new_thread(self.__bootstrap, ()) thread.error: can't start new thread <class 'thread.error'>
- botti yrittää avata liian monta linkkiä kerralla ja palvelimen ylläpito on asettanut rajoituksen. Oletusarvo on skriptissä 50, mutta arvoa täytyy yrittää pienentää. Mitä pienempi arvo on, sitä kauemmin toiminnon suorittaminen kestää. Yritä ensin esim. 25 ja jos ei toimi pienennä arvoa lähelle yhtä. Esim. Siteground/GoGeek arvo on 25 ja 26 ei enää toimi.
- Jos saat virheilmoituksen: File "/chroot/python27/lib/python2.7/threading.py", line 743, in start _start_new_thread(self.__bootstrap, ()) thread.error: can't start new thread <class 'thread.error'>
python2.7 pwb.py weblinkchecker.py -start:! -max_external_links:25
- Voit myös yrittää asettaa user-config.py -tiedostoon jotain tällaista (ei toiminut...): max_external_links = '25'
- Toinen ajokerta
python2.7 pwb.py weblinkchecker.py -repeat -max_external_links:25
- Komentoja lisää katso https://www.mediawiki.org/wiki/Manual:Pywikibot/weblinkchecker.py
Salasanan vaihtaminen[muokkaa]
Maintenance-hakemistossa: php changePassword.php --user=käyttäjänimi --password=salasana
Sivujen poistaminen[muokkaa]
Laajennusosa DeleteBatch poistaa sivuja antamasi listan perusteella "aktiivisesta" käytöstä. Ne eivät kuitenkaan poistu historiatietoineen tietokannasta tällä komennolla, joten ne on palautettavissa esimerkiksi kun samannimistä sivua yritetään kirjoittaa. Myös mahdollista muilla palautustoiminnoilla.
- Sivujen poistaminen pysyvästi tietokannasta: 1) poista sivu ja 2) ...
Sivujen vienti ja tuonti[muokkaa]
Vaihtoehto 1[muokkaa]
- Avaa kaikki sivut ja kopioi hiirellä värjäämällä ja siirrä johonkin taulukkolaskentaohjelmaan
- Siirrä sarakkeeseen A mahdollisesti muissa sarakkeissa olevat ja lajittele aakkosjärjestykseen
- Kopio lista laitteen leikepöydälle
- Valitse Toiminstosivut > Sivujen vienti ja liitä sivut listaan
- Avaa toisessa wikissä Tuo sivuja ja valitse muodostettu tiedosto
- Jos kaikki sivut eivät tule kerralla, voit ajaa tuonnin uudestaan ja uudestaan. Onnistunut tuonti tulostaa listauksen.
- Jos tuotavassa wikissä saat ilmoituksen että tiedostokoko on liian suuri (esim. Gateway Timeout The gateway did not receive a timely response from the upstream server or application.)
- voit yrittää muuttaa php.ini asetuksia, katso ohje sivulla PHP kohdassa Lataus ja asennus.
- tai katso Kaikki sivut -sivulta mihin asti tiedostot ovat tulleet ja poista ne tuotavasta tiedostosta. Näin voit tuoda kaikki tiedostot, aina poistamalla tuodut tiedostosta ja yrittämällä tuoda, kunnes kaikki on tuotu. Tiedostot pitäisi olla luettelossa tuontijärjestyksessä... Sivu on tagien <page> ja </page> välissä. Säilytä tiedoston alussa ja lopussa <mediawiki>-tagi ja tiedoston alussa <siteinfo> ja </siteinfo>-välissä olevat tiedot.
Sivukartta[muokkaa]
sitemap
- Sivukartta hakukoneita varten.
- Luodaan kansio sitemap tiedosto-oikeuksilla 775. Epäselvää, tuleeko sitemap-hakemiston sijaita public_html-hakemistossa vai mediawiki-hakemistossa.
- Pääteohjelmassa SSH-yhteydellä palvelimeen hakemistossa /maintenance komento: php run.php generateSitemap.php jolloin tiedostot muodostuvat maintenance-hakemistoon.
- Parempi vaihtoehto antaa maintenance-hakemistossa: php run.php generateSitemap.php --fspath /home/omapalvelinnimi/public_html/sitemap jolloin muodostetaan sitemap-hakemisto, ja johon lisätään kyseiset tiedostot
- Huom. versioissa aiemmin kuin MediaWiki 1.40 ei lisätä komentoon: run.php
- Cpanelissa Cronin voi asettaa esim. seuraavasti: /usr/local/bin/ea-php74 /home/omapalvelinkäyttäjätunnus/public_html/wikihakemisto/maintenance/run.php generateSitemap.php --fspath /home/omapalvelinkäyttäjätunnus/public_html/sitemap
- Sivulla Cron on lisää ohjeita.
Staattinen mediawiki[muokkaa]
- Wget. Jos olet suojannut salasanalla wikin, tämä ei toimi. Virheilmoitus on "Incomplete or invalid multibyte sequence encountered". Ehkä laajennusosasta olisi tähän ratkaisu? https://www.mediawiki.org/wiki/Extension:Wget_Authentication
wget --recursive --page-requisites --html-extension \ --convert-links --no-parent -R "*Special*" -R "*action=*" \ -R "*printable=*" -R "*oldid=*" -R "*title=Talk:*" \ -R "*limit=*" "http://www.domain.fi/wiki/index.php\?title=Main_Page.htm" cd domain.fi/wiki cp index.php\?title=Main_Page.html index.html cp skins/common/shared.css?207 skins/common/shared.css cp skins/monobook/main.css\?207 skins/monobook/main.css sed -i 's/shared\.css\%3F207/shared.css/g' *.html sed -i 's/main\.css\%3F207/main.css/g' *.html
Sähköposti[muokkaa]
Muutoksista kotisivun sisällöstä voi laittaa esimerkiksi automaattisen sähköposti-ilmoituksen ylläpitäjälle. Nämä viestit sisältävät html–muotoiluja ja eivät näy oikein sähköpostiviestissä. Mime Mail–moduulin asentaminen saa ne näkymään muotoiltuna.
Tarkkailulistan tyhjentäminen[muokkaa]
watchlist
- Katso ensin käyttäjänumero, jonka osalta poistaminen tehdään taulusta watchlist sarakkeesta wl_user
- Anna tietokannassa SQL-välilehdellä seuraava komento, jossa vaihda käyttäjänumeroksi
DELETE FROM `watchlist` WHERE `wl_user` = käyttäjänumero;
Taulukko[muokkaa]
- Solun väri ja solun tekstin väri
{| class="wikitable" |+ Otsikkoteksti |-style="background-color:green;color: white" | solun1 teksti || solun2 teksti |}
solun1 teksti | solun2 teksti |
The page you are trying to access is restricted due to a security rule.[muokkaa]
Lisää public_html/.htaccess -tiedostoon seuraava:
<IfModule mod_security.c> # Turn the filtering engine On or Off SecFilterEngine Off </IfModule>
Tiedoston tallennus[muokkaa]
Suojaa hakemisto /images php-tiedostojen suorittamiselta. Ks. sivu .htaccess otsikko Hakemiston suojaaminen php-skripteiltä.
Toimintosivujen poiskytkeminen[muokkaa]
- Lisäosia, joilla asian voi hoitaa, esim. Lockdown
- https://gist.github.com/victorskl/6245051 -skripti, joka lisätään LocalSettings.php -tiedostoon ja merkitään risuaidalla ne sivut, jotka halutaan kuitenkin kirjautumattomille näyttää.
Tuoreimmat muutokset[muokkaa]
- Tuoreimmat muutokset listausta voi pidentää. Avaa normaalisti Tuoreimmat muutokset > Klikkaa esm. 14 päivää > Klikkaa esim. Näytä 50 > Muuta osoiteriville haluamasi arvot. Esim. /index.php?title=Toiminnot:Tuoreet_muutokset&limit=5000&days=90 näyttää viimeisimmän 90 päivän muutokset jotka mahtuvat 5000 joukkoon.
- Listan tyhjentäminen
- Poista tietokannasta taulun recentchanges rivit/rivejä. PhpMyAdmin:lla valitse taulusta rivit ja paina delete ja hyväksy.
phpMyAdmin[muokkaa]
Tietokannassa voi suorittaa haun esm. seuraavasti SQL -kohdassa. Seuraava esimerkki hakee muutokset ennen 18.3.2014
SELECT page_id, page_namespace, page_title FROM page WHERE page_touched < '20140318000000'
Tulostus -sivulle alatunnisteeseen tekstiä[muokkaa]
Tulostettavan sivun alatunnisteeseen voi lisätä omaa tekstiä, joka tulostuu jokaiseen sivuun samanlaisena. Lisättävä teksti ei näy normaalissa wikin sivussa, eikä valittaessa Tulostettava versio valikosta. Teksti näkyy vasta tulostuksen esikatselussa tai paperilla.
- Avaa palvelimelta MediaWikin hakemistosta /skins/MonoBook.php
- Siellä on kohta <!-- end content -->
- Lisää sen yläpuolelle seuraava
<div class="printfooter"> haluamasi teksti tähän</div>
Esimerkiksi
<?php $this->html('catlinks') ?></div><?php } ?> <div class="printfooter"> haluamasi teksti tähän whatever you want</div> <!-- end content -->
- Tulostuksen muuttaminen.
- Aseta tiedostoon MediaWiki:Print.css. Nämä korvaavat tiedostossa /skins-1.5/common/commonPrint.css olevia asetuksia. Lisätietoa sivulta https://en.wikipedia.org/wiki/Help:Printable
@media print { #footer, #content, body { font-size: 6pt !important; } h1 { font-size: 14pt } h2 { font-size: 12pt } h3 { font-size: 10pt } h4 { font-size: 8pt } h5 { font-size: 8pt } h6 { font-size: 6pt; font-weight: normal; } }
Ulkoasuun muutoksia[muokkaa]
- Muutokset kannattaa pyrkiä tekemään suoraan tietokantaan, eikä tiedostojärjestelmään koodia muuttamalla. Muutos tehdään kyseiselle sivulle. Yleismuutokset kaikkiin ulkoasuihin tapahtuvat Common.css avulla, johon pääsee selaimessa riippuen URL-asetuksista:
Kirjoita hakuruutuun: MediaWiki:Common.css http://palvelin.fi/wiki/index.php?title=Järjestelmäviesti:Common.css http://palvelin.fi/wiki/Järjestelmäviesti:Common.css
- pelkästään ulkoasuun Vector: Vector.css
- vector-2022 piilottaa sivupalkin, joka aukeaa vasta "menu-painiketta" painaessa.
- käyttäjäryhmään: Group-sysop.css
- ilman JavaScript käyttäville käyttäjille: Noscript.css
- tulostus: Print.css
- käyttäjäkohtaisesti: User:käyttäjänimi/ulkoasunnimi.css
- pelkästään ulkoasuun Vector: Vector.css
- Common.css -sivua ei voi oletuksena muuttaa. Muutosoikeus saadaan lisäämällä käyttäjälle käyttöoikeus 'käyttöliittymän ylläpitäjä'. Ks. otsikko 'Käyttöoikeuksien muuttaminen'
- Jos olet kirjautuneena wikiin, mutta kyseisellä Common.css-sivulla ei ole muokkaa-linkkiä: Kirjaudu kyseisellä sivulla ulos ja kirjaudu uudestaan sisään.
- Sivuun tehdyn muutoksen jälkeen täytyy tehdä selaimen välimuistin tyhjennys. Wiki antaa tallennuksen jälkeen siitä ohjeen. Esimerkiksi OSX:ssä Cmd-r
- Muutoksen kohteen div-tiedon voi hakea esimerkiksi Safarilla Kehitys > Show Web Inspector > valitsemalla tähtäimen ja klikkaamalla haluttua kohtaa. Tämän jälkeen koodista voi etsiä kyseisen kohdan, esimerkiksi <div class="editCheckboxes">. Liikuttamalla hiirtä koodin päällä, kyseinen kohta sivussa muuttaa väriä. Kehitys-valikko pitää tarvittaessa kytkeä Safarin asetuksista päälle. Samanlainen toiminto löytyy Firefox-selaimesta Inspector -nimellä.
- Välilehtien poistaminen: https://www.mediawiki.org/wiki/Manual:Remove_Tabs
- Toimiva komento voi alkaa esim. .ns-0 tai #ca.
- Common.css -sivulla kyseiseen diviin vaikutetaan seuraavalla rakenteella. Css-tyyli voi olla myös yhdellä rivillä puolipisteillä erotettuna.
- Tämä on pieni muutos ja Lisää tarkkailulistaan –kohdat punaiseen laatikkoon, jota ympäröi ohut musta reunus.
.editCheckboxes { style="font-size: 0.6cm; background-color: red; border: 1px solid black;}
- Sisällön koon muuttaminen
/* Sisällön tekstin koko */ #bodyContent { font-size: 1.2em; }
- Tekstieditorin tekstin muuttaminen.
#wpTextbox1 { line-height: 1.0em; resize: vertical; font-size: 1.0em; }
- Sivupalkista kirjautumattomilta toimintosivujen-linkin piilottaminen. .ns-0 on wikiartikkelisivujen namespace. https://www.mediawiki.org/wiki/Manual:Namespace
.ns-0 #t-specialpages { display: none; }
- Editorin taustaväri
- Editorin taustaväri saattaa alkaa ottamaan valkoisena silmiin. Valkoisen vaihtoehdoksi voi etsiä vaikka netistä ehdotuksia. Eräs suositeltava on harmaan sävyinen #f0f0f0
- Editorin värin voi muuttaa /mediawiki/skins/common/commonContent.css tiedostoon lisäämällä aivan tiedoston lopussa olevaan kohtaan #editform textarea seuraavan rivin: background-color: #f0f0f0;
Gray94 | f0f0f0 |
- Poistetaan muokkaustilasta ja esikatselusta kirjautumislinkit
- http://www.palvelin.fi/wiki/Järjestelmäviesti:Anoneditwarning
- http://www.palvelin.fi/wiki/Järjestelmäviesti:Anonpreviewwarning
- Linkkien poisto perussivujen yläreunasta
- Katso sivun koodista, josta haluat jotain poistaa, sen body-tagista mikä namespace on kyseessä eli ns-luku. Seuraavassa esim. ns-0
- http://www.palvelin.fi/wiki/Järjestelmäviesti:Common.css
.ns-0 #pt-anonuserpage { display: none !important; } .ns-0 #pt-anontalk { display: none !important; } .ns-0 #pt-anoncontribs { display: none !important; }
- Keskusteluvälilehden poisto
- http://www.palvelin.fi/wiki/Järjestelmäviesti:Common.css
- .ns-0 #ca-talk { display: none !important; }
- Varoituslaatikon lisäys.
- ** http://www.palvelin.fi/wiki/Järjestelmäviesti:sitenotice
- Kirjaudu sisään linkin poistaminen
- Lisää LocalSettings.php -tiedostoon
# Poistetaan sisäänkirjautumislinkki function NoLoginLinkOnMainPage( &$personal_urls ){ unset( $personal_urls['login'] ); unset( $personal_urls['anonlogin'] ); return true; } $wgHooks['PersonalUrls'][]='NoLoginLinkOnMainPage';
- Kirjautumattoman muokkauksen yhteydessä esitettävä varoitus punaisella:
- Lisätään Vector.css
div.mw-anon-edit-warning { background-color:red; }
Valikon muuttaminen[muokkaa]
http://www.palvelin.fi/wiki/Järjestelmäviesti:Sidebar http://www.palvelin.fi/wiki/index.php?title=Järjestelmäviesti:Sidebar
- Luokan lisääminen: ** Luokka:Euroopan unioni|Euroopan unioni
- Etusivu: ** mainpage|mainpage
- Kaikki sivut: ** Toiminnot:Allpages | Kaikki sivut
- Satunnainen sivu: ** randompage-url|randompage
- Ohje: ** helppage|help
- Valikkoon on vaikea lisätä tuosta vain tekstiä. Yksinkertainen keino on lisätä teksti väliotsikkona:
* kirjoita teksti tähän ** |
Sivupalkki paikoillaan[muokkaa]
Kun vector-ulkoasussa halutaan sivupalkin pysyvän paikoillaan eikä jäävän sivua skrollatessa piiloon. Kirjoita hakuruutuun MediaWiki:Common.css ja lisää sivulle seuraava koodi:
/* Sivupalkki pysyy paikoillaan */ div#mw-panel { position: -webkit-fixed; /* Safari */ position: fixed; top: 0; }
Valkoinen sivu[muokkaa]
Oletko juuri tehnyt LocalSettings.php tiedostoon muutoksen? Esimerkiksi rivin lopusta puuttuva puolipiste (;) voi aiheuttaa tämän.
Varnish[muokkaa]
Virheilmoitukset[muokkaa]
Lisäämällä LocalSettings.php tiedostoon rivin $wgShowExceptionDetails = true; saat näkyviin enemmän tietoa virheilmoituksista.
- Detected bug in an extension! Hook wfSetupImageMap has invalid call signature
- Kokeile vaihtaa palvelimen MediaWiki hakemistossa käyttämä PHP-versio vanhemmaksi versioksi. Kun PHP-versio on väärin, sivusto saattaa olla ettei se aukea tai virheilmoituksia tulee loputtomiin tai sivun muokkaaminen ei onnistu. Ts. esiintyy monenlaisia virhetoimintoja, vaikka itse MediaWiki-ohjelmassa tai tietokannassa ei ole mitään virhettä.
- Deprecated: Function mcrypt_create_iv() is deprecated in
- Nämä virheilmoitukset voi sivuuttaa tavanomaisessa käytössä. Lisää LocalSettings.php-tiedostoon seuraava rivi
- error_reporting(E_ERROR | E_WARNING | E_PARSE);
- Virheilmoitus yritettäessä tulostaa PDF-dokumenttia laskusta tms.
- Fatal error: Declaration of Zend_Pdf_FileParserDataSource_File::__construct() must be compatible with Zend_Pdf_FileParserDataSource::__construct() in C:\jotain\lib\Zend\Pdf\FileParserDataSource\File.php on line 41
- tieostossa lib/Zend/Pdf/FileParserDataSource.php muuta abstract public function __construct(); seuraavaksi: abstract public function __construct($filePath);
- Use of userCan hook (used in AccessControlHooks::onuserCan) was deprecated in MediaWiki 1.37. [Called from MediaWiki\HookContainer\HookContainer::run in /var/www/html/includes/HookContainer/HookContainer.php at line 137] in /var/www/html/includes/debug/MWDebug.php on line 375
- Lisää LocalSettings.php tiedostoon rivi: $wgDeprecationReleaseLimit = '1.x';
Välimuisti[muokkaa]
Word ja Pages dokumenttien tuominen MediaWikiin[muokkaa]
Asenna laajennus wikEd, joka lisää MediaWikiisi monipuolisen editorin.
- muokkaa http://www.palvelin.fi/wiki/Järjestelmäviesti:Common.js
- lisää seuraava koodi MediWikin ylläpitäjän roolissa. Tallenna ja tarvittaessa tyhjennä selaimesi välimuisti. Tarvittaessa käyttäjäkohtaisesti katso ohje
// install [[Wikipedia:User:Cacycle/wikEd]] in-browser text editor importScriptURI('//en.wikipedia.org/w/index.php?title=User:Cacycle/wikEd.js' + '&action=raw&ctype=text/javascript');
- Kopioi teksti Wordista tai Pagesista normaalisti esim. Cmd-a > Cmd-c > ja liitä MediaWikiin Cmd-v > paina sitten [w]
- wikEd ohje
- Poistaminen. Poista tai kommentoi pois käytöstä skripti. Jos editori ei poistu heti, kokeile Asetukset > Muokkaus > Poista käytöstä "Ota käyttöön parannettu työkalupalkki muokkauksissa" ja tallena asetukset > Ota käyttöön "Ota käyttöön parannettu työkalupalkki muokkauksissa" ja tallenna asetukset.
Varmuuskopiointi[muokkaa]
Nämä ohjeet ovat puutteelliset, mutta voivat auttaa eteenpäin, ohjeita löytyy paljon netistä hakusanoilla MediaWiki Backup
- Mediawikin varmuuskopioitava tieto koostuu tietokannasta ja tiedostojärjestelmästä. Kummatkin on varmuuskopioitava erikseen. Varmuuskopiointi voidaan automatisoida. Lisäksi /extensions kansio ja LocalSettings.php saattaa kannattaa kopioida.
- Turvallisinta olisi asettaa wiki vain-luku tilaan ettei samanaikaisesti wikiin tapahdu tallennusta. LocalSettings.php -tiedostoon:
$wgReadOnly = 'Tämä wiki on nyt vain luku -tilassa meneillään olevasta huollosta johtuen (pp.kk.vv)';
- Jos teet esimerkiksi siirron uuteen wikiin viemällä ja tuomalla. Kannattaa varmuuden vuoksi pitää vanha wiki käyttökunnossa jonkin aikaa. Saattaa helposti paljastua mitä ei tullut vietyäkään; mallineita, keskustelusivuja, css-sivuja ym.
Tietokannan varmuuskopiointi[muokkaa]
Tietokanta sisältää tärkeimmät tiedot, esimerkiksi sisällön, joten voi olla tärkeämpää esimerkiksi kopioida ne useammin. Helpoimmat tavat varmuuskopioida on cPanelin toiminnot ja cPanelin kautta siirtyminen PhpMyAdmin-ohjelmaan.
- MySQL -tietokanta on helppo myös dumpata tiedostoksi, josta se on myös yksinkertaista palauttaa.
mysqldump -h localhost -u tietokantakäyttäjätunnus --password --default-character-set=käytettävämerkistö tietokannannimi > varmuuskopio.sql mysqldump -h localhost -u tietokantakäyttäjätunnus --password --default-character-set=käytettävämerkistö tietokannannimi | gzip > pakattuvarmuuskopio.sql.gz mysqldump -h localhost -u tietokantakäyttäjätunnus --password --default-character-set=käytettävämerkistö --xml tietokannannimi > varmuuskopio.xml mysqldump -h localhost -u tietokantakäyttäjätunnus --password --default-character-set=käytettävämerkistö --xml tietokannannimi | gzip > pakattuvarmuuskopio.xml.gz
- Katso tiedot LocalSettings.php -tiedostosta. Merkistö on kerrottu kohdassa # MySQL table options to use during installation or update. Ole tarkkana merkistön kanssa, koska palautus ei välttämättä suju helposti tällöin ja ääkköset eivät siis tule kohdalleen.
Cron ajastus[muokkaa]
Katso sivu Cron.
PHP -ohjelmalla[muokkaa]
Tästä linkistä löytyvä php-kielinen ohjelma tallentaa hakemistoihin päivä, viikko ja kuukausivarmuuskopiot tietokannasta, kuvakansiosta, laajennusosakansiosta ja LocalSettings.php-tiedostosta pakattuina. Ohjelman perusasetukset on asetettu OSX Mavericks käyttöjärjestelmässä pyörivään MediaWikiin. Jos haluat varmuuskopioinnin tapahtumaan automaattisesti taustalla, katso sivulta Cron.
Sh skriptillä[muokkaa]
- Seuraava tiedosto ottaa varmuuskopion tietokannasta, kuvakansiosta, laajennukset-kansiosta ja LocalSettings.php tiedostosta ja pakkaa ne zip-tiedostoksi.
- Tee tekstieditorilla tiedosto joka sisältää seuraavan ja tallenna se mediawikin hakemistoon jossa on LocalSettings.php tiedosto sijaitsee. Anna tiedostolle nimi, esim. mediawikivarmuuskopio.sh eli joka päättyy .sh
- Lisää uusi kansio nimeltä varmuuskopiot samaan kansioon eli /mediawiki/varmuuskopiot
- Anna komento: sh mediawikivarmuuskopio.sh
#!/bin/bash FNAME=`date +%Y-%m-%d` /usr/local/mysql/bin/mysqldump -u tietokantakäyttäjätunnus -psalasana --default-character-set=käytettävämerkistö --database tietokannannimi --add-drop-table -B > ${FNAME}.sql zip -r ./varmuuskopiot/${FNAME}.zip images/ ${FNAME}.sql LocalSettings.php extensions/ rm ${FNAME}.sql
- Seuraava lisäys samaan tiedoston jatkoksi huolehtii että 5 viimeisintä varmuuskopiota on hakemistossa. Näin hakemiston koko ei pääse kasvamaan.
# OLE ERITTÄIN HUOLELLINEN HAKEMISTON NIMEN KANSSA. MUUTOIN SAATAT TUHOTA VÄÄRÄN HAKEMISTON SISÄLLÖN. # ASETA TÄHÄN SE VARMUUSKOPIOKANSION NIMI JOTA ON KÄYTETTY MYÖS YLÄPUOLELLA. # TÄMÄN TIEDOSTON SIJAINTIHAN ON SAMA HAKEMISTO KUIN MISSÄ LOCALSETTINGS.PHP SIJAITSEE. cd ./varmuuskopiot #Tiedostojen lukumäärän laskenta (piilotiedostoja ei huomioida) file_count=`ls | wc -l` #Poistetaan hakemistosta tiedostoja kunnes 5 uusinta jäljellä. Luku pitää olla 1 suurempi haluttua. while [ $file_count -ge 6 ] do del_files="${del_files} `ls | head -n 1`" rm `ls | head -n 1` file_count=`ls | wc -l` done
- Seuraava tiedosto antaa mahdollisuuden kutsua edellä tehtyä varmuuskopioskriptiä suoraan selaimen osoiteriviltä ja ladata näin sen suoraan tietokoneeseen mistä sitä kutsutaan. Sen lisäksi se tietysti tekee palvelimelle varmuuskopion ja pitää siellä enintään 5 uusinta.
- Tallenna se myös /mediawiki -hakemistoon kuten edellinenkin tiedosto. Tiedoston nimeksi anna tiedostonimi.php eli .php -päätteinen.
- Kutsu ohjelmaa http://www.mediawikinosoite/mediawikivarmuuskopio.php
- Jos zip tiedoston sisällä on tyhjä tietokanta 0 kt, todennäköisin virhe on että /usr/local/mysql/bin/ -polku puuttuu .sh -tiedostosta.
KESKEN KOSKA KORVATTIIN PHP TIEDOSTOLLA. KTS YLLÄ.
mysqldump[muokkaa]
Katso sivulta PHP ja MySQL kohta MediaWiki
phpMyAdmin ohjelmalla[muokkaa]
- Kirjaudu ohjelmaan
- phpMyAdmin ohjelma pitää olla asennettu palvelimelle. Sen voi tarvittaessa tehdä itse, jos omaa riittävät oikeudet. Yleensä siihen pääsee suoraan cPanel:in kautta
- Valitse vasemmalta valikosta tietokanta jonka haluat varmuuskopioida
- Valitse ylhäältä välilehti Vienti
- Valitse Vienti-laatikossa kohta: Valitse kaikki
- Valitse Tallenna tiedostoon
- Paina Siirry
- Tietokanta kopioituu koneellesi määrittelemääsi sijaintiin.
Kuvien varmuuskopiointi[muokkaa]
- Kopioi images -hakemisto palvelimelta
Muiden tiedostojen varmuuskopiointi[muokkaa]
- Yksinkertaisinta lienee ottaa palvelimella koko mediawiki-hakemistosta kopio.
- Jos sinulla on ssh yhteys palvelimeen, niin voit tehdä sen esimerkiksi komennolla
cp -r wikihakemistonnimi varmuuskopionnimi
- Esimerkiksi LocalSettings.php sisältää itse asettamasi asetustiedot wikille.
- Mahdolliset asennetut lisäosat ja jopa muutokset koodiin
MediaWikin asentaminen[muokkaa]
Jos asennat MediaWikiä esimerkiksi kaupalliselle palvelimelle, kannattaa asennus tehdä cPanelin Installatron Application Installer -toiminnon kautta. Tällöin MediaWikin päivitykset tapahtuvat automaattisesti.
Apache palvelin[muokkaa]
- Asennus tehty 24.11.2024 - MediaWiki 1.42.3 - macOS Sequoia
- Tarkista palvelimesi sopivuus kyseiselle MediaWiki-versiolle
- Lue release-notes kyseistä versiota koskien
- https://www.mediawiki.org/wiki/Download Lataa MediaWiki, yleensä viimeisin versio.
- lataa se suoraan pääteohjelmalla kotitietokoneella tai verkkosivun linkistä tai palvelimella tai siirrä esimerkiksi cPanel File Managerilla kotikoneelta palvelimen public_html -hakemistoon eli juurihakemistoon!
- suoraan palvelimelta jos asennettuna wget: wget http://releases.wikimedia.org/mediawiki/1.42/mediawiki-1.42.3.tar.gz
- pura tiedosto cPanel:n Extract toiminnolla tai pääteohjelmalla: tar -xvzf mediawiki-*.tar.gz
- vaihda kansion nimeksi w esimerkiksi File Manager:lla klikkaamalla kansion nimeä tai pääteohjelmalla mv mediawiki-1.34.1 w. MediaWikiä ei suositella asennettavaksi suoraan juureen vaan juuren alihakemistoon eli esim. w. Kannattaa antaa nimeksi w, jos haluat asentaa lyhyen URL-osoitteen myöhemmin wikiisi. Esim. www.palvelin.fi/wiki/Sivunnimi. Huom! Älä ainakaan anna tästä syystä hakemistolle nimeä wiki.
- hakemiston voi myöhemmin muuttaa helposti muuttamalla hakemiston nimen ja muuttamalla LoacalSettings.php tiedostoon kyseisen hakemiston nimen.
- tarkista/aseta mediawiki/mw-config hakemistolle 755-oikeudet File Manager > Change Permissions tai pääteohjelmalla: chmod 755 mw-config Huomaa, että 777 -oikeus voi saada aikaiseksi 500-virheilmoituksen!
- MediaWiki luo automaattisesti uuden tietokannan jos sinulla on antaa sille tietokantapalvelimen root tunnus ja salasana. Tällöin voit siirtyä suoraan mediawikin asennukseen. Muutoin,
- jos et tiedä tietokannan root-käyttäjän salasanaa, tietokanta pitää luoda mediawikille esimerkiksi cPanel:sta löytyvällä phpMyAdmin -ohjelmalla tai cPanel:in 'MySQL Database':lla tai MySQL Database Wizard:lla.
- cPanel > MySQL® Database Wizard. Anna käyttäjälle seuraavat 8 oikeutta: index, create, select, insert, update, delete, alter, lock tables.
- tai phpMyAdmin > SQL
create database wikidb; grant index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'jokunimi'@'localhost' identified by 'salasana';
- Avaa selaimessa osoite http://www.palvelin.fi/w/index.php tai http://localhost/~käyttäjätunnus/w/index.php
- set up the wiki > Your language fi -suomi ja Wiki language fi - suomi > Continue > Tarkista ympäristö ja Jatka
- Tietokannan tyyppi MySQL, Tietokantapalvelin localhost, Tietokannan nimi esim. wikidb, jos haluat tauluille etuliitteen, kirjoita etuliite_, MySQL-tietokannan root-käyttäjän salasana > Jatka
- UTF-8 vai binary. Ei näytä olevan ongelma ainakaan jos vanha wiki on binary ja uusi UTF-8 ja siirrät sivut sivuston vienti/tuonti -toiminnolla. Utf-8 on hyvä.
- Kysyy Tietokantatunnus verkkokäyttöön: Käytä samaa tunnusta kuin asennuksessa. Valitse tämä. ???
- Anna vähintään tietokannalle nimi, käyttäjätunnus ja salasana.
- Siirrä muodostunut LocalSettings.php mediawiki hakemistoon.
- Muuta LocalSettings.php tiedosto-oikeudeksi 400 tai jos ei toimi 600, 640 tai 644 tässä järjestyksessä kokeillen. Pääteohjelmalla: chmod 644 LocalSettings.php
- Siirry asettamaan LocalSettings.php-tiedoston asetuksia (oma otsikko alla)
- Aseta lyhyt URL
- Muuta tarvittaessa nimipalvelimet (domain) osoittamaan palvelimelle
- Enter your wiki ja testaa sivujen näkyminen, muokkaus, tiedostojen lataus, tarkista versionumero
- Tee tarvittavat perusasetukset. Kts. vinkkejä kohdasta MediaWikin siirtäminen esimerkki 1
- Ota varmuuskopio toimivasta asennetusta versiosta: tiedostojärjestelmä ja tietokanta.
- Asennus tehty 5.9.2020 - MediaWiki 1.34.2
- Tarkista palvelimesi sopivuus kyseiselle MediaWiki-versiolle
- Lue release-notes kyseistä versiota koskien
- Lataa MediaWiki, yleensä viimeisin versio MediaWiki -sivustosta.
- lataa se suoraan pääteohjelmalla "kotitietokoneella" tai palvelimella tai siirrä esimerkiksi cPanel File Managerilla "kotikoneelta" palvelimen public_html -hakemistoon eli juurihakemistoon!
- suoraan palvelimelta: wget http://releases.wikimedia.org/mediawiki/1.34/mediawiki-1.34.2.tar.gz
- pura tiedosto cPanel:n Extract toiminnolla tai pääteohjelmalla: tar -xvzf mediawiki-*.tar.gz
- vaihda kansion nimeksi w esimerkiksi File Manager:lla klikkaamalla kansion nimeä tai pääteohjelmalla mv mediawiki-1.34.1 w. MediaWikiä ei suositella asennettavaksi suoraan juureen vaan alihakemistoon eli hakemistoon w. Kannattaa antaa nimeksi w, jos haluat asentaa lyhyen URL-osoitteen myöhemmin wikiisi. Esim. www.palvelin.fi/wiki/Sivunnimi. Huom! Älä ainakaan anna tästä syystä hakemistolle nimeä wiki.
- hakemiston voi myöhemmin muuttaa helposti muuttamalla hakemiston nimen ja muuttamalla LoacalSettings.php tiedostoon kyseisen hakemiston nimen.
- tarkista/aseta mediawiki/mw-config hakemistolle 755-oikeudet File Manager > Change Permissions tai pääteohjelmalla: chmod 755 mw-config Huomaa, että 777 -oikeus voi saada aikaiseksi 500-virheilmoituksen!
- MediaWiki luo automaattisesti uuden tietokannan jos sinulla on antaa sille tietokantapalvelimen root tunnus ja salasana. Tällöin voit siirtyä suoraan mediawikin asennukseen. Muutoin,
- jos et tiedä tietokannan root-salasanaa, tietokanta pitää luoda mediawikille esimerkiksi cPanel:sta löytyvällä phpMyAdmin -ohjelmalla tai cPanel:in 'MySQL Database':lla tai MySQL Database Wizard:lla.
- cPanel > MySQL® Database Wizard. Anna käyttäjälle seuraavat 8 oikeutta: index, create, select, insert, update, delete, alter, lock tables.
- tai phpMyAdmin > SQL
create database wikidb; grant index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'jokunimi'@'localhost' identified by 'salasana';
- Avaa selaimessa osoite http://www.palvelin.fi/w/index.php
- set up the wiki > Your language fi -suomi ja Wiki language fi - suomi > Continue > Tarkista ympäristö ja Jatka
- Tietokannan tyyppi MySQL, Tietokantapalvelin localhost, merkistö UTF-8, Tietokannan nimi wikidb, jos haluat tauluille etuliitteen, kirjoita etuliite_ > Jatka
- UTF-8 vai binary. Ei näytä olevan ongelma ainakaan jos vanha wiki on binary ja uusi UTF-8 ja siirrät sivut sivuston vienti/tuonti -toiminnolla. Utf-8 on hyvä.
- Siirrä muodostunut LocalSettings.php mediawiki hakemistoon
- Muuta LocalSettings.php tiedosto-oikeudeksi 400 tai jos ei toimi 600, 640 tai 644 tässä järjestyksessä kokeillen.
- Siirry asettamaan LocalSettings.php-tiedoston asetuksia (oma otsikko alla)
- Aseta lyhyt URL
- Muuta tarvittaessa nimipalvelimet (domain) osoittamaan palvelimelle
- Enter your wiki ja testaa sivujen näkyminen, muokkaus, tiedostojen lataus, tarkista versionumero
- Tee tarvittavat perusasetukset. Kts. vinkkejä kohdasta MediaWikin siirtäminen esimerkki 1
- Ota varmuuskopio toimivasta asennetusta versiosta: tiedostojärjestelmä ja tietokanta.
LocalSettings.php -asetuksia[muokkaa]
LocalSettings.php /w -hakemistossa on se, mihin tehdään tiedostojärjestelmässä muutokset, jotka vaikuttavat välittömästi tallennuksen jälkeen sivustossa.
# Sallitut tiedostopaatteet. $wgFileExtensions = array( 'csv', 'pdf', 'gif', 'jpeg', 'jpg', 'png', 'doc', 'docx', 'txt', 'rtf', 'xls', 'xlsx', 'wmv', 'ppt', 'pptx'); # Poistetaan kayttajan IP Kirjaudu sisaan rivilta. $wgShowIPinHeader = False; # Poistetaan tilin lisaaminen. $wgGroupPermissions['*']['createaccount'] = false; # Poistetaan keskustelulinkki toimintosivuilta kirjautumattomilta. $wgDisableAnonTalk = True; # Muokkauslaatikon rivien maara ja esikatselu em. laatikon alapuolelle. $wgDefaultUserOptions['rows'] = 40; $wgDefaultUserOptions['previewontop'] = false; # Asetetaan aikavyohyke. $wgLocaltimezone = "Europe/Helsinki"; date_default_timezone_set( $wgLocaltimezone ); # Ulkoinen linkki avautumaan uudelle sivulle. $wgExternalLinkTarget = '_blank'; # Vaihdetaan tekijänoikeuslinkki suomeksi $wgRightsUrl = 'https://creativecommons.org/licenses/by-nc-sa/4.0/deed.fi'; # Mahdollisuus piilottaa muokkauksia $wgGroupPermissions['sysop']['deletelogentry'] = true; $wgGroupPermissions['sysop']['deleterevision'] = true; # VIRHEILMOITUKSET NAKYVIIN # $wgShowExceptionDetails = true;
Lyhyt URL[muokkaa]
- Wikipediassa URL näyttää seuraavalta: https://fi.wikipedia.org/wiki/Sivunimi
- Oletuksena MediaWikin asetuksen jälkeen osoite näkyy https://wikinosoite.pääte/wiki/index.php?title=Sivunimi
- MediaWikin ohjeiden mukaan ei suositella käyttää seuraavaa: https://wikinosoite.pääte/Sivunimi
- MediaWikiä ei tule asentaa hakemistoon /public_html/wiki
- Lähtökohtaisesti kun sivun käyttäjä lähettää URL-osoitteen palvelimellesi pyytäen haluttua wikisi sivua, pyyntö ohjataan cPanel:ssa public_html -hakemistoon, josta löytyy .htaccess -tiedosto, joka ohjaa sen määrättyyn alihakemistoon esimerkiksi /w -hakemistoon, jossa MediaWikin index.php ottaa haltuunsa osoitteen luomisen yhdessä .htaccess -tiedoston kanssa ja käyttää siinä hyväksi vielä LocalSettings.php-tiedoston ohjeita minkälaisessa muodossa osoite näkyy URL-rivillä kun sivu on ladattu käyttäjälle.
- Tämä osa-alue voi olla konstikas, koska tässä on vähintään seuraavat muuttuvat tekijät:
- LocalSettings.php
- public_html-hakemiston .htaccess
- mahdollisesti domainohjaus cPanel:ssa
- .htaccess-tiedostosta on lisää sivulla .htaccess
- Sivustossa https://www.mediawiki.org/wiki/Manual:Short_URL on linkki sivustoon https://shorturls.redwerks.org// jossa voi muodostaa omalle MediaWikille helposti räätälöidyt .htaccess ja LocalSettings.php -koodit. Sivustolla on vanha sertifikaatti, joten selain saattaa antaa sivua avatessa varoituksen (4/2021).
- Wikissä, joka on vuosia vanha saattaa olla käytetty vaihtelevasti URL-osoitteen muotoa. Linkkejä sivuihin on sitten käytetty keskustelupalstoilla ym. ja kun wikin URL-osoitteen rakennetta muutetaan, nämä linkit eivät enää toimi ja johtavat 404-virheilmoitukseen. Esimerkiksi jos vanha muoto on ollut http://osoite.pääte/w/index.php?title=Sivunnimi niin osoitteesta voidaan havaita, että tuolloin MediaWiki on asennettu hakemistoon w. Tällöin sen sääntö on RewriteRule ^/?w(/.*)?$ %{DOCUMENT_ROOT}/uuden MediaWikin hakemisto/index.php [L] eli huomaa, että alkuosassa on kysymysmerkin jälkeen tuo w-hakemisto. Lisää tämä alla olevassa esimerkissä esimerkiksi kolmannelle riville /public_htlml/.htaccess-tiedostoon.
- Seuraavissa ohjeissa MediaWiki on asennettu hakemistoon /public_html/w
- 1. MediaWiki on tiedostojärjestelmässä esimerkiksi seuraavasti: /home/käyttäjätunnus/public_html/w jolloin LocalSettings.php löytyy hakemistosta /w
- 2. LocalSettings.php -tiedostossa on seuraavat asetukset:
$wgServer = 'https://mediawikisivusto.pääte'; $wgScriptPath = '/w'; $wgScriptExtension = ".php"; $wgArticlePath = "/wiki/$1"; $wgUsePathInfo = true; $wgGenerateThumbnailOnParse = false;
- 3. .htaccess-tiedoston, joka vaikuttaa MediaWikin osoitteeseen, tulee sijaita public_html-hakemistossa. EI siis /w -hakemistossa! Tiedosto-oikeus 644. .htaccess:ssa voi olla muitakin ohjauksia useampaan MediaWikiin public_html-hakemiston alahakemistoissa tai muihin ohjelmistoihin, esimerkiksi WordPressiin. Yksi RewriteEngine on riittää sivun alussa.
<Files .htaccess> order allow,deny deny from all </Files> Options -Indexes Options +FollowSymLinks #Allow rewriting URLs RewriteEngine on RewriteRule ^/?wiki(/.*)?$ %{DOCUMENT_ROOT}/w/index.php [L] RewriteRule ^/?$ %{DOCUMENT_ROOT}/w/index.php [L] RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d RewriteRule ^/?w/images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/w/thumb.php?f=$1&width=$2 [L,QSA,B] RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d RewriteRule ^/?w/images/thumb/archive/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/w/thumb.php?f=$1&width=$2&archived=1 [L,QSA,B]
- 4. Jos olet hankkinut wikille esimerkiksi oman domainin (esim. wikini.pääte), etkä käytä sitä domainia, joka osoittaa public_html -hakemistoon niin aseta cPanel:ssa kohdassa Domains > Addon Domains seuraavasti osoittamaan public_html-hakemistoon:
Addon Domains: mediawikisivusto.pääte Document Root: /public_html Redirects To: not redirected
- 5. Muista, että selaimet ovat usein syynä siihen, että et näe muutoksia. Muista siis tyhjentää selaimen välimuistia ja jopa sulkea selainohjelma ja avata se uudestaan (siis ei ainoastaan ikkunoita). Joskus .htaccess -tiedosto täytyy jopa kirjoittaa uudestaan puhtaaseen tekstitiedostoon.
- HUOM! Usein ongelma esiintyy Safari-selaimen kanssa niin macOS-tietokoneessa kuin iOS-matkapuhelimessa, joten kokeile muita kuten Chrome ja Firefox.
- Yleiset virheilmoitukset ovat 404 ja 500.
- 6. Hyödyllisiä sivuja sattavat olla esim.
- https://www.mediawiki.org/wiki/Manual:Short_URL
- https://www.mediawiki.org/wiki/Manual:Short_URL/Apache
- https://httpd.apache.org/docs/2.4/rewrite/intro.html
Lyhyt URL ja useampi MediaWiki[muokkaa]
- Päivitetty 11.4.2021
- alihkaemisto1 ja alihakemisto2 sisältävät kaksi eri MediaWikiä.
- alihakemisto1-hakemistoon ohjataan kun URL kohdistuu www.mediawikisivusto.pääte
- alihakemisto2-hakemistoon ohjataan kun URL kohdistuu mediawikisivusto.pääte/alihakemisto2
- Toisin sanoen alihakemisto1 sijaitseva Mediawiki on domainin ensisijainen mediawiki ja kun halutaan käyttää alihakemisto2 olevaa mediawikiä, lisätään domainiin polku /alihakemisto2
- Esimerkissä toinen mediawiki käyttää www ja toinen ilman.
- alihakemisto1 url on muotoa https://mediawikisivusto.pääte/wiki/Etusivu
- alihakemisto2 url on muotoa https://mediawikisivusto.pääte/alihakemisto2/wiki/Etusivu
- RewriteRule-sanan jälkeen tehdään ero siinä, kohdistuuko URL pelkkään domainiin vai domainiin alihakemiston kanssa. Kuitenkin kummassakin tapauksessa MediaWikit ovat alihakemistoissa.
- Huomaa robots.txt sijainti, jotta robots.txt aukeaa osoitteella www.osoite.xxx/robots.txt eikä sen sijaan aukea Meadiawikin robots.txt -sivu.
public_html/.htaccess
<Files .htaccess> order allow,deny deny from all </Files> Options -Indexes Options +FollowSymLinks #Allow rewriting URLs RewriteEngine on # Short url for Wikikko pages Alihakemisto1 RewriteRule ^/?wiki(/.*)?$ %{DOCUMENT_ROOT}/alihakemisto1/index.php [L] # Redirect for old pages http://osoite.xxx/polku/index.php?title=Sivunimi RewriteRule ^/?w(/.*)?$ %{DOCUMENT_ROOT}/alihakemisto1/index.php [L] # Redirect / to Wikikko Main Page RewriteRule ^/?$ %{DOCUMENT_ROOT}/alihakemisto1/index.php [L] # Redirect for url https://osoite.xxx/Sivunimi RewriteCond %{HTTP_HOST} ^osoite\.xxx [NC] # Don't rewrite requests for robots.txt (osoite.xxx/robots.txt) RewriteCond %{REQUEST_URI} !^/robots.txt RewriteRule ^(.*)$ https://osoite.xxx/wiki/$1 [L] RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d RewriteRule ^/?w/images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/alihakemisto1/thumb.php?f=$1&width=$2 [L,QSA,B] RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d RewriteRule ^/?w/images/thumb/archive/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/aihakemisto1/thumb.php?f=$1&width=$2&archived=1 [L,QSA,B] # Short url for Wikikko pages Alihakemisto2 RewriteRule ^/alihakemisto2/?wiki(/.*)?$ %{DOCUMENT_ROOT}/alihakemisto2/index.php [L] # Alihakemisto2 -etusivulle ohjaus kun kohdistuu URL-osoitteeseen /alihakemisto2 RewriteRule ^/alihakemisto2/?$ %{DOCUMENT_ROOT}/alihakemisto2/index.php [L] RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d RewriteRule ^/?alihakemisto2/images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/alihakemisto2/thumb.php?f=$1&width=$2 [L,QSA,B] RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d RewriteRule ^/?alihakemisto2/images/thumb/archive/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/alihakemisto2/thumb.php?f=$1&width=$2&archived=1 [L,QSA,B]
alihakemisto1/LocalSettings.php
$wgServer = 'https://mediawikisivusto.pääte'; $wgScriptPath = '/alihakemisto1'; $wgScriptExtension = ".php"; $wgArticlePath = "/wiki/$1"; $wgUsePathInfo = true; $wgGenerateThumbnailOnParse = false;
alihakemisto2/LocalSettings.php
$wgServer = "https://mediawikisivusto.pääte"; $wgScriptPath = "/alihakemisto2"; $wgScriptExtension = ".php"; $wgArticlePath = "/alihakemisto2/wiki/$1"; $wgUsePathInfo = true; $wgGenerateThumbnailOnParse = false;
- Linkkejä
Lyhyt URL ilman /wiki tai /w[muokkaa]
- Seuraava ohjaa https://osoite.pääte/sivunimi -urlin MediaWikiin, jossa käytetään URL:ssa on /wiki
- Tämä voi olla hyödyllinen kun esimerkiksi jaettaisiin sivun linkkiä lyhennetyssä selkeässä muodossa: osoite.pääte/sivunimi
RewriteCond %{HTTP_HOST} ^osoite\.pääte [NC] RewriteRule ^(.*)$ https://osoite.pääte/wiki/$1 [L]
Logo[muokkaa]
- Logon koko on 135 x 135 px ja läpinäkyvä png, gif tai jpg
- Sijoita hakemistoon /resources/assets/logonnimi.png
- aseta LocalSettings.php tiedostoon $wgLogo = "$wgResourceBasePath/resources/assets/logonnimi.pääte";
Ongelmia ja huomioita[muokkaa]
- Fatal exception of type MWException. Lisää LocalSettings.php tiedostoon require_once asetuksen alle oheinen rivi. Jostain syystä selaimen kautta tehty asennus ei lisää tätä riviä, mutta se on mainittu laajennusosan kotisivulla asennusohjeissa.
require_once "$IP/extensions/LocalisationUpdate/LocalisationUpdate.php"; $wgLocalisationUpdateDirectory = "$IP/cache";
- Sivua ei löydy, 404-virhe. Et pääse esimerkiksi Toimintosivulle, kun muualle pääset. Kokeile ensimmäisenä toisella selaimella (esm. Safari/Firefox). Epätodennäköinen syy, mutta voi korjaantua: Jos annat muun alihakemiston nimen kuin w saattaa olla että et esimerkiksi pääse myöhemmin Toimintosivut -sivulle.
- Valkoinen sivu
- Vaihtoehto 1. Tarksita LocalSettings.php tiedoston rivi $wgDBTableOptions = "ENGINE=InnoDB, DEFAULT CHARSET=utf8"; eli default charset. Kokeile muuttaa binary tai päinvastoin utf8.
- Vaihtoehto 2. Oletko kenties päivittänyt? LocalSettings.php esimerkiksi muuttui usealta kohdin MediaWiki 1.25 versiossa. Asenna puhdas MediaWiki ja luo asennuksessa UUSI LocalSettings.php. Tee vertailu olemassaolevaan LocalSettings.php -versioosi tai katso MediaWikin Upgrade sivulta ohjeita. Saattaa olla ettei toimi tästä huolimatta. Jos olet päivittänyt MediaWikin, muista ajaa päivitys http://domain.fi/wikisiosoite/mw-config/
- Vaihtoehto 3. Jos vaihtoehdossa 2 luotu MediaWiki toimii, on php ja MySQL toiminnassa. Todennäköisesti ongelma on LocalSettings.php -tiedostossa tai tietokannassa.
- Vaihtoehto 4. Tee uusi puhdas MediaWiki asennus. Vie päivittämäsi (upgrade) tietokanta phpMyAdmin -ohjelmalla sql-tiedostoksi. Tuhoa uuden MediaWiki:n kaikki taulut. Tuo sql-tiedosto tähän uuteen nyt tyhjään tietokantaan. Kopioi image-kansio. Tarkista tarvittaessa vaihtoehto 1.
OSX Yosemite[muokkaa]
Asennus tehty 13.8.2015 MediaWiki 1.25.2
- Ota käyttöön PHP ja MySQL ja phpMyAdmin. Ohjeet löytyvät sivuilta PHP asennus.
- Kytke MySQL päälle
- Lataa MediaWikin esimerkiksi viimeisin versio MediaWiki sivustosta, pura ja siirrä /Sites -hakemistoon.
- Anna selaimeen http://localhost/~käyttäjänimesi/mediawiki
- set up the wiki > Your language fi -suomi ja Wiki language fi - suomi > Continue > Jatka
- Tietokannan tyyppi MySQL, Tietokantapalvelin localhost, Tietokannan nimi wikidb > Jatka > Jatka > Jatka
- Siirrä LocalSettings.php mediawiki hakemistoon
- Asennus valmis.
- ImageMagick
- Kuvien pikkukuvakkeiden muodostamiseen tarvittava ohjelma: sudo port install ImageMagick
OSX Mavericks[muokkaa]
- Asennus tehty 21.1.2014
- Ota käyttöön PHP ja MySQL ja phpMyAdmin. Ohjeet löytyvät sivuilta PHP asennus.
- Kytke MySQL päälle ja luo wikille oma tietokanta phpMyAdmin -ohjelmalla
- Tietokannat > Luo tietokanta tietkannannimi Aakkosjärjestys > Luo
- Lataa MediaWikin esimerkiksi viimeisin versio MediaWiki sivustosta.
- Siirrä Finder:lla tiedosto hakemistoon käyttäjänimesi/Sites
- Pääte -ohjelmassa tee seuraavat:
- cd Sites/
- tar -xvzf mediawiki-1.22.1.tar eli puretaan tiedosto (vaihda versionumero tarpeen mukaan)
- mv mediawiki-1.22.1 mediawiki eli vaihdetaan tiedoston nimi, voi tehdä myös Finder:lla
- Anna selaimeen http://localhost/~käyttäjänimesi/mediawiki
- set up the wiki > Your language fi -suomi ja Wiki language fi - suomi > Continue > Jatka
- Tietokannan tyyppi MySQL, Tietokantapalvelin localhost, Tietokannan nimi wikidb > Jatka > Jatka > Jatka
- Siirrä LocalSettings.php mediawiki hakemistoon
- enter your wiki
- Logo.
- sijoita hakemistoon mediawiki/skins/common/images
- aseta LocalSettings.php tiedostoon $wgLogo = "{$wgStylePath}/common/images/logonnimi.png";
- Kuvienlatausongelma
- OSX Mavericks alustalla saattaa ilmetä erikoinen ongelma joka nk. voi vaikuttaa yöuniin. Ongelma ilmenee niin että pystyt lataamaan kuvia /images hakemistoon tallenna tiedosto toiminnon avulla, mutta ne eivät tule näkyviin kuvina vaan saat ilmoituksen että sinulla ei ole oikeuksia: You don't have permission to access /~yourusername/w/images/7/77/image.png on this server.
- Ongelma ratkeaa poistamalla /images kansiosta .htaccess tiedoston. Tiedostossa on maininta Protect against bug 28235. Katso kohdasta Mac vinkit kuinka piilotiedostot saadaan näkyviin Finder:ssa.
- Ratkaisua etsiessä selvisi myös että Apache käyttää User ja Group omistajina _www nimeä. Tarvittaessa tämän voi muuttaa, katso sivu PHP asennus. Tämä ei kuitenkaan näyttänyt vaikuttavan ainakaan ennen .htaccess tiedoston poistamista. Sen jälkeen en ole kokeillut _www. Tarvittaessa tarkista /images kansion omistaja ja ryhmä myös. Kansion oikeus kuuluisi olla 755. Images kansion voi tyhjentää, wiki aloittaa kansioiden lisäämisen sinne ensimmäisen kuvan latauksen yhteydessä. Kansioiden numerointi tulee jollain tavoin MD5 avulla.
MediaWikin siirtäminen[muokkaa]
HUOM! Jos tietokannan koko on merkittävän suuri sisältöön nähden, kannattaa harkita siirtämistä tämän sivun 'text-taulu gigatavuja' -ohjeen mukaan.
MediaWikin siirtäminen esimerkki 1[muokkaa]
- Tehty 24.11.2024 - MediaWiki 1.42.3 -> 1.42.3
Tässä kuvataan tuotannossa olevan MediaWikin TIETOKANNAN ja TIEDOSTOJÄRJESTELMÄN kopioiminen toiselle palvelimelle, tässä tapauksessa verkosta macOS-tietokoneelle (Sequoia), johon on asennettu Wikikossa olevien ohjeiden mukaan Apache, PHP, MySQL ja phpMyAdmin sekä käyttäjäkohtainen Sites-hakemisto. Tässä ei tehdä MediaWikin päivitystä, vain siirretään sivusto toiseen palvelimeen.
- Asetetaan vanha wiki vain luku -tilaan. Tällöin vanha sivusto aukeaa normaalisti, mutta muokkauksen tallentaminen ei ole mahdollista.
- Lisätään LocalSettings.php -tiedostoon $wgReadOnly = 'Wikiä siirretään parhaillaan uudelle palvelimelle.';
- Varmuuskopioidaan siirrettävä tietokanta: Cpanel > Tools > Files > Backup > valitse tietokanta.
- Vaihtoehtoisesti jos sama tietokanta esim. sisältää useiden eri sovellusten tauluja, valitaan phpMyAdmin:ssa siirrettävät taulut ja viedään ne sivun alareunan valikosta
- Varmuuskopioidaan siirrettävä tiedostojärjestelmä: Esimerkiksi cPanel File Manager:lla tehdään wikin sisältävästä hakemistosta zip-paketti ja ladataan tietokoneelle/toiselle palvelimelle. Tai cPanel > Backups > Download a Home Directory Backup.
- Luodaan uudelle palvelimelle tietokanta ja siihen käyttäjä ja sille oikeudet. Tietokannan lisääminen kohdassa MediaWikin asentaminen.
- Tuodaan kopioitu tietokanta uuteen tietokantaan.
- Käytetään cPanelin/omalle tietokoneelle asennettua phpMyAdmin-ohjelmaa ja sen tuonti-toiminitoa (import). Jotta ei saada virheilmoitusta 'Incorrect format parameter': php.ini-tiedoston upload_max_filesize ja post_max_size -arvot ovat liian pienet. Kannattaa tarvittaessa suurenta php.ini-tiedoston em parametria tuotavan tietokannan .gz-koko huomioiden, ks. ohje sivu PHP asennus. Vaihtoehtoisesti kokeile ensin viedä tietokanta .gz-pakattuna eli cPanel > cPanel Backup ja valitse vietävä ja samalla pakattava tietokanta.
- Valitaan phpMyAdminissa ensin uusi tietokanta ja sitten sen välilehdeltä Import. Ei tarvitse purkaa .gz-tiedostoa. Valitaan tuotava tiedosto ja voidaan tuoda ehdotetuilla asetuksilla. Tuonti voi kestää hyvän tovin.
- Tuodaan kopioitu tiedostojärjestelmä uudelle palvelimelle ja puretaan zip-tiedosto public_html tai käyttäjäkohtaisen Sites-hakemiston juureen tai muualle. Kun tehtiin suoraan kopio, pysyvät myös tiedosto-oikeudet kohdallaan.
- Annetaan LocalSettings.php -tiedostolle vaadittava lukuoikeus, kaupallisella palvelimella 400 riittää, localhost voi edellyttää 404. Jos sivusto ei avaudu, ilmoittaa ettei pääsyä LocalSettings.php
- Tehdään tarvittavat muutokset vanhaan LocalSettings.php -tiedostoon.
- Muuta vähintään uuden tietokannan nimi $wgDBname ja uuden tietokannan käyttäjätunnus $wgDBuser ja salasana $wgDBpassword.
- Poistetaan tarvittaessa lyhennetty URL, erityisesti jos linkit eivät toimi.
- Päivitetään tai poistetaan laajennokset, jotka eivät toimi tai antavat virheilmoituksen.
- Jos käytetään esimerkiksi tilapäistä uuden palvelimen IP osoitetta laitetaan siksi ajaksi ennenkuin saadaan domain siirrettyä, $wgServer kohtaan uuden palveluntarjoajan IP-osoite: xxx.xxx.xxx.xxx/~käyttäjätunnustähän Huomaa, että lopussa EI saa olla / -viivaa. Jos lisätään se, sivusto pyrkii aloittamaan MediaWikin asennuksen, jota nyt ei tarvita.
- Tehdään tarvittaessa muutokset uuden palvelimen public_html-hakemiston .htaccess-tiedostoon ja mediawiki-hakemiston .htaccess-tiedostoon.
- Testataan sivuston toimivuus uudella palvelimella.
- Tehdään nimipalvelimien muutokset. Sivusto ohjautuu vanhalle palvelimelle ja muuttuu minuuttien - tuntien aikana uudelle palvelimelle.
- Kirjaudutaan sisään wikiin. Tarvittaessa osoitepolku kirjautumiseen on /w/index.php?title=Toiminnot:Kirjaudu_sisään
- Virheilmoitus: Notice: Uncommitted DB writes (transaction from DatabaseBase::query (LCStore_DB::get)). in /home/käyttäjätunnus/public_html/w/includes/db/Database.php on line 3944 todennäköisesti poistuu viimeistään kun kirjaudut ylläpitoon.
- Jos ei päästä kirjautumaan, koska tilapäisen IP-osoitteen jäljestä tipahtaa aina linkkiä painettaessa käyttäjätunnus pois
- Ongelma liittyy todennäköisesti juurihakemiston public_html .htaccess -tiedostoon jota joko ei ole tai siinä on virhe tai LocalSettings.php -tiedostoon. SELVITTÄMÄTTÄ
- Tehty 5.9.2020
Tässä kuvataan tuotannossa olevan MediaWikin TIETOKANNAN JA TIEDOSTOJÄRJESTELMÄN kopioiminen toiselle palvelimelle. Tässä ei tehdä MediaWikin päivitystä vaan yksinkertaisesti siirretään sivusto toiseen palvelimeen. Oletuksena on että palvelin on samanlainen eli muutoksia siltä osin ei tarvitse tehdä.
- Asetetaan vanha wiki vain luku -tilaan
- Lisätään LocalSettings.php -tiedostoon $wgReadOnly = 'Wikiä siirretään parhaillaan uudelle palvelimelle.';
- Tällöin vanha sivusto aukeaa normaalisti, mutta muokkauksen tallentaminen ei onnistu.
- Varmuuskopioidaan tietokanta
- Kopiodaan cPanel > cPanel Backup ja valitse tietokanta.
- Varmuuskopioidaan tiedostojärjestelmä
- Esimerkiksi cPanel File Manager:lla tehdään wikin sisältävästä hakemistosta zip-paketti ja ladataan tietokoneelle.
- Luodaan uudelle palvelimelle tietokanta ja siihen käyttäjä ja sille oikeudet
- Voit katsoa kohdasta Asentaminen tältä sivulta.
- Tuodaan tietokanta "kotikoneelta" uudelle palvelimelle
- Käytetään cPanelin kautta phpMyAdmin -ohjelmaa ja sen tuonti-toiminitoa (import). Tuodaan tietokanta tai halutut taulut.
- Virheilmoitus 'Incorrect format parameter': php.ini-tiedoston upload_max_filesize ja post_max_size -arvot ovat liian pienet. Kokeile kuitenkine ensin viedä tietokanta .gz-pakattuna eli cPanel > cPanel Backup ja valitse vietävä ja samalla pakattava tietokanta.
- Tuodaan tiedostojärjestelmä "kotikoneelta" uudelle palvelimelle ja puretaan zip-tiedosto public_html-hakemistoon
- Nyt kun tehtiin suoraan kopio, pysyvät myös tiedosto-oikeudet kohdallaan.
- Tarkistetaan LocalSettings.php -tiedosto
- Jos käytetään esimerkiksi tilapäistä uuden palvelimen IP osoitetta laita siksi ajaksi ennenkuin saat domainin siirrettyä $wgServer kohtaan uuden palveluntarjoajan IP-osoite: xxx.xxx.xxx.xxx/~käyttäjätunnustähän Huomaa ettei lopussa EI saa olla / -viivaa. Jos lisäät sen, sivusto pyrkii aloittamaan MediaWikin asennuksen, jota nyt ei tarvita.
- Muuta uusi tietokannan nimi kohtaan $wgDBname ja uuden tietokannan käyttäjätunnus ja salasana.
- Tee tarvittaessa muutokset uuden palvelimen public_html-hakemiston .htaccess-tiedostoon mediawiki-hakemiston .htaccess-tiedostoon.
- Testataan sivuston toimivuus uudella palvelimella
- Tehdään nimipalvelimien muutokset. Sivusto ohjautuu vanhalle palvelimelle ja muuttuu minuuttien - tuntien aikana uudelle palvelimelle.
- Kirjaudu sisään. Tarvittaessa osoitepolku kirjautumiseen on /w/index.php?title=Toiminnot:Kirjaudu_sisään
- Virheilmoitus: Notice: Uncommitted DB writes (transaction from DatabaseBase::query (LCStore_DB::get)). in /home/käyttäjätunnus/public_html/w/includes/db/Database.php on line 3944 todennäköisesti poistuu viimeistään kun kirjaudut ylläpitoon.
- Jos et pääse kirjautumaan, koska tilapäisen IP-osoitteen jäljestä tipahtaa aina linkkiä painettaessa käyttäjätunnus pois
- Ongelma liittyy todennäköisesti juurihakemiston public_html .htaccess -tiedostoon jota joko ei ole tai siinä on virhe tai LocalSettings.php -tiedostoon. SELVITTÄMÄTTÄ
MediaWikin siirtäminen esimerkki 2[muokkaa]
- Tehty 11.4.2021
Tässä kuvataan tuotannossa olevan MediaWikin vaihtaminen cPanelin kautta automaattitoiminnolla luotuun MediaWikiin samalla palvelimella ja samalla tehdään myös upgrade 1.34.0 --> 1.35.1. Tässä vanha MediaWiki pysyy koko ajan käytössä, mutta suljetaan muutoksilta. Kun uusi MediaWiki on saatu käyttöön sulkuhetken tietokannalla ja tiedostojärjestelmällä, tehdään uudelleenohjaus uuteen MediaWikiin ja poistetaan vanha MediaWiki käytöstä. Oletuksena on että on mahdollista perustaa tilapäisesti yksi uusi tietokanta.
- Luodaan cPanelissa uusi tietokanta
- cPanel > MySQL® Database Wizard. Anna käyttäjälle seuraavat 8 oikeutta: index, create, select, insert, update, delete, alter, lock tables.
- tai phpMyAdmin > SQL
create database wikidb; grant index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'jokunimi'@'localhost' identified by 'salasana';
- Luodaan uusi MediaWiki uuteen public_html-alihakemistoon käyttäen uutta tietokantaa. Huom! Luo uusi MediaWiki samalla kielellä kuin vanha MediaWiki eli jos suomen kielellä, valitse Suomi.
- cPanel > Web Applications > MediaWiki
- Poistetaan tietokannasta MediaWikin asennuksessa luodut taulut phpMyAdminilla
- Valitaan poistettavat taulut ja alaosan pudotusvalikosta drop ja Yes
- Tehdään uuteen LocalSettings.php-tiedostoon tarvittavat muutokset käsin. Katso esim. vanhasta LocalSettings.php-tiedostosta.
- Tärkeää muistaa muuttaa vanhan tietokannan taulujen etuliite!
- Asetetaan vanha wiki vain luku -tilaan
- Lisätään LocalSettings.php -tiedostoon $wgReadOnly = 'Wikiä huolletaan. Arvioitu päättymisajankohta xx.xx.20xx klo xx.xx. Wikiin ei voi tehdä huollon aikana muutoksia.';
- Varmuuskopioidaan vanha tietokanta varmuuden vuoksi kahdella eri tavoin
- cPanel > Backup > Download a MySQL Databse Backup > valitse tietokanta
- cPanel > phpMyAdmin > Export > Custom > Format: SQL > Databases: valitse MediaWikin sisältävä tietokanta
- Varmuuskopioidaan vanha tiedostojärjestelmä
- cPanel > File Manager > tehdään (compress) wikin sisältävästä hakemistosta zip-paketti ja ladataan se tietokoneelle.
- Kopioidaan File Managerilla vanhan MediaWikin images-hakemisto uuden MediaWikin hakemistoon eli korvataan siellä oleva uusi. Images-hakemiston .htaccess saattaa olla muuttunut.
- Kopioidaan vanhan MediaWikin tietokanta edellä luotuun uuteen tyhjään tietokantaan
- phpMyAdmin > valitse tietokanta > Operations-välilehti > Copy database to: jos tietokanta on jo olemassa samassa järjestelmässä anna sen nimi ja poista valinta kohdasta CREATE DATABASE before copying, valitse Structure and data, valitse Add AUTO_INCREMENT value, valitse Add constraints > Go
- https://osoite.fi/Uuden MediaWikin polku/mw-config/index.php
- Tärkeää: Valitse kieliksi samat kuin vanha MediaWiki eli jos suomen kielellä, valitse Suomi
- Katsotaan uuden MediaWikin LocalSettings.php -tiedostosta päivitysavain eli $wgUpgradeKey
- Testataan sivuston toimivuus uudella palvelimella menemällä kyseisen hakemiston URL-osoitteeseen.
- Jos sivut kuten Vastuuvapaus yms. itse MediaWikiin liittyvät eivät toimi tai niitä ei siirron jälkeen löydy vaan näkyvät punaisena linkkinä, aseta LocalSettings.php-tiedostossa $wgMetaNamespace = false;
- Tehdään uudelleenohjaukset ja lyhyt URL. Katso tarkemmin oma otsikko tällä sivulla.
- Poistetaan vanhasta tietokannasta vanhan MediaWikin taulut
- Poistetaan vanhan MediaWikin tiedostohakemisto
MediaWikin siirtäminen esimerkki 3[muokkaa]
- Tehty 11.4.2021
Tässä kuvataan tuotannossa olevan MediaWikin vaihtaminen cPanelin kautta automaattitoiminnolla luotuun MediaWikiin samalla palvelimella ja samassa tietokannassa. Samalla tehdään myös upgrade 1.34.0 --> 1.35.1.
- Asetetaan vanha wiki vain luku -tilaan
- Lisätään LocalSettings.php -tiedostoon $wgReadOnly = 'Wikiä huolletaan. Arvioitu päättymisajankohta xx.xx.20xx klo xx.xx. Wikiin ei voi tehdä huollon aikana muutoksia.';
- Varmuuskopioidaan vanha tietokanta varmuuden vuoksi kahdella eri tavoin
- cPanel > Backup > Download a MySQL Databse Backup > valitse tietokanta
- cPanel > phpMyAdmin > Export > Custom > Format: SQL > Databases: valitse MediaWikin sisältävä tietokanta
- Varmuuskopioidaan vanha tiedostojärjestelmä
- cPanel > File Manager > tehdään (compress) wikin sisältävästä hakemistosta zip-paketti ja ladataan se tietokoneelle.
- Luodaan uusi MediaWiki uuteen public_html-hakemistoon käyttäen samaa tietokantaa kuin vanha MediaWiki samalla käyttäjätunnuksella ja nimellä, mutta eri tietokannan taulujen etuliitteellä kuin vanhassa MediaWikissä. Esim. etuliite: a_
- Huom! Luo uusi MediaWiki samalla kielellä kuin vanha MediaWiki eli jos suomen kielellä, valitse Suomi.
- cPanel > Web Applications > MediaWiki
- Kopioidaan File Managerilla vanhan MediaWikin images-hakemisto uuden MediaWikin hakemistoon eli korvataan siellä oleva uusi.
- Muutetaan uuden MediaWikin LocalSettings.php -tiedostoon vanhan MediaWikin tietokannan taulut.
- $wgDBprefix = "tähän vanhan MediaWikin etuliite";
- Muutetaan tarvittaessa uuteen LocalSettings.php -tiedostoon muut vanhan MediaWikin LocalSettings.php -tiedot. Lähinnä kyseessä on omat muutokset. HUOM! Jos kyseessä on MediaWiki, joka vaatii sisäänkirjautumisen, muista muuttaa tämä jo tässä vaiheessa!!!
- Päivitetään uusi MediaWiki
- Vaihtoehto 1: https://osoite.fi/Uuden MediaWikin polku/mw-config/index.php
- Tärkeää: Valitse kieliksi samat kuin vanha MediaWiki eli jos suomen kielellä, valitse Suomi
- Katsotaan uuden MediaWikin LocalSettings.php -tiedostosta päivitysavain eli $wgUpgradeKey
- Vaihtoehto 2: Kirjaudutaan pääteohjelmalla palvelimelle (SSH) > siirrytään uuden Mediawikin maintenance-hakemistoon ja ajetaan updater.php eli komento php updater.php
- Vaihtoehto 1: https://osoite.fi/Uuden MediaWikin polku/mw-config/index.php
- Testataan sivuston toimivuus uudella palvelimella menemällä kyseisen hakemiston URL-osoitteeseen.
- Luokat eivät toimi sivupalkissa eivätkä luokat näy sivujen alareunassa: Todennäköisesti ongelma on kielissä eli vanha MediaWiki on ollut esimerkiksi suomen kielellä ja uusi on englannin kielellä. Katso vanhasta MediaWikistä jonkun sivun URL, näkyykö siinä millä kielellä ja vertaa uuteen MediaWikiin.
- Voit suorittaa uudestaan https://wikinosoite.fi/polku/mw-config/index.php ja varmistaa, että molemmat vaihtoehdot ovat vanhan MediaWikin kielen mukaan.
- Avaa cPanel > Web Applications > asentamasi uusi MediaWiki > tarkista, että kohdassa Language on Suomi ja muuta tarvittaessa ja tallenna
- Tarkista File Managerissa LocalSettings.php, jossa kuuluu olla $wgLanguageCode = 'fi';
- MediaWiki osaa automaattisesti huomioida englannista suomen kielelle, jos esimerkiksi sivupalkissa on ohjaus Category:luokannimi, jolloin URL:ssa näkyy Luokka:luokannimi Tai tuoreet muutokset, kaikki sivut ja etusivu ovat sivupalkissa englannin kielellä.
- Luokat eivät toimi sivupalkissa eivätkä luokat näy sivujen alareunassa: Todennäköisesti ongelma on kielissä eli vanha MediaWiki on ollut esimerkiksi suomen kielellä ja uusi on englannin kielellä. Katso vanhasta MediaWikistä jonkun sivun URL, näkyykö siinä millä kielellä ja vertaa uuteen MediaWikiin.
- Poistetaan tietokannasta uuden MediaWikin asennuksessa luodut tilapäiset taulut phpMyAdminilla
- Valitaan poistettavat taulut ja alaosan pudotusvalikosta drop ja Yes
- Poistetaan vanha MediaWiki-tiedostohakemisto.
- Tehdään tarvittaessa ohjaukset public_html-hakemiston .htaccess-tiedostoon.
MediaWikin siirtäminen esimerkki 4[muokkaa]
Asennus siirto tehty 3.9.2016 versioon 1.27.1
- http://www.mediawiki.org/wiki/Manual:Moving_a_wiki
- https://www.mediawiki.org/wiki/Manual:Upgrading
- https://www.mediawiki.org/wiki/Manual:Maintenance_scripts
Tässä kuvataan olemassa olevan MediaWikin siirtäminen tyhjään tietokantaan ja tiedostojärjestelmään. Siirto tehdään viemällä sivut ja tiedostot manuaalisesti MediaWikin skriptien avulla. Tässä ei siis siirretä tietokantaa ja tiedostojärjestelmää!
- Asenna uusi MediaWiki normaalisti edellä esitetyn ohjeen mukaisesti tms.
- Asenna tarvittavat laajennukset
- Aseta LocalSettings.php tiedostoon tarvittaessa vanhasta LocalSettings.php tiedostosta asetuksia.
- Testaa sivustoa ja tee tarvittavia muutoksia kun se on vielä tyhjä.
- Ota uudesta sivustosta varmuuskopio (tiedostojärjestelmä ja tietokanta)
- Vie vanhasta wikistä sivut, joko Vie sivuja -toiminnon avulla tai pääteohjelmalla. Kaikki sivut -toiminnossa valitse eri Nimiavaruuksia, joita viet. Sivu tarkoittaa tässä ohjeessa siis muitakin kuin varsinaisia sisältösivuja. Niitä ovat esimerkiksi varsinaiset sisältösivut, keskustelusivut ym. On siis huomattava, että kaikki eivät sisälly "pääavaruuteen"!
- jos viet ohjelman kautta kopioi Kaikki sivut toiminnon kautta viedyt sivut esimerkiksi taulukko-ohjelmaan jossa saat ne väkerrettyä yhteen sarakkeeseen, josta ne sitten voit siirtää Vie sivuja -sivulle. Kannattaa varmuuden vuoksi aakkostaa sivut aina taulukkolaskentaohjelmassa.
- vienti taphtuu toimintosivujen kautta lisäämällä vietävien sivujen muokattu lista ruutuun.
- Tuo tiedosto(t) uuteen wikiin. Jos saat aikavirheen tai muun virheilmoituksen, tuo sivu uudestaan. Tämä saattaa johtua että sivuja on niin paljon että niitä ei pysty kerralla tuomaan. Sivut eivät tule kahteen kertaan kuitenkaan. Jos ei tahdo onnistua, katso edellä otsikko: Sivujen vienti ja tuonti
- Vie myös luokat ja tuo ne kuten sivut. Jokaisen vietävän luokan edessä pitää olla sana Luokka: esimerkiksi Luokka:luokannimi
- HUOM! Luokat näkyvät vasta kun ajat maintenance-hakemistossa komennon: php refreshLinks.php
- Vie keskustelut ja tuo ne kuten luokat. Keskustelut löytyvät kohdasta Kaikki sivut > Nimiavaruus Keskustelu. Jokaisen vietävän luokan edessä pitää olla sana Keskustelu: esimerkiksi Keskustelu:keskustelusivunnimi
- Vie myös muut nimiavaruudessa olevat sivut edellä kuvatusti.
- Vaihtoehtoisesti joitakin sivuja voi toki viedä copy-pastella. Esim. Etusivu, Ohje, Vastuuvapaus, Tietoja, Tietosuojakäytäntö -sivut.
- Tarvittaessa ohjaa Tietosuojakäytäntö, Tietoja ja Vastuuvapaus linkkejä toisille sivuille #REDIRECT [[Wikinimi:Tietoja]] -komennolla. Ja korjaa mahdollisia tekstissä olevia linkkejä.
- Tuo kuvat. Katso otsikko Kuvien uudelleenasennus.
- Erinäisiä hienosäätöjä
- Lisätään uudelleenohjaus muokkaustilan alateksin Tekijänoikeudet-linkkiin: klikataan linkkiä ja lisätään #REDIRECT [[Sivu jolle ohjaus tehdään]]
- Muutetaan muokkaustilan alatekstin Muokkausohjeet -linkki osoittamaan ohje-sivulle: http://www.palvelin.fi/wiki/Järjestelmäviesti:Edithelppage
- Muokataan sivupalkkivalikkoa:
http://www.palvelin.fi/wiki/Järjestelmäviesti:sidebar tai https://www.palvelin.fi/wiki/index.php?title=MediaWiki:Sidebar
- Lisätään LanguageUpdate-laajennokselle cron-ajo, jos se on otettu käyttöön. cPanel:ssa Cron-kohtaan: php /home/käyttäjätunnus/public_html/w/extensions/LocalisationUpdate/update.php > /dev/null ja ajastus 30 0 * * *
- Tarvittaessa hyödyllisiä skriptejä maintenance-hakemistossa voivat olla: php update.php ja php Maintenance.php
- update.php on tarkoitettu siiretyn vanhan tietokannan päivittämiseen uuden MediaWiki-version vaatimuksiin. Se tulee ajaa upgraden yhteydessä, eli MediaWiki version muutoksen yhteydessä ja jos asennetaan laajennoksia, jotka vaativat tietokantamuutoksia.
- Erityisesti php runJobs.php saattaa olla hyödyllinen ajamaan tehtäviä, jotka tulisi saada suoritettua nyt, jotta muutokset näkvyät. Joskus esimerkiksi listauksissa näkyy poistettuja tiedostoja.
- https://www.mediawiki.org/wiki/Manual:Footer
- https://www.mediawiki.org/wiki/Manual:Job_queue ???
MediaWikin päivittäminen (upgrade) - Installatron[muokkaa]
- "There is currently no text in this page. You can search for this page title in other pages, search the related logs, or create this page." tai otsikolla Virhe "Tällä hetkellä tällä sivulla ei ole tekstiä. Voit etsiä sivun nimellä muilta sivuilta, hakea aiheeseen liittyviä lokeja tai luoda tämän sivun."
- Osa sivuista näkyy ja osa ei, täysin satunnaisesti. Sivujen nimet ovat myös peruskirjaimia, ei esimerkiksi sisällä ääkkösiä. Sivun pituudet ovat myös vaihtelevia.
- Automaattinen cPanelin päivitys ei suorita tietokannan päivitystä. Tämä saattaa ilmetä esimerkiksi ettei valikko näy tai vain osa sivuista aukeaa päivityksen jälkeen. Anna maintenance-hakemistossa komento php update.php tai verkkoselaimessa kuten alla on ohjeistettu kohdassa 'Tietokannan päivitys'.
MediaWikin päivittäminen (upgrade)[muokkaa]
ESIMERKKI 1: versiosta 1.33 versioon 1.34 (tehty 25.12.2019)
- Tuotannossa olevassa /maintenance-hakemistossa: php runJobs.php (suorittaa mahdolliset odottavat toimet)
- Aseta tuotannossa oleva MediaWiki huoltotilaan, jolloin käyttäjät eivät voi tehdä muutoksia sisältöön. Aseta LocalSettings.php-tiedostoon seuraava $wgReadOnly = 'Wikiä päivitetään PVM. Arvioitu kesto kello XXX–XXX.';
- Ota varmuuskopio tietokannasta, esim. cPanel
- Tarvittaessa päivityksessä vioittuneen tietokannan taulut voi poistaa esim. phpMyAdmin-ohjelman drop-komennolla ja tämän jälkeen jos tietokanta on megatavuitaan suuri, tuoda sen takaisin esim. lataamalla sql-tiedoston public_html-hakemistoon ja antamalla ssh-yhteydellä muodostetussa pääteyhteydessä komennon mysql -u TIETOKANNANKÄYTTÄJÄTUNNUSTÄHÄN -p TIETOKANNANNIMIMTÄHÄN < TIETOKANNANTIEDOSTONIMITÄHÄN.sql Ed. komennossa käytä osoitettuja välilyöntejä. Kysyy vielä tietokannan salasanan. Jos komennon jälkeen ei ilmesty mitään virheilmoituksia, palautettu tietokanta on heti käytettävissä.
- Ota varmuuskopio tiedostojärjestelmästä, esim. cPanel tai säilytä tuotannossa oleva hakemisto jonkin aikaa.
- Selvitä mikä on viimeisin uusin versio sivulta https://www.mediawiki.org
- public_html-hakemistossa: wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.1.tar.gz
- tar -xvzf mediawiki-1.35.1.tar.gz
- rm mediawiki-1.35.1.tar.gz
- Kopioi tuotannossa olevasta LocalSettings.php ja tee tarvittaessa muutokset esim. (logon polku, ulkoasu (skins)). HUOM! Älä kopioi includes/DefaultSettings.php-tiedostoa LocalSettings.php-tiedostoksi ja tee muutoksia!!! Sivusto ei välttämättä toimi ja uudellenohjaa oikein, tätä ei siis tule tehdä vaan käytä edellisen version LocalSettings-tiedostoa ja tee siihen tarvittavat muutokset. Tarvittaessa apuna muutoksissa voi käyttää DefaultSettings.php-tiedostoa. Versiovaihdoksissa esimerkiksi laajennusten hakutapa on muuttunut.
- Kopioi tuotannossa olevasta images-hakemisto
- Lisää tarvittaessa omat laajennokset (extensions) käyttäen uusimpia versioita
- Hae laajennoksen lautausosoite MediaWikin Versio-sivuilta. Lataa laajennus extensions-hakemistoon: wget tiedostonimi ja pura se tar -xvzf tiedostonimi, jolloin muodostuu oma hakemisto laajennokselle.
- Tee tarvittavat muutokset LocalSettings.php-tiedostoon laajennoksia koskien.
- Tee tarvittavat muutokset esim. .htaccess (jos käytössä), omat muutokset laajennoksiin tai itse MediaWikiin
- Uuden version /maintenance-hakemistossa: php update.php (päivittää tietokannan).
- Error: You might be using an older PHP version (PHP 7.2.34). MediaWiki 1.35 needs PHP 7.3.19 or higher. Check if you have a newer PHP executable with a different name.
- "Can not upgrade from versions older than 1.27, please upgrade to that version or later first." -virheilmoitus. Mediawikin em. upgrade-sivu sanoo seuraavasti: "Reason for this error is that the command line can use another PHP version than that one which you have when you execute MediaWiki from the web server. When you get this message you should check, if you can execute a newer PHP version on the shell by using a different command: That might e.g. be php5 or php56. If another version is available and - if so - under which name, depends on the setup of your server. If it does not work, ask your hoster; they will surely know."
- PHP-ongelmat: Useat toimimattomuuteen liittyvät ongelmat liittyvät palvelimen php-version ja MediaWikin vaatiman php-version välisiin ristiriitoihin. Sivusto ei vain toimi.
- Vikaa kannattaa tällöin etsiä cPanelin MultiPHP Manager ja Select PHP Version -kohdista. Esimerkiksi 'Inherited' saattaa olla ratkaisu, joka saa palvelinmen oikeasti käyttämään MediaWikin vaatimaa php-versiota.
- Lisäksi näissä ongelmissa saattaa ilmetä varsinkin päivityksen yhteydessä, että MediaWiki-kansiossa tai esim. public_html-kansiossa oleva .htaccess-tiedosto sisältää virheen aiheuttaman rivin, yleensä esim. alla esitetty AddHander-aiheuttaa ongelman eli kokeile myös sitä ilman.
- Vastaavasti public_html-kansiossa mahdollisesti oleva php.ini -tiedosto saattaa myös sisältää jotain php:ta häiritsevää.
- Kannattaa myös lisätä public_html-kansioon nk. phpinfo.php-tiedosto, jolla saa käsityksen mikä php-versio on asentunut ja ovatko tarpeelliset lisäosat kuten mbstring ja fileinfo käytössä (enabled).
- Huomaa lisäksi, että pelkkä php update.php -komento ei komentoriviltä välttämättä toimi vaan vaatii esim. php74 -alkuisen komennon käytettävän php-version mukaan.
- Komentorivillä annetun em. komennon jälkeen saattaa tulla virheilmoitus: -bash: php74: command not found Kannattaa myös huomata, että tämä vaihtoehto saattaa olla syy toimimattomuuteen!!!
- Vaihtoehto 1: Vaihda cPanelissa kohdassa 'MultiPHP Manager' uudempi php-versio. Asetuksen pitäisi olla heti voimassa.
- Vaihtoehto 2: Lisää wiki-hakemistoon .htaccess-tiedosto, jossa esim. AddHandler application/x-httpd-php74 .php .php5 .php4 .php3 ja anna komento php74 update.php Cpanelista voi löytyä myös kohta PHP Version Manager, jolla kyseisen muutoksen voi tehdä. Edellisessä on valittu PHP 7.4.1, joka löytyy kyseiseltä palvelimelta. Joka tapauksessa vähintään virheilmoituksen mukaan PHP-versio.
- Error: Missing one or more required components of PHP. You are missing a required extension to PHP that MediaWiki needs. Please install: * mbstring <https://www.php.net/mbstring> * fileinfo <https://www.php.net/fileinfo> Kannattaa yrittää säätää cPanelista joku toinen versio, jos taidot eivät riitä muuhun.
- Jos mikään ei tunnu auttavan, kannattaa olla yhteyttä palvelimen ylläpitoon.
- PHP-ongelmat: Useat toimimattomuuteen liittyvät ongelmat liittyvät palvelimen php-version ja MediaWikin vaatiman php-version välisiin ristiriitoihin. Sivusto ei vain toimi.
- Jos php update.php-komento ei onnistu komentoriviltä, yritä suorittaa verkkosivun kautta antamalla osoite joka osoittaa mediawikin juureen esim. https://osoite.fi/wikihakemisto/mw-config/
- php update.php -komento ei välttämättä enää onnistuneen ajon jälkeen toimi uudestaan...
- Katso onko virheilmoituksia. Jos on, korjaa ja aja update.php uudestaan.
- Vaihda tuotannossa olevan version hakemistonimi ja nimeä uuden version hakemistonimi vanhan mukaiseksi.
- Testaa sivustoa, korjaa virheilmoitukset.
- MediaWiki internal error.
MediaWiki internal error. Original exception: [XXXXXX] /wiki/Toiminnot:Etusivu Error: Call to undefined method User::isLoggedIn() Backtrace: from /home/hakemisto/public_html/hakemisto/LocalSettings.php(325)
- Edellä nähdään, että ongelma liittyy LocalSettings.php-tiedoston riviin 325. Todennäköisesti uusi päivitetty versio ei enää toimi edellisen version komennon kanssa. Aseta kyseisen komennon/komentorimpsun ympärille /* */ tai joka rivin alkuun # Tämän jälkeen kokeile uudestaan.
- 500-virheilmoitus
- Valkoinen sivu tai 500-virheilmoitus:
- Tarkista lisäsitkö LocalSettings.php-tiedoston huoltotilaa poiskytkiessä oikean merkin, pitäisi olla todennäköisesti # eikä *
- Virhe päivitettässä 1.31.1 --> 1.33.0
- [XT4EK-CjwfGNKTKSJzqOGgAAAAM] 2019-07-28 20:23:07: Vakava virhe, jonka tyyppi on ”Wikimedia\Rdbms\DBQueryError”
- [XT4HMFxtk85CWsW1h6wM1wAAAAQ] / Wikimedia\Rdbms\DBQueryError from line 1587 of /home/XXX/public_html/w/includes/libs/rdbms/database/Database.php: A database query error has occurred. Did you forget to run your application's database schema updater after upgrading?
- Error: 1054 Unknown column 'ipb_sitewide' in 'field list' (localhost)
- Korjaus: Taulusta ipblocks puuttuu "sarake" ipb_sitewide Anna seuraava SQL-komento phpMyAdminissa mediawikin käyttämässä tietokannassa:
ALTER TABLE ipblocks ADD ipb_sitewide bool NOT NULL default 1;
- Virheitä päivitettäessä 1.3.1 --> 1.33.0, joka näkyy suoritettaessa pääte-ohjelmassa php update.php -komentoa. Seuraavat taulut voi poistaa. Aja aina uudestaa update.php kunnes ei ilmesty virheilmoituksia.
- Error: 1142 DROP command denied to user 'XXX'@'localhost' for table 'transcache' (localhost)
- Korjaus: poista taulu phpMyAdmin-ohjelmalla. Taulua ei käytetä enää version 1.32 jälkeen.
- Error: 1142 DROP command denied to user 'XXX'@'localhost' for table 'image_comment_temp' (localhost)
- Korjaus: poista taulu phpMyAdmin-ohjelmalla. Taulua ei käytetä enää version 1.31 jälkeen.
- Error: 1142 DROP command denied to user 'XXX'@'localhost' for table 'valid_tag' (localhost)
- Korjaus: poista taulu phpMyAdmin-ohjelmalla. Taulua ei käytetä enää versiossa 1.33 jälkeen.
- Error: 1142 DROP command denied to user 'XXX'@'localhost' for table 'tag_summary' (localhost)
- Korjaus: poista taulu phpMyAdmin-ohjelmalla. Taulua ei käytetä enää versiossa 1.33 jälkeen.
- Error: 1142 DROP command denied to user 'XXX'@'localhost' for table 'transcache' (localhost)
- Fatal error: require(): Failed opening required '/home/xxx/public_html/xxx/ServiceWiring.php
- Oletko kopioinut DefaultSettings.php-tiedoston LocalSettings.php-tiedostoksi juurihakemistoon? Näin ei tule tehdä. DefaultSettings.php-tiedostossa on joku polkuohjaus, joka ei toimi kun tiedosto on juurihakemistossa. Käytä vain LocalSettings.php-tiedostoa, joka on muodostettu MediaWikia perustettaessa tai vastaavaa.
ESIMERKKI 2: versiosta 1.12 versioon 1.13.2 (tehty 23.11.2008)
Varmuuskopioi tietokanta[muokkaa]
- Katso ohje tällä sivulla.
Uuden ohjelmistoversion päivitys palvelimelle[muokkaa]
Huom! Tässä ohjeessa Mediawiki hakemistojen oletuksena on että ne ovat esimerkiksi palvelimesi html -päähakemistostasi seuraavana. Esim. /html/Mediawiki
- Toimenpiteet tehdään iTerm ohjelmalla ja samalla voidaan käyttää apuna Cyberduck ohjelmaa.
- Kirjaudu esimerkiksi iTerm pääteohjelmalla palvelimellesi. Avattuasi iTerm ohjelman anna tietokoneessasi pääkäyttäjän nimi login kohtaan ja sen salasana Password kohtaan. Tämän jälkeen anna komento ssh palvelimenkäyttäjätunnuksesi@ssh.palveluntarjoajanosoite Vastaa kirjoittamalla koko sana yes ja anna palvelin salasanasi
- Jos haluat ottaa ylimääräisen varmuuskopion koko vanhasta wikihakemistosta, niin anna komento siinä hakemistossa, jossa näkyy vanha hakemistonnimi: cp -r hakemistonnimi uusinimi_vvkkpp Tämä voi kestää jonkin aikaa palvelimen nopeudesta ja hakemiston koosta riippuen.
- Muuta vanha hakemisto toisellenimelle esimerkiksi Cyberduck -ohjelmalla. Älä tuhoa vanhaa hakemistoa, koska tarvitset sieltä kuvat ja asetustiedot, sekä lisäosat vähintään! Paina Cyberduck ohjelmassa tiedostonimen kohdalla hiiren oikeaa ja valitse Nimeä uudelleen...
- Katso MediaWikin sivuilta uusin versio ja sen latauslinkki
- Anna iTerm ohjelmassa komento wget http://download.wikimedia.org/mediawiki/1.13/mediawiki-1.13.2.tar.gz
- Anna iTerm ohjelmassa ladatun tiedoston purkukomento tar -zxvf mediawiki-1...tar.gz ja seuraavaksi tuhoa ladattu tiedosto rkomento rm media..tar.gz
- Lue Upgrade tiedosto hakemistosta. Päivitykseen liittyvät mahdolliset huomiot ovat siellä kerrottu.
Vanhojen asetusten siirtäminen[muokkaa]
- Siirry uuteen hakemistoon komennolla cd mediawikiversiosi
- Kopioi vanhasta hakemistosta images kansio. Hakemisto korvaa uuden version imagehakemiston. Images kansiossa on kaikki wikiin ladatut kuvat, ne eivät siis ole tietokannassa!
- Anna komento cp -r ../vanhawikihakemisto/images ./
- Siirretään Extensions -kansio, silloin jos olet asentanut wikiin lisäosia.
- Anna uudessa mediawiki hakemistossa komento cp -r ../vanhawikihakemisto/extensions ./
- Jos olet tehnyt muutoksia esimerkiksi monobook.php -tiedostoon, tee muutos manuaalisesti myös uuteen. Välttämättä ei kannata korvata uutta tiedostoa suoraan vanhalla, koska uudessa mediawikissä saattaa olla parannuksia itse ohjelmointikoodissa.
- Muuta hakemiston nimi samaksi, joka oli alkuperäinen
- Esimerkiksi Cypberduckilla hiiren oikea painike, Nimeä uudelleen ja anna hakemistonimi.
Tietokannan päivitys[muokkaa]
Tietokanta täytyy päivittää, uudessa mediawikissä on todennäköisesti uusia tauluja, jotka pitää asentaa.
- Anna selaimessa komento http://www.domain.com/wikihakemistosi/maintenance/update.php
- Jos sait virheilmoituksen Forbidden... siirry seuraavaan otsikkoon, tekemään tietokannan päivitys manuaalisesti luomalla uusi LocalSettings.
- Jos pystyit antamaan selaimen kautta päivityskomennon tietokantaan, niin voit hyödyntää vanhat asetustiedostot.
- Siirretään LocalSettings.php ja madollisesti myös AdminSettings.php
- Anna uudessa mediawiki hakemistossa komento cp ../vanhawikihakemisto/LocalSettings.php ./
- Anna uudessa mediawiki hakemistossa komento cp ../vanhawikihakemisto/AdminSettings.php ./
Uusi LocalSettings.php tiedosto[muokkaa]
Jos tietokannan päivitys ei onnistunut edellisen kohdan mukaan, on asetukset tehtävä selaimen kautta toisella tavoin. Jos ollain on ratkaisu tähän, niin voisi kirjoittaa sen tänne.
- Anna selaimessa komento http://www.domain.com/wikihakemistonnimi ja valitse set up the wiki
- Täytä ohjeiden ja palvelimesi mukaan
- Wiki name: Anna otsikko wikillesi
- Contact e-mail: toimiva sähköpostiosoite
- Language: fi - Suomi
- Copyright/license: valitse sopiva
- Admin username: Pääkäyttäjänimesi wikissä
- Salasana: salasana siihen
- Object caching:
- E-mail asetukset tarpeen mukaan.
- Database type: MySQL
- Database host: esim. db.palveluntarjoaja.net Tämän saat palvelin-palveluntarjoajaltasi
- Database name: Tämän saat palvelin-palveluntarjoajaltasi
- DB username: Tämän saat palveli-palveluntarjoajaltasi
- DB password: salasana Tämän saat palveli-palveluntarjoajaltasi
- Database table prefix: jos haluat erottaa wikin taulut muista samassa tietokannassa olevista tauluista.
- Storage Engine: InnoDB
- Database character set: ??
- Asenna. Selain raksuttaa jonkun aikaa. Odota kunnes tulee ilmoitus että valmista, Installation successful!. Voit seurata edistymistä ja asennusta ruudulla. Tallenna nettisivu varmuuden vuoksi.
- Siirrä LocalSettings -tiedosto mediawikihakemistoon
- Anna iTerm ohjelmassa komento cp ./config/LocalSettings.php ./ ja varmistu että tiedosto on kopioitunut mediawikisi päähakemistoon.
- Tuhoa config-hakemistossa oleva vastaava LocalSettings.php sitten rm ./config/LocalSettings.php
Muutetaan kansioiden oikeuksia[muokkaa]
- Jos kopioit vanhan LocalSettings.php -tiedostosi, oikeudet ovat valmiiksi 640
- Muutoin anna komento chmod 400 LocalSettings.php tai tee muutos Cyberduckilla hiiren oikea painike tiedoston päällä ja valitse Tietoja.
- Config hakemisto tuhoa tai muuta 755 -muotoon
- Anna komento chmod -R 755 config tai tee muutos Cyberduckilla.
- Tiedostojen oikeudet on yleisesti 644 ja kansioiden 755.
Muutetaan LocalSettings.php tiedostoa[muokkaa]
- Avaa jossain tekstieditorissa ja tee muutokset jotka tarvitaan. Katso mallia edellisestä LocalSettings tiedostostasi.
- HUOM! Jos $wgDBmysql5 = false; asetus on automaattisen tiedostoluonnin yhteydessä asettunut arvolle true, niin silloin ääkkösillä olevat sivujen nimet eivät tulostu oikein ja ne sivut eivät näy niitä ääkkösillä haettaessa. Eli vaihda arvoksi false
- $wgEnableUploads = true;
- $wgUploadPath = "$wgScriptPath/images";
- $wgUploadDirectory = "$IP/images";
- $wgFileExtensions = array( 'pdf', 'gif', 'jpeg', 'jpg', 'png', 'doc', 'txt', 'xls', 'wmv', 'ppt');
- $wgMimeDetectorCommand= "file -bi";
- $wgLogo = "/wikihakemistosi/images/logo.gif";
- Jos käytät joitain extensions -lisäosia, niin
- esimerkiksi require_once("$IP/extensions/ParserFunctions/ParserFunctions.php");
- Tallenna tiedosto ja lataa se takaisin mediawikisi päähakemistoon. Älä turhaan sulje editoria, koska kohta vielä tarvitaan tehdä muutos.
- Anna taas komento chmod 640 LocalSettings.php tai tee muutos Cyberduckilla hiiren oikea painike tiedoston päällä ja valitse Tietoja.
Testaus[muokkaa]
Kokeile nyt wikiä painamalla selaimen asennussivun lopussa olevaa click this linkkiä. Tai mene suoraan selaimella wikin hakemistoon. Tarvittaessa säädä LocalSettings asetuksia, jos jokin ei ole kohdallaan.
Kuvien uudelleenasennus[muokkaa]
Kuvakansion siirtäminen uuteen tiedostojärjestelmään ei saa niitä näkymään. Vaihtoehtoja on muutamia. Seuraavalla ohjeella saat muodostettua uuden /images kansion sisällön vanhasta ja tämän jälkeen kuvat näkyvät sivuilla kuten vanhassa wikissä.
Vaihtoehto 1 (suositeltava)[muokkaa]
Kuvien vienti ja tuonti. 1) Tehdään luettelo kuvista ja missä images-hakemistossa kuvat sijaitsevat, 2) muokataan luetteloa 3) tehdään luettelon perusteella kopiot kuvista backup-kansioon, 4) viedään kansio uuteen wikiin, 5) tuodaan kuvat kansiosta
- Vanhassa wikissä (josta viedään)
cd maintenance mkdir backup php dumpUploads.php > listOfMediafiles.txt readlink -f listOfMediafiles.txt TAI ls -d $PWD/*
- Lataa tekstieditoriin edellä luotu tekstitiedosto ja korvaa mwstore://local-backend/local-public -tekstit absoluuttisella polulla, joka tulostui readlink-komennolla ja osoittaa images-hakemistoon. Käyttäjätunnus tarkoittaa tässä sitä, jota käytät palvelimella.
- esm. /home/käyttäjätunnus/public_html/w/maintenance/listOfMediafiles.txt --> /home/käyttäjätunnus/public_html/wiki/images
- Lataa tiedosto takaisin palvelimelle mainenance-hakemistoon
- Anna samassa hakemistossa komento:
xargs -a listOfMediafiles.txt cp -t /home/käyttäjätunnus/public_html/w/maintenance/backup
- Pakkaa backup-hakemisto kuvineen ja siirrä ja pura se uudelle palvelimelle maintenance-hakemistoon.
- Anna komento maintenance-hakemistossa:
php importImages.php backup
- Jos kuvat eivät näy, anna maintenance-hakemistossa:
php update.php php Maintenance.php php runJobs.php
Vaihtoehto 2[muokkaa]
- Anna asennuksen /images kansion olla tyhjä
- Kopioi samaan hakemistoon vanhakuvakansio toisella hakemistonimellä esim. /ximages
- Etsitään kaikki kuvatiedostot alihakemistoista ximages hakemistoon ja siirretään ne uuteen mediawikiin mukana tulevalla apuohjelmalla. Muista piste lopussa.
cd ximages mv /*/*.{jpg,JPG,png,PNG,gif,GIF} . cd .. php maintenance/importImages.php --overwrite ximages
- Tämän jälkeen katso Toimintosivut > Sivujen huoltaminen > Halutut sivut ja näet onko vielä jotain tiedostoja joita tarvitaan. Apuohjelma ei pysty tuomaan kuin kuvatiedostoja, joten pdf, xls, doc yms. pitää tuoda ilmeisesti käsin. Ne kuitenkin sijaitsevat /images hakemistossa ja saat kaivettua ne samalla tavoin esille esim.
mv ?/*/*.{pdf,PDF,ogg,OGG,xls,XLS,rtf,RTF} .
- Nämä voi tämän jälkeen vaikka cPanel FileManager:lla zipata ja tuoda Tallenna tiedosto toiminnon kautta. Alkuperäinen ohje.
- Ongelmia saattaa olla tiedostojen kanssa joissa on ääkkösiä. Ne kyllä siirtyvät, mutta ne eivät automaattisesti yhdisty sivuihin.
- TOINEN VAIHTOEHTO. Voit tuoda tiedostot myös Kaikki sivut ja valitse nimiavaruudeksi Tiedosto. Muodosta esimerkiksi kuten edellä on kuvattu taulukko-ohjelmassa niistä nimi per rivi ja tallenna se tekstitiedostona vanhan wikin palvelimelle ja anna pääteohjelmassa seuraava komento: php maintainance/dumpBackup.php --current --pagelist=~/tiedostonimi--uploads > ~/dmp ja anna uudessa wikissä php maintainance/importDump.php ~/dmp --uploads Alkuperäinen ohje
Laajennokset (extension)[muokkaa]
Asennus[muokkaa]
- Manuaalisesti tai esimerkiksi Git-asennuskomennon avulla (sisältyy valmiina OSX).
cd kohdekansio git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/DeleteBatch.git
ConfirmEdit (captcha)[muokkaa]
Tämä lisäosa tulee MediaWikin mukana ja voit kytkeä sen asennusvaiheessa tai myöhemmin.
- Asenna lisäosa
- Lisää LocalSettings.php tiedostoon
- tarvittava koodi, jonka saat lisäosan ohjesivulta (linkki siihen Toimintosivut > Versio > lisäosan nimi). Valitse koodi sen mukaan minkälaista suojausta haluat käyttää (esm. kuva, kysymys).
- $wgCaptchaTriggers['edit'] = true; ja $wgCaptchaTriggers['create'] = true;
- Muokkaa tiedostoa /extensions/ConfirmEdit/ConfirmEdit.php sen mukaan a) keneltä sitä kysytään ja b) missä tilanteissa kysytään. Muuta True arvoksi kun kysytään ja False kun ei kysytä.
- Kysymystä edeltävä informatiivinen teksti muutetaan: Järjestelmäviesti:Questycaptcha-edit
Dynamic Page List[muokkaa]
Lisäosalla voi esimerkiksi tulostaa etusivulle tuoreimmat muutokset luettelon. Huom. Collection ei tällä hetkellä tulosta tällä lisäosalla tuotettuja sisältöjä, esimerkiksi kuvagalleriaa.
- Laajennusosa on nimellä Intersection translatewiki:ssä.
Asennus[muokkaa]
- Lataa http://www.mediawiki.org/wiki/Extension:DynamicPageList_(third-party) joka löytyy sivun Installation kohdasta.
- Pura /extension -hakemistoon nimellä DynamicPageList
- Lisää LocalSettings.php tiedoston loppuun rivi require_once __DIR__ . "/extensions/DynamicPageList/DynamicPageList.php";
- Lataa jokin MediaWikin sivu, jolloin saat ilmoituksen asennuksen onnistumisesta, voit katsoa asennuksen onnistumisen Toimntosivut > Versio kohdasta.
Kaikki sivut yhdessä sarakkeessa[muokkaa]
Kun käytössä laajennos DynamicPageList (Wikimedia)
<DynamicPageList> namespace=* shownamespace=false includesubpages=false columns = 1 </DynamicPageList>
Etusivulle tuoreimmat muutokset[muokkaa]
==Tuoreimmat muutokset== <DynamicPageList> namespace=(sivut) ordermethod=lastedit count=5 order = descending addeditdate = false </DynamicPageList>
Kuvagalleria[muokkaa]
- Avaa kuvatiedosto, jonka haluat liittää galleriaan. Paina kuvatiedoston Muokkaa ja lisää kuvatiedostoon [[Luokka:kuvaluokannimi]]
- Huom. Jostain syystä muutokset eivät välttämättä tule näkyviin, kun lisäät luokkaan uuden kuvan. Tällöin avaa tämä koodi muokkaa toiminnolla ja tallenna se saman tien.
<DynamicPageList> category = kuvaluokannimi mode = gallery </DynamicPageList>
ExternalLinks[muokkaa]
Luetteloi kaikki sivuston ulkopuolelle suunnatut linkit. Niiden toimivuus voidaan myös samalla tarkastaa.
- Jos saat asennuksen jälkeen virheilmoituksen liittyen funktioon wfLoadExtensionMessages(). Käy merkitsemässä tiedostossa SpecialExternalLinks.php rivin wfLoadExtensionMessages( 'ExternalLinks' ); eteen risuaita eli # Tätä funktiota ei tarvita enää.
- Toimintosivut > Versio > ExternalLinks kohdasta löytyy linkki laajennusosaan.
- Firefoxin lisäosalla Pinger on helppo tarkastaa linkkien toimivuus jos lisäosan mukana tuleva tarkastustoiminto ei riitä tai toimi odotetusti.
- Asenna Pinger, säädä LocalSettings.php:ssä esimerkiksi 500 sivua näytettäväksi. Värjää hakutulokset hiirellä ja valitse hiiren oikean näppäimen takaa tarkasta valitut linkit.
- Suomenkielinen käännös. Lisää hakemistossa olevaan kielitiedostoon sen loppuun.
FileProtocolLinks[muokkaa]
HitCounters[muokkaa]
MediaWikin 1.25-versiossa poistettiin sivuilla käyntien laskuri ja suositeltiin käyttämään esimerkiksi Google Analytics-palvelua. Tämä lisäosa lisää sivun alareunaan sivujen näyttökerran sekä toimintosivujen Tilastot-sivulle tilaston näyttökerroista.
- Näytettäviä suosituimpien sivujen lukumäärää voi muuttaa laajennoksen /includes/HitCounters.hooks.php -tiedostossa rivillä $options['LIMIT'] = 10;
OSX[muokkaa]
- Safarin tietosuoja-asetukset eivät anna mahdollisuutta avata tiedostoa klikkaamalla. Myöskään hiiren oikea painike ei avaa valikkoa linkistä. Kehitys > Poista paikallistiedostorajoitukset ei myöskään auta.
- Firefox lisäosa LocalLink lisää hiiren oikean painikkeen valikkoon kohdan jossa linkkiä voi katsoa, esimerkiksi pdf-tiedostoa
- Linkin muoto esim. iCloud Driven tiedostoon: <file>Users/käyttäjänimi/Library/Mobile Documents/com~apple~CloudDocs/hakemisto/tiedostonimi.pdf</file>
MobileFrontend[muokkaa]
Mukauttaa wikisivujen avautumisen älypuhelimiin ja tabletteihin.
- Asennuksen jälkeen katso mobiilipalvelusta että sivun alalaidan Yksityisyyslinkki ohjautuu oikein. Tarvittaessa tee uudelleenohjaus toiselle sivulle tai lisää kyseinen sivu.
- Käyttöehdot -sivu ohjautuu myös väärin. Sen voi korjata esm. MobileFrontend.i18n.php tiedoston suomenkielisestä käännöksestä noin riviltä 5409 'mobile-frontend-terms-use-text' => 'Käyttöehdot',
- Sivun alalaitaan ilmestyy linkki Mobiilinäkymä. Tämä ei välttämättä toimi ilman seuraavia asetuksia:
- Perusta esm. cPanel:n avulla subdomain mobile.osoitteesi.pääte ja ohjaa se wikihakemistoon esm. /w
- Lisää LocalSettings.php jompikumpi seuraavista:
$wgMobileUrlTemplate = 'mobile.osoitteesi.pääte'; $wgMobileUrlTemplate = '%h0.m.%h1.%h2';
- Odota että muutos tulee voimaan, voi kestää vuorokauden.
- Katso lisätietoa.
Google Analytics[muokkaa]
- Avaa tili ja selvitä sieltä UA-koodi.
- Asenna Extension:Google Analytics Integration.
LocalisationUpdate[muokkaa]
Pitää mediawikin käännökset ajan tasalla.
- Ajetaan päätteessä manuaalisesti mediawiki hakemistossa komennolla: php extensions/LocalisationUpdate/update.php tai asetetaan automaattisesti ajettavaksi cron -toiminnolla. Huomaa että päivitys päivittää kaikki kielet.
- Cron asetuksen voi asettaa esimerkiksi cPanelissa Advanced > Cron jobs > Ja valitse haluamasi aikataulu ja lisää seuraava rivi säädettynä sen mukaan mikä on php tiedoston osoite. Tämä selviää esimerkiksi menemällä pääteohjelmalla kyseiseen hakemistoon ja antamalla komento pwd. Esimerkiksi se voi olla /home/palvelunkayttajatunnus/public_html/w/extensions/LocalisationUpdate/update.php
php /polku/seuraavaan/tiedostoon/wiki/extensions/LocalisationUpdate/update.php -q php /polku/seuraavaan/tiedostoon/wiki/extensions/LocalisationUpdate/update.php --quiet
- Jos asetat pääteohjelmalla, tapahtuu se komennolla crontab -e ja lisäämällä seuraava rivi
@daily php /polku/seuraavaan/tiedostoon/wiki/extensions/LocalisationUpdate/update.php --quiet
- Jos saat virheilmoituksen, jossa pyydetään asettamaan Set $wgShowExceptionDetails = true; in LocalSettings.php to show detailed debugging information. Kytke LocalSettngs.php:ssä kyseinen virheidenetsintä päälle ja anna päivityskomento esm. pääteohjelmassa tai selaimessa. Vastaus voi lla esm. Unable to get directory listing for wikimedia/mediawiki-core Tällöin saattaa olla että sinulla on käytössä esimerkiksi liian uusi LocalisationUpdate -versio kuin mediawikisi versio. Löydät tältä sivulta. Valitse sopivan mediawikiversion kohdalta tree ja ylhäältä zip.
PDF[muokkaa]
MediaWikin sivun tai sivujen muodostamiseen on useita lisäosia. Ne ovat lueteltu sivulla https://www.mediawiki.org/wiki/PDF_export
Mpdf[muokkaa]
Muodostaa PDF-tiedoston palvelimella ja lataa sen tietokoneelle. (Asennettu Wikikkoon 5/2024)
- Lataa Mpdf -zip-tiedosto tietokoneelle osoitteesta https://github.com/wikimedia/mediawiki-extensions-Mpdf Latauslinkki löytyy Code-painikkeesta.
- Lisää esim. cPanelilla hakemisto Mpdf /extensions-hakemistoon.
- Lataa em. zip-tiedosto palvelimelle ja pura se niin, että se on Mpdf-hakemistossa.
- Selvitä mitä php-versiota palvelin käyttää. Esimerkiksi tee palvelimelle tiedosto phpinfo.php ja laita sen sisälle <?php phpinfo() ?> ja anna tiedostolle esim. 755 -oikeudet ja aja tiedosto selaimessa palvelimesiosoite.fi/polku/phpinfo.php jolloin PHP-versio näkyy avautuvan sivun otsikossa.
- Selvitä sivulta https://github.com/mpdf/mpdf mikä mPDF tulee kyseeseen, esim. PHP 8.1.28 käytä mPDF v8.0.13
- PHP >=5.6 <7.3.0 is supported for mPDF >= 7.0
- PHP 7.3 is supported since mPDF v7.1.7
- PHP 7.4 is supported since mPDF v8.0.4
- PHP 8.0 is supported since mPDF v8.0.10
- PHP 8.1 is supported as of mPDF v8.0.13
- PHP 8.2 is supported as of mPDF v8.1.3
- PHP 8.3 is supported as of mPDF v8.2.1
- since tarkoittaa että esim. php 7.4 on tuettu akaen mPDF versiosta 8.0.4. Esimerkiksi Composer ei asenna versiota 8.0.3 kun palvelimen versio on 7.4.16 ja Mpdf on REL1_36.
- Kirjaudu SSH-yhteydellä palvelimelle ja siirry em. Mpdf-hakemistoon.
- Anna hakemistossa komento, jossa käytät oikeaa mPDF-versiota:
composer require mpdf/mpdf:8.0.13
- 8. Lisää LocalSettings.php-tiedostoon
wfLoadExtension( 'Mpdf' ); $wgMpdfTab = True; # Lisää MediaWikin yläpalkkiin välilehden 'PDF-vienti'. $wgMpdfSimpleOutput = True; # Tekee yksinkertaisen PDF-tiedoston, jossa on vain sivun sisältö
- Asennuksesta 5/2021
- MediaWikin lisäosa on Mpdf ja varsinainen muunnoksen tekevä php-ohjelma on mPDF eli mpdf
- Eri mPDF eli mpdf versioita käytettäessä on huomioitava mikä on palvelimen PHP-versio.
- Mpdf 1.34 ei sisällä MpdfAction.php -tiedostoa. Se on versiosta 1.35 alkaen.
- Lisäosa Mpdf tarvitsee mPDF:n eli mpdf -PHP kirjaston, joka muodostaa PDF-tiedoston UTF-8 enkoodatusta HTML-sivusta eli MediaWikin sivusta.
- Kun Mpdf-versio on ladattu /extensions -hakemistoon, ajetaan kyseisessä hakemistossa composer-komento, joka asentaa mPDF eli mpdf/mpdf kyseiseen hakemistoon. Katso https://wikikko.info/wiki/Mac_vinkit#Composer
- Jos composer-komento tehdään "kotitietokoneella" ja siirretään sitten palvelimelle, tulisi ilmeisesti ajaa palvelimella komento: composer update
- Virheilmoitukset
- Class 'mPDF' not found
- /wiki/index.php?title=Sivunimi&action=mpdf Error from line 96 of /home/käyttäjätunnus/public_html/extensions/Mpdf/MpdfAction.php: Class 'mPDF' not found
- Varmista että palvelimen PHP-versio vastaa Mpdf ja mPDF
- MpdfAction.php sisältää rivin $mpdf = new mPDF( $mode, $format, 0, , $marginLeft, $marginRight, $marginTop, $marginBottom, $marginHeader, $marginFooter, $orientation );
- Jostain syystä Mpdf-laajennus ei toimi esimerkiksi (5/2021) kun asennus on tehty seuraavasti: Mpdf REL1_36, mpdf 8.0.10, MediaWiki 1.35.2, PHP 7.4.16.
- Korvaa em. rivi seuraavalla: $mpdf=new \Mpdf\Mpdf();
- Nyt MediaWiki välilehden linkkiä painamalla muodostuu PDF-tiedosto ja se latautuu automaattisesti käyttäjän laitteelle.
- Class 'mPDF' not found
Mpdf Testi[muokkaa]
- Kun Mpdf ja mpdf-kirjasto ovat 1) asennettu composer-komennolla palvelimelle 2) ne täsmäävät palvelimen PHP-versiota 3) laajennus Mpdf on otettu käyttöön LocalSettings.php-tiedostossa, voidaan tehdä yksinkertainen testi.
- Muuta Mpdf-hakemistossa olevan tiedoston MpdfAction.php nimi tilapäisesti.
- Luo tyhjä tiedosto nimeltä MpdfAction.php ja lisää sinne seuraava koodi:
<?php require_once __DIR__ . '/vendor/autoload.php'; $mpdf = new \Mpdf\Mpdf(); $mpdf->WriteHTML('<h1>Testi</h1>'); $mpdf->Output();
- Anna komento https://www.osoite.fi/wiki/Sivunnimi ja sivulle pitäisi aueta PDF-dokumentti, joka sisältää tekstin Testi
Collection[muokkaa]
Collection lisäosalla voi tulostaa Wikin sivuja pdf muodossa kirjana. Katso esimerkki Wikipediasta jossa voit tehdä sivuista kirjoja ja lähettää ne PediaPress -yritykselle painettavaksi oikeaan kirjamuotoon. Itse laajennuksen asentaminen on helppoa, mutta sen lisäksi tarvitaan renderöinti palvelin joka suorittaa muunnoksen eli tekee PDF ja zip -tiedostoja MediaWikin sivuista. Jos käytettävissä ei ole valmiina sellaista, se on asennettava palvelimelle. Seuraavassa on kerrottu kuinka se tapahtuu OSX Mavericks järjestelmässä. Ei ole aivan yksinkertainen, mutta näillä ohjeilla on saatu toimimaan 28.2.2014.
- HUOM! Tähän kohtaan on linkki sivulta http://www.mediawiki.org/wiki/Extension:Collection
Collection: OSX Yosemite, Python 2.7, MediaWiki 1.25.2[muokkaa]
Choose either mwlib_server or OCG_server.
Collection: mwlib_server[muokkaa]
Installed 13.8.2015 NOT WORK
- We need mwlib and for that Python needs modules pil and lxml.
- Let's use MacPorts and update it at first. Installing MacPorts have a look the page Hp_LaserJet_1000.
- Suitable pil and lxml modules are found in http://www.macports.org/ports.php. Change them when necessary, I used for Python 2.7 modules py27-
$ sudo port install py27-pil $ sudo port install py27-lxml
- Now we continue with pip and install mwlib core
$ brew install python $ sudo pip install --upgrade pip $ sudo pip install -i http://pypi.pediapress.com/simple/ mwlib --trusted-host pypi.pediapress.com TIMELIB PROBLEM
Collection: OCG_server[muokkaa]
- Let's use MacPorts and update it at first. Installing MacPorts have a look the page Hp_LaserJet_1000.
- Installing npm
$ sudo port install npm
- Downloading
mkdir OCG cd OCG git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Collection/OfflineContentGenerator mw-ocg-service git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Collection/OfflineContentGenerator/bundler mw-ocg-bundler git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Collection/OfflineContentGenerator/latex_renderer mw-ocg-latexer git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Collection/OfflineContentGenerator/text_renderer mw-ocg-texter
- For each four folder do the next:
cd mw-ocg-service sudo npm -g install cd .. INSTALLING NOT WORK
Collection: OSX Mavericks, Python 2.7, MediaWiki 1.22.1[muokkaa]
- We need mwlib and for that Python needs modules pil and lxml.
- Let's use MacPorts and update it at first. Installing MacPorts have a look the page Hp_LaserJet_1000.
- Suitable pil and lxml modules are found in http://www.macports.org/ports.php. Change them when necessary, I used for Python 2.7 modules py27-
$ sudo port Install Python Imaging Library (pil): > install py27-pil Install Python lxml (lxml): > install py27-lxml
- Now we continue with pip and install mwlib core
$ sudo pip install -i http://pypi.pediapress.com/simple/ mwlib Result: Successfully installed mwlib pyparsing timelib bottle pyPdf apipkg qserve lxml py sqlite3dbm simplejson roman gevent odfpy Pillow greenlet
- Install mwlib.rl which creates PDF's
$ sudo pip install -i http://pypi.pediapress.com/simple/ mwlib.rl Result: Successfully installed mwlib.rl pygments mwlib.ext The pyfribidi might not be necessary but it doesn't matter to install too. It's for right-to-left texts. pip install -i http://pypi.pediapress.com/simple/ pyfribidi
- Now we are ready to test. Let's try it with downloading a page from Wikipedia. At first we'll make a zip and then pdf. You should see a PDF -document. It's located in the same directory you gave previous commands.
$ mw-zip -c :en -o test.zip Acdc Number $ mw-render -c test.zip -o test.pdf -w rl
- Always you want to use Collection, you need to have mwlib-server on. You can start it when needed or make a script to launch it when you OSX starts. Keep a terminal window open when you've started it manually. If you have errors with ports, they might be already open.
- You can check with lsof -i | grep LISTEN which ports in your computer are listened. If you want to end the mwlib listening just shut down the terminal. Or do the lsof-command and the second column shows the number you kill. For example kill 541 Also shutting down the computer resets the mwlib ports. There are three default ports open for Python mwlib: 8899, 8898 and 14311.
- The first command will put server on for PDF's. So if you use only PDF's you don't need postman.
$ nserve & mw-qserve & nslave --cachedir ~/cache/ & $ nserve & mw-qserve & nslave --cachedir ~/cache/ & postman &
- The trickiest part may be to connect the mwlib server and mediawiki. My Mavericks' Mediawiki is working in ~/Sites/mediawiki
- /mediawiki/LocalSettings.php you need to have:
require_once ( "$IP/extensions/Collection/Collection.php" ); $wgCollectionMWServeURL = 'http://localhost:8899/cache'; $wgServer = "http://mediawiki.local"; $wgScriptPath = "/~myusername/mediawiki"; or the path to your mediawiki root
- Problem may be that you'll get base_url errors or not found -errors if all these settings are not right. The point is that important settings are $wgCollectionMWServeURL, $wgServer and $wgScriptPath.
- In my case this was not enough and the most important part was next:
- Change two lines in httpd-vhosts.conf. Add them to the first section of the file. Change your username and the path of your MediaWiki installation when needed.
sudo vi /etc/apache2/extra/httpd-vhosts.conf press button a and change flollowing lines and after that press esc : w q DocumentRoot "/Users/yourusername/Sites/mediawiki" ServerName mediawiki.local
- Add a line to hosts file and flush the cache and restart Apache.
sudo vi /private/etc/hosts press button a and add following line and after that press esc : w q 127.0.0.1 mediawiki.local dscacheutil -flushcache sudo apachectl restart
- Instructions says that you need to create a cache folder but it seems that this is not necessary. I noticed that folder cache is automatically created if it not exists to /Users/yourusername/cache
- If you need to do like instructions says do it with Finder. I understood that the right place should be ~/Sites/cache but like I wrote earlier it was automatically made /Users/youurusername/cache. Strange or my misunderstanding. When you add it with Finder, there will be right permissions and owners. This directory mwlib is used for PDF's.
- Hope your MediaWiki still works. You find the Collection from the sidebar. Add wikipages to the collection. Try at first with one page and if it works, then more. You can reorder pages and add titles for you book. Click PDF and now it should create a PDF file. If you get an error, you change the "localhost" settings and try again to reload that page.
- TWO or MORE PAGE ERROR: If Collection prints only one page and two or more pages give lot of errors. Problem may be TOC Table of Contents. The solution may be to install PDFtk Server package like it was in my case.
- When you got this half page of errors, look for it and you can find the solution from there. Before I found this PDFtk Server I installed pyfribidi which I did not do before. There are also much errors of fonts. You can find help for them from internet, but after PDFtk Server install I did not see font errors anymore.
- You can upgrade mwlib:
pip install -i http://pypi.pediapress.com/simple/ --upgrade mwlib pip install -i http://pypi.pediapress.com/simple/ --upgrade mwlib.rl
- These may help you:
- http://davidwalsh.name/create-virtual-host
- http://www.mediawiki.org/wiki/Extension:PDF_Writer
- http://edutechwiki.unige.ch/en/Mediawiki_collection_extension_installation
- http://www.mediawiki.org/wiki/Setup_a_render_server_on_Ubuntu_12.04_LTS
- http://www.mediawiki.org/wiki/Setup_a_render_server_on_Ubuntu_12.04_LTS#Setup_mwlib
- http://mwlib.readthedocs.org/en/latest/installation.html
Push[muokkaa]
Sivujen työntäminen wikistä toiseen.
require_once( "$IP/extensions/Push/Push.php" ); $wgAllowCopyUploads = true; $wgEnableAPI = true; $egPushTargets['Vapaavalintainen nimi'] = 'http://www.osoite.fi/w'; # $egPushTargets['Vapaavalintainen nimi'] = 'http://localhost/~käyttäjänimi/wiki'; $egPushLoginUsers['Sama nimi tähän kuin PushTargets kohdassa'] = 'Käyttäjätunnus'; $egPushLoginPasswords['Sama nimi tähän kuin PushTargets kohdassa'] = 'Salasana';
Survey[muokkaa]
Mielipidekyselyiden tekemiseen.
- MediaWiki 1.22 kanssa git-toiminnolla ladattu Survey versio 1.23 ei toimi vaan antaa virheilmoituksen Fatal exception of type MWException. Tähän ei kuitenkaan auta /cache tiedoston määrittely.
- Lataa versio 1.22: https://git.wikimedia.org/branches/mediawiki%2Fextensions%2FSurvey > Klikkaa version REL1_22 NIMEÄ > valitse riviltä tree kohta zip. Asenna normaalisti /extension hakemistoon ja toimi Surveyn asennusohjeen mukaisesti.
- getPageTitle() method was introduced in MediaWiki 1.23, which is still under development. Basically the newest version (git HEAD) of Survey requires MediaWiki 1.23 (or newer); try using an older version of the extension with 1.22 (and don't take the Extension: pages as absolute truth; often the documentation is more or less out-of-date, especially for extensions which have no clear "owner"/maintainer). http://www.mediawiki.org/wiki/Extension_talk:Survey
TableEdit[muokkaa]
Taulukoiden muokkaaminen on varsin haastavaa ja työlästä normaalissa muokkaustilassa. Tämän lisäosan avulla taulukkoa voi muokata painikkeiden ja tekstikenttien avulla. Lisäosa muodostaa sivun taulukosta erillisen koodin, jota sitten muokataan tarvittaessa lisäosan avulla. Muokkausta ei pidä siis enää tehdä suoraan muokkaa-toiminnon avulla, vaan taulukon alareunasta löytyvän linkin kautta. Lisäosa lisää tietokantaan tauluja ja käyttää niitä hyväkseen. Taulukkoon tehdyt muutokset tallentuvat vasta varsinaiseen sivuun, kun lisäosassa painetaan tallenna.
- Taulukko perustetaan seuraavasti. Lisää normaalisti sivun muokkaustilaan seuraavat rivit.
<newTableEdit> Otsikko1 Otsikko2 </newTableEdit>
- Tallenna taulukko ja klikkaa uuden taulukon alle ilmestyvää table edit -kohtaa.
- Lisäosan osittainen suomennos löytyy tältä sivulta. Katso tällä sivulla Vinkkejä/Kieliasun muuttaminen.
MediaWikin kääntäminen[muokkaa]
Mediawiki on pitkälti suomennettu, mutta saattaa tulla tarve muuttaa joitakin sanoja tai lauseita tai kääntää suomentamattomia osia, esimerkiksi laajennusosia. Tähän on kaksi vaihtoehtoa toinen tapahtuu suoraan ylläpitämäsi MediaWikin käyttöliittymän kautta ja toinen translatewiki palvelun avulla. Ensimmäisessä vaihtoehdossa käännös tehdään omaan tietokantaasi, toisessa se tehdään kaikille MediaWikien käyttäjille maailmanlaajuisesti. Jos siis olet kiinnostunut palvelemaan yhteisöä ja saattamaan käännöksesi samalla kaikkien käyttäjien saataville ne tehdään http://translatewiki.net sivuston kautta.
Suoraan tietokantaan kääntäminen[muokkaa]
- Kaikki muutettavat kohdat saadaan näkyviin yhteenvetosivulla: http://wikinosoite/wiki/Toiminnot:Järjestelmäviestit TAI index.php/Special:AllMessages
- Säädä hakuasetuksista tai osoiteriville Kohteita sivua kohden: 5000 ja tämän jälkeen etsi haluttu teksti selaimen omalla hakutoiminnolla.
- Klikkaa haluttua punaista tekstiä ja tee muutos avautuvalle sivulle. Alkuperäinen säilyy ja näkyy yhteenvetosivulla.
- Sivun voi avata näyttämään muutettavat nimet, jos et muutoin sitä pysty määrittelemään: http://wikinosoite/wiki/index.php?title=sivunnimi&uselang=qqx tai &uselang=qqx&debug=1 eli esim. /index.php?title=Help:System_message&uselang=qqx
- anoneditwarning HUOMIO: VARMISTA MUUTOS VASTAAMALLA SEURAAVAAN KYSYMYKSEEN. IP-osoitteesi kirjataan tämän sivun muutoshistoriaan.
Yhteisökääntäminen[muokkaa]
Käännöksiä voi tehdä suoraan Translatewiki.net sivustolla tai asentamalla laajennusosan Translate ylläpidettyyn wikiin ja hoitaa käännösten päivittymisen kyseisen laajennusosan avulla. Suoraan sivulle tehdyn päivityksen voi tuoda manuaalisesti omaan wikiin tai LocalUpdate toiminnon avulla kun siitä on muodostunut ajallaan käännöstiedosto.
Käännöksien yhteydessä käytetään vakiintuneita tapoja. Lue ohjeita ja katso esimerkkiä aiemmista käännöksistä
Kääntäminen Translate laajennusosalla[muokkaa]
Käännös on käytettävissä välittömästi omassa wikissä…..?
Kääntäminen Translatewiki.net sivustossa[muokkaa]
Rekisteröityminen Translatewikiin[muokkaa]
- Luo itsellesi tunnus
- Säädä asetukset mieleiseksi nyt tai myöhemmin
- Sivusto ehdottaa muutamia käännöksiä käännettäväksi, joilla testataan ettet ole roskapostittaja tms.
- Muutaman minuutin tai parin päivän sisällä saat sähköpostin, jossa kerrotaan sinun hyväksymisestä kääntäjäksi. Itse käänsin noin 20 helppoa ja sähköposti tuli näiden aikana.
Laajennusosien kääntäminen Translatewikisä[muokkaa]
- Eräs keino on etsiä laajennusosan oma kotisivu ja sen yläosassa olevan tietolaatikon alaosassa on kohta Translate the Push extension if possible. Tämä linkki vie suoraan käännökseen.
- Toinen on valita Translatewikin valikosta vasemmalta Käännöstyökalu > laajenna kaikki > etsi selaimen hakutoiminnolla laajennusosan nimeä
- Kolmas on …
Kääntäminen[muokkaa]
Oikoluku[muokkaa]
Translatewikissä tehtyjen käännösten tuominen omaan wikiin[muokkaa]
Mediawiki 1.23 alkaen[muokkaa]
Mediawiki 1.23 versiossa on otettu käyttöön uudenlainen tapa käsitellä käännöstiedostoja. Tiedostot on tallennettu erilliseen i18n -tiedostoon fi.json mudosssa. Jokaisella kielellä on oma tiedostonsa. Näitä tiedostoja voi viedä translatewikistä.
- Käännöstyökalu > Valitse joku käännettävä kohde > Valitse välilehti Vie > Valitse vietävä käännös > Valitse kieli > Valitse Vie perusmuodossa > Paina Hae.
- Vaihda tallentuneen tiedoston nimeksi fi.json
- Siirrä tiedosto hakemistoon i18n joka on kyseissä laajennusosassa jonka käännöksen latasit. Jokaisessa laajennusosalla on oma i18n-kansio.
- Käännökset ovat välittömästi käytössä.
- Toinen vaihtoehto on että Translatewikin käännöksiä ajetaan ajoittain tiedostoiksi, jotka ovat tämän jälkeen ladattavissa omaan wikiin. Joten välttämättä aivan nopealla aikataululla käännökset eivät ole käytettävissä. Ilmeisesti kuitenkin enintään muutaman viikon viiveellä.
- Päivitysten lataamiseen käytetään LocalUpdate -laajennusosaa, joka täytyy asentaa wikiin. Tämän lisäksi pääteohjelmassa annetaan päivityskomento tai päivityskomento ajastetaan palvelimen Cron palveluun.
Mediawiki 1.22 ja aikaisemmat[muokkaa]
Käännöstiedostot löytyvät laajennusosan päähakemistosta, laajennusosannimi.i18n.php tiedostona. Kaikki käännetyt kielet ovat samassa tiedostossa ja ne ovat => -muodossa. Niiden vaihtaminen tuoreisiin translatewikin käännöksiin tapahtuu esimerkiksi http://www.mediawiki.org/wiki/Manual:GenerateJsonI18n.php Ainakin edellä mainittu toinen vaihtoehto ilmeisesti on ratkaisu LocalUpdate -laajennusosan avulla.
- Jos haluat hyödyntää uutta käännöstekniikkaa vanhassa mediawikin versiossa, voit myös sijoittaa i18n hakemistoon json-käännöstiedostot ja laajennusosan päähakemistossa korvata olemassaolevan vanhan käännöstiedoston laajennusosannimi.i18n.php seuraavalla koodilla:
<?php /** * This is a backwards-compatibility shim, generated by: * https://git.wikimedia.org/blob/mediawiki%2Fcore.git/HEAD/maintenance%2FgenerateJsonI18n.php * * Beginning with MediaWiki 1.23, translation strings are stored in json files, * and the EXTENSION.i18n.php file only exists to provide compatibility with * older releases of MediaWiki. For more information about this migration, see: * https://www.mediawiki.org/wiki/Requests_for_comment/Localisation_format * * This shim maintains compatibility back to MediaWiki 1.17. */ $messages = array(); if ( !function_exists( 'wfJsonI18nShim50369e2729c28ff8' ) ) { function wfJsonI18nShim50369e2729c28ff8( $cache, $code, &$cachedData ) { $codeSequence = array_merge( array( $code ), $cachedData['fallbackSequence'] ); foreach ( $codeSequence as $csCode ) { $fileName = dirname( __FILE__ ) . "/i18n/$csCode.json"; if ( is_readable( $fileName ) ) { $data = FormatJson::decode( file_get_contents( $fileName ), true ); foreach ( array_keys( $data ) as $key ) { if ( $key === '' || $key[0] === '@' ) { unset( $data[$key] ); } } $cachedData['messages'] = array_merge( $data, $cachedData['messages'] ); } $cachedData['deps'][] = new FileDependency( $fileName ); } return true; } $GLOBALS['wgHooks']['LocalisationCacheRecache'][] = 'wfJsonI18nShim50369e2729c28ff8';
ARKISTO[muokkaa]
MediaWikin tietokannan tuominen muualta[muokkaa]
Tässä esimerkissä ohjeistetaan toisella palvelimella toimivan MediaWiki -tietokannan asentaminen Mac-tietokoneeseen ja näinollen sen käyttämistä ilman nettiyhteyttä. Toimenpiteeseen tarvitaan siis oikeus tuoda MediaWikin tietokanta.
Huomioitavaa[muokkaa]
- MediaWikien versionumeroiden tulee olla mielellään samoja. Esimerkiksi jos tuotava tietokanta on v. 12.0, ei se toimi välttämättä täydellisesti MediaWiki versiossa 13.0 tai toisinpäin. Mutta saattaa kuitenkin toimia.
- BitNami tapauksessa, katso Omenaan asentamasi MediaWikin versio Toimintosivuilta (ilmeisesti uusin versio). Tarvittaessa asenna ennen tietokannan kopiointia palvelimelta, palvelimelle sama MediaWikin versio.
Kopioidun tietokannan asentaminen (BitNami mediawiki esimerkkinä)[muokkaa]
Asennus tehty 23.11.2008.
- Vie tietokanta esimerkiksi ohjelmalla phpMyAdmin omalle kovalevylle.
- Valitse palvelimella kyseinen tietokanta, Vienti-toiminto, Valitse kaikki, Tallenna tiedostoon .sql -muodossa.
- Tallenna suoraan tai siirrä myöhemmin tietokantatiedosto BitNami -tapauksessa hakemistoon /Ohjelmat/MediaWiki-versionro/mysql/bin
- Luo uusi tietokanta tai käytä mieluummin BitNamin luomaa bitnami_mediawiki -tietokantaa.
- Tietokannan luontiin pääsee MediaWikiohjelman etusivulta, kun sen käynnistää ensimmäisen kerran. Kohta You can access the built-in management tool phpMyAdmin here.
- Käyttäjätunnus phpMyAdmin ohjelmaan on administrator ja salasana se, minkä annoit BitNami MediaWikiä asentaessasi.
- Valitse sama MySQL-yhteyden aakkosjärjestys kuin tuomassasi tietokannassa. Tämä tieto löytyy phpMyAdmin etusivulta, sieltä mistä toit tietokannan. Se voi olla esimerkiksi utf8_general_ci. En tiedä onko tämä pakollinen toimenpide??
- Kannattanee nollata vanha tietokanta eli BitNamin luoma bitnami_mediawiki tietokanta. Valitse tietokanta listasta ja kun se aukeaa valitse alaosasta linkistä kaikki kyseisen tietokannan taulut ja tee valituille komento Pudota. Toimenpide pitää hyväksyä.
- Nyt tietokanta näkyy rivinä bitnami_mediawiki (0).
- Siirry Pääte -ohjelmaan (löytyy Ohjelmat/Lisäohjelmat) ja anna komento su ja pääkäyttäjän salasana (saat lisäoikeuksia).
- Siirry kansioon cd /applications/Mediawiki-versio/mysql/bin ja anna siellä komento ./mysql -u root -p bitnami_mediawiki < tuomasitietokantatiedostonnimi.sql Ensimmäisessä komennossa cd sanan jälkeen on välilyönti.
- Pääte kysyy salasanaa. Anna se salasana jonka annoit kun asensit BitNamilla MediaWikin. Jos ei toimi, kokeile esimerkiksi tietokoneesi varsinaista salasanaa tai muita mahdollisia tähän liittyviä. Ei kannata lähteä välttämättä muuttamaan/poistamaan salasanoja phpMyAdmin kautta, koska silloin saattaa menettää yhteyden phpMyAdmin ohjelman kautta tietokantaan.
- Ohjelma raksuttaa tietokannan koosta riippuen vähän aikaa, voi kestää muutamia minuutteja 100 Mt tietokannan kohdalla.
- Avaa /Ohjelmat/Mediawiki-versio/apps/mediawiki/htdocs/LocalSettings.php Avaa tiedosto johonkin tekstinkäsittelyohjelmaan, esimerkiksi Texturiin.
- Lue loppuun asti ennen kuin teet tämän: Jos muutat riville 97 kohtaan $wgLanguageCode = "fi"; sana en sanaksi fi. Tämä vaikuttaa siihen että wikistä tulee suomenkielinen, mutta se saattaa myös vaikuttaa siihen että sivuja ei tule enää näkyviin jos tuodun wikin versionumero on vanhempi kuin BitNami versiosi.
- Jos olet käyttänyt MediaWikissä jotain prefix -alkua tauluissa, eli olet nimennyt wikisi tietokantaan niin että taulun edessä on jokin tunnistekoodi esimerkiksi rautawikivalidate -taulu. Tällöin pitää käydä BitNami mediawikiin asetuksiin asettamassa tämä prefix koodi.
- Tee muutos kohtaan # MySQL specific settings $wgDBprefix = "koodisi"; Se sijaitsee noin rivillä 67.
- Siirry Mediawikin etusivulle http:localhost:8080/mediawiki/
- Jos ei toimi, palvelin ei ole ilmeisesti käynnissä, joten käynnistä se. Ohje löytyy mediawiki-versio hakemistosta README.txt
- Valitse kohta Access BitNami MediaWiki Stack ja mediawiki on käytössäsi.
- Saattaa olla että MediaWiki ei toimi aivan täydellisesti, jos versionumerot ovat wikeissä erilaiset. Tällöin kannattaa käydä asentamassa uusi wiki palvelimelle jos mahdollista ja tehdä tämä proseduuri kokonaisuudessaan uudestaan. Esimerkiksi Kaikkisivut toiminto ei saata toimia, mutta toimii kun korvaat otsikkorivillä sanan Toiminnot:Allpages sanalla Special:AllPages
Kuvien asentaminen[muokkaa]
- Kopioi kuvakansio (images) palvelimelta ylläolevien varmuuskopio-ohjeiden mukaan.
- Siirrä kansio BitNami -tapauksessa hakemistoon /Ohjelmat/MediaWiki-versionro/apps/mediawiki/htdocs
LocalSettings asetukset[muokkaa]
- Tee mahdolliset muutokset tiedostoon, esimerkiksi mistä löytyy logo yläkulmaan.
Ääkkösongelma[muokkaa]
- Kopioitu tietokanta BitNami-tapauksessa kirjoittaa ääkköset, mutta ei sivujen nimiin. Näinollen osa linkeistä ei toimi, koska olemassolevan sivun nimi on vääristynyt.
- Ratkaisua etsitään....
MediaWiki 1.15.1 asennus[muokkaa]
Lue ohjeet MediaWikin dokumentaatiosta. Asennus suoritettu 22.9.2009.
Ohjelmiston asennus palvelimelle[muokkaa]
- Toimenpiteet tehdään Mac-tietokoneessa tässä ohjeessa iTerm ohjelmalla ja samalla voidaan käyttää apuna Cyberduck ohjelmaa.
- Kirjaudu esimerkiksi iTerm pääteohjelmalla palvelimellesi. Avattuasi iTerm ohjelman anna tietokoneessasi pääkäyttäjän nimi login kohtaan ja sen salasana Password kohtaan. Tämän jälkeen anna komento ssh palvelimenkäyttäjätunnuksesi@ssh.palveluntarjoajanosoite Vastaa kirjoittamalla koko sana yes ja anna palvelin salasanasi.
- Siirry /html /www tms. hakemistoon käyttäen cd html tms. komentoa
- Katso MediaWikin sivuilta uusin ohjelmistoversio ja sen latauslinkki
- Anna iTerm ohjelmassa komento wget http://download.wikimedia.org/mediawiki/1.15/mediawiki-1.15.1.tar.gz
- Anna iTerm ohjelmassa ladatun tiedoston purkukomento tar -zxvf mediawiki-1...tar.gz ja seuraavaksi tuhoa ladattu tiedosto rm media..tar.gz
- Nimeä purettu mediawiki-1.15.1 hakemisto haluamallesi nimelle komennolla mv mediawiki-1.15.1 uusiwikihakemistonimi
- Siirry tekemääsi hakemistoon komennolla cd uusiwikihakemisto
- Anna komento chmod a+w config
Tietokannan luonti[muokkaa]
- Anna selaimessa komento http://www.domainosoitteesi/uusiwikihakemisto/config/index.php
- MediaWiki ajaa testin palvelimella ja antaa ilmoituksia ja lopuksi ilmoituksen voitko asentaa vai et. Tarpeen mukaan korjaa ongelmat. Tämä voi vaatia yhteydenottoa palveluntarjoajaasi ja pyytää häntä asentamaan oleelliset ohjelmat MediaWikin toimintaan saattamiseksi. Kuitenkin palvelimella ei tarvitse olla kaikkia "lisäosia", vaan testi ilmottaa että niitä ei löydy, mutta asennus voidaan suorittaa ja MediaWiki toimii ilman näitä lisäosia aivan normaalisti.
- Täytä ohjeiden ja palvelimesi mukaan
- Wiki name: Anna nimi wikillesi
- Contact e-mail: toimiva sähköpostiosoite
- Language: fi - Suomi
- Copyright/license: valitse sopiva
- Admin username: Pääkäyttäjänimesi wikissä
- Password: salasana siihen ja toistamiseen sama
- Object caching: Voit asentaa jos sivun yläolevassa testissä "cache"-ohjelma on asennettuna palvelimellesi
- E-mail asetukset tarpeen mukaan.
- Database type: Katso sivun yläreunasta mitä palvelin vastasi, tai kysy palveluntarjoajaltasi
- Database host: esim. db.palveluntarjoaja.päätetunnus Tämän saat palveluntarjoajaltasi
- Database name: Tämän saat palveluntarjoajaltasi
- DB username: Tämän saat palvelluntarjoajaltasi
- DB password: salasana Tämän saat palveluntarjoajaltasi
- Database table prefix: jos haluat erottaa wikin taulut muista samassa tietokannassa olevista tauluista, esimerkiksi asentaa kaksi eri wikiä samaan tietokantaan. Tällöin antamasi sana tulee tämän wikin taulujen eteen.
- Storage Engine: InnoDB
- Database character set: MySQL 4.1/5.0 binary lienee sopiva
- Install MediaWiki! eli paina asenna. Selain raksuttaa jonkun aikaa. Odota kunnes tulee ilmoitus että valmista, Installation successful!. Voit seurata edistymistä ja asennusta ruudulla. Onnistunut asennus ilmoitetaan tekstillä Installation successful!
- Siirrä LocalSettings -tiedosto mediawikihakemistoon komennolla mv config/LocalSettings.php . eli php sanan jälkeen on välilyönti ja yksi piste jos annat tämän komennon wikihakemistossasi
- Paina asennusnettisivulla this link -linkkiä.
LocalSettings.php[muokkaa]
- Anna pääteohjelmassa komento chmod 640 LocalSettings.php
- Jos et pysty muuttamaan oikeuksia, et ole tiedoston "omistaja". Tällöin anna komento chown nimipalvelimellasi LocalSettings.php
- Jotkin palvelimet eivät hyväksy komentoa chown. Jos edellinen ei onnistu, kopioi tiedosto esimerkiksi graafisella Cyberduck ohjelmalla tietokoneesi työpöydälle. Anna tämän jälkeen palvelimella tuhoamiskomento rm LocalSettings.php ja kopio graafisella Cyberduck tms. ohjelmalla työpöydältä LocalSettings.php takaisin wikihakemiston päähakemistoon. Tällöin sinulla on käyttöoikeudet ja voit antaa komennon chmod 640 LocalSettings.php
- Tuhoa config hakemisto komennolla rm -r config tai muuta sen oikeuksia komennolla chmod go-rwx config
- Wiki on nyt käytössäsi.
Tarvittaessa voit tehdä seuraavia asetuksia, joita ovat esimerkiksi:
- Logo on PNG kuva 135 pixeliä leveä ja sen oletushakemisto palvelimella asetetaan kohtaan $wgLogo.
- Estetään uusien tunnuksien luonti
- Estetään anonyymien käyttäjien sivujen muokkaus, mutta lukeminen sallitaan
MediaWiki[muokkaa]
- MediaWikin kautta yleensä kannattaa katso että ohjeet ym. "yleissivut" ovat asianmukaiset.
- Valikkoa muutetaan antamalla selaimen osoiterivillä wikidomainosoitteen loppuun /index.php/MediaWiki:Sidebar
MediaWikin asentaminen Mac -tietokoneeseen (Leopard)[muokkaa]
- Paikallisesti omalle tietokoneelle. Tällöin MediaWikiä voi käyttää esimerkiksi, kun ei ole internetyhteyttä. Käytän itse sitä esimerkiksi uusia sivuja tehdessä ja wikissä olevaa materiaalia opetustilanteissa, kun internetyhteyttä ei ole. Toisin sanoen lataan viimeisimmän toisessa wikissä olevan sivuston tietokannan ja asennan sen koneeseen. Tietysti tällöin pitää muistaa että offline tilassa wikiin tehdyt muutokset pitää siirtää takaisin palvelimella olevaan wikiin niin että sillä aikaa palvelimella olevaan wikiin tehdyt muutokset eivät katoa. Tämän takia vanhojen sivujen muuttaminen offline tilassa voi wikistä riippuen olla työn tekemistä kahteen kertaan.
- Yksinkertaisin tapa lienee ladata netistä BitNami -asennusohjelma, stack. Tämä on erittäin helppo tapa saada MediaWiki omaan koneeseen. Paketissa tulee kaikki tarvittava, itse ohjelma, palvelin, php-kieli ja tietokanta. Pakettia löytyy Windows, Mac, Linux ja Solaris -käyttöjärjestelmille. http://bitnami.org/stack/mediawiki
- Asennusohjelma kysyy tarvittavat tiedot ja asentaa ohjelman. Lähinnä kysytään käyttäjänimeä ja salasanaa, sekä asennuskohdetta. Kannattaa valita kaikki asennettavaksi mitä ehdotetaan.
- Asennus tehty 23.11.2008.
- Asennus tapahtuu englanninkielisenä, joten jälkeenpäin voi tulla ongelmia suomenkielen ääkkösten kanssa.