Skriva och redigera

Med frontend-redigering påslagen (Themes → Groovy Docs → Editing) och ett konto med rätt att ändra sidor (editor) får menyn ⋮ vid sidans titel fler val.

Site-Admin och System-Admin

Det som gäller hela sajten, och det som gäller alla sajter, ligger inte i ⋮ utan i två kontrollpaneler. Två ikoner i sidhuvudet leder dit:

• Site-Admin gäller sajten du står på (/<sajt>/site-admin). Du ser bara de avsnitt du får använda:

  • Åtkomst: vem som får läsa sajten (Åtkomst);
  • Inställningar: sajtens preset, vilka funktioner som är på och sajtens identitet: logga, länkar i sidhuvudet och sidfot (Editors och site-admins → Inställningar);
  • Papperskorg: papperskorgen (Radera och papperskorg), bara med frontend-redigering påslagen;
  • Hälsokontroll: det som går att rätta i sajten (Hälsokontroll);
  • Members: medlemmar och grupper (Medlemmar och grupper);
  • Site: titel, beskrivning, taggar, lås och begäran om att sajten tas bort (Editors och site-admins → Site). Finns bara i en installation med flera sajter.

  En editor ser bara Papperskorg. Övriga avsnitt är site-adminens.

• System-Admin gäller hela installationen (/system-admin, på grundsajten). Den ser system-admin och super-admin:
  • Sajter: registret över alla sajter (Skapa en sajt);
  • Taggar: den gemensamma tagglistan (Taggar);
  • Temainställningar: temats inställningar för hela installationen, för super-admin (Temainställningar);
  • Presets: utseendet (Presets);
  • Domain accounts, för super-admin (Åtkomst).

En kontrollpanel ser inte ut som sajten. Uppe till vänster står System-Admin, eller sajtens namn och Site-Admin. Sajtens meny, sökning och sidfot är borta. Till vänster finns panelens egen meny, ett avsnitt i taget; på en smal skärm ligger menyn överst. Tillbaka till sajten i sidhuvudet (på en smal skärm en pil) tar dig tillbaka till sidan du kom ifrån, också om du har bytt mellan panelerna.

Har du inget att göra i en panel syns inte ikonen, och adressen svarar som en sida som inte finns. Panelerna kräver inte frontend-redigering. Varje panel kan stängas av i Temainställningar eller i Themes → Groovy Docs: Site-Admin med Show Site-Admin (fliken Editing), System-Admin för hela installationen med Show System-Admin (i Temainställningar fliken Whole installation). En super-admin kan också stänga Site-Admin för en enda sajt, i sajtens Site-Admin → Inställningar.

• Ny sida här: en ny undersida till den sida man står på. Titeln är det enda som krävs.
• Dolda sidor (visible: false i filen, eller en mapp utan nummer) står i sidomenyn bara för dig som får redigera sajten, nedtonade och med ett överstruket öga, med sina undersidor under sig. Läsarna ser dem inte i någon meny, men når dem på adressen och i sökningen (om sidan inte har Utelämna ur sökningen). Sektionskorten, föregående/nästa och undersidelistor visar dem inte, inte heller för dig.
• Redigera sidan (Cmd/Ctrl+E): redigera direkt på sidan.
  • Välj läge längst till höger på titelraden: Editor (block), Markdown eller Förhandsvisning.
  • Filen sparas alltid som Markdown.
  • Överst ligger en rad med Spara och Avbryt och vyerna Text · Inställningar · Bilagor · Historik. Raden följer med när du rullar.
  • Cmd/Ctrl+S sparar, Esc avbryter.
• Inställningar visar sidans egna inställningar i textens plats, som kort: Vem får läsa, Meny, Taggar (när taggar är på), På sidan, Export och Utseende.
  • Med versioner på har en versions startsida också kortet Version, med etiketten som visas i versionsväljaren, versionens status (Beta, Utfasad eller ingen) och en egen bannertext. Bannertexten ersätter meningen för statusen. Länken till den aktuella versionen läggs alltid till efter den, och den texten följer gränssnittets språk. Områdets sida har där valet Aktuell version: vilken version adresser utan version leder till. Det valet sparas för sig, med knappen Spara aktuell version, och gäller direkt, också medan sidan har ett opublicerat utkast.
  • Texten ligger kvar medan du ställer in. Välj Text för att gå tillbaka; inget går förlorat.
  • En prick vid Inställningar och vid kortets namn visar vad du har ändrat men inte sparat.
  • Spara sparar text och inställningar ihop. Vem får läsa har en egen knapp och gäller direkt (se Åtkomst).
• Bilagor visar sidans filer (se Bilagor). Historik visar tidigare versioner (se Sidans historik).
• Titel, beskrivning och sidhuvudets utseende ändrar du direkt i texten.
• Har någon annan sparat sidan sedan du började visas en konfliktruta, där du väljer att ladda deras version eller spara din ändå.

Allt skrivs som vanlig Markdown, så att texten går att läsa även utan temat. Blockeditorn har egna block för det mesta nedan.

Länkar

Skriv länkar till sidor i samma sajt utan sajtens namn, från sajtens början:

