gatsby starter ghost

Gatsby Starter Ghost

Eine Startervorlage zum Erstellen blitzschneller Websites mit Ghost & Gatsby

Demo: https://gatsby.ghost.org/

Installieren

 # With Gatsby CLI
gatsby new gatsby-starter-ghost https://github.com/TryGhost/gatsby-starter-ghost.git

 # From Source
git clone https://github.com/TryGhost/gatsby-starter-ghost.git
cd gatsby-starter-ghost

Dann installieren Sie Abhängigkeiten

yarn

Läuft

Starten Sie den Entwicklungsserver. Sie haben jetzt eine Gatsby-Site, die Inhalte von Headless Ghost abruft.

gatsby develop

Standardmäßig füllt der Starter Inhalte aus einer Standard-Ghost-Installation unter https://gatsby.ghost.io.

Um Ihre eigene Installation zu verwenden, müssen Sie die Konfigurationsdatei .ghost.json mit Ihren Anmeldeinformationen bearbeiten. Ändern Sie den apiUrl Wert in die URL Ihrer Ghost-Site. Für Ghost(Pro)-Kunden ist dies die Ghost-URL, die auf .ghost.io endet, und für Benutzer der selbst gehosteten Version von Ghost ist es dieselbe URL, die für den Zugriff auf Ihre Website verwendet wird.

Aktualisieren Sie als Nächstes den contentApiKey -Wert auf einen Schlüssel, der der Ghost-Site zugeordnet ist. Ein Schlüssel kann durch Erstellen einer Integration in Ghost Admin bereitgestellt werden. Navigieren Sie zu Integrationen und klicken Sie auf „Neue Integration hinzufügen“. Benennen Sie die Integration entsprechend und klicken Sie auf „Erstellen“.

Konfigurieren Sie abschließend Ihre gewünschte URL in siteConfig.js , damit Links (z. B. kanonische Links) korrekt generiert werden. Sie können in dieser Datei auch andere Standardwerte aktualisieren, z. B. postsPerPage .

Um diesen Starter problemlos verwenden zu können, muss Ihre Ghost-Installation mindestens Version 2.10.0 haben.

Die standardmäßige Ghost-Version, die für diesen Starter verwendet wird, ist 5.x Wenn es sich bei Ihrer Ghost-Installation um eine niedrigere Version handelt, müssen Sie in Ihren .ghost.json Einstellungen eine version übergeben:

Geist >=2.10.0 <5.0.0

{
    "apiUrl" : " https://gatsby.ghost.io " ,
    "contentApiKey" : " 9cc5c67c358edfdd81455149d0 " ,
    "version" : " v4.0 "
}

Geist >=5.0.0

{
    "apiUrl" : " https://gatsby.ghost.io " ,
    "contentApiKey" : " 9cc5c67c358edfdd81455149d0 "
}

Bereitstellung mit Netlify

Der Starter enthält drei Konfigurationsdateien speziell für die Bereitstellung mit Netlify. Eine netlify.toml Datei für Build-Einstellungen, eine /static/_headers Datei mit Standard-Sicherheitsheadern für alle Routen und /static/_redirects zum Festlegen benutzerdefinierter Netlify-Domänenumleitungen.

Klicken Sie zur Bereitstellung auf Ihrem Netlify-Konto auf die Schaltfläche unten.

Inhalts-API-Schlüssel gelten im Allgemeinen nicht als vertrauliche Informationen, sie sind so vorhanden, dass sie im Falle eines Missbrauchs geändert werden können; Daher übernehmen die meisten Leute es direkt in ihre .ghost.json -Konfigurationsdatei. Wenn Sie diese Informationen lieber aus Ihrem Repository fernhalten möchten, können Sie diese Konfiguration entfernen und stattdessen Netlify ENV-Variablen für Produktions-Builds festlegen.

Nach der Bereitstellung können Sie eine Ghost + Netlify-Integration einrichten, um Deploy-Hooks von Ghost zu verwenden, um Netlify-Neuerstellungen auszulösen. Auf diese Weise wird Ihre Website jedes Mal, wenn sich Daten in Ghost ändern, auf Netlify neu erstellt.

Optimieren

Sie können das Standard-Frontend des Ghost-Lenker-Designs deaktivieren, indem Sie in Ihren Ghost-Einstellungen die Markierung Make this site private aktivieren. Dies ermöglicht den Passwortschutz vor der Ghost-Installation und legt <meta name="robots" content="noindex" /> fest, sodass Ihr Gatsby-Frontend zur Quelle der Wahrheit für SEO wird.

Zusätzliche Optionen

 # Run a production build, locally
gatsby build

# Serve a production build, locally
gatsby serve

Gatsby develop verwendet die development in .ghost.json – während Gatsby build die production verwendet.

Urheberrecht & Lizenz

Copyright (c) 2013–2025 Ghost Foundation – veröffentlicht unter der MIT-Lizenz.