# Skriva och redigera > Handbok · 2026-10-30 · https://groovy.simplo.dev/handbok/skriva Redigera direkt på sidan: text, innehåll, bilagor, historik, papperskorg, flytta och kopiera, utkast och publicering, taggar. Med **frontend-redigering** påslagen (Themes → Groovy Docs → Editing) och ett konto med rätt att ändra sidor ([editor](https://groovy.simplo.dev/handbok/atkomst/redaktorer)) 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å (`//site-admin`). Du ser bara de avsnitt du får använda: - *à tkomst*: vem som får läsa sajten ([à tkomst](../atkomst)); - *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](https://groovy.simplo.dev/handbok/atkomst/redaktorer)); - *Papperskorg*: papperskorgen ([Radera och papperskorg](https://groovy.simplo.dev/handbok/skriva/papperskorg)), bara med frontend-redigering påslagen; - *Hälsokontroll*: det som går att rätta i sajten ([Hälsokontroll](https://groovy.simplo.dev/handbok/drift/halsokontroll)); - *Members*: medlemmar och grupper ([Medlemmar och grupper](../atkomst/medlemmar)); - *Site*: titel, beskrivning, taggar, lås och begäran om att sajten tas bort ([Editors och site-admins → Site](https://groovy.simplo.dev/handbok/atkomst/redaktorer)). 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](../kom-igang/skapa-en-sajt)); - *Taggar*: den gemensamma tagglistan ([Taggar](https://groovy.simplo.dev/handbok/skriva/taggar)); - *Temainställningar*: temats inställningar för hela installationen, för super-admin ([Temainställningar](https://groovy.simplo.dev/handbok/utseende/installningar)); - *Presets*: utseendet ([Presets](https://groovy.simplo.dev/handbok/utseende/presets)); - *Domain accounts*, för super-admin ([à tkomst](../atkomst)). 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*. > [!SUBPAGES 1 descriptions] ## Redigera en sida Ny sida, redigeringsläget och sidans 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](../../atkomst)). - **Bilagor** visar sidans filer (se [Bilagor](https://groovy.simplo.dev/handbok/skriva/bilagor)). **Historik** visar tidigare versioner (se [Sidans historik](https://groovy.simplo.dev/handbok/skriva/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å. > [!NOTE] > Startsidan kan redigeras men inte raderas. ## Innehåll Länkar, ikonlänkar, knappar, hänvisningsrutor, rutor, steg, utfällbara avsnitt, interna anteckningar, heroes, undersidor, sektionskorten, listan över sajterna, inbäddningar, bilder och tabeller. 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: ```markdown [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](https://groovy.simplo.dev/handbok/skriva/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 (`text`), 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 ``, ``, ``, ``, `` och `
` fungerar som vanligt. ### Ikonlänkar En länk får en ikon före texten om du ger den titeln `icon` och ikonens namn: ```markdown Ö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: ```markdown > [!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: ```markdown > [!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: ```markdown > [!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: ```markdown > [!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 ```markdown > [!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: ```markdown > [!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: ```markdown > [!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: ```markdown > [!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: ````markdown > [!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: ````markdown > [!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: ````markdown > [!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: ```markdown > [!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: ```markdown > [!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: ```markdown > [!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: ```markdown > [!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: ```markdown > [!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](https://groovy.simplo.dev/handbok/kom-igang/skapa-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. ```markdown [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: ```markdown ![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: ```markdown ![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. ```markdown 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: ```markdown | ![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: ```markdown > [!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 Sidans filer: ladda upp, byt namn, ersätt och ta bort. **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. ## Sidans historik Jämför tidigare versioner och återställ en. **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](https://groovy.simplo.dev/handbok/skriva/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. ## Radera och papperskorg Raderade sidor och filer går att återställa. - **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](../flytta-kopiera)). - 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](https://groovy.simplo.dev/handbok/drift/schemalagda-jobb)). - Varje sajt har sin egen papperskorg. ## Flytta och kopiera sidor Flytta en sida till en annan plats i sajten, kopiera den eller skapa en ny version. **⋮** → **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. ## Utkast och publicering Spara utan att läsarna ser det, och publicera en sida eller en hel sektion när den är klar. 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](../../atkomst)). ### 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. ## Taggar Märk sidor och sajter med ord som läsaren kan filtrera på: gemensamma taggar och sajtens egna. 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 | | Gemensamma taggar | Sajtens egna taggar | |---|---|---| | **Vad** | Samma ord i alla sajter, ur en lista | Fria ord, bara i den sajten | | **Vem bestämmer orden** | Den som förvaltar listan (nedan) | Sajtens editors, direkt på sidan | | **Passar för** | Ord som ska betyda samma sak överallt | Ord som bara den sajten behöver | | **Kan sättas på sajter** | Ja | Nej | 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](https://groovy.simplo.dev/handbok/skriva/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](https://groovy.simplo.dev/handbok/skriva/utkast)). 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](https://groovy.simplo.dev/handbok/kom-igang/sajter).