Tietohallinto

...

...

Sisällysluettelo:

...

...

Ohjeita ja vinkkejä eri makrojen käyttöön

Mitä ovat makrot?

Makrot ovat Confluence-wikialustan erityisominaisuuksia, jotka mahdollistavat ohjelmallisten ja dynaamisten sisältöjen liittämisen osaksi wikisivua.

...

Makrot liitetään haluttuun kohtaan wikisivua, ja ne muodostuvat seuraavasti:

{makron_nimi:parametri=arvo|parametri2=arvo|parametri3=arvo}

Makro on kokonaisuudessaan määritelty aaltosulkujen { ja } sisään, ja eri parametrit on erotettu toisistaan pystyviivalla eli putkimerkillä |.

Confluencen käyttöoppaassa on kattavat ohjeet kaikkien makrojen käyttöön. Tässä oppaassa esitellään Metropoliassa hyödyllisiksi havaittuja makroja ja niiden perusominaisuuksia.

Yksi yksinkertaisimmista makroista on alla ensimmäisenä oleva Table of Contents.

TOC - automaattinen sisällysluettelo

Table of Contents -makro luo sivulle automaattisesti sisällysluettelon sivulla olevien otsikkojen mukaan, kun otsikoinnissa käytetään Wiki Markupin mukaista hierarkkista otsikkomerkintää (h2., h3., h4. jne.).

Merkintätapa:

{toc}

Esimerkkitoteutus näkyy oikeassa palstassa ylhäällä.

Children - alasivujen listaus

...

Miten toiminnallisuus liitetään wiki-sivulle?

1. Aseta kohdistin sille kohdalle sivua, johon haluat sijoittaa toiminnallisuuden.
2. Edit
3. (Mikäli etsimäsi makro ei tullut näkyviin) Other macros

Mitkä ovat yleisimpiä makroja?

Table of Contents

Sisällysluettelo
Vihje: Sisällysluettelon hierakia perustuu sivun otsikkotasoihin (Heading 1, Heading 2 jne.)

Gallery

Kuvagalleria.

Tasklist

Tehtäväluettelo

Children Display

Luettelo alasivuista
Vihje: Sitä voi käyttää esimerkiksi kokouspöytäkirjojen arkistoinnissa: Lisätään pöytäkirja uudeksi alasivuksi, jolloin listaus tapahtuu pääsivulle automaattisesti makron avulla. Näin vähenee yksi linkitysoperaatio, kun linkkiä uuteen dokumenttiin ei tarvitse luoda manuaalisesti.

Merkintätapa:

{children}

Esimerkki:

Kokeile lisätä tälle sivulle uusi alasivu: Add => page, niin näet kuinka uusi sivu ilmestyy yllä olevaan listaan automaattisesti.

RSS - syötteenlukija

...

Team Calendars

Kalenteri.

Gliffy Diagram

Diagrammi.

Blog Posts

Blogikirjoitus
Vihje: Makrolla on mahdollista liittää wikisivulle wikissä julkaistuja uutisia blogimaisessa muodossa. Yleinen käyttökohden on liittää työtilassa julkaistut uutiset työtilan etusivulle, jolloin rakentuu blogi. Blog Posts -makro mahdollistaa kuitenkin myös monipuolisempia toimintoja, joilla uutisia voi hakea esimerkiksi eri työtiloista labeleiden ja käyttäjien perusteella suodatettuina.

RSS Feeds

Upota RSS-syöte sivulle
Vihje: Sitä voi käyttää ulkoisten verkkopalvelujen sisältöjen esittämiseen. Esimerkiksi eri uutispalvelut ja blogit tarjoavat usein sisältönsä myös RSS-muodossa.

Esimerkki:

{rss:url=http://www.hs.fi/uutiset/rss/|showTitlesOnly=true|max=5|titleBar=false}

Tuo Helsingin Sanomien sivuilta 5 tuoreinta uutisotsikkoa näin:

Include ja Excerpt Include

Include - sivun esittäminen osana toista sivua

...

Widget Connector

Upota Youtube-video, Flickr-kuva,  
Google Drive -dokumentti, Twitter-virta tai muu dokumentti sivulle

Recently Updated

Luettelo tuoreutuksista.

Include Page

Sisällytä toinen sivu osaksi sivua
Vihje: Includea voi käyttää esimerkiksi usein toistuvien sivurakenteiden (navigaatio tai footer, eli sivun loppuosassa oleva toistuva tunniste kuten logo tai yhteystiedot) rakentamisen yhdelle sivulle, joka voidaan liittää muille sivuille. Näin yhdelle sivulle tehdyt muutokset päivittyvät automaattisesti kaikille sivuille, joille tuo sisältö on liitetty.

...

Merkintätapa:

...

Tässä esimerkki, jossa sisältö on liitetty sivusta Include-esimerkki (käy muokkaamassa tiedostoa, niin huomaat, että esimerkkisivulle tehty muutos päivittyy tähän alapuolelle):

...

Excerpt Include - sivun tiivistelmän esittäminen osana toista sivua

Include Excerpt

Sisällytä toisen sivun osa osaksi sivua
Vihje: Exerpt Include toimii yhdessä Excerpt -makron kanssa, jolloin sivulle voidaan määritellä tiivistelmä, joka Exerpt Includen avulla voidaan liittää toiselle sivulle siten, että laajempi sisältöosuus ei liity mukana

...

Tähän on liitetty sivu Exerpt Include -esimerkki, jossa alku on määritelty tiivistelmäksi. Vertaa varsinaista tiedostoa ja alla olevaa liitettyä osuutta:

...

Calendar - kalenteritoiminto

...

.

...

Esimerkki: Jussin kalenterit

Gallery - kuvagalleria

Mahdollistaa sivulle liitettyjen kuvatiedostojen esittämisen kuvagalleriana.

{gallery:title=Gallerian otsikko|sort=date}

Esimerkki: Jussin kuvia

View File - liitetiedoston esittäminen osana sivua

View File -makrolla sivulle voi upottaa liitetiedoston siten, että tiedostoa voi selailla osana sivua. Makro osaa näyttää Office 97-2003 dokumentteja (Word, Excell ja PowerPoint) ja PDF-tiedostoja.

Merkintätapa:

{viewfile:Testipresentaatio.ppt}

Tuo näkyviin tämän sivun liitteenä olevan Testipresentaatio.ppt -PowerPoint-tiedoston:

...

Näin käyttäjien ei tarvitse ladata esitystä omalle koneelleen nähdäkseen sen. Esityksen voi avata myös kokoruututilaan, jolloin sitä voi käyttää esimerkiksi luennolla wikin kautta.

Content by Label

...

Tee luettelo tietyllä tagilla eli avainsanalla merkityistä sivuista
Vihje: Täydennystä kaipaaville sivuille liitetään label korjatkaa. Tämän jälkeen voidaan automaattisesti listata kaikki korjausta kaipaavat sivut, jolloin ylläpitäjät löytävät ne helposti. Tämä on erittäin monipuolinen makro, jota voi säätää monilla parametreillä.

Merkintätapa:

No Format
{contentbylabel:label=korjatkaa|showLabels=false|showSpace=false|space=@self}

Alla olevaan listaan tulevat mukaan kaikki tämän työtilan (space=@self) sivut, joihin on merkitty label "korjatkaa":

Content by Label
showLabels false label korjatkaa showSpace false space @self cql label = "korjatkaa" and space = currentSpace()

Create Page - linkki uuden sivun luomiseksi

Tällä makrolla voi tehdä oman linkin uuden sivun luomista varten mihin tahansa kohtaan sivua.

Merkintätapa:

{create-page:prompt=Anna nimi uudelle sivulle|target:edit}Luo uusi alasivu{create-page}

Kokeile tästä:

{create-page:prompt=Anna nimi uudelle sivulle|1=target:edit}Luo uusi alasivu{create-page}

Add Page

Lisää uusi sivu
Vihje: Tämä voi joissain tilanteissa olla selvempi käytäntö kuin ylävalikon Add => Page käyttäminen.

Table Plus

Mahdollistaa tavallista taulukkoa toiminnallisemman taulukon, jossa voi olla esimerkiksi rivien automaattinen järjestäminen avaimen mukaan ja laskuominaisuuksia. 

,

Sisällysluettelo:

{recently-updated}

{widget:url=http://www.youtube.com/watch?v=crnLQB4Uf6w}

{widget:url=http://www.flickr.com/photos/tags/helsinki/}

{widget:url=http://www.flickr.com/photos/callion/4227979490/}

{widget:url=http://twitter.com/sosiaalinen}

{blog-posts:spaces=katalyytti,@self}

{blog-posts:labels=metropolia,opetus|spaces=@all}

{blog-posts:labels=+metropolia,+opetus|spaces=@all}

{blog-posts:spaces=@all|author=a3454,kokkj|labels=metropolia}