Sharp Diagrams: Mermaid-kaaviot Confluenceen ja Jiraan
Kirjoita kaavio tekstinä, niin Sharp Diagrams piirtää siitä terävän ja zoomattavan kuvan Confluence-sivulle tai Jira-tikettiin. Sovelluksia on kaksi, yksi kummallekin tuotteelle, ja ne tulevat Atlassian Marketplaceen.

Mikä Sharp Diagrams on?
Sharp Diagrams piirtää Mermaid-kaaviot tekstistä: Confluencessa sivulle lisättävänä makrona ja Jirassa tiketin paneelissa. Mermaid on tekstimuoto, jolla kirjoitetaan vuokaavioita, sekvenssikaavioita, Gantt-kaavioita ja muita kaavioita.
Sovelluksia on kaksi, ja niissä on sama kaaviomoottori. Sharp Diagrams – Mermaid for Confluence tuo Confluenceen kaaviomakron, jossa on muokkain ja esikatselu. Sharp Diagrams – Mermaid for Jira piirtää tiketin kuvauksen mermaid-koodilohkot paneeliin. Asenna se, jota käytät, tai molemmat.
Tiedot eivät lähde Atlassianilta. Sovellukset toimivat Atlassianin Forge-alustalla, eivät ota yhteyttä muualle eivätkä tallenna mitään omaa, vaan kaavion koodi pysyy Confluence-sivulla tai Jira-tiketissä.
Miten Mermaid-kaavio lisätään Confluenceen ja Jiraan?
Kaaviotyypit ja niiden kirjoitustapa ovat Mermaidin omassa ohjeessa: mermaid.js.org (englanniksi).
Confluence
- Muokkaa sivua, kirjoita /mermaid ja valitse Mermaid diagram.
- Kirjoita Mermaid-koodi vasemmalle tai valitse pohja kohdasta Start from.
- Esikatselu oikealla päivittyy sitä mukaa kuin kirjoitat. Jos koodissa on virhe, virheilmoitus ja rivinumero näkyvät koodin alla.
- Valitse Save ja julkaise sivu. Kun myöhemmin haluat muuttaa kaaviota, muokkaa sivua, valitse kaavio ja paina muokkauspainiketta (kynä).
Jira
- Lisää tiketin kuvaukseen koodilohko, valitse sen kieleksi mermaid ja kirjoita kaavion koodi lohkoon.
- Avaa tiketti ja valitse Mermaid diagrams otsikon alla olevasta sovelluspainikkeesta. Sen jälkeen paneeli pysyy tiketissä.
- Jokaisesta kuvauksen mermaid-koodilohkosta tulee paneeliin oma kaavionsa. Kun muutat kuvausta, lataa tiketti uudelleen, niin uusi kaavio näkyy.
Ominaisuudet
Esikatselu kirjoittaessa
Kirjoita Mermaid-koodi vasemmalle, niin kaavio piirtyy oikealle. Virheestä näkyy viesti ja rivinumero, ja viimeisin toimiva kaavio jää näkyviin.
Pohjat 11 kaaviotyypille
Vuokaavio, sekvenssi-, luokka-, tila-, ER- ja Gantt-kaavio, miellekartta, aikajana, piirakkakaavio, käyttäjäpolku ja Git-kaavio. Muokkain kysyy ennen kuin pohja korvaa oman koodisi.
Terävä kaavio oikeassa koossa
Kaavio piirretään SVG-kuvana sivun tai paneelin levyiseksi, ja se pysyy terävänä zoomattaessa. Hyvin leveää kaaviota pienennetään vain 75 prosenttiin, jotta teksti pysyy luettavana.
Zoomaus, lataus ja kopiointi
Zoomaa 50–300 % ja sovita kaavio taas leveyteen. Lataa kaavio SVG-kuvana tai kaksinkertaisena PNG-kuvana dioja ja dokumentteja varten. Koodin voi kopioida.
Kaaviot Jira-tiketin kuvauksesta
Jokaisesta kuvauksen mermaid-koodilohkosta tulee oma kaavionsa, joten samassa tiketissä voi olla vaikkapa vuokaavio ja sekvenssikaavio. Muihin koodilohkoihin sovellus ei koske.
Vaalea ja tumma tila
Kaaviot seuraavat Confluencen ja Jiran väritilaa. Tummassa tilassa ne piirretään Mermaidin tummalla teemalla.
PDF- ja Word-vienti
Confluence tekee viennit palvelimillaan, joilla kaaviota ei voi piirtää, joten vientiin tulee kaavion koodi. Kuvan saa dokumenttiin lataamalla sen PNG- tai SVG-muodossa.
Tiedot pysyvät Atlassianilla
Ei yhteyksiä Atlassianin ulkopuolelle eikä omaa tallennusta. Jirassa paneeli lukee kuvauksen katsojan omilla oikeuksilla, joten se näyttää vain sen, minkä katsoja muutenkin näkee.
Hinnoittelu
Enintään 10 käyttäjää
Ilmainen.
100 käyttäjää
250 dollaria vuodessa.
Hinta koskee kumpaakin sovellusta erikseen. Laskutuksen hoitaa Atlassian. Muiden käyttäjämäärien hinnat näkyvät Atlassian Marketplacessa, kun sovellukset on julkaistu. Ilmaisen tason käyttäjät saavat saman tuen kuin maksavat asiakkaat.
Kuvia sovelluksista






Usein kysytyt kysymykset
Mitä Sharp Diagrams maksaa?
Enintään 10 käyttäjälle se on ilmainen. Sadalle käyttäjälle hinta on 250 dollaria vuodessa. Hinta koskee kumpaakin sovellusta erikseen, ja laskutuksen hoitaa Atlassian.
Tarvitaanko molempia sovelluksia?
Ei tarvita. Confluence-sovellus piirtää kaaviot Confluence-sivuille ja Jira-sovellus Jira-tikettien kuvauksista. Asenna se, jota käytät, tai molemmat.
Mitä kaaviotyyppejä Sharp Diagrams tukee?
Mermaidin kaaviotyyppejä, esimerkiksi vuokaaviota, sekvenssi-, luokka-, tila-, ER- ja Gantt-kaaviota, miellekarttaa, aikajanaa, piirakkakaaviota, käyttäjäpolkua ja Git-kaaviota. Confluencen muokkaimessa on pohja näille 11 tyypille.
Miten kaavio lisätään Jira-tikettiin?
Lisää tiketin kuvaukseen koodilohko, jonka kieli on mermaid, ja avaa tiketin Mermaid diagrams -paneeli. Jokaisesta mermaid-koodilohkosta tulee oma kaavionsa. Kun muutat kuvausta, lataa tiketti uudelleen, niin uusi kaavio näkyy.
Näkyykö kaavio PDF- ja Word-viennissä?
Vientiin tulee kaavion koodi koodilohkona ja maininta siitä, että kuva on sivulla. Confluence tekee viennit palvelimillaan, joilla kaaviota ei voi piirtää. Kuvan saa dokumenttiin lataamalla sen PNG- tai SVG-muodossa.
Lähteekö tietoja Atlassianin ulkopuolelle?
Ei. Sovellukset toimivat Atlassianin Forge-alustalla eivätkä ota yhteyttä muualle. Ne eivät tallenna mitään omaa, vaan kaavion koodi pysyy Confluence-sivulla tai Jira-tiketissä.
Suoritetaanko kaavioiden linkit ja HTML?
Ei. Kaaviot piirretään katsojan selaimessa Mermaidin tiukalla turvatasolla (strict), joten kaavioiden linkkejä, napsautustoimintoja ja HTML:ää ei suoriteta.
Mitä tapahtuu, jos lisenssi ei ole voimassa?
Kaaviota ei piirretä, vaan sen koodi näytetään. Sisältöä ei katoa.
Tuki ja ehdot
Tuki: support@hdsoft.fi, maanantaista perjantaihin klo 9–17 Suomen aikaa, suomeksi ja englanniksi. Vasteajat ja tietoturvailmoitukset ovat tukisivulla (englanniksi).
Ohje: käyttöohje (englanniksi).
Tietosuoja: tietosuojaseloste (englanniksi).
Ehdot ja muut sovellukset: Jira- ja Confluence-sovellukset.
Tulossa Atlassian Marketplaceen
Sharp Diagrams tulee Confluence Cloudiin ja Jira Cloudiin Atlassian Marketplacen kautta. Ohjeesta näet jo nyt, miten se toimii.
Atlassian, Jira ja Confluence ovat Atlassianin tavaramerkkejä. Sovellukset tekee ja niitä tukee HD SofT.
