Sisällysluettelo:
| Table of Contents |
|---|
Mitä ovat makrot?
Makrot ovat Confluence-wikialustan erityisominaisuuksia, jotka mahdollistavat ohjelmallisten ja dynaamisten sisältöjen liittämisen osaksi wikisivua.
Miten toiminnallisuus liitetään wiki-sivulle?
- Aseta kohdistin sille kohdalle sivua, johon haluat sijoittaa toiminnallisuuden.
- Edit
- (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.
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.
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.
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.
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ä.
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.
,
| Div | ||
|---|---|---|
| ||
|
Ohjeita ja vinkkejä eri makrojen käyttöön
| Table of Contents |
|---|
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)
| Table of Contents |
|---|
| 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.
|
| Children Display |
|---|
| 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:
|
| RSS Feed | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| No Format |
|---|
Tuo Helsingin Sanomien sivuilta 5 tuoreinta uutisotsikkoa näin:
{rss:url=http://www.hs.fi/uutiset/rss/|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.
|
...
| 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 | ||||||
|---|---|---|---|---|---|---|
|
| No Format |
|---|
Esimerkki: [Jussin kalenterit|~a3454:Jussin kalenterit]
----
h3. Gallery
Mahdollistaa sivulle liitettyjen kuvatiedostojen esittämisen kuvagalleriana.
|
| Gallery | ||||
|---|---|---|---|---|
|
...