優れた Simply Ghost テーマを使用して、Ghost (この場合はヘッドレス CMS として) と Gatsby で超高速 Web サイトを構築するためのスターター テンプレート。 Handlebars テーマから React/Gatsby に書き直されました。
デモ: https://gatsby-ghost-simply.netlify.app/
custom_template
フィールドではなく内部タグを使用してください!)custom_template
フィールドではなく内部タグを使用してください!)custom_template
フィールドではなく内部タグを使用してください!)custom_template
フィールドではなく内部タグを使用してください!) # With Gatsby CLI
gatsby new gatsby-starter-ghost https://github.com/anarion80/gatsby-ghost-simply.git
# From Source
git clone https://github.com/anarion80/gatsby-ghost-simply.git
cd gatsby-ghost-simply
次に依存関係をインストールします
yarn
開発サーバーを起動します。これで、ヘッドレス Ghost からコンテンツを取得する Gatsby サイトが完成しました。 Ghost インスタンスにオリジナルの Simply Ghost テーマをインストールする必要も、そこに追加のルートを設定する必要もありません。
gatsby develop
デフォルトでは、スターターは https://gatsby.ghost.io にあるデフォルトの Ghost インストールからコンテンツを取り込みます。
独自のインストールを使用するには、資格情報を使用して.ghost.json
構成ファイルを編集する必要があります。 apiUrl
値を Ghost サイトの URL に変更します。 Ghost(Pro) の顧客の場合、これは.ghost.io
で終わる Ghost の URL であり、Ghost のセルフホスト バージョンを使用している人の場合は、サイトへのアクセスに使用されるのと同じ URL になります。
次に、 contentApiKey
値を Ghost サイトに関連付けられたキーに更新します。キーは、Ghost Admin 内で統合を作成することで提供できます。 「統合」に移動し、「新しい統合を追加」をクリックします。統合に適切な名前を付けて、「作成」をクリックします。
{
"apiUrl" : " https://gatsby.ghost.io " ,
"contentApiKey" : " 9cc5c67c358edfdd81455149d0 "
}
最後に、リンク (正規リンクなど) が正しく生成されるように、 siteConfig.js
で目的の URL を構成します。メニュー、ソーシャル共有、検索に必要な他の値も更新する必要があります。
{
menuDropdown : [
{
label : `About` ,
url : `/about` ,
} ,
.
.
.
] ,
followSocialMedia : [
{
service : `youtube` ,
title : `YOUR_TITLE` ,
url : `YOUR_URL` ,
} ,
.
.
.
] ,
searchSettings : {
key : `YOUR_GHOST_API_KEY` ,
url : `YOUR_GHOST_URL` ,
/* This is optional */
options : {
keys : [ `title` , `plaintext` ] ,
limit : 10 ,
} ,
/* This is optional to perform filtering of the ghost api */
api : {
resource : `posts` ,
parameters : {
limit : `all` ,
fields : [ `title` , `slug` , `plaintext` ] ,
filter : `` ,
include : `` ,
order : `` ,
formats : `` ,
} ,
} ,
} ,
}
カスタム投稿テンプレートを使用するには、特定の内部タグを投稿に追加します (例: #custom-post-wide
、 #custom-kusi-doc
など)。
デモとリポジトリは、ホームページのバリアント、投稿テンプレート、ポートフォリオ、ドキュメントなどの可能なすべてのタイプを備えた「最大バージョン」です。必要に応じて調整/削除してください。
スターターには、Netlify でのデプロイに特化した 3 つの構成ファイルが含まれています。ビルド設定用のnetlify.toml
ファイル、すべてのルートに設定されたデフォルトのセキュリティ ヘッダーを含む/static/_headers
ファイル、および Netlify カスタム ドメイン リダイレクトを設定する/static/_redirects
。
Netlify アカウントにデプロイするには、下のボタンを押してください。
コンテンツ API キーは通常、機密情報とは見なされません。悪用された場合に変更できるように存在します。そのため、ほとんどの人は.ghost.json
構成ファイルに直接コミットします。この情報をリポジトリに保存したくない場合は、この構成を削除し、代わりに運用ビルド用の Netlify ENV 変数を設定できます。
デプロイ後は、Ghost と Netlify の統合を設定して、Ghost からのデプロイフックを使用して Netlify の再構築をトリガーできます。そうすれば、Ghost でデータが変更されるたびに、サイトが Netlify 上で再構築されます。
Ghost 設定内でMake this site private
フラグを有効にすることで、デフォルトの Ghost Handlebars Theme フロントエンドを無効にできます。これにより、Ghost のインストール前にパスワード保護が有効になり、 <meta name="robots" content="noindex" />
が設定されるため、Gatsby フロントエンドが SEO の信頼できる情報源になります。
# Run a production build, locally
gatsby build
# Serve a production build, locally
gatsby serve
Gatsby develop
.ghost.json
のdevelopment
構成を使用しますが、Gatsby build
production
構成を使用します。
Copyright (c) 2021 anarion80 - GPLv3 ライセンスに基づいてリリースされています。