Languages & Versions BETA

Dorcs can serve your docs in multiple languages and maintain multiple versions side by side.

Multiple languages

To offer your docs in more than one language, create a folder per language and tell Dorcs about them:

docs/
├── en/
│   ├── index.md
│   └── guide.md
└── de/
    ├── index.md
    └── guide.md

languages:
  default: "en"
  enabled:
    - code: "en"
      name: "English"
    - code: "de"
      name: "Deutsch"

Dorcs automatically adds a language switcher to the header. The default language is served at the root URL (/guide), other languages get a prefix (/de/guide).

Doc versioning

Keep older versions of your docs alongside the current ones:

docs/
├── index.md        ← latest (default)
├── guide.md
└── v1/
    ├── index.md    ← version 1
    └── guide.md

versions:
  default: "latest"
  enabled:
    - id: "latest"
      name: "Latest"
    - id: "v1"
      name: "Version 1"

The default version lives in the root docs folder — no subfolder needed. Other versions go in their own folders. Dorcs adds a version switcher to the header.

URLs:

• /guide — latest version
• /v1/guide — version 1

Using both together

When you need languages AND versions, put languages first:

docs/
├── en/
│   ├── index.md
│   ├── guide.md
│   └── v1/
│       ├── index.md
│       └── guide.md
└── de/
    ├── index.md
    ├── guide.md
    └── v1/
        ├── index.md
        └── guide.md

This gives you URLs like: