Ohjeita ja vinkkejä eri makrojen käyttöönTOC (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 otsikkomerkintää. Merkintätapa: Esimerkkitoteutus näkyy oikeassa palstassa ylhäällä. ChildrenChildren-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. Näin vähenee yksi linkitystoiminto, kun linkkiä uuteen dokumenttiin ei tarvitse luoda manuaalisesti. Merkintätapa: Esimerkki: Kokeile lisätä tälle sivulle uusi alasivu: Add => page, niin näet kuinka uusi sivu ilmestyy yllä olevaan listaan automaattisesti. 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 usein sisältönsä myös RSS-muodossa. Merkintätapaesimerkki: No Format |
---|
{rss:url=http://www.hs.fi/uutiset/rss/|showTitlesOnly=true|max=5|titleBar=false} |
Tuo Helsingin Sanomien sivuilta 5 tuoreinta uutisotsikkoa näin: RSS Feed |
---|
titleBar | false |
---|
max | 5 |
---|
showTitlesOnly | true |
---|
url | http://www.hs.fi/uutiset/rss/ |
---|
| Include ja Excerpt IncludeIncludeInclude 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 tai yhteystiedot) rakentamisen yhdelle sivulle, jotka voidaan liittää muille sivuille. Näin yhden sivun muutokset päivittyvät automaattisesti kaikille sivuille, joille sisältö on liitetty. Merkintätapa: No Format |
---|
{include:Liitettävän sivun nimi} |
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): Include Page |
---|
| tietohallinto: Include-esimerkki |
---|
| tietohallinto: Include-esimerkki |
---|
|
Excerpt IncludeExerpt 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: Excerpt Include |
---|
| tietohallinto:Exerpt Include -esimerkki |
---|
| tietohallinto:Exerpt Include -esimerkki |
---|
nopanel | true |
---|
| CalendarMahdollistaa 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 GalleryMahdollistaa sivulle liitettyjen kuvatiedostojen esittämisen kuvagalleriana. No Format |
---|
{gallery:title=Gallerian otsikko|sort=date} |
Esimerkki: Jussin kuvia View FileView 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: No Format |
---|
{viewfile:Testipresentaatio.ppt} |
Tuo näkyviin sivun liitteenä olevan Testipresentaatio.ppt -PowerPoint-tiedoston: View File |
---|
| Testipresentaatio.ppt |
---|
| Testipresentaatio.ppt |
---|
| Content by LabelTällä makrolla voi listata eri labelein merkittyjä sivuja. Voitaisiin esimerkiksi sopia, että täydennystä kaipaaville sivuille liitetään label "korjatkaa". Tämän jälkeen voitaisiin yhdelle sivulle listata kaikki korjausta kaipaavat sivut. 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 sivut, joihin on merkitty label "korjatkaa": Content by Label |
---|
showLabels | false |
---|
label | korjatkaa |
---|
showSpace | false |
---|
space | @self |
---|
cql | label = "korjatkaa" and space = currentSpace() |
---|
| Create PageTällä makrolla voi tehdä oamn linkin uuden sivun luomista varten mihin tahansa kohtaan sivua. Merkintätapa: No Format |
---|
{create-page:prompt=Anna nimi uudelle sivulle|target:edit}Luo uusi alasivu{create-page} |
Kokeile tästä: Wiki Markup |
---|
{create-page:prompt=Anna nimi uudelle sivulle|1=target:edit}Luo uusi alasivu{create-page} | Recently UpdatedTämä makro auttaa seuraamaan wikissä tapahtuneita muutoksia. Yksinkertaisimmillaan se listaa työtilan 15 viimeisintä muutosta. Merkintätapa: No Format |
---|
{recently-updated} |
Ja tulos on seuraava: Tätä monipuolista makroa voi suodattaa eri työtilojen, labeleiden ja käyttäjien sekä sisältötyyppien mukaan. Siis varsin kiva lisä wikimertarin työkalupakkiin. |