Zum Hauptinhalt springen

Upgrading

Mit create-docstatic erstellte Websites werden mit demselben Paket aktualisiert, ausgeführt im Stammordner der Website:

npx create-docstatic@latest --update

Dieser Befehl aktualisiert die docStatic-eigenen Dateien und Abhängigkeitsversionen und lässt Ihre Inhalte unangetastet. Er ermittelt, welche Dateien zu docStatic selbst gehören, indem er update-manifest.json liest – ein Manifest, das aus der Projektvorlage generiert und mit jeder Version ausgeliefert wird.

Bevor irgendetwas geschrieben wird, prüft der Befehl, ob Ihr Git-Arbeitsverzeichnis sauber ist, damit Sie das Update anschließend mit git diff überprüfen können. Haben Sie nicht committete Änderungen, committen oder stashen Sie diese zuerst, oder übergeben Sie --force, um trotzdem fortzufahren.

Der Update-Befehl akzeptiert folgende Optionen:

  • --dry-run: Meldet, was sich ändern würde, ohne etwas zu schreiben.
  • --force: Fährt fort, auch wenn das Git-Arbeitsverzeichnis nicht sauber ist.
  • --tag <dist-tag>: Aktualisiert auf eine bestimmte docstatic-Paketversion oder einen Dist-Tag statt auf latest.
  • --no-install: Überspringt die Installation der Abhängigkeiten nach dem Update.
Ein Update zuerst in der Vorschau ansehen

Führen Sie den Befehl vor dem Aktualisieren einer Website mit lokalen Anpassungen mit --dry-run aus, damit Sie sehen können, welche Dateien sich ändern würden, bevor Sie sich auf das Update festlegen.