Innehåll

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).