Schnellstart#

Diese Anleitung bringt dich von Null zu einer live aktualisierten Doku-Seite.

1. Ein Projekt scaffolden#

Am schnellsten geht es mit der CLI:

kiln new my-docs
cd my-docs

kiln new fragt nach Name, URL und Sprachen und schreibt dann ein fertig baubares SwiftPM-Projekt:

my-docs/
├── Package.swift
├── Content/
│   └── index.md
└── Sources/
    └── MyDocs/
        └── main.swift

2. Die Seite konfigurieren#

Sources/MyDocs/main.swift ist die einzige Quelle der Wahrheit für deine Seite:

import Kiln

let site = KilnSite(name: "Meine Doku", url: "https://example.com") {
    Page("Willkommen", "index.md")
    Section("Anleitungen") {
        Page("Konfiguration", "guides/configuration.md")
    }
}

try await Kiln.build(site, contentDirectory: "Content", outputDirectory: "site")

3. Markdown schreiben#

Inhalte sind einfaches Markdown unter Content/. Erstelle Content/index.md:

# Willkommen

Hallo, Welt!

4. Vorschau anzeigen#

kiln serve

Das baut die Seite und liefert sie unter http://127.0.0.1:8080 aus — mit automatischem Neubau bei jeder Änderung. Lade den Browser neu, um Änderungen zu sehen.