Hoppa till huvudinnehåll

Internationalisering och versionering

Docusaurus gör det enkelt att skapa dokumentation som är anpassad för en global publik och som hanterar olika versioner av din produkt eller tjänst.

Internationalisering (i18n)​

Om din dokumentation ska vara tillgänglig för användare världen över är flerspråkighet en viktig funktion. Med Docusaurus kan du enkelt hantera flera språk i samma projekt, tack vare det inbyggda stödet för internationalisering.

Så funkar det​

Docusaurus organiserar innehållet för varje språk i separata kataloger. När du bygger din sajt skapas en språkväxling som gör det möjligt för användare att navigera mellan språkversionerna.

Exempel på struktur:

i18n/
├── sv/
│   ├── docusaurus-plugin-content-docs/
│   │   ├── current/
│   │   │   ├── intro.md
│   ├── docusaurus-theme-classic/
│   │   ├── navbar.json
│   ├── docusaurus-plugin-content-blog/
│   │   ├── 2025-01-01-valkommen.md
├── en/

Exempel på URL-struktur:

  • Svenska: example.com/docs/intro
  • Engelska: example.com/en/docs/intro
  • Franska: example.com/fr/docs/intro

Fördelar med flerspråkighet​

  • Global tillgänglighet – Gör det enkelt för användare från olika regioner att förstå din dokumentation.
  • Centraliserad hantering – Allt innehåll hålls organiserat inom samma projekt.
  • Automatisk språkväxling – Docusaurus lägger till en språkväxlare i navigeringen.

Versionering​

Docusaurus erbjuder också kraftfull versionshantering, vilket gör det möjligt att underhålla dokumentation för flera versioner av din produkt.

Så funkar det​

Versionering låter dig kopiera en befintlig uppsättning dokumentation och arkivera den som en specifik version. Samtidigt kan du fortsätta att uppdatera dokumentationen för den senaste versionen.

Exempel:

docs/
├── versioned_docs/
│   ├── version-1.0/
│   │   ├── intro.md
│   ├── version-2.0/
│   │   ├── intro.md
├── current/
│   ├── intro.md

Exempel på URL-struktur:

  • Version 1.0: example.com/docs/v1.0/intro
  • Version 2.0: example.com/docs/v2.0/intro
  • Senaste versionen: example.com/docs/intro

Fördelar med versionering​

  • Tydlighet för användare: Användare kan enkelt navigera till den version av dokumentationen som gäller för deras produkt.
  • Effektiv hantering: Behåll äldre versioner som referens samtidigt som du uppdaterar den senaste.
  • Flexibilitet: Anpassa innehåll för specifika versioner utan att påverka andra.

Kombinera internationalisering och versionering​

Dessa två funktioner fungerar sömlöst tillsammans. Du kan till exempel ha flera språkversioner av samma dokumentation för olika produktversioner.

Exempel:

  • Svenska, version 1.0: example.com/docs/v1.0/intro
  • Engelska, version 1.0: example.com/fr/docs/v1.0/intro
  • Engelska, senaste versionen: example.com/docs/intro

✨ Nästa steg – Lär dig hur du kan optimera användarupplevelsen med en kraftfull sökfunktion! ✨