File Structure & Organization

Dorcs uses your folder tree as the primary source of routing and navigation.

Standard layout

docs/
├── index.md
├── guide.md
└── api/
    ├── index.md
    └── auth.md

URL mapping

Ordering by filename

Numeric prefixes help when you use automatic navigation:

docs/
├── 01_intro.md
├── 02_install.md
└── 03_deploy.md

The numbers influence order but are not part of the URL.

Languages

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

With:

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

URLs become:

• /guide for default language content in docs/en/guide.md
• /de/guide for German content

Versions

docs/
├── index.md
├── guide.md
└── v1/
    ├── index.md
    └── guide.md

With:

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

URLs become:

• /guide
• /v1/guide

Default-version content is served from the root docs folder. Non-default versions use folders.

If you configure latest as the default version, / serves the content from the root docs folder, not from docs/latest/.

Languages and versions together

Use language-first folders:

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

Dorcs serves paths like /de/v1/....