Nelli-wikin muokkaus

Skip to end of metadata
Go to start of metadata

Nelli-wikin muokkaus

 Nelli-wikiä on mahdollista muokata mm. seuraavilla apuvälineillä:

Sivupohjat (Templates) 

Nelli-wikissä on käytössä sivupohja(t), jotka löytyvät kohdasta Add Page/ Select a page template to start from. Jos tunnet tarvetta muokata tai korjata sivupohjaa, löytyy se kohdasta Browse Space/Advanced/Templates. Templaattia voi muokata sekä Rich Text että Wiki Markup -välilehdillä; jos tekemäsi muutokset eivät tallennu, mene tekemään ne Wiki Markupin puolelle niin saatat löytää syyn ongelmaasi. Perussivu on jaettu kahteen palstaan suhteessa 70-30 (vasemmalta oikealle). Jos käytössä on kolme palstaa (kuten pääsivulla), ovat suhteet 35-35-30.
Perussivulla vasemmassa palstassa on käytössä seuraavat elementit.

  • Pääotsikko ( Heading 1)
  • Alaotsikko (Heading 2 ja Heading 3)
  • Sisällysluettelo; se rakentuu automaattisestitasoista Heading 2 - Heading 6. Heading 1 -taso on jätetty turhana pois. Jos tunnet tarvitsevasi sitä esim. sen vuoksi, että sivulla on useita Heading 1 -tason otsikoita, muuta sisällysluettelomakroa Wiki Markupin  "minLevel=2"  "minLevel=1":ksi:

Oikeassa palstassa ovat:

  • Perussivun alasivut (jos niitä on; tähän voi laittaa myös jonkin toisen sivun alasivut). HUOM! Korjaa perussivupohjalla olevat asia/kuvailusanat (Label) sivun oikeaan sisältöön liittyvillä sanoilla. Templateen on tallennettu vain esimerkkisanoja.
  • Nelli-wikiin kohdistuva sanahaku (livesearch, specekey=nelli). Tässä voi olla myös sivujen kuvailussa käytettyihin asiasanoihin (Label) perustuva haku. Haettavat termit määritellään yksitellen Contentbylabel-makroon. Haussa voi olla useampia termejä välilyönnillä erotettuina.

Sivulta löytyvät myös värilliä korostetut huomautus- ja infotekstipohjat:

Huomautukset ja vinkit; käytä tarvittaessa ja poista, jos niitä ei tarvita.
Infolaatikot; käytä tarvittaessa ja poista, jos niitä ei tarvita.

Sivuston hierarkia (Location)

Sivuston sivujen suhteet määrittelevät sivujen ja myös sivujen sisältöjen keskinäiset suhteet. Sivun asema sivustossa määritellään sivun yläreunan kohdassa "Location:Nelli > Nelli-wikin ohjeet EDIT."  
Sivujen hierarkian voi määritellä uuden sivun lisäämisen yhteydessä tai missä vaiheessa tahansa jälkeenpäin. Hierarkiamääritellyt sivut näkyvät "lapsi"-sivuina oikean palstan kohdassa "Alasivut". Alasivut-makron voi poistaa, jos se ei ole hyödyllinen tai alasivuja ei ole.

Linkitys (Labels)

Confluence tukee muiden wiki-ohjelmien tavoin monipuolista linkitystä:

  • Avainsana-linkitys (Labels)
  • Ristiinlinkitys (Insert/Edit Link)
  • Hierarkia-linkitys

Navigointi avansanojen (Labels) ja ylä- ja alasivujen avulla on helppoa ja nopeaa ja sivuille on käytännössä mahdotonta eksyä. Koko sivuston rakenteen näkee esim. Browse Space -linkistä. Avaninsanat määritellään sivun tallentamisen jälkeen yläsivun linkistä Labels. Jos yhtään avainsanaa ei ole määritelty, Labels-tekstin perässä on merkintä (None) ja EDIT-linkki . avainsanat voi valita avansanapankista (Suggested labels)  tai kirjoittamalla halutut sanat kohtaan " Enter labels to add to this page". Avainsanat häviävät avaninsanapankista sitä mukaan kun niitä lisätään sivulle.

Suosi käyttökelpoisia ja yleismuotoisia termejä avainsanoina. Vältä liian spesifejä termejä.

Ristiinlinkitys määritellään seuraavasti: sana "parserit" linkitetään sivulle "Termit ja lyhenteet" ankkuroituun sanaan "parseri", jossa kuuluu olla tämän sanan selitys. Wiki-markupissa linkitys merkitään hakasulkeisiin ja putkimerkkeihin seuraavasti:

"Termit ja lyhenteet" -sivulla "Parseri"-sanan kohdalla on vastaavasti seuraavanlainen ankkuri (voidaan tehdä Rich Text -tilassa):

Rich Text -muokkaus ja Wiki markup

Confluencen wikejä muokataan lähtökohtaisesti ns. Rich Text -editorilla, joka on yksinkertainen WYSIWYG-työkalu. Siinä toimivat jopa Ctrl+B (lihavointi), Ctrl+I (kursivointi) ja Ctrl+U (alleviivaus) -komennot.  Kuvat, linkit, erikoismerkit ja hymiöt lisätään painikkeiden avulla, samoin tekstin värin.  Taulukoiden luonti on yksinkertaisinta tässä tilassa, mutta se on mahdollista myös wiki markupilla.

Muista tallentaa muutokset ennen siirtymistä uusille sivuille.

Wiki markup on Confluencessa käytettävä merkintäkieli. Sitä voi editoida jokaisella sivulla olevalla "Wiki markup"-välilehdellä .  Markupin muokkaaminen ei ole välttämätöntä, mutta joskus tulee vastaan muotoiluja, joita "Rich Text" -muodossa ei voi muokata. Silloin tulee siirtyä markup-välilehdelle, muokata wiki-koodia, tallentaa muutokset ja palata katsomaan tulosta.

