HUOM! Voit itse lisätä ja muuttaa sisältöä muokkaa-painikkeiden avulla

 Olet itse vastuussa tämän teoksen käytöstä aiheutuvista vahingoista Lue lisää.

MediaWiki

Kohteesta Wikikko - kansan taitopankki
Loikkaa: valikkoon, hakuun

Sisällysluettelo

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]

Excel tai muu taulukko Mediawiki taulukoksi[muokkaa]

Seuraavan ohjelman voi asentaa myös omaan tietokoneeseen, jos yksityisyys epäilyttää. Vaatii php:n.

http://excel2wiki.net

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 = "$wgScriptPath/resources/assets/favicon.ico";

Historian poistaminen ja siivous[muokkaa]

  • Laajennusosa DeleteHistory poistaa historiatiedot. Sisältää myös tietokannan optimointitoiminnon.
  • Arkistoitujen kuvien poistaminen
    • maintenance-hakemistossa komento: php deleteArchivedFiles.php --delete
  • Rikkoutuneet kuvalinkit
    • maintenance-hakemistossa komento: php cleanupImages.php
  • Katso lisää maintenance-hakemistossa skriptejä

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:
  1. Kirjoita hakuruutuun Template:Highlight
  2. Paina Luo sivu "Malline:Highlight" tähän wikiin.
  3. 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.

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ä

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

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.

Asennusohje yleinen
Pikaohje
Täydellisempi asennusohje
  • 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.
  1. Tarkista, että käytössä on vähintään Python-ohjelmointikieli versio 2.7.2.
    1. python --version
    2. 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
  2. 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.
    1. huomaa, että pywikibot hakemisto tulee sisältämään myös pywikibot-hakemiston.
  3. 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.
    1. lisää wikissä normaalisti uusi käyttäjä
    2. anna käyttäjälle botti -oikeudet
  4. 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.
    1. family = 'wikinimi' # Nimen "pitäisi" ohjeen mukaan olla ilmeisesti sama kuin LocalSettings.php-tiedoston $wgSitename, mutta ei tarvitse olla.
    2. mylang = 'fi'
    3. usernames['wikinimi']['fi'] = u'bottikäyttäjätunnus' # tarkkana isojen ja pienien kirjaimien kanssa käyttäjätunnuksessa
    4. console_encoding = 'utf-8'
  5. Tehdään family-tiedosto
    1. python2.7 generate_family_file.py
      1. Please insert URL to wiki: wikidomain.pääte
      2. Please insert a short name (eg: freeciv): wikinimi
    2. tiedostossa tulisi olla esim. seuraavankaltaisia rivejä:
      1. self.name = 'wikinimi' # Set the family name; this should be the same as in the filename
      2. 'fi': 'wikindomain.pääte', # ei siis www. -edessä
      3. 'fi': '/w', # kts. tarvittaessa wikisi Toimintosivut > Versio, mikä on skriptipolkusi
      4. 'fi': u'1.27.1', # wikin versionumero
    3. uudelleennimeä tiedosto tarvittaessa /home/pywikibot/pywikibot/families/wikinimi_family.py
  6. Ensimmäisellä kerralla pywikibottiin tulee kirjautua ja tarvittaessa myöhemminkin.
    1. cd pywikibot
    2. python2.7 pwb.py login
      1. Password for user bottikäyttäjätunnus on wikinimi:fi (no characters will be shown):
      2. Logged in on wikinimi:fi as bottikäyttäjätunnus.
    3. 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'>
      1. yhteyttä ei login-komennon aikana synny, voit kokeilla lisätä user-config.py -tiedostoon: authenticate['www.wikidomain.pääte'] = ('bottikäyttäjätunnus','bottisalasana')
    4. 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'>
      1. /pywikibot/pywikibot/family.py -tiedostossa laita # -merkki rivin 899 eteen.
    5. Jos saat virheilmoituksen: pywikibot.exceptions.UnknownFamily: Family omawiki nimi jatkuu tässä
      1. vaihda user-config.py tiedostoon family sama kuin /families -tiedoston nimessä, kuten edellä on kerrottu.
  7. Testaa botin toimivuus, esimerkiksi wikisi Hiekkalaatikko -sivulla
    1. ota tietokannasta varmuuskopio kaiken varalta. Muutoinkin on erittäin hyödyllistä ottaa varmuuskopioita ennen merkittäviä muutoksia botilla!
    2. tyhjennä Hiekkalaatikko -sivu ja kirjoita sinne Testi
    3. python2.7 pwb.py replace.py -page:Hiekkalaatikko -regex "Testi" "Toimii"
    4. eli korvauskomento on muotoa: python2.7 pwb.py replace.py -page:Sivunnimi -regex "korvattavateksti" "uusi teksti"
    5. tarkista wikissä tapahtuiko em. sivulla muutos. Komentorivillä näkyy myös toiminnon eteneminen.
    6. 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

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

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) ...
http://www.mediawiki.org/wiki/Manual:Reduce_size_of_the_database

Sivujen vienti ja tuonti[muokkaa]

Vaihtoehto 1[muokkaa]

  1. Avaa kaikki sivut ja kopioi hiirellä värjäämällä ja siirrä johonkin taulukkolaskentaohjelmaan
  2. Siirrä sarakkeeseen A mahdollisesti muissa sarakkeissa olevat ja lajittele aakkosjärjestykseen
  3. Kopio lista laitteen leikepöydälle
  4. Valitse Toiminstosivut > Sivujen vienti ja liitä sivut listaan
  5. Avaa toisessa wikissä Tuo sivuja ja valitse muodostettu tiedosto
  6. 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.

Staattinen mediawiki[muokkaa]

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.

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>

Toimintosivujen poiskytkeminen[muokkaa]

  1. Lisäosia, joilla asian voi hoitaa, esim. Lockdown
  2. 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.
http://www.mediawiki.org/wiki/Help:Recent_changes
  • 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.

  1. Avaa palvelimelta MediaWikin hakemistosta /skins/MonoBook.php
  2. Siellä on kohta <!-- end content -->
  3. 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 --> 
@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 siis tehdään kyseiselle sivulle. Yleismuutokset kaikkiin ulkoasuihin tapahtuvat Common.css avulla, johon pääsee selaimessa riippuen URL-asetuksista:
http://palvelin.fi/wiki/Järjestelmäviesti:Common.css
http://palvelin.fi/wiki/index.php?title=Järjestelmäviesti:Common.css
    • pelkästään ulkoasuun Vector: Vector.css
    • 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
  • 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ä.
  • 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;
}
  • 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

Valkoinen sivu[muokkaa]

Oletko juuri tehnyt LocalSettings.php tiedostoon muutoksen? Esimerkiksi rivin lopusta puuttuva puolipiste (;) voi aiheuttaa tämän.

Varnish[muokkaa]

http://briansnelson.com/Setup_Varnish_Cache
http://briansnelson.com/Setup_Varnish_for_MediaWiki

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);

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.
http://www.mediawiki.org/wiki/Manual:Backing_up_a_wiki
Mysqldump komennon ohje

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
http://www.mediawiki.org/wiki/User:Flominator/Backup_MW
  • 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]

Apache palvelin[muokkaa]

  • Asennus tehty 2.9.2016 - MediaWiki 1.27.1
  1. Tarkista palvelimesi sopivuus kyseiselle MediaWiki-versiolle
  2. Lue release-notes kyseistä versiota koskien
    1. esim. 1.27: https://phabricator.wikimedia.org/diffusion/MW/browse/REL1_27/RELEASE-NOTES-1.27
  3. Lataa MediaWiki, yleensä viimeisin versio MediaWiki -sivustosta.
    1. lataa se suoraan pääteohjelmalla "kotitietokoneella" tai palvelimella tai siirrä esimerkiksi cPanel File Managerilla "kotikoneelta" palvelimen public_html -hakemistoon eli juurihakemistoon!
    2. suoraan palvelimelta: wget http://releases.wikimedia.org/mediawiki/1.27/mediawiki-1.27.1.tar.gz
  4. pura tiedosto cPanel:n Extract toiminnolla tai pääteohjelmalla: tar -xvzf mediawiki-*.tar.gz
  5. vaihda kansion nimeksi w esimerkiksi File Manager:lla klikkaamalla kansion nimeä tai pääteohjelmalla mv mediawiki-1.27.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.
    1. hakemiston voi myöhemmin muuttaa helposti muuttamalla hakemiston nimen ja muuttamalla LoacalSettings.php tiedostoon kyseisen hakemiston nimen.
  6. 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!
  7. MediaWiki luo automaattisesti uuden tietokannan jos sinulla on antaa sille tietokantapalvelimen root tunnus ja salasana. Tällöin voit siirtyä suoraan mediawikin asennukseen. Muutoin,
    1. 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.
    2. cPanel > MySQL® Database Wizard. Anna käyttäjälle seuraavat oikeudet: grant index, create, select, insert, update, delete, alter, lock tables.
    3. tai phpMyAdmin > SQL
create database wikidb;
grant index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'jokunimi'@'localhost' identified by 'salasana';
  1. Avaa selaimessa osoite http://www.palvelin.fi/w/index.php
  2. set up the wiki > Your language fi -suomi ja Wiki language fi - suomi > Continue > Tarkista ympäristö ja Jatka
  3. Tietokannan tyyppi MySQL, Tietokantapalvelin localhost, merkistö UTF-8, Tietokannan nimi wikidb, jos haluat tauluille etuliitteen, kirjoita etuliite_ > Jatka
    1. 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ä.
  4. Siirrä muodostunut LocalSettings.php mediawiki hakemistoon
  5. Muuta LocalSettings.php tiedosto-oikeudeksi 400 tai jos ei toimi 600, 640 tai 644 tässä järjestyksessä kokeillen.
  6. Siirry asettamaan LocalSettings.php-tiedoston asetuksia (oma otsikko alla)
  7. Aseta lyhyt URL
  8. Muuta tarvittaessa nimipalvelimet (domain) osoittamaan palvelimelle
  9. Enter your wiki ja testaa sivujen näkyminen, muokkaus, tiedostojen lataus, tarkista versionumero
  10. Tee tarvittavat perusasetukset. Kts. vinkkejä kohdasta MediaWikin siirtäminen esimerkki 1
  11. 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]

esimerkiksi www.palvelin.fi/wiki/Sivunnimi

Tämä osa-alue on melko konstikas, koska tässä on vähintään kolme muuttuvaa tekijää: 1) LocalSettings.php, 2) .htaccess ja 3) domainohjaus cPanel:ssa. Kaikki vaikuttavat toisiinsa ja oikean yhdistelmän löytäminen saattaa olla haastavaa. www.wikini.pääte -pyyntö ohjataan cPanel:ssa public_html -hakemistoon, josta löytyy .htaccess -tiedosto, joka ohjaa /w -hakemistoon, jossa MediaWikin index.php ottaa haltuunsa osoitteen luomisen yhdessä .htaccess -tiedoston kanssa.

  • On hyvä muistaa muutama perusasia:
  • 1. MediaWiki on tiedostojärjestelmässä seuraavasti: /home/käyttäjätunnus/public_html/w eli esim. LocalSettings löytyy /w -hakemistosta. Jos näin ei ole, säädöt ovat haastavammat varsinkin jos pyrit saamaan edellä esitetyn "virallisen" muodon osoiteriville.
  • 2. LocalSettings.php -tiedostossa seuraavat asetukset:

$wgScriptPath = "/w"; $wgArticlePath = "/wiki/$1"; $wgServer = "http://www.wikini.pääte";

  • 3. .htaccess -tiedoston tulee sijaita public_html -hakemistossa. EI siis /w -hakemistossa! Tiedosto-oikeus 644. Lisää sinne seuraavat rivit. .htaccess:ssa toki voi olla muitakin ohjauksia muihin ohjelmistoihin, joita käytät. Yksi RewriteEngine on riittää sivun alussa.
RewriteEngine on
# Short url for Wiki pages
RewriteRule ^/?wiki(/.*)?$ %{DOCUMENT_ROOT}/w/index.php [L]

# Redirect / to Wiki Main Page
RewriteRule ^/*$ %{DOCUMENT_ROOT}/w/index.php [L]
  • 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: wikini.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.
    • 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
http://shorturls.redwerks.org

[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

  1. Ota käyttöön PHP ja MySQL ja phpMyAdmin. Ohjeet löytyvät sivuilta PHP asennus.
  2. Kytke MySQL päälle
  3. Lataa MediaWikin esimerkiksi viimeisin versio MediaWiki sivustosta, pura ja siirrä /Sites -hakemistoon.
  4. Anna selaimeen http://localhost/~käyttäjänimesi/mediawiki
  5. set up the wiki > Your language fi -suomi ja Wiki language fi - suomi > Continue > Jatka
  6. Tietokannan tyyppi MySQL, Tietokantapalvelin localhost, Tietokannan nimi wikidb > Jatka > Jatka > Jatka
  7. Siirrä LocalSettings.php mediawiki hakemistoon
  8. 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 esimerkki 1[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 olemassaolevan 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ää!

  1. Asenna uusi MediaWiki normaalisti edellä esitetyn ohjeen mukaisesti tms.
  2. Asenna tarvittavat laajennukset
  3. Aseta LocalSettings.php tiedostoon tarvittaessa vanhasta LocalSettings.php tiedostosta asetuksia.
  4. Testaa sivustoa ja tee tarvittavia muutoksia kun se on vielä tyhjä.
  5. Ota uudesta sivustosta varmuuskopio (tiedostojärjestelmä ja tietokanta)
  6. 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"!
    1. 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.
    2. vienti taphtuu toimintosivujen kautta lisäämällä vietävien sivujen muokattu lista ruutuun.
  7. 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
  8. Vie myös luokat ja tuo ne kuten sivut. Jokaisen vietävän luokan edessä pitää olla sana Luokka: esimerkiksi Luokka:luokannimi
    1. HUOM! Luokat näkyvät vasta kun ajat maintenance-hakemistossa komennon: php refreshLinks.php
  9. 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
  10. Vie myös muut nimiavaruudessa olevat sivut edellä kuvatusti.
  11. Vaihtoehtoisesti joitakin sivuja voi toki viedä copy-pastella. Esim. Etusivu, Ohje, Vastuuvapaus, Tietoja, Tietosuojakäytäntö -sivut.
    1. Tarvittaessa ohjaa Tietosuojakäytäntö, Tietoja ja Vastuuvapaus linkkejä toisille sivuille #REDIRECT [[Wikinimi:Tietoja]] -komennolla. Ja korjaa mahdollisia tekstissä olevia linkkejä.
  12. Tuo kuvat. Katso otsikko Kuvien uudelleenasennus.
  13. Erinäisiä hienosäätöjä
    1. Lisätään uudelleenohjaus muokkaustilan alateksin Tekijänoikeudet-linkkiin: klikataan linkkiä ja lisätään #REDIRECT [[Sivu jolle ohjaus tehdään]]
    2. Muutetaan muokkaustilan alatekstin Muokkausohjeet -linkki osoittamaan ohje-sivulle: http://www.palvelin.fi/wiki/Järjestelmäviesti:Edithelppage
    3. Muokataan sivupalkkivalikkoa: http://www.palvelin.fi/wiki/Järjestelmäviesti:sidebar
    4. 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 * * *
  14. Tarvittaessa hyödyllisiä skriptejä maintenance-hakemistossa voivat olla: php update.php ja php Maintenance.php
    1. 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.
    2. 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.
  15. https://www.mediawiki.org/wiki/Manual:Footer
  16. https://www.mediawiki.org/wiki/Manual:Job_queue ???

MediaWikin siirtäminen esimerkki 2[muokkaa]

Tässä kuvataan tuotannossa olevan MediaWikin TIETOKANNAN JA TIEDOSTOJÄRJESTELMÄN siirtäminen toiselle palvelimelle. Tässä ei tehdä mitään päivityksiä vaan yksinkertaisesti siirretän sivusto toiseen osoitteeseen. Oletuksena on että palvelin on samanlainen, eli muutoksia siltä osin ei tarvitse tehdä.

  1. Asetetaan vanha wiki vain luku -tilaan
    1. Lisätään LocalSettings.php -tiedostoon $wgReadOnly = 'Wikiä siirretään parhaillaan uudelle palvelimelle.';
  2. Varmuuskopioidaan tietokanta
    1. Kopiodaan cPanelin kautta phpMyAdmin -ohjelmalla. Viedään tietokanta tai halutut taulut.
  3. Varmuuskopioidaan tiedostojärjestelmä
    1. Käytän usein Cyberduck -ohjelmaa jolla teen koko mediawiki hakemistosta zip-paketin ja vedän sen hiirellä avoinna toisessa ikkunassa olevaan uuden palvelimen tiedostopuuhun. Zip-pakkaaminen/purkaminen Cyberduck:ssa vaatii sftp-yhteyden. Voit käyttää myös cPanelin kautta tiedostojärjestelmää. Tarvittaessa voit purkaa esm. pääte-ohjelmalla komennolla unzip tiedostonimi.zip
  4. Luodaan tietokanta ja siihen käyttäjä ja sille oikeudet
    1. Tässä ei ole neuvottu tarkemmin, mutta voit katsoa muualta tältä sivulta tai Wikikosta, esm. sivu SiteGround.
  5. Tuodaan tietokanta "kotikoneelta" uudelle palvelimelle
    1. Käytetään cPanelin kautta phpMyAdmin -ohjelmaa. Tuodaan tietokanta tai halutut taulut.
  6. Tuodaan ja puretaan tiedostojärjestelmä uudelle palvelimelle
    1. Nyt kun tehtiin suoraan kopio, pysyvät myös tiedosto-oikeudet kohdallaan.
  7. Tarkistetaan LocalSettings.php -tiedosto
    1. 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.
  8. Testataan toimivuus
    1. Kirjaudu sisään. Tarvittaessa osoitepolku kirjautumiseen on /w/index.php?title=Toiminnot:Kirjaudu_sisään
    2. 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.
    3. Jos et pääse kirjautumaan, koska tilapäisen IP-osoitteen jäljestä tipahtaa aina linkkiä painettaessa käyttäjätunnus pois
      1. 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 päivittäminen (upgrade)[muokkaa]

ESIMERKKI 1: versiosta 1.27.1 versioon 1.31 (tehty 21.10.2018)

https://www.mediawiki.org/wiki/Manual:Upgrading
  1. maintenance-hakemistossa: php runJobs.php (suorittaa mahdolliset odottavat toimet)
  2. Ota varmuuskopio tietokannasta
  3. Ota varmuuskopio tiedostojärjestelmästä
  4. publich_html-hakemistossa: wget wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.1.tar.gz
    1. tar -xvzf mediawiki-1.31.1.tar.gz
    2. rm mediawiki-1.31.1.tar.gz
  5. Kopioi vanhasta versiosta LocalSettings.php
  6. Kopioi vanhasta versiosta images-hakemisto
  7. Lisää omat laajennokset (extensions) käyttäen uusimpia versioita
    1. Hae laajennoksen lautausosoite MediaWikin sivuilta. Lataa laajennus extensions-hakemistoon: wget tiedostonimi ja pura se tar -xvzf tiedostonimi, jolloin muodostuu oma hakemisto laajennokselle.
    2. Tee tarvittavat muutokset LocalSettings.php-tiedostoon laajennoksia koskien.
  8. Tee tarvittavat muutokset esim. LocalSettings.php, logon polku, ulkoasu (skins), .htaccess (jos käytössä), omat muutokset laajennoksiin tai itse MediaWikiin
  9. maintenance-hakemistossa: php update.php (päivittää tietokannan)
  10. Vaihda vanhan version hakemistonimi ja nimeä uuden version hakemistonimi vanhan mukaiseksi.
  11. Testaa sivustoa, korjaa virheilmoitukset.


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ä[email protected] 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

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.

OSX Yosemite, Python 2.7, MediaWiki 1.25.2[muokkaa]

Choose either mwlib_server or OCG_server.

mwlib_server[muokkaa]

Installed 13.8.2015 NOT WORK

  • We need mwlib and for that Python needs modules pil and lxml.
$ 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

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

OSX Mavericks, Python 2.7, MediaWiki 1.22.1[muokkaa]

  • We need mwlib and for that Python needs modules pil and lxml.
$ 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

ConfirmEdit (captcha)[muokkaa]

Tämä lisäosa tulee MediaWikin mukana ja voit kytkeä sen asennusvaiheessa tai myöhemmin.

  1. Asenna lisäosa
  2. Lisää LocalSettings.php tiedostoon
    1. 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).
    2. $wgCaptchaTriggers['edit'] = true; ja $wgCaptchaTriggers['create'] = true;
  3. 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ä.
  4. Kysymystä edeltävä informatiivinen teksti muutetaan: Järjestelmäviesti:Questycaptcha-edit

DeleteHistory[muokkaa]

  • 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 );

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]

  1. Lataa http://www.mediawiki.org/wiki/Extension:DynamicPageList_(third-party) joka löytyy sivun Installation kohdasta.
  2. Pura /extension -hakemistoon nimellä DynamicPageList
  3. Lisää LocalSettings.php tiedoston loppuun rivi require_once __DIR__ . "/extensions/DynamicPageList/DynamicPageList.php";
  4. 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.
http://www.mediawiki.org/wiki/Extension:ExternalLinks

FileProtocolLinks[muokkaa]

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.

http://www.mediawiki.org/wiki/Extension:MobileFrontend
  • 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]

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.
https://www.mediawiki.org/wiki/Extension:LocalisationUpdate

Push[muokkaa]

Sivujen työntäminen wikistä toiseen.

http://www.mediawiki.org/wiki/Extension:Push
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.
http://www.mediawiki.org/wiki/Extension:TableEdit


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.
http://www.mediawiki.org/wiki/Help:System_message

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]
  1. Luo itsellesi tunnus
  2. Säädä asetukset mieleiseksi nyt tai myöhemmin
  3. Sivusto ehdottaa muutamia käännöksiä käännettäväksi, joilla testataan ettet ole roskapostittaja tms.
  4. 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ä.

  1. 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.
  2. Vaihda tallentuneen tiedoston nimeksi fi.json
  3. Siirrä tiedosto hakemistoon i18n joka on kyseissä laajennusosassa jonka käännöksen latasit. Jokaisessa laajennusosalla on oma i18n-kansio.
  4. 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.
http://www.mediawiki.org/wiki/Localisation_file_format
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ä[email protected] 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.