Ohjeita ja vinkkejä eri makrojen käyttöön
TOC (table of contents)
Table of contents -makro luo sivulle automaattisesti sisällysluettelon sivulla olevien otsikkojen mukaan, kun otsikoinnissa käytetään Wiki Markupin mukaista hierarkkista otsikkomerkitää.
Merkintätapa:
{noformat)
No Format |
---|
Esimerkki on yllä ensimmäisen otsikon alapuolella.
h3. Children
Children-makro listaa automaattisesti kaikki sivun alasivut.
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.
|
No Format |
---|
Esimerkki:
{children}
Kokeile lisätä tälle sivulle uusi alasivu: add => page, niin näet kuinka uusi sivu ilmestyy listaan.
----
h3. RSS
RSS-makro mahdollistaa ulkoisen RSS-syötteen liittämisen sivulle.
Sitä voi käyttää ulkoisten verkkopalvelujen sisältöjen esittämiseen. Esimerkiksi eri uutispalvelut ja blogit tarjoavat yleensä sisältönsä myös RSS-muodossa.
Esimerkiksi seuraava koodi:
|
Kokeilemme erilaisia makroja
Children
Children-makro listaa automaattisesti kaikki sivun alasivut.
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.
Esimerkki:
Kokeile lisätä tälle sivulle uusi alasivu: add => page, niin näet kuinka uusi sivu ilmestyy listaan.
RSS-makro mahdollistaa ulkoisen RSS-syötteen liittämisen sivulle.
Sitä voi käyttää ulkoisten verkkopalvelujen sisältöjen esittämiseen. Esimerkiksi eri uutispalvelut ja blogit tarjoavat yleensä sisältönsä myös RSS-muodossa.
Esimerkiksi seuraava koodi:
...
RSS Feed |
---|
titleBar | false |
---|
max | 5 |
---|
showTitlesOnly | true |
---|
url |
---|
|
http://www.hs.fi/uutiset/rss/ |
|
...
No Format |
---|
Tuo Helsingin Sanomien sivuilta 5 tuoreinta uutisotsikkoa näin:
{rss:url= |
Tuo Helsingin Sanomien sivuilta 5 tuoreinta uutisotsikkoa näin:
...
http://www.hs.fi/uutiset/rss/ |
...
Include ja Excerpt Include
Include ja Excerpt Include ja mahdollistavat toisen wikisivun liittämisen osaksi toista sivua.
Includea voi käyttää esimerkiksi usein toistuvien sivurakenteiden (navigaatio tai footer, eli sivun loppuosassa oleva toistuva tunniste kuten logo) rakentamisen yhdelle sivulle, joka voidaan liittää muille sivuille.
Exerpt Include toimii yhdessä Exerpt -makron kanssa, jolloin sivulle voidaan määritellä tiivistelmä, joka Exerpt Includen avulla voidaan liittää toiselle sivulle.
No Format |
---|
{include:Liitettävän sivun nimi} |
Tässä esimerkki, sisältö on liitetty sivusta Include-esimerkki:
...
Calendar
Mahdollistaa kalenterin liittämisen sivulle. Kalenteria voi käyttää paikallisena kalenterina, tai siihen voi liittää ulkoisia kalentereja esim. iCal -muodossa.
No Format |
---|
{calendar:id=myCalendar|title=My Calendar|defaultView=month} |
Esimerkki: Jussin kalenterit
Gallery
Mahdollistaa sivulle liitettyjen kuvatiedostojen esittämisen kuvagalleriana.
|showTitlesOnly=true|max=5|titleBar=false}
----
h3. Include ja Excerpt Include
Include ja Excerpt Include ja mahdollistavat toisen wikisivun liittämisen osaksi toista sivua.
Includea voi käyttää esimerkiksi usein toistuvien sivurakenteiden (navigaatio tai footer, eli sivun loppuosassa oleva toistuva tunniste kuten logo) rakentamisen yhdelle sivulle, joka voidaan liittää muille sivuille.
Exerpt Include toimii yhdessä Exerpt -makron kanssa, jolloin sivulle voidaan määritellä tiivistelmä, joka Exerpt Includen avulla voidaan liittää toiselle sivulle.
|
Include Page |
---|
| tietohallinto:Liitettävän sivun nimi |
---|
| tietohallinto:Liitettävän sivun nimi |
---|
|
No Format |
---|
Tässä esimerkki, sisältö on liitetty sivusta Include-esimerkki:
{include: Include-esimerkki}
----
h3. Calendar
Mahdollistaa kalenterin liittämisen sivulle. Kalenteria voi käyttää paikallisena kalenterina, tai siihen voi liittää ulkoisia kalentereja esim. iCal -muodossa.
|
Team Calendars |
---|
defaultView | month |
---|
id | myCalendar |
---|
title | My Calendar |
---|
|
No Format |
---|
Esimerkki: [Jussin kalenterit|~a3454:Jussin kalenterit]
----
h3. Gallery
Mahdollistaa sivulle liitettyjen kuvatiedostojen esittämisen kuvagalleriana.
|
Gallery |
---|
sort | date |
---|
title | Gallerian otsikko |
---|
|
No Format |
---|
No Format |
{gallery:title=Gallerian otsikko|sort=date} |
---|
|
Esimerkki: Jussin kuvia
...