[Installation](/komma-igang/installation)
[Sökning](/guider/sok#filter)

I blockeditorn, i stycken, listor och tabellceller: markera texten och välj länkverktyget. Skriv eller klistra in adressen, eller välj bland förslagen, och tryck Enter. Markera en länk för att se och ändra dess adress; länkknappen tar då bort länken, och ett tömt adressfält med Enter gör samma sak.

Relativa länkar fungerar också ([Sök](../sok)). Adressen till sajten läggs till när sidan visas, så länken håller även om sajten byter namn eller flyttas. Har en länk ändå sajtens namn först tas det bort vid visning; filen ändras inte.

Klistrar du in en hel adress till den egna sajten (https://…/guider/sok) blir den en sådan länk (/guider/sok). När du sparar görs samma sak med resten av sidans länkar. Hela adresser i löptext och i HTML-länkar lämnas som de står.

Till en annan sajt, eller från en sajt till grundsajten, går det inte med en sådan länk: den pekar alltid in i den egna sajten. Skriv då hela adressen (https://…) eller en HTML-länk (<a href="/annan-sajt/sida">text</a>), som visas precis som den står.

HTML i texten

Det mesta skrivs bäst som Markdown. HTML i texten visas bara så långt det är säkert för den som läser. Skript, formulär, ramar (utom i embed-kod), SVG-bilder och attribut som kör något visas inte, och en länk till javascript: eller data: blir vanlig text. Det gäller oavsett vem som skrev sidan. Taggar som <kbd>, <mark>, <abbr>, <sup>, <sub> och <details> fungerar som vanligt.

Ikonlänkar

En länk får en ikon före texten om du ger den titeln icon och ikonens namn:

Öppna [inställningarna](/installningar "icon settings") när du vill.
Se även [Inställningar](/installningar "icon settings only").

Med only visas bara ikonen. Texten blir då det som visas när muspekaren vilar på ikonen och det en skärmläsare läser upp, så skriv den ändå.

Ikonerna är desamma som menyikonerna (Lucide), till exempel settings, download och book-open. Ett namn som inte finns ger en vanlig länk.

I blockeditorn: markera texten, välj länkverktyget och skriv ikonens namn i fältet under adressen. Kryssa i Bara ikonen för att visa bara ikonen.

Knappar

En eller flera knappar på en rad. Varje knapp är en länk på en egen rad:

> [!BUTTONS center]
> [Kom igång](/kom-igang "icon rocket")
> [Läs guiden](/guider "secondary icon book-open")
> [Ladda ner](https://example.test/fil.pdf "secondary")

• Efter BUTTONS kan du skriva center (centrerat) och large (större knappar).
• I titeln efter adressen: secondary ger en knapp med bara kontur. Utan det ordet får knappen sajtens accentfärg. icon och ett namn ger en ikon före texten. Titeln kan utelämnas helt.
• En ensam knapp skrivs på samma sätt, med en enda rad.

I blockeditorn är det blocket Knappar: en rad per knapp med text, länk, ikon och variant. Knapparna skrivs ut med kontur.

Band

Ett avsnitt med egen bakgrund, bredare än texten, till exempel ett mörkt band med en uppmaning och knappar:

> [!BAND dark center]
> ## Redo att börja?
>
> En mening om vad som händer sedan.
>
> > [!BUTTONS]
> > [Kom igång](/kom-igang)

• Efter BAND: bakgrunden och center (centrerat). Bakgrunden är light (en ljus ton, standard), dark (nästan svart), en av heroernas bakgrunder eller en av sajtens egna heroes.
• Bandet går över hela innehållsytan, och över hela fönstret på en sida utan sidomeny. Texten står kvar i textens spalt.
• Knappar, kort och centrerad text i bandet skrivs som ett citat i citatet, med > > först på varje rad.

I blockeditorn är det blocket Band: välj bakgrund bland färgrutorna och skriv rubrik, text och knappar. Ett band med kort i redigeras som Markdown.

Kort

En rad kort, till exempel tre saker sajten erbjuder. Varje kort börjar med raden [!CARD] och kan ha en ikon efter ordet:

> [!CARDS 3 center]
> [!CARD rocket]
> ### Snabbt
> Sidorna laddar direkt.
>
> [Läs mer](/om/snabbt)
>
> [!CARD shield-check]
> ### Säkert
> Inloggning med e-post.

• Efter CARDS: antal kolumner (2, 3 eller 4), center och plain (utan ram). Utan tal blir det lika många kolumner som kort, högst fyra. På en mobil står korten under varandra.
• Ikonen är ett namn ur samma ikonsamling som ikonlänkarna.
• Länken sist i kortet är valfri. Den gör hela kortet klickbart. Den ska vara en sökväg i sajten eller en adress som börjar med http.
• Kortens rubriker står inte i innehållsförteckningen.

I blockeditorn är det blocket Kort. Varje kort redigeras som det ser ut, och ikonen väljs i fältet överst i kortet.

Centrerad text

Ett eller flera stycken i mitten av sidan, till exempel en ingress på en startsida:

> [!CENTER large]
> ## Välkommen
>
> En mening eller två om vad sajten handlar om.

• large ger större text. Utan ordet har texten vanlig storlek.
• Rubriken är valfri.
• Knappar under texten skrivs som ett citat i citatet: > > [!BUTTONS] och knapparnas rader med > > först.

I blockeditorn är det blocket Centrerad text. Välj storleken i blockets överkant.

Hänvisningsrutor

> [!NOTE]
> Bra att veta.

Typerna är NOTE, TIP, IMPORTANT, WARNING och CAUTION. I rutan går stycken, listor, kod, citat, tabeller och andra rutor. Rader som hör till rutan börjar med >, också de tomma.

I blockeditorn är det blocket Hänvisningsruta. Välj typ i rutans rubrik. Innehållet redigeras som vanliga block inne i rutan: Enter ger ett nytt stycke i rutan, / ett annat slags block, och "+" och handtaget står till höger i rutan. Klicka utanför rutan för att skriva vidare under den.

Rutor

En ruta samlar fritt innehåll i en neutral ram, med en ikon eller en bild bredvid:

> [!BOX book-open]
> **Läs mer**
>
> - [Installation](/komma-igang/installation)
> - [Sökning](/guider/sok)

• Ordet efter BOX är en ikon (samma namn som menyikonerna, till exempel book-open eller message-circle) eller en bild: ett filnamn bland sidans filer (maskot.png) eller en sökväg från sajtens början (/images/maskot.png).
• Utan ord blir det en ruta utan ikon.
• I rutan går allt som går på sidan: stycken, listor, bilder, tabeller, hänvisningsrutor och andra rutor. En ruta i rutan skrivs med > > först på raderna.
• Rutan har sajtens neutrala färger, inte hänvisningsrutornas.

I blockeditorn är det blocket Ruta. Skriv ikonens namn eller välj Bild… i blockets överkant. Innehållet redigeras som vanliga block inne i rutan; deras "+" och handtag står till höger i rutan.

Steg

Ett steg är en ram med en bokstav eller en siffra, en rubrik och fritt innehåll:

> [!STEP]
> **Öppna inställningarna**
>
> 1. Välj *Inställningar* i menyn.
> 2. …

• Temat ritar bokstaven eller siffran. Stegen numreras löpande på sidan: [!STEP] är nästa (det första på sidan blir 1), [!STEP A] eller [!STEP 1] sätter värdet och ordningen fortsätter därifrån (A, B, C). [!STEP plain] är en stegruta utan bokstav eller siffra, och räknas inte.
• Rubriken är ett första stycke i fetstil eller en rubrik (###). En rubrik står i innehållsförteckningen och går att länka till.
• I steget går allt som går på sidan: listor, bilder, tabeller, hänvisningsrutor och rutor.
• I Word och på Markdown-adressen står etiketten före rubriken: A. Rubrik.

I blockeditorn är det blocket Steg. Välj Nästa i ordningen, Börja på… eller Ingen bokstav eller siffra och rubrikens form i blockets överkant. Bokstäverna och siffrorna i editorn är sidans.

Utfällbara avsnitt

Ett avsnitt som läsaren fäller ut och ihop:

> [!DETAILS]
> **Vad hämtar analysen?**
>
> - Ägare och adresser

• Rubriken (fetstil eller en rubrik) är det läsaren klickar på. open efter DETAILS visar innehållet från början.
• Avsnitt direkt efter varandra står ihop som ett dragspel.
• En utskrift, Word-filen, Markdown-adressen och sökningen har alltid hela innehållet.
• En länk till en rubrik i ett stängt avsnitt fäller ut det.

I blockeditorn är det blocket Utfällbart avsnitt. I editorn står avsnittet alltid utfällt; Öppet från början bestämmer hur läsaren ser det.

Interna anteckningar

En anteckning som bara editors ser, till exempel något att göra eller att kontrollera före nästa version:

> [!INTERNAL]
> Kontrollera skärmbilden när nästa version kommer.

• Bara den som får redigera sidan ser anteckningen, med en streckad ram och etiketten Intern. För alla andra finns den inte: den tas bort på servern innan sidan visas.
• Den följer aldrig med i en utskrift, i Word-filen, i Markdown-filen (Kopiera och Ladda ner, sidans .md-adress och sektionens fil), i sökningen, i llms.txt eller till AI-verktyg som läser sidan, inte ens för en editor. En export delas vidare.
• Den går att lägga i ett steg, en ruta eller ett avsnitt. Ett steg, en ruta eller ett avsnitt som bara har en anteckning syns inte alls för läsaren.
• Site-Admin → Interna anteckningar visar hur många anteckningar sajten har och vilka sidor de står på, med en länk till varje.
• Anteckningen står i sidans fil. Den som läser filen själv, eller ser sidan i ett annat tema, ser den som ett vanligt citat.

I blockeditorn är det blocket Intern anteckning.

Delad text

En text som ska stå likadant på flera sidor skrivs en gång, på en egen sida, och visas på de andra med en rad:

> [!INCLUDE /delat/kontakt]

• Sökvägen är sidans väg inom sajten, från roten, utan sajtens namn.
• Läsaren ser texten som en del av sidan. Ändrar du källsidan syns det direkt på alla sidor som visar den.
• Bara den som får läsa källsidan ser texten. Har källsidan strängare regler för vem som får läsa den än sidan, ser de andra läsarna ingenting där. Du som redigerar ser då en markering: Alla som läser sidan ser inte texten nedan. Samma regel gäller utskrift, Word, Markdown och AI-verktyg som läser sidan.
• I sökningen hittas sidan på den delade textens ord bara när alla som får läsa sidan också får läsa källan.
• Saknas sidan, är den inte publicerad, eller visar den i sin tur sidan du står på, visas ingenting, och du ser en markering med skälet. Delad text i delad text går högst tre nivåer djupt.
• Källsidans interna anteckningar följer inte med. Dess bilder och länkar pekar på källsidan, dess steg fortsätter sidans numrering och dess rubriker står i innehållsförteckningen.
• Lägg källsidorna samlat, dolda i menyn, och kryssa i Utelämna ur sökningen i sidans Inställningar (kortet Meny). Annars hittas texten två gånger i sökningen.
• Du som redigerar sajten hittar de dolda källsidorna i sidomenyn: de står nedtonade, med ett överstruket öga. Läsarna ser dem inte där.

I blockeditorn är det blocket Delad text. Skriv sidans titel eller väg och välj bland förslagen. Blocket visar texten som den står på källsidan; den ändras där, med Öppna sidan.

Bild med numrerade punkter

En skärmbild med siffror på, där läsaren pekar på en siffra (eller trycker på den) och ser vad delen heter och gör:

> [!HOTSPOTS]
> ![Översikt](oversikt.png?classes=shadow)
>
> 1. [20%, 10%] **Meny** Här väljer du vad du vill göra.
> 2. [85%, 60%, sw] **Karta** Här ser du resultatet.

• Bilden står först, ensam på sin rad. Sedan en numrerad lista med en punkt per rad.
• Platsen är procent av bildens bredd och höjd: först från vänster, sedan uppifrån. Siffrans spets står på platsen, och siffran hänger nedåt åt höger. Ett tredje ord ändrar hållet för siffran och förklaringen: sw nedåt vänster, ne uppåt höger, nw uppåt vänster. Använd det för en punkt nära bildens högra kant eller nederkant.
• Titeln är den feta texten direkt efter platsen; resten är texten.
• Siffrorna följer bilden i alla bredder, också på mobilen. Förklaringen öppnas när läsaren pekar på siffran, går till den med Tab eller klickar på den, och stängs med Esc eller ett klick utanför.
• Listan syns inte på sidan, men skärmläsare läser den. I utskrift står siffrorna på bilden och listan under. Word och Markdown har bilden och listan, och sökningen hittar titlarna och texterna.
• Bildens bredd, sida och skugga gäller som för andra bilder.

I blockeditorn är det blocket Bild med numrerade punkter. Välj en av sidans bilder och klicka på bilden där en punkt ska stå. Dra en siffra för att flytta den. Skriv titel och text i raden under bilden, och välj åt vilket håll förklaringen öppnas.

Heroes

En banner, antingen överst på sidan (välj den under titeln i redigeringsläget) eller i texten:

> [!HERO ocean tall center]
> ## Rubrik
> Text under rubriken.

Det finns 16 färdiga bakgrunder: gray, blue, teal, yellow, pink, ink, indigo, ocean, twilight, berry, ember, forest, night, dawn, mist och mint. Sajten kan också ha egna heroes, med toning eller bild, i sajtens preset. De väljs på samma sätt, överst på sidan och i texten, med sitt namn.

I texten kan du efter bakgrunden skriva:

• compact eller tall för höjden, och center för centrerad text;
• dark-text eller light-text för textens färg;
• button-accent, button-outline och button-large för knappen;
• en egen färg i stället för ett namn, som #5c3d2e.

En länk sist i heron blir knappen. En bild ur sidans mapp blir bakgrunden, med en mörk ton över:

> [!HERO night tall center]
> ## Egen bild som bakgrund
>
> En mening om sidan.
>
> [Läs mer](/guider)
>
> ![](landskap.png)

Heron överst kan ha en knapp under beskrivningen. Skriv knappens text och länk under titeln i redigeringsläget, och välj färg och storlek. Båda behövs. Länken är en sida i sajten (/guider), en webbadress som börjar med http eller https, eller en e-postadress (mailto:).

En andra knapp kan stå bredvid den första, med samma regler för länken. Den har bara en kontur, i herons textfärg.

Heron överst kan ha bilden under texten i stället för bakom den: välj Bild under texten under titeln i redigeringsläget. Rubrik, text och knappar står då överst på bakgrunden, och bilden stor under dem.

Med Text i en panel över bilden visar heron bara bilden. En yta i sidans egen bakgrund går upp över bildens nederkant, med vägen till sidan, titeln, beskrivningen och knapparna mitt i. Det passar bäst som fotobanner över hela bredden.

Heron överst kan också bli en fotobanner över hela fönstrets bredd, kant i kant under sidhuvudet, med menyn under. Välj Hela fönstret vid Bredd under titeln i redigeringsläget. Den passar bäst med en bild och centrerad text. En hero i sajtens preset kan ha bredden inställd, så att alla sidor som använder den får den. Väljer sidan Spalten stannar heron i spalten. Medan du redigerar visas heron i spalten.

Undersidor

En innehållsförteckning över sidans undersidor, här två nivåer med beskrivningar:

> [!SUBPAGES 2 descriptions]

Grupprubriker i menyn

En sida kan visas som en rubrik i menyn, som inte går att klicka på, med undersidorna under sig. Slå på Render as group label i sidans inställningar i Admin.

Sektionskorten

Ett kort per avsnitt på toppnivån i sajten, med ikon, titel och beskrivning. Startsidan är en vanlig sida och får inte korten av sig själv: lägg in dem där du vill ha dem, till exempel sist på startsidan. Raden under är rubriken över korten och kan utelämnas:

> [!SECTIONS]
> Avsnitt

I blockeditorn är det blocket Sektionskort.

• Korten är desamma som toppmenyn visar: varje läsare ser bara de avsnitt den får läsa.
• Ikonen är sidans Menu icon, beskrivningen dess Beskrivning.

Listan över sajterna

En lista över installationens sajter, med titel och beskrivning. Lägg den där läsarna ska hitta alla dokumentationer, till exempel på grundsajtens startsida. Raden under är listans rubrik och kan utelämnas:

> [!SITES]
> Våra dokumentationer

I blockeditorn är det blocket Sajter.

• Varje läsare ser bara de sajter den får läsa. En gäst ser bara sajter som är öppna för alla. En sajt som läsaren inte får se finns inte någonstans i sidan, inte heller dess beskrivning.
• Sajten du står på är med, markerad och utan länk.
• Har sajterna gemensamma taggar grupperas listan per tagg, som i sajtväljaren.
• Titel och beskrivning ändras i registret (se Skapa en sajt → Ändra en sajt).
• Site-adminernas namn kan visas under varje sajt, för inloggade läsare. Det är av från början. Slå på det i Admin på grundsajten: Plugins → Subsites → Site-admins' names in the list of sites. Då visas namnet på site-adminens konto, aldrig e-postadressen. En site-admin utan namn på kontot visas inte. Editors namn visas inte.
• Förhandsvisningen i editorn visar din egen lista. En läsare kan se färre sajter.

Inbäddningar

En länk med titeln embed, ensam i sitt stycke, visas som spelare eller ram: video, ljud, PDF, Word, PowerPoint, Excel, YouTube och Vimeo.

[Instruktionsfilm](film.mp4 "embed")
[Rutin](rutin.docx "embed 600 50% right")

Talen är höjd i pixlar, bredd och sida.

• PDF, Word, PowerPoint och Excel ritas i läsarens webbläsare. Inget skickas till någon annan tjänst.
• Ikonen i hörnet öppnar filen i en större vy, med Download.
• En vanlig länk till filen, utan embed, öppnar samma vy.

Bilder

Bredd, placering, skugga och linje sätts med klasser:

![Skärmbild](bild.png?classes=docs-w-50,docs-right,shadow,docs-border)

• shadow ger bilden en skugga.
• Bilder har ingen linje runt sig. docs-border ger bilden en tunn linje, i sajtens linjefärg och med rundade hörn. Linjen följer med i utskrift och i Word.
• Klick på en bild öppnar den i dialogen, i full storlek.
• I blockeditorn finns Bredd, Höjd, Placering, Skugga och Linje i bildblockets meny.

En bild blir aldrig högre än en viss del av fönstret, som standard 65 %. Bredden minskar då, så att bilden behåller sina proportioner. Gränsen ställs in i sajtens preset (Highest image height). En stor skärmbild tar alltså aldrig över hela skärmen.

En enskild bild kan få en fast högsta höjd, så att bilder med samma val ser lika ut på alla sidor:

![Dialogen](dialog.png?classes=docs-h-medium)

• docs-h-small, docs-h-medium och docs-h-large är högst 12, 20 och 30 rem (ungefär 190, 320 och 480 pixlar). I editorn: Höjd → Liten, Mellan eller Stor. Temats gräns tar bort valet.
• En bild som redan är lägre än steget visas i sin egen storlek.
• Med både bredd och höjd gäller den gräns som slår till först.
• På mobilen blir bilden aldrig bredare än texten.

En bild på en rad med text blir en ikon: lika hög som raden, utan ram och skugga, och den öppnas inte i dialogen.

Klicka på ![Spara](spara.png) för att spara.

Ändra inte bildens storlek i adressen (?resize=, ?cropZoom=); temat sätter ikonens storlek.

En bild ensam på sin rad i en tabellcell (en logga bredvid en länk, till exempel) har sin egen storlek. Den kan få en fast storlek med en klass:

| ![Kartan](karta.png?classes=docs-size-small) | [Kartan](/karta) |

• docs-size-icon är lika hög som en textrad.
• docs-size-small, docs-size-medium och docs-size-large är 3, 6 och 12 rem breda (ungefär 48, 96 och 192 pixlar), aldrig bredare än kolumnen.
• Utan klass visas bilden i filens storlek, högst så hög som gränsen för bilder.
• Stegen här är bredder för loggor och ikoner. De är inte samma som bildblockets höjdsteg ovan.

I blockeditorn syns ikonen i texten som på sidan, i stycken, listor, rubriker, hänvisningsrutor och tabellceller. Lägg till en: markera ordet som bilden ska stå för, välj bildknappen i menyn som visas och klicka på en av sidans bilder. Ordet byts mot bilden och blir dess alternativtext. Ta bort en ikon som ett tecken, med Backspace. Bildens adress, titel och skugga står kvar som de var när du ändrar texten runt den.

Klicka på en bild i texten eller i en tabellcell så öppnas en liten meny under den:

• Alternativtext: vad bilden visar.
• Storlek (Ikon, Liten, Mellan, Stor, Som filen), Skugga och Linje (en linje runt bilden): bara för en bild ensam på sin rad. En ikon på en rad med text är alltid lika hög som raden och har ingen linje.
• Byt bild…: en av sidans bilder, eller Ladda upp… för en ny.
• Ta bort tar bort bilden.

Bara det du väljer ändras i bildens Markdown. Esc eller ett klick utanför stänger menyn. Står bilden längst ner i fönstret öppnas menyn ovanför den.

Tabeller

Ett citat runt en tabell ger val för just den tabellen:

> [!TABLE striped first-25]
>
> | Namn | Vad den gör |
> |------|-------------|
> | A    | Det första  |

• striped ger varannan rad en ljus bakgrund.
• plain tar bort linjerna och rubrikradens bakgrund.
• first-15, first-20, first-25, first-33, first-40 och first-50 ger första kolumnen den andelen av tabellen.
• middle och full finns också. Tabeller är redan centrerade i höjd och lika breda som texten, så orden ändrar inget i dag.
• Låt raden med > efter markören stå kvar: utan den ser andra program ingen tabell.

I blockeditorn finns Randig, Utan linjer och Första kolumnen i tabellblockets meny. En tabell med bilder i cellerna öppnas som tabellblock, och en ändrad cell ändrar bara sin egen rad i filen. Utseendet kan också göra alla tabeller randiga (Striped tables i preseten).

Bilagor … i menyn ⋮, eller Bilagor i redigeringsläget, visar sidans filer. På en bred skärm står listan till höger om texten medan du redigerar; annars öppnas den som en panel.

• Ladda upp genom att välja filer eller släppa dem i listan. Släpper du filer på texten i redigeringsläget laddas de upp och länkas där markören står.
• Byt namn, ersätt, skriv en beskrivning eller flytta till papperskorgen. Byter du namn uppdateras länkarna på sidan.
• Filerna följer sidans skydd: den som inte får läsa sidan kommer inte åt dess filer.
• Vilka filtyper som får laddas upp styrs av Allowed file extensions (Themes → Groovy Docs → Attachments).
  • Från början tillåts pdf, png, jpg, jpeg, gif, svg, webp, zip, docx, xlsx, pptx, csv, txt och mp4.
  • En annan filtyp nekas, med ett meddelande som säger vilka som går. Behöver sajten fler typer lägger en administratör till dem i listan.
  • Listan gäller också filer som laddas upp i Admin, till en sida eller till sajternas gemensamma media (Media), och också när redigeringen på sajten är av.
  • Låt jpg vara med: stillbilderna för video, PDF och Office-filer är jpg.

Historik … i menyn ⋮, eller Historik i redigeringsläget, visar sidans tidigare versioner, om sidhistoriken är påslagen (Site-Admin → Inställningar → Page history, eller Themes → Groovy Docs → Editing → Page history).

• Varje sparning från redigeringsläget blir en version. Sparningar i Admin blir det inte; de syns som Ändrad utanför editorn nästa gång sidan sparas här.
• Välj en version för att se vad som ändrades, jämfört med versionen före, med den aktuella texten eller med en annan version.
• Återställ den här versionen lägger tillbaka hela sidan som den var. Det blir själv en version, så det går att ångra.
• Med utkast påslaget blir varje publicering en version, Publicerad, med vem som skrev utkastet. Sparningar av utkastet blir inga versioner. Återställ den här versionen blir då sidans utkast (ett utkast sidan redan har ersätts): läsarna ser inget förrän du publicerar det.
• Flytt, kopiering och papperskorg syns som rader i historiken.
• Bara sidans text har historik, inte dess filer.

• Ta bort sidan … flyttar sidan, med alla undersidor, till sajtens papperskorg. Du hamnar på föräldern och kan ångra direkt. Finns föräldern inte längre när du ångrar kommer du till papperskorgen, som frågar var sidan ska ligga.
• Har en undersida en egen sidregel (permissions i sidhuvudet) som nekar dig att radera den, går hela raderingen inte. Meddelandet säger vilken undersida det gäller. Detsamma vid flytt och kopiering (Flytta och kopiera sidor).
• En sida som raderas i Admin, eller av ett program via API:t, hamnar också i papperskorgen, med undersidor. Admins fråga säger This cannot be undone, men sidan går att återställa. Startsidan går inte att radera.
• Detsamma gäller en fil som raderas från en sida i Admin eller via API:t.
• En fil som raderas i Admins Media (sajternas gemensamma filer) hamnar i papperskorgen i den sajt där du raderade den, märkt gemensamma medier. Likaså den gamla filen när du laddar upp en ny fil med samma namn där: den nya ersätter den, och den gamla ligger i papperskorgen. Bara super-admin kan återställa den. Den går tillbaka till sin mapp; finns där redan en fil med samma namn får den återställda -restored i namnet.
• Site-Admin i sidhuvudet → Papperskorg visar papperskorgen: återställ, radera permanent eller töm.
• Som editor kan du återställa men inte radera permanent eller tömma papperskorgen: det gör bara super-admin. Det du lagt där ligger kvar tills den töms automatiskt.
• En återställd sida hamnar där den låg, en fil på sin sida (också om sidorna fått nya nummer). Finns inte föräldern kvar (den är raderad eller flyttad) frågar papperskorgen var sidan ska ligga, för en fil vilken sida den ska till: välj och Återställ här. En sida läggs sist där. Ändrar den nya platsen vem som får läsa, eller versionen, visas en varning som vid flytt: kryssa i rutan och tryck Återställ här igen.
• Papperskorgen töms automatiskt efter ett antal dagar (Themes → Groovy Docs → Editing → Trash). Med flera sajter ställs det in i bas-sajtens Admin och gäller alla sajter. Ett schemalagt jobb tömmer då korgarna varje natt (Schemalagda jobb).
• Varje sajt har sin egen papperskorg.

⋮ → Flytta eller kopiera … gäller sidan du står på. Valet finns på alla sidor utom sajtens rot.

• Flytta den flyttar sidan med alla undersidor, filer och historik. Välj ny förälder (Lägg den under, med filter) och plats bland sidorna där: Sist, Först eller efter en viss sida. Sidorna där får nya nummer när du väljer Först eller Efter. En sida utan nummer (dold i menyn) förblir utan nummer och dold; platsvalet visas inte då.
• Kopiera den kopierar bara sidan eller sidan med undersidor. Ge kopian en titel och adress (förifyllt med "(kopia)"). Filerna följer med, historiken inte: kopian börjar om.
• Granska visar vad som händer innan något ändras: gammal och ny adress, hur många sidor och filer, och vilka sidor som har länkar som ändras.
• Länkarna följer med vid flytt. Länkar i sajtens sidor som pekar på den gamla adressen (eller en undersida) ändras till den nya, och relativa länkar som flytten skulle bryta rättas. En ändrad länk skrivs utan sajtens namn (se Innehåll → Länkar). Länkar i kodblock och kod ändras aldrig, inte heller länkar till andra sajter. Gick en sida inte att ändra säger meddelandet efter flytten vilken; rätta den för hand. Med sidhistoriken på syns ändringen som Länkar uppdaterade efter en flytt och kan ångras där. En kopia ändrar inga länkar.
• Varning och kryssruta när flytten eller kopian ändrar vem som får läsa sidorna (en skyddad sida ovanför kommer till eller försvinner) eller när sidan hamnar i en annan version. Kryssa i rutan för att gå vidare.
• En undersidas regel kan stoppa åtgärden. Har en undersida en egen sidregel (permissions i sidhuvudet) som nekar dig att ändra den går flytten inte, och nekar den dig att läsa den går kopian med undersidor och Ny version från… inte. Granska säger vilken undersida det gäller. Kopian av bara sidan påverkas inte.
• Startsidan kan inte flyttas. En sida kan inte flyttas in under sig själv. Versionsområdets egen sida och en hel version flyttas i Admin.

Ångra en flytt

Vad: Ångra flyttar sidan tillbaka dit den låg, med samma nummer som förut. Länkarna som flytten ändrade blir som före flytten.

Var: i meddelandet Flyttad. nere till höger, direkt efter flytten. Det syns i 8 sekunder.

När: bara direkt efter flytten. Det går inte när någon annan hunnit flytta, kopiera, radera, återställa eller skapa en sida i sajten efter din flytt. Flytta då tillbaka sidan med Flytta eller kopiera.

Vem: den som flyttade sidan, och super-admin.

Hur det blir:

• Har någon ändrat en sida med sådana länkar efter flytten får den sidan stå kvar som den är. Meddelandet säger vilka sidor det gäller; rätta länkarna där för hand.
• Med sidhistoriken på syns både flytten och ångringen i historiken.

En kopia ångrar du genom att radera den. Den hamnar i papperskorgen.

Ny version

Vad: Ny version från… skapar nästa version av en dokumentation med versioner, till exempel 3.0 utifrån 2.0. Hela versionen kopieras, med undersidor, filer och bilagor.

Var: står du på en sida inne i en version finns valet under Kopiera den i Flytta eller kopiera.

Hur:

1. Välj vilken version du kopierar. Den aktuella är förvald.
2. Skriv etiketten, till exempel 3.0. Titel och adress fylls i efter etiketten; du kan ändra dem.
3. Granska visar den nya adressen, hur många sidor och filer som kopieras och hur många länkar som ändras.
4. Klicka Skapa versionen. Den nya versionen öppnas.

Vad som händer:

• Den nya versionen hamnar först bland versionerna.
• Den är dold: läsarna ser den inte i versionsväljaren eller i sök, men den finns på sin adress. Du kan arbeta i den i lugn och ro.
• Den blir inte aktuell version. Läsarna hamnar fortfarande i den version som var aktuell.
• Länkar i kopian som pekar in i versionen du kopierade från pekar nu på den nya. Länkar på andra sidor ändras inte.
• Historiken följer inte med; den nya versionen börjar om.

När den är klar: att visa den i väljaren och göra den aktuell görs i Admin, av den som har tillgång dit.

Vem: den som får flytta och kopiera sidor. Inte i en låst sajt.

• I en låst sajt kan editors inte flytta eller kopiera.

Med utkast påslaget (Site-Admin → Inställningar → Drafts, eller Themes → Groovy Docs → Editing → Drafts; varje sajt väljer själv) sparar redigeringsläget till ett utkast. Läsarna ser den publicerade sidan tills en editor publicerar. Utan utkast sparas allt direkt till sidan, som förut.

Spara och publicera

• Spara utkast (Cmd/Ctrl+S) sparar utkastet och lämnar editorn öppen. Brickan Utkast visar att sidan har ett utkast, och vem som sparade det senast och när.
• Publicera… sparar det som inte är sparat och publicerar sidans utkast: en ruta visar vad som publiceras innan något händer.
• Kasta utkastet kastar utkastet; sidan är då det läsarna ser. På en ny sida som aldrig publicerats lägger det sidan i papperskorgen, varifrån den kan återställas med sitt utkast.
• En sida med utkast har en rad överst (bara för editors) med Redigera utkastet och Publicera….

Publicera en sektion

Publicera utkast … i menyn ⋮ listar utkasten på sidan och allt under den, eller i hela sajten (Hela sajten), med vem som skrivit och när. Publicera publicerar exakt den listan. Har ett utkast sparats om medan listan var öppen publiceras det inte; det står vilka som lämnades och varför.

Har sidan ändrats på annat sätt sedan utkastet påbörjades (till exempel i Admin) varnar listan: en publicering ersätter sidans titel och text med utkastets. Kryssa i rutan för att gå vidare.

Nya sidor

Ny sida här skapar sidan opublicerad. Bara editors når den. I editorns meny står den med märket Utkast; läsarna ser den inte i menyn, sökningen eller exporten, och den kan inte exporteras, inte heller av en editor. Den blir synlig för läsarna när den publiceras första gången; listan varnar för det och du kryssar i rutan.

Det här går inte via utkast

Flytta, kopiera, ordna, radera och bilagor gäller direkt, som förut. Utkasten följer med när en sida flyttas eller byter adress (också i Admin), läggs i papperskorgen och återställs. En kopia får inget utkast, och en ny sida på samma plats som en raderad tar aldrig över dess utkast.

Utkast utan sida

Raderas en sida direkt på servern, eller hamnar en annan sida på dess plats, kan ett utkast bli utan sida. Det publiceras aldrig. Publicera utkast … listar sådana utkast under Utkast utan sida: Koppla till den här sidan gör det till utkastet för sidan du står på (om den inte redan har ett), Kasta kastar det. Gäller andra åtkomstregler eller en annan version för sidan du står på än där utkastet skrevs, eller vet temat inte var det skrevs, får du bekräfta kopplingen först. Hälsokontrollen i Admin varnar också för dem. Publicering och versioner ändras bara i Admin. Vem som får läsa sidan väljs i Inställningar (Vem får läsa) och gäller direkt, utan utkast (se Åtkomst).

Två som redigerar samma sida

En sida har ett utkast. Sparar någon annan utkastet medan du redigerar visas en ruta som säger vem och när: Hämta deras version laddar deras, Spara min ändå skriver över med ditt.

I en låst sajt går det varken att spara utkast eller publicera.

En tagg är ett ord på en sida, till exempel Installation. Taggen visas under sidans titel. Läsaren klickar på den och får alla sidor med samma tagg. Taggar hjälper läsaren att hitta sidor som hör ihop, också när de ligger i olika delar av menyn.

Två sorters taggar

Skriver en editor en egen tagg med samma namn som en gemensam, blir den den gemensamma.

Slå på taggarna

Båda sorterna är av från början. Sajtens site-admin slår på dem i Site-Admin → Inställningar. Super-admin kan också göra det i Admin under Themes → Groovy Docs → Tags:

• Common tags: de gemensamma taggarna;
• The site's own tags: sajtens egna.

Med flera sajter väljer varje sajt själv, till exempel egna taggar på i bara en sajt. En sajt får aldrig grundsajtens val. Är en sort av syns den inte och går inte att söka på, men ingenting tas bort från sidorna.

Sätta taggar på en sida

Du behöver kunna redigera sidan (se Redigera).

1. Öppna sidan med Redigera sidan och välj Inställningar i raden överst.
2. I kortet Taggar: kryssa i de gemensamma taggar som passar.
3. Skriv egna taggar i fältet Sajtens taggar. Komma eller Enter lägger till en tagg. Förslagen är taggar som redan används i sajten.
4. Spara sidan. Med utkast på syns taggarna för läsarna när sidan publiceras (se Utkast och publicering).

I Admin sätts de gemensamma taggarna under sidans flik Docs (Common tags) och de egna under Options (Tag).

• En tagg gäller bara sidan, inte dess undersidor.
• I en sajt med versioner gäller taggen sidan i den versionen.
• Taggar följer inte med i export och utskrift.

Hitta sidor med en tagg

• Klicka på en tagg under en sidas titel. Sökningen öppnas med taggen som filter.
• Skriv tag: i sökrutan, till exempel tag:installation följt av mellanslag. Taggen blir ett filter överst i rutan.
• Flera taggar: sidan ska ha alla.
• Utan söktext listas alla sidor med taggen. Med tomt sökfält visas taggarna som finns, med antal sidor.

Läsaren ser bara taggar på sidor den får läsa. En skyddad sida syns varken i sökningen eller genom sina taggar.

Förvalta de gemensamma taggarna

Listan är gemensam för alla sajter. Den förvaltas av system-admin och av super-admin, i System-Admin. Andra ser inte avsnittet.

Öppna System-Admin i sidhuvudet, från vilken sajt som helst, och välj Taggar. Där kan du:

• lägga till en tagg: ett namn och en nyckel. Nyckeln är det sidorna sparar och det man skriver efter tag:. Den föreslås ur namnet och ändras aldrig;
• byta namn (Byt namn): alla sidor med taggen visar det nya namnet direkt. Det gamla namnet fungerar fortfarande på sidorna;
• slå ihop två taggar (Slå ihop med en annan tagg): sidorna med den ena får den andra;
• ta bort (Ta bort): taggen syns inte längre. Sidorna behåller den i filen, så att den kommer tillbaka om taggen läggs till igen med samma nyckel.

Ingen sida skrivs om vid en ändring. Varje ändring kan ångras med Ångra i meddelandet. Listan visar aldrig var en tagg används, eftersom sidorna kan ligga i sajter som förvaltaren inte ska se.

Taggar på sajter

System-admin och super-admin kan ge varje sajt gemensamma taggar, till exempel en produktgrupp. Sajtväljaren grupperar då sajterna per tagg.

1. Öppna System-Admin i sidhuvudet och välj Sajter.
2. Välj Ändra vid sajten.
3. Kryssa i taggarna under Taggar och spara. Meddelandet har Ångra.

• Taggarna visas som brickor vid sajten i listan. Klicka på en bricka för att se alla sajter med den taggen.
• Bara gemensamma taggar kan sättas på sajter.
• Du kan tagga sajterna innan gemensamma taggar slås på. Sajtväljaren grupperar först när Common tags är på.

Hur grupperingen ser ut för läsaren: Sajter → Sajtväljaren.