Zu docmd migrieren
docmd bietet eine vollständig automatisierte Migration-Engine. Wechseln Sie mit einem einzigen Befehl von Legacy-Plattformen. Die Engine eliminiert die mühselige Arbeit, Markdown-Dateien zu verschieben und Verzeichnisse umzustrukturieren.
Wie es funktioniert
Der Migrate-Befehl wird:
- Erkennen Ihrer bestehenden Konfigurationsdatei (z. B.
docusaurus.config.js,mkdocs.yml). - Extrahieren von Kern-Metadaten wie dem
titleIhrer Site. - Sichern Ihrer bestehenden Dateien und Verzeichnisse sicher in einem
*-backup/-Verzeichnis. - Kopieren Ihrer Markdown-Inhalte in das Standard
docs/-Verzeichnis von docmd. - Generieren einer frischen
docmd.config.json, die auf Ihre Inhalte zugeschnitten ist.
Sie können dann sofort npx @docmd/core dev ausführen, um Ihre Inhalte gerendert zu sehen.
Was migriert wird
| Feature | Automatisch migriert? |
|---|---|
| Markdown-Dateien | ✅ Ja, alle .md und .mdx Dateien werden nach docs/ verschoben |
| Verzeichnisstruktur | ✅ Ja, Ihre Ordner-Verschachtelung bleibt erhalten |
| Site-Titel | ✅ Ja, aus Ihrer Konfiguration extrahiert |
| Container-Syntax | ✅ Ja, VitePress/Docusaurus-Container funktionieren ohne Änderungen |
| Navigation / Sidebar | ⚠️ Nein, erfordert manuelles Mapping |
| Lokalisierung (i18n) | ⚠️ Nein, erfordert manuelles Mapping |
| Versionierung | ⚠️ Nein, erfordert manuelles Mapping |
| Eigene React/Vue-Komponenten | ❌ Nein, diese müssen durch docmd-Container ersetzt werden |
Container-Syntax von VitePress (:::tip, :::warning, :::danger, :::info, :::details) und Docusaurus (:::note, :::caution) funktioniert ohne Modifikation. Ihre bestehenden Admonitions und Collapsible-Sections werden in docmd korrekt gerendert.
MkDocs verwendet !!!-Syntax, die manuelle Konvertierung in das :::-Format erfordert.
Warum Navigation und i18n nicht automatisch migriert werden
Jede Plattform behandelt Navigations-Sidebars, Übersetzungen und Mehrfach-Versionierung anders. Beispielsweise verwendet Docusaurus komplexe JavaScript-Objekte. MkDocs verlässt sich auf streng eingerückte YAML-Strukturen.
Anstatt eine fehlerhafte Migration durch das Erraten komplexer Konfigurationen zu riskieren, verschiebt docmd Ihre Inhalte sicher. Sie müssen Navigation, Lokalisierung und Versionierung nativ mit docmds JSON-basierten APIs konfigurieren.
- Navigation: Erfahren Sie, wie Sie eine
navigation.jsonin der Navigations-Einrichtung erstellen. - Lokalisierung: Siehe Lokalisierungs-Leitfaden zur Einrichtung mehrsprachiger Dokumentation.
- Versionierung: Siehe Versionierungs-Einrichtung.
Unterstützte Plattformen
Wählen Sie Ihre aktuelle Plattform für spezifische Migrations-Anweisungen: