Von Haus aus statisch

So veröffentlichen Sie eine Website mit MkDocs

MkDocs macht aus einem Ordner voller Markdown eine fertige Dokumentations-Website. Der Ausgabeordner heißt site, und genau dieses Detail wird oft übersehen.

Build-Befehl
mkdocs build
Upload-Ordner
site

Kostenloser Tarif, SSL inklusive, ohne Kreditkarte.

.droply.id
  1. Projekt bauen

    Führen Sie mkdocs build im Projektordner aus. Diesen Schritt übernimmt Droply nicht: Wir veröffentlichen fertige Seiten und führen Ihren Build nie selbst aus.

  2. Ausgabeordner finden

    Der Build schreibt die fertige Website nach site. Diesen Ordner laden Sie hoch, nicht den Projektordner.

  3. Hineinziehen

    Ziehen Sie den Ordner (oder eine ZIP-Datei davon) in Droply. In Sekunden ist er per HTTPS auf einer Subdomain von droply.id online, und jeder neue Upload veröffentlicht eine neue Version unter derselben URL.

Wissenswertes zu MkDocs

  • Hochzuladen ist der Ordner site, nicht docs. In docs liegen Ihre Markdown-Quellen. Laden Sie ihn hoch, veröffentlichen Sie den Quelltext statt der Website.

  • site_dir in der mkdocs.yml ändert den Ausgabeordner. Schauen Sie dort nach, bevor Sie vom Standard ausgehen.

  • Setzen Sie site_url auf die Adresse, unter der die Website liegen wird. Der Suchindex und die Canonical-Tags von Material for MkDocs lesen beide diesen Wert.

  • Verwenden Sie mkdocs build, nicht mkdocs gh-deploy. Der zweite Befehl committet in einen gh-pages-Branch, also an ein ganz anderes Ziel.

Hat ein KI-Tool dieses Projekt erstellt?

Eine KI-generierte Website hosten beantwortet die Frage, die vor dem Build-Befehl kommt: Haben Sie eine einzelne Datei oder ein ganzes Projekt vor sich, und was liefert jedes Tool tatsächlich?

Häufige Fragen

Baut Droply mein Projekt mit MkDocs für mich?
Nein, und das wird sich auch nicht ändern. Droply veröffentlicht fertige statische Dateien. Ihren Build auszuführen hieße, Ihre Abhängigkeiten auf unseren Servern laufen zu lassen: ein ganz anderes und deutlich riskanteres Produkt. Bauen Sie lokal oder in Ihrer bestehenden CI und laden Sie dann das Ergebnis hoch.
Welchen Ordner lade ich hoch?
Den Ordner site, den mkdocs build erzeugt, nicht den Projektordner. Laden Sie ihn direkt hoch oder packen Sie ihn vorher als ZIP: Beides funktioniert.
Was passiert, wenn ich die Website aktualisiere?
Neu bauen und erneut hochladen. Die neue Version ersetzt die alte unter derselben URL, ein bereits geteilter Link funktioniert also weiter. Die Tarife Pro, Business und Enterprise speichern einen Versionsverlauf, zu dem Sie mit einem Klick zurückkehren können.
Kann ich meine eigene Domain verwenden?
Ja, in den Tarifen Pro, Business und Enterprise. Richten Sie Ihre Domain auf Droply aus, dann wird das Zertifikat automatisch ausgestellt und erneuert.