Antora

Utvecklingsverktyg

Antora är en statisk dokumentationsplattformsgenerator som samlar AsciiDoc-innehåll från ett eller flera git-repository till en komplett, versionerad dokumentationssajt.

Betyg 78 av 100 Preliminär (källbaserad)

Läs bedömningen
API · Officiellt

Officiell CLI-dokumentation (HTTP 200).

Antora CLI · Antora-projektet

Källa: https://docs.antora.org/antora/latest/cli/

Kontrollerat:

MCP · Ej hittat

Kontrollerat i officiellt MCP-register, npm och GitHub-sökning; ingen MCP-integration för Antora.

Källa: https://registry.modelcontextprotocol.io/v0/servers?search=antora

Kontrollerat:

Antoras standardgränssnitt med Nordljus AB:s driftdokumentation: vänstermeny med Översikt, Drift, Nätverk, Runbook och Releaseflöde, sidans rubrik, tabellen över dokumentationsområden och miljötabellen med portal, databas och filarea
1 / 8 Den byggda driftdokumentationen – startsidan med innehållsförteckning och miljötabell

Bedömning

Så bedömer vi

Totalbetyg

78 av 100

Preliminär (källbaserad)

Bedömningsprofil
Ett utvecklingsteam publicerar sina interna API-dokument med Antora: varje tjänst ligger i eget repo, playbook-filen samlar dem och sajten byggts om vid varje release.
Bedömningsdatum
Modellversion
3.0.0
  1. Öppenhet och kontroll

    MPL-2.0 enligt LICENSE i det officiella GitLab-repot (verifierad via postens källor 2026-10-27); OSI-godkänd licens med full rätt att läsa, ändra, återdistribuera och drifta själv. Utdatan är en statisk sajt utan formatlåsning och kan servas var som helst.

  2. Funktionell passform

    Playbook-filen samlar AsciiDoc-innehåll från flera git-repository till en versionerad sajt med komponent-/versionsväljare — exakt det angivna docs-as-code-fallet enligt antora.org och docs.antora.org. Kända lucker: inga ändringar i webbläsaren och ingen serversidessökning i grunden, men de träffar inte kärnbehovet i användningsfallet.

  3. Dataflytt och interoperabilitet

    Innehållet lagras i AsciiDoc-filer i git (öppna format) och utdata är en komplett statisk sajt som kan publiceras och servas var som helst enligt antora.org. Inget särskilt API för dataförflyttning finns, men för en generator är in- och utdatans portabilitet dokumenterad och täckande; vissa dynamiska funktioner (sök på serversidan) ingår inte.

  4. Mognad och trygghet

    Aktivt sedan 2018 (npm-registryts historik för @antora/cli), regelbundna utgåvor som git-taggar i GitLab-repot och genomarbetad officiell dokumentation på docs.antora.org med tydligt ekosystem kring AsciiDoc. Inga motstridiga källor.

  5. Framtidskraft

    Modulärt CLI på Node.js som körs i pipelines och kan skriptas vid varje release; de @antora/*-paket som dokumenteras i repots devdocs kan användas programmatiskt. Webhooks, SDK eller agent-/MCP-integration finns inte dokumenterat i postens källor, så nivå 4 nås inte.

  6. Drift och införande

    Installeras med npm (npm install -g @antora/cli @antora/site-generator), körs som CLI mot en playbook och ger statisk utdata som servas med valfri webbserver — direkt dokumenterat på docs.antora.org. Löpande drift är försumbar: ingen serverkod, uppgradering via ny paketversion.

  7. Kostnadsbild

    MPL-2.0 utan licenskostnad enligt LICENSE i repot. Kostnadsbilden är därmed tydlig på licenssidan, men driftkostnader (Node-miljö, byggtid i pipeline, förvaring av utdata) får beräknas själv — per regel ger gratis licens 3, inte 4.

  8. Svensk användbarhet

    Namngiven negativ kontroll: källkodsträden för antora/antora och antora/antora-ui-default (GitLab-API, verifierat 2026-10-27) innehåller inga lokaliserings- eller översättningskataloger, och docs.antora.org serveras med lang="en". Ingen svensk lokalisering, dokumentation eller support är belagd — engelskspråkigt CLI som tekniskt fungerar i Sverige.

Om Antora

Antora är en dokumentationsplattformsgenerator för skribenter som skriver i AsciiDoc. Ni lagrar dokumentationen i ett eller flera git-repository, och en playbook-fil samlar innehållet och genererar en komplett statisk webbplats. Komponenter och versioner modelleras först: dokumentationen versioneras med git-grenar precis som programvara, så flera utgåvor kan publiceras sida vid sida.

Antora körs som ett kommandoradsverktyg på Node.js och installeras med npm. Utdatan är en statisk sajt som kan publiceras var som helst och servas med valfri webbserver, vilket gör driftbelastningen i labbet försumbar: bygg en testsajt, serva utdatan lokalt och fotografera den. Innehållet skrivs i AsciiDoc-filer som versioneras tillsammans med koden. Eftersom byggresultatet är statiskt kan sajten genereras i en pipeline vid varje ändring och publiceras utan serverkod.

Verktyget passar team som vill driva dokumentation som kod: flera team kan äga var sitt innehålls- och versionschema eftersom innehållet ligger i separata repository. Den ersätter inte en wikimiljö med redigering i webbläsaren; ändringar sker i git och publiceras genom en ny generering.

Användning

Passar för

  • Publicera en versionerad produktdokumentation skriven i AsciiDoc
  • Samla dokumentation från flera team och git-repository i en sajt
  • Versionera dokumentation med grenar, sida vid sida i webbgränssnittet
  • Generera en statisk sajt att serva i labbet eller bakom webbserver

Passar mindre bra för

  • Wikier med redigering direkt i webbläsaren, där en wiki-motor passar bättre
  • Ad hoc-dokument utan git- och AsciiDoc-arbetsflöde
  • Sajter med dynamiskt innehåll, sökning på serversidan eller användarkonton

Styrkor och begränsningar

Styrkor

  • Bygger en komplett statisk dokumentationssajt från en playbook-fil
  • Inbyggd komponent- och versionsmodell baserad på git-grenar
  • Flera repository kan aggregeras till en sajt med egna versionscheman
  • Statisk utdata som kan publiceras och servas var som helst
  • Modulärt verktyg på Node.js som installeras med npm

Begränsningar

  • Kräver AsciiDoc och git-arbetsflöde; inga ändringar i webbläsaren
  • Kommandoradsverktyg utan eget webbgränssnitt för administration
  • Serversidssökning och dynamiska funktioner ingår inte i grunden

Skärmbilder

Tekniska resurser

Alternativ

Jupyter

Utvecklingsverktyg · Interaktiv beräkningsmiljö i notebook-format

Project Jupyter är ett paraplyprojekt för interaktiv beräkning: notebook-gränssnitt som Jupyter Notebook och JupyterLab, fleranvändarplattformen JupyterHub och öppna standarder för körbara dokument.

Startår
2015
Licens
BSD 3-Clause License (Modified BSD)
Öppen källkod
Ja

Betyg

92 av 100

Preliminär (källbaserad)

Läs bedömningen om Jupyter

Projektdata

13 459GitHub-stjärnor
Visa alla fakta och bedömningarVisa alla fakta
Startår
2015
Licens
BSD 3-Clause License (Modified BSD)Öppen källkod (OSI-godkänd licens) · Repot jupyter/notebook anger BSD 3-Clause License (Modified BSD) och jupyterlab/jupyterlab likaså; PyPI klassar båda paketen som 'License :: OSI Approved :: BSD License'. Projektet är alltså OSI-godkänd öppen källkod (BSD-3-Clause). · Licensmodeller
Öppen källkod
Ja
Plattformar
Windows · macOS · Linux · Webbläsare · containers
API
REST API Verifierat
Export
Finns Notebooks sparas som .ipynb (JSON) och kan exporteras till HTML, PDF, LaTeX, Markdown med flera format med hjälp av nbconvert, ett officiellt Jupyter-projekt. Ej verifierat
Språk
Gränssnitt: Engelska · Dokumentation: Engelska · Support: Engelska
Öppenhet och kontroll Gäller: BSD-3-Clause (OSI), full kodfrihet och öppet notebook-format — inga låsningar.
Funktionell passform Gäller: Interaktiv beräkning och notebooks är exakt Jupyter kärna; täcker användningsfallet utan luckor.
Dataflytt och interoperabilitet Gäller: .ipynb är ett öppet JSON-format, nbconvert exporterar till många format och kernel-protokollet är öppet — fullt portabel.
Mognad och trygghet Gäller: Sedan 2014, industristandard inom data science, mycket stort ekosystem.
Framtidskraft Gäller: Kernel-protokoll, REST-API och nbconvert möjliggör automation.
Drift och införande Gäller: Lätt att installera lokalt; serverdelning (JupyterHub) är väldokumenterad och hanterbar.
Kostnadsbild Gäller: Fri BSD-licens utan avgifter; transparent totalkostnad.
Svensk användbarhet Gäller: Engelskt gränssnitt/dokumentation; ingen svensk lokalisering belagd — tekniskt användbart i Sverige.

Kostnad: .

Faktakontrollerad

Bruno är en API-klient som lagrar sina samlingar som vanliga textfiler i projektmappen, så att API-testerna blir en del av kodbasen. För skrivbord och kommandorad.

Startår
2022
Licens
MIT
Öppen källkod
Ja

Betyg

84 av 100

Preliminär (källbaserad)

Läs bedömningen om Bruno

Projektdata

48 162GitHub-stjärnor
Visa alla fakta och bedömningarVisa alla fakta
Startår
2022
Licens
MITÖppen källkod (OSI-godkänd licens) · Avser det öppna GitHub-projektet. Produktfamiljen innehåller även betalda erbjudanden. · Licensmodeller
Öppen källkod
Ja
Plattformar
Windows · macOS · Linux
API
Annan Verifierat
Export
Ej verifierat Ej verifierat
Språk
Gränssnitt: Engelska · Dokumentation: Engelska · Support: Engelska
Öppenhet och kontroll Gäller: MIT (OSI), full kodfrihet, offline-first utan molntvång.
Funktionell passform Gäller: API-klient och testning med öppna, filbaserade samlingar täcker användningsfallet fullt ut.
Dataflytt och interoperabilitet Gäller: Samlingar som öppna filer (Bru/JSON) ger god portabilitet; formatet är dock Bruno-specifikt.
Mognad och trygghet Gäller: Sedan 2022, aktivt, men yngre med mindre ekosystem.
Framtidskraft Gäller: CLI och samlingar-som-kod möjliggör automation; agentintegration sker via CLI:et.
Drift och införande Gäller: Desktop-app + CLI, enkel drift.
Kostnadsbild Gäller: Fri MIT-kärna; molntjänster/enterprise valfria.
Svensk användbarhet Gäller: Engelskt gränssnitt/dokumentation; ingen svensk lokalisering belagd.

Kostnad: .

Faktakontrollerad

Källor