{"canonical_url":"https://engineer.company/nb/glossary/gemtext/","content_markdown":"# gemtext\n\n## Hva det er\n\nGemtext er dokumentformatet til protokollen Gemini: ren UTF-8-tekst der de første tegnene på hver\nlinje avgjør hva linjen er, slik at en klient kan rendre en hel side i én gjennomgang fra topp til\nbunn. Spesifikasjonen kaller det Gemini-hypertekstformatet, på engelsk «Gemini hypertext format».\nServere merker det med medietypen `text/gemini`, og filene slutter etter fast skikk på `.gmi`.\n\nFormatet har seks slags linjer. En linje som begynner med `=\u003e`, er en lenke, laget av en adresse,\nabsolutt eller relativ, og en valgfri etikett etter den. En linje med tre backticks slår\nforhåndsformatert modus av eller på, og alt som står mellom to slike linjer, vises nøyaktig som det\ner skrevet, i en font med fast tegnbredde. Ett, to eller tre `#`-tegn gir en overskrift, en stjerne\nfulgt av et mellomrom gir et listepunkt, og et `\u003e`-tegn gir et sitat. Alle andre linjer er vanlig\ntekst, og klienten bryter dem til bredden på den skjermen de havner på.\n\n```text\n# Field notes\n\nA text line is a paragraph, however long it runs. The client wraps it.\n\n=\u003e /archive/ Older notes\n=\u003e gemini://example.org/ A capsule elsewhere\n\n* A list item\n\u003e A quoted line\n```\n\nSpesifikasjonen deler de seks i tre kjernetyper som alle klienter må håndtere (tekst, lenker og\nbryteren for forhåndsformatering), og tre som en minimal klient har lov til å vise som ren tekst.\nMer er det ikke. Fet skrift, kursiv, tabeller, innebygde bilder, nesting og klikkbare ord midt i en\nsetning står alle utenfor formatet. En parser holder styr på én eneste bit med tilstand: om den\nbefinner seg inne i en forhåndsformatert blokk.\n\nGemtext sammenlignes oftest med Markdown, som det ligner ved første øyekast. Forskjellen ligger i\nhva de to er til for. En Markdown-fil er kildetekst, skrevet for å bli konvertert til noe annet. En\ngemtext-fil er allerede det ferdige dokumentet, og leserens klient er den eneste som rendrer den.\nDen ene strukturelle vanen sin, lenken på en egen linje, har formatet lånt fra de eldre menyene i\nGopher.\n\n## Hvorfor det er viktig\n\nÅ velge gemtext er å velge hvem som styrer siden. Forfatteren bestemmer strukturen: hvilke linjer\nsom er overskrifter, hvilke som er lenker, og hvor koden står. Leserens klient bestemmer alt annet,\nfra skrifttype og linjelengde til farge, luft og om overskriftene blir til en innholdsfortegnelse.\nSpesifikasjonen sier rett ut at formatet ikke er ment å gi forfattere presis kontroll over\npresentasjonen. For noen utgivere er det en lettelse, for andre setter det punktum for hele\nsamtalen, og det lønner seg å vite hvilken gruppe dere hører til før dere konverterer en eneste\nside.\n\nLettelsen ligger i det som forsvinner. En gemtext-side består av ord og lenker og ingenting annet:\nstilark, skript, webfonter, varsler om informasjonskapsler og sporingspiksler har ingen plass i den,\nog det eneste som noen gang må oppdateres, er ordene. Sidene er små og raske å skrive for hånd.\nLenker henter aldri noe av seg selv, fordi spesifikasjonen forbyr en klient å åpne en\nnettverksforbindelse bare for å vise en lenke. En side kan dermed aldri trekke inn et bilde eller en\nfont fra en tredjepart bak ryggen på leseren.\n\nKostnaden er like konkret. Gemtext når bare folk som bruker en Gemini-klient, og det er et lite\npublikum ved siden av webens. Inndata ber en kapsel om gjennom en statuskode i protokollen, aldri\ngjennom noe i selve dokumentet, for skjemafelt har formatet ikke. Og prosaen må klare seg uten\ninnebygde lenker. En setning skrevet for HTML, «se prissiden for detaljer», beholder ordene og\nmister pekeren, så å skrive god gemtext betyr å skrive setninger som fortsatt gir mening når lenken\nstår på linjen under.\n\nDerfor er det realistiske spørsmålet for de fleste virksomheter gemtext i tillegg til et nettsted,\nikke gemtext i stedet for et, produsert fra den samme kilden av det samme bygget. Stilt slik koster\ngemtext lite å legge til, og formatet fungerer samtidig som en prøve på skrivingen. Hvis en side\nfortsatt leses klart som en kolonne av tekstlinjer og lenkelinjer, lå strukturen i ordene hele\ntiden.\n\n## Slik ser det ut i praksis\n\nDette nettstedet publiseres som gemtext ved siden av HTML-en. Siden\n[Engineer i en terminal](/nb/cli/) oppgir kapselens adresse, `gemini://engineer.company/`, sier at\nhver side på nettstedet også finnes i formatet, og nevner klienter som leser det: Amfora, Lagrange\nog Bombadillo i en terminal, Castor og Kristall i et vindu. Den gir også begrunnelsen. Én\nproduksjonssetting skriver én mappe som alle inngangsdørene leser, så gemtext-kopien holder seg i\ntakt med HTML-en, og en side som leses godt som gemtext, er en side der strukturen er ekte og ikke\nmalt på.\n\nHvordan det ble bygd, er beskrevet i [gjennomgangen av speilingen av nettstedet til Gemini og Gopher](/nb/portfolio/mirrored-the-site-to-gemini-and-gopher/). Gemtext er et utdataformat fra det samme bygget, ikke en separat verktøykjede. Nettstedsgeneratoren fikk egendefinerte medietyper og utdataformater, og hver side, seksjon og taksonomiterm fikk et Gemini-dokument ved siden av HTML-en og Markdown-tvillingen sin: 777 dokumenter på det dokumenterte implementeringstidspunktet, servert av en liten daemon på samme vert. De nye formatene er merket som ikke-alternative representasjoner. En separat sammenligning av bygg målte null endrede HTML-byte da disse formatene ble lagt til; den målte ikke senere redaksjonelle eller visuelle endringer.\n\nMalene bak den kopien viser hva en konvertering til gemtext innebærer. Hver innebygd lenke løftes ut\nav setningen sin: ordene blir stående der setningen trenger dem, og adressen flyttes ned under\nteksten som en egen `=\u003e`-linje. Markeringene for fet skrift fjernes, punkter med bindestrek blir til\nstjerner, og en kodeblokk mellom tre backticks går gjennom urørt, fordi kodegjerdet i Markdown og\nbryteren for forhåndsformatering i gemtext er de samme tre tegnene.\n\n## Hvor det går galt\n\n### Halve linjer som blir stående hver for seg\n\nProsaen kommer fram i klienten som en ujevn kolonne av korte linjer, brutt midt i setningsleddene.\nKilden var hardt brutt ved 80 kolonner, slik Markdown-filer ofte er, og spesifikasjonen forbyr en\nklient å slå sammen påfølgende korte tekstlinjer til lengre linjer. Skriv hvert avsnitt som én lang\nlinje, eller la konverteringsverktøyet slå sammen myke linjeskift før det skriver filen.\n\n### Lenker som fører ut av kapselen\n\nDen første lenken en leser følger, åpner en nettleser. Konverteringsverktøyet skrev hver lenke som\nen absolutt `https://`-adresse, og en Gemini-klient sender slike adresser videre til et annet\nprogram. Skriv navigasjonen som rotrelative stier som `/about/`, som tolkes relativt til kapselens adresse, og\nbehold én bevisst lenke per side til webversjonen.\n\n### Kode som klapper sammen til én linje\n\nEt kodeeksempel vises som én lang linje klistret til åpningsgjerdet. Konverteringsverktøyet\nbehandlet blokken som prosa og slo sammen linjene med alt det andre. Del dokumentet opp ved\ngjerdene før noe annet steg, send hver forhåndsformatert blokk gjennom slik den er skrevet, og la\nbryterlinjen bære høyst en kort alternativtekst, for eksempel navnet på språket.\n\n### Markdown som blir til bokstavelige tegn\n\nPunkter med bindestrek, doble stjerner, understrekede overskrifter, nestede lister og lenker i\nhakeparenteser dukker opp i klienten nøyaktig slik de ble skrevet. Gemtext kjenner bare igjen en\nstjerne og et mellomrom som listepunkt og `#`-tegn som overskrift, og formatet har ingen oppmerking inne i linjene. Konverter disse konstruksjonene på vei ut, eller skriv kapselen direkte i\ngemtext.\n\n### Setninger som peker ut i løse luften\n\nEt avsnitt sier «klikk her» eller «som lenket ovenfor», og leseren blir stående uten å vite hvor det\nskal gå videre. Lenken ble løftet ut av setningen, og ordene som ble igjen, sa aldri hvor de førte.\nSkriv lenketekster som navngir målet sitt, slik at både setningen og `=\u003e`-linjen gir mening hver for\nseg.\n\n## Les mer\n\n- [A quick introduction to gemtext markup](https://geminiprotocol.net/docs/gemtext.gmi) —\n  prosjektets egen korte gjennomgang av alle linjetypene, med merknader for den som kan Markdown.\n- [Gemini hypertext format specification](https://geminiprotocol.net/docs/gemtext-specification.gmi)\n  — den normative teksten: linjetyper, parsertilstand, regler for linjebryting, parameteren `lang`\n  og en formell grammatikk.\n- [Gemini network protocol specification](https://geminiprotocol.net/docs/protocol-specification.gmi)\n  — hvordan en kapsel serverer gemtext: forespørsler, statuskoder og TLS-reglene en klient følger.\n- [Project Gemini FAQ](https://geminiprotocol.net/docs/faq.gmi) — begrunnelsen bak designet, blant\n  annet hvorfor lenker står på egne linjer.\n\n\u003chttps://engineer.company/nb/glossary/gemtext/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvordan gemtext, dokumentformatet i Gemini, bygges opp av linjer, hvorfor leserens klient styrer utseendet, og hvor Markdown-vaner ødelegger en kapsel.","formats":{"gemtext":"https://engineer.company/nb/glossary/gemtext/index.gmi","gopher":"https://engineer.company/nb/glossary/gemtext/gophermap","html":"https://engineer.company/nb/glossary/gemtext/","json":"https://engineer.company/nb/glossary/gemtext/index.json","markdown":"https://engineer.company/nb/glossary/gemtext/index.md","pdf":"https://engineer.company/nb/glossary/gemtext/index.pdf"},"kind":"page","language":"nb","title":"Hva er gemtext?","url":"https://engineer.company/nb/glossary/gemtext/","version":1}