Esimerkki markupista: 

h4. Confluence Markup

Wiki markup on luettavaa ja *ymmärrettävää* editointitilassakin. Sen muotoilukin on suhteellisen helppoa.
Markup on välttämätön työväline silloin, kun Rict Text -tilassa muotoilu ei onnistu. Wiki markup käyttää esimerkiksi luettelomerkeissä seuraavia symboleja:

* Wiki markup
** Tekstityylit
** Otsikot
** Linkit
** Muut

Taulukko näyttää wiki markupissa seuraavalta:

||Päivä||Tehtävä||
|Tiistai|Pidä Wiki-koulutus|
|Keskiviikko|Lepää|

 ...ja Confluencessa:

Päivä Tehtävä
Tiistai Pidä Wiki-koulutus
Keskiviikko Lepää

Makrot

Confluencen toiminnalliset ominaisuudet rakennetaan makrojen avulla. Tällä hetkellä Nelli-wikissä on käytössä seuraavat makrot (/pluginit):


         1. Attachments Macros (confluence.extra.attachments, Version: 1.4)
         2. Space Item Tabs (confluence.sections.space, Version: 1.0)
         3. JIRA Macros (confluence.extra.jira, Version: 1.6)
         4. Task List Macros (confluence.extra.tasklist, Version: 1.3)
         5. Admin Sections (confluence.sections.admin, Version: 1.0)
         6. Chart Plugin (confluence.extra.chart, Version: 1.8)
         7. Space Pages Sections (confluence.sections.space.pages, Version: 1.0)
         8. Left Navigation Theme (com.atlassian.confluence.themes.leftnavigation, Version: 1.0)
         9. Confluence Remote API (confluence.extra.confluencerpc, Version: 1.4)
        10. BloggingRPC (com.atlassian.confluence.plugins.xmlrpc.bloggingrpc, Version: 1.2.1)
        11. Page Tabs (confluence.sections.page, Version: 1.0)
        12. IM Presence Macros (confluence.extra.impresence, Version: 0.1)
        13. Dynamic Task List Macros (confluence.extra.dynamictasklist, Version: 1.5)
        14. Page Operations (confluence.sections.page.operations, Version: 1.0)
        15. Attachment Extractors (confluence.extractors.attachments, Version: 1.4)
        16. Advanced Macros (confluence.macros.advanced, Version: 1.3)
        17. Basic Macros (confluence.macros.basic, Version: 1.3)
        18. News Tabs (confluence.sections.news, Version: 1.0)
        19. Core Extractors (confluence.extractors.core, Version: 1.4)
        20. Core Startup and Shutdown (confluence.lifecycle.core, Version: 1)
        21. Compatibility Macros (confluence.macros.compatibility, Version: 1.3)
        22. Edit Profile Sections (confluence.sections.profile.edit, Version: 1.0)
        23. Dashboard Macros (confluence.macros.dashboard, Version: 1.3)
        24. Code Macro (confluence.macros.code, Version: 1.4)
        25. TinyMCE Editor Plugin (com.atlassian.confluence.extra.tinymceplugin, Version: 1.12)
        26. Confluence Contributors Plugin (com.atlassian.confluence.contributors, Version: 1.1)
        27. Table of Contents Plugin (org.randombits.confluence.toc, Version: 2.3.2)
        28. Atlassian Plugin Repository (confluence.repository.client, Version: 2.0.4)
        29. User Listener (confluence.extra.userlister, Version: 1.2)
        30. Space Advanced Sections (confluence.sections.space.advanced, Version: 1.0)
        31. Clickr Theme (com.atlassian.confluence.themes.clickr, Version: 0.9.1)
        32. WebDAV Plugin (confluence.extra.webdav, Version: 1.1)
        33. IM Presence NG Plugin (confluence.extra.impresence2, Version: 2.0-rc2)
        34. Space Labels Sections (confluence.sections.space.labels, Version: 1.0)
        35. Space Actions Sections (confluence.sections.space.actions, Version: 1.0)
        36. Tabular Metadata (confluence.extra.masterdetail, Version: 1.0)
        37. Information Macros (confluence.extra.information, Version: 0.2)
        38. Live Search Macros (confluence.extra.livesearch, Version: 1.6)
        39. Confluence Usage Stats (com.atlassian.confluence.ext.usage, Version: 0.7.2)
        40. Global Labels Sections (confluence.sections.labels, Version: 1.0)
        41. Page View Links (confluence.sections.page.actions, Version: 1.0)
        42. Layout Macros (confluence.extra.layout, Version: 0.2)
        43. Profile Tabs (confluence.sections.profile, Version: 1.0)
        44. Core Listeners (confluence.listeners.core, Version: 1.3)
        45. Space Admin Sections (confluence.sections.space.admin, Version: 1.0)

Lisää makroja voi asentaa vain Confluencen ylläpitäjä (Helsingin yliopiston opetusteknologiakeskus). Jos haluat Nelli-wikiin uuden makron, ilmoita siitä Nelli-toimistoon, niin lähetämme pyynnön eteenpäin.

Katso lisää makroilla työskentelystä.

Searching Nelli

Sivut, joissa käsitellään aihetta "wiki" tai "ohjeet"

Page: Nelli-wikin muokkaus
Page: Huomioitavaa Nelli-hauissa
Page: Lehtivalinta
Page: Loppukäyttäjille suunnatut Nelli-ohjeet
Page: Nelli ja SRU
Page: Lyhytlinkit Nelliin
Page: Käännöstiedostot
Page: Nelli ja Zotero

 

Labels:
wiki wiki Delete
ohjeet ohjeet Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.