Docsify

Dies ist ein Beispiel dafür, wie du eine statische Website mit Docsify auf Kinstas Statische-Seiten-Hosting Dienst von einem GitHub-Repository aus einrichtest.

Docsify ist ein Dokumentationsgenerator, der aus den Markdown-Dateien im docs-Verzeichnis deines Repositorys eine Website für deine Dokumentation erstellt. Weitere Informationen findest du auf der Website docsify.js.org.

Du kannst diese Schnellstartvorlage auch auf dem Anwendungs-Hosting von Kinsta ohne zusätzliche Konfiguration verwenden. Wenn du das Anwendungs-Hosting verwendest, kann der Start-Befehl für den Webprozess leer gelassen werden, da Kinsta den erforderlichen Befehl bei der ersten Bereitstellung automatisch erkennt.

Voraussetzungen

  • Die Schnellstartvorlagen von Kinsta werden in GitHub gespeichert und verwaltet. Daher brauchst du einen GitHub-Account, um auf sie zuzugreifen.
  • Um die Anwendung bereitzustellen, musst du ein MyKinsta-Konto erstellen.

Bereitstellen einer statischen Docsify-Site

  1. Melde dich bei GitHub an und erstelle ein neues Repository aus dieser Vorlage (Diese Vorlage verwenden > Neues Repository erstellen): Kinsta – Hello World – Statische Website mit Docsify.
  2. Klicke in MyKinsta auf Statische Seiten > Seite hinzufügen > wähle GitHub, klicke auf Git-Anbieter verbinden > Autorisieren und melde dich bei deinem GitHub-Konto an.
  3. Wähle das Hello World Docsify Repository aus, klicke auf Weiter, vergewissere dich in den Build-Einstellungen, dass der Build-Befehl und die Node-Version leer sind und das Veröffentlichungsverzeichnis auf docs eingestellt ist, und klicke auf Seite erstellen.

Während des Deployment-Prozesses installiert Kinsta automatisch die in deiner package.json-Datei definierten Abhängigkeiten. Die Site ist verfügbar, sobald die Bereitstellung abgeschlossen ist und die Docsify-Willkommensseite unter der URL deiner Site geladen wird.

Docsify-Willkommensseite nach erfolgreicher Bereitstellung von Docsify
Docsify-Willkommensseite nach erfolgreicher Bereitstellung von Docsify

Bereitstellungs-Lebenszyklus

Immer wenn eine Bereitstellung initiiert wird (durch die Erstellung einer statischen Website oder eine erneute Bereitstellung aufgrund eines eingehenden Commits), wird der Build-Befehl ausgeführt, gefolgt von der Bereitstellung der Inhalte des Veröffentlichungsverzeichnisses.

War dieser Artikel hilfreich?