Mediawiki – Tarkkaamo

MediaWiki, Open Graph ja Featured Image

Jussi Linkola — Sat, 20 Dec 2014 16:39:00 +0000

MediaWiki-ohjelmistolla tehdyn sivuston sivuja Facebookiin jaettaessa voi olla vaikeuksia saada haluttu kuva mukaan linkkijulkaisuun. Open Graph Tagit ovat verkkosivun -osioon asetettavia tietueita, joilla voi antaa Facebookille ohjeet, kuinka sivuun liittyvät tiedot näytetään, kun se jaetaan Facebookissa. MediaWikissä tämän voi tehdä lisäosalla, joka omassa käytössäni ei toiminut suoraan asennettuna toivotulla tavalla.

Nämä ohjeet perustuvat MediaWikin versioon 1.23.2, kokeilu omalla vastuulla.

OpenGraphMeta Extension

Open Graph -määritysten lisäämiseen on tässä esimerkissä käytetty OpenGraphMeta-nimistä laajennusta, joka asennetaan aluksi asennusohjeen mukaan.

Tavoitetila

Halutaan, että sivuilla, joille ei erikseen ole määritelty artikkelikuvaa (Featured Image), Facebook näyttää linkin yhteydessä wikisivuston logon. Oletuskuva pitää voida ohittaa määrittelemällä sivulle erikseen kuva, jota sen oletuskuvana käytetään. Artikkelikuvaan liittyvä Open Graph -tietue näyttää suunnilleen tältä:

Havaitut ongelmat

Asennuksen jälkeen OpenGraphMeta tuottaa -osioon sivuston logoon viittaavan artikkelikuvan, kun kyseessä on sivuston etusivu. Muille sivuille kuvatietue ei tulostu.

Korjauksia

Ensimmäinen korjaus löytyy OpenGraphMeta-lisäosan keskustelusivulta. Lisäosan koodia tiedostossa /extensions/OpenGraphMeta/OpenGraphMeta.php pitää muuttaa seuraavasti:

Rivillä 46 oleva määritys:

Title::newFromDBkey($data['dbkey'], NS_FILE) )

muutetaan muotoon:

Title::newFromDBkey( "File:" . $data['dbkey'] )

Tämän jälkeen lisäosan ohjeiden mukaisen, wikitekstin sekaan määritellyn parseri-funktion, esimerkiksi {{#setmainimage:Otsakekuva.jpg}}, pitäisi tuoda haluttu og:image määritys sivun otsakkeiden joukkoon.

Nyt pitää saada vielä sivuston logo oletuskuvaksi, joka näytetään aina, kun muuta kuvaa ei ole määritelty. Riviltä 80 alkava lauseke:

elseif ( $isMainpage ) {
                $meta["og:image"] = wfExpandUrl($wgLogo);

muutetaan muotoon:

else {
                $meta["og:image"] = wfExpandUrl($wgLogo);

Muuta huomioitavaa

Lisäosa ei ole aivan uusi, ja se muokkaa itse määritellystä kuvasta varsin pienen kuvakkeen. Open Graphin nykyisissä suosituksissa otsakekuvan koko olisi minimissään 1200×630 pikseliä, joten kuvakkeelle asetetun koon voi muuttaa suuremmaksi. (Jos kuvakekoko on suurempi kuin alkuperäinen kuva, käytää MediaWiki alkuperäistä kuvaa.) Eli rivillä 75:

$meta["og:image"] = wfExpandUrl($out->mMainImage->createThumb(100*3, 100));

mutetaan esimerkiksi muotoon:

$meta["og:image"] = wfExpandUrl($out->mMainImage->createThumb(1200, 630));

Logon määrittäminen

Oletuskuvan osalta pitää huomata, että logon polun on oltava määriteltynä LocalSettings.php -tiedostossa:

$wgLogo = "$wgStylePath/myskin/mylogo.jpg";

Avoimen oppimateriaalin Logistiikan maailma

Jussi Linkola — Thu, 10 Jan 2013 10:51:40 +0000

Olen ollut mukana kiinnostavassa avoimen oppimateriaalin projektissa, jossa on rakennettu logistiikka-alan wikipohjainen verkkoaineisto, Logistiikan maailma. Palvelun ensimmäinen versio julkaistiin tänään, 10.1.2013.

Projektin lähtökohtana oli Logistiikan ja toimitusketjun hallinan perusteet -kirja, jonka sisältö toimii verkkoaineiston perustana. Kirjan julkaisija Reijo Rautauoman säätiö on myös verkkoaineiston julkaisija ja vastaa sisällöstä yhdessä kirjoittajien kanssa. Palvelun on toimittanut Metropolia Ammattikorkeakoulun mediakeskus Valo.

Tekniikka ja ulkoasu

Logistiikan maailma on toteutettu Wikipediankin käyttämän MediaWiki -ohjelmiston avulla. Wikialustan muokkauksen ja ulkoasusuunnittelun on tehnyt webdesigner Mikko Rusko, jonka palveluja suosittelen lämpimästi.

Sivustolla on pyritty selkeään ja luettavaan ulkoasuun muun muassa häivyttämällä MediaWikin ominaispiirteitä ja sivustolle tarpeettomia ominaisuuksia näkyvistä. Etusivulle on nostettu sivuston aihealueita ”salkkuihin”, joiden avulla pyritään tarjoamaan suoria oikopolkuja kiinnostaviin sisältöihin ja sisältökokonaisuuksien alkukappaileisiin:

Logistiikan maailma -palvelun etusivu kansiorakenteineen (kehitysvaiheessa)

Materiaaleja on lajiteltu ja organisoitu MediaWikin tarjoaman luokkarakenteen avulla viiteen pääluokkaan, jotka mukailevat etusivun kansiomallia. Pääluokat löytyvät sivuston ylänavigaation kautta. Sisältösivun näkymässä sisältö on omassa palstassaan oikealla ja luokkavalikko asettuu vasempaan palstaan. Esillä olevan sivun kanssa samaan aihepiiriin liittyviä sivustoja tarjotaan näkyviin Nice Category List2 -lisäosaa hyödyntävän mallineen avulla. Tavoitteena on ollut kirjamaisempi, sisältökokonaisuuksista rakentuva sivusto kuin esimerkiksi Wikipedia, joka selkeämmin koostuu yksittäisistä artikkeleista.

Responsiivisuus

Koska Logistiikan maailma on tietopankki ja käsikirja, haluttiin siitä tehdä mahdolisimman monipuolisesti saavutettava. Sivusto on toteutettu niin sanotulla responsiivisella suunnittelutekniikalla, jolloin sivuston ulkoasu mukautuu päätelaitteen näytön tai www-selaimen leveyden mukaan. Näin esimerkiksi sisältösivu mukautuu vaikkapa älypuhelimen näyttöön:

Logistiikan maailma mukatuu kapeaan ikkunaan

Esimerkiksi iPadilla sivuston lukeminen on varsin miellyttävää ja ”kirjamaista”, kannattaa kokeilla.

Muita huomioita

Valmiiseen, massiiviseen aineistoon perustuvan wikisivuston suunnittelu on mielenkiintoista ja tarkkaa puuhaa. Mielestäni suurin haaste on ollut materiaalin pilkkominen ja esittäminen selkeästi siten, että lukija tietää missä kohtaa sivustoa hän on ja minne hän seuraavaksi menee. Jossain vaiheessa sisältöä lisätessä ylitetään kriittinen piste, jonka jälkeen oleelliset muutokset tehtyihin valintoihin aiheuttavat merkittävästi lisätyötä. Siksi suunnittelu ja pienehköllä materiaalimassalla prototyyppaaminen on tärkeää.

MediaWiki on yleisesti käytetty ja tunnettu alusta, joka edelleen ajaa asiansa Open Source wikiohjelmistona. MediaWikille löytyy runsaasti lisäominaisuuksia tarjoavia laajennuksia, joiden osalta kannattaa huomioida, että ne ovat usein herkkiä käytössä olevan ohjelmistoversion suhteen.

Kokonaisuutena arvioisin, että sivustolla on onnistuttu yhdistämään MediaWiki-alusta joustavasti tämän päivän verkkokäytön tarpeisiin sisältöä palvelevalla tavalla.

Avoimen oppimateriaalin projektina tämä on mielestäni siitä mainio, että julkaisija on sitoutunut aineiston jatkuvaan kehittämiseen. Emme siis tule näkemään sivustoa, jonka kehitys päättyy pian julkaisun jälkeen, vaan julkaisuhetki on vasta lähtölaukaus sille, mitä palvelusta ajan mittaan kehittyy. Sivusto ei ole avoimesti muokattavissa, mutta halukkaat ja aihepiiriä tuntevat kirjoittajat voivat päästä mukaan kehittämään sisältöjä eteenpän.

Logistiikan maailma julkaistiin tänään, 10.1.2013, joten kaikki palaute toteutuksen ja sisällön osalta on tervetullutta.

Päivitys 26.9.2014: Uusi sivusto Varaudu.INFO avataan 1.10.2014. Se on toteutettu pitkälti Logistiikan maailman mallin mukaan.

Mediawikin sivukohtainen keskustelu

Jussi Linkola — Tue, 04 Aug 2009 08:09:04 +0000

Törmäsin parin Mediawikin käyttöönotossa tilanteeseen, jossa sivukohtainen keskusteluominaisuus oli tarpeeton. Keskusteluvälilehden tai -tabin sai poistettua muokkaamalla tiedostoa includes/SkinTemplate.php seuraavasti:

Koodissa olevan kohdan

$content_actions['talk'] = $this->tabAction(
          $talkpage,
          'talk',
          $this->mTitle->isTalkPage() && !$prevent_active_tabs,
          '',
          true);

ympärille lisätään kommentointimerkit:

/* Ylläpitäjä poisti keskustelusivu-tabit
$content_actions['talk'] = $this->tabAction(
          $talkpage,
          'talk',
          $this->mTitle->isTalkPage() && !$prevent_active_tabs,
          '',
          true);
*/

Saman voi tehdä myös käyttäjäsivuun liittyvälle keskustelinkille, joka löytyy samasta tiedostosta:

/* Ylläpitäjä poisti käyttäjään liittyvän keskustelu-tabin
$personal_urls['mytalk'] = array(
          'text' => wfMsg('mytalk'),
          'href' => &$usertalkUrlDetails['href'],
          'class' => $usertalkUrlDetails['exists']?false:'new',
          'active' => ( $usertalkUrlDetails['href'] == $pageurl )
);
*/