gatsby starter ghost

Стартовый призрак Гэтсби

Начальный шаблон для создания молниеносных веб-сайтов с помощью Ghost & Gatsby.

Демо: https://gatsby.ghost.org/

Установка

 # 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

Затем установите зависимости

yarn

Бег

Запустите сервер разработки. Теперь у вас есть сайт Gatsby, загружающий контент из обезглавленного Ghost.

gatsby develop

По умолчанию программа запуска будет заполнять контент из стандартной установки Ghost, расположенной по адресу https://gatsby.ghost.io.

Чтобы использовать собственную установку, вам необходимо отредактировать файл конфигурации .ghost.json указав свои учетные данные. Измените значение apiUrl на URL-адрес вашего сайта-призрака. Для клиентов Ghost(Pro) это URL-адрес Ghost, заканчивающийся на .ghost.io , а для людей, использующих самостоятельную версию Ghost, это тот же URL-адрес, который используется для доступа к вашему сайту.

Затем обновите значение contentApiKey , указав ключ, связанный с сайтом-призраком. Ключ можно предоставить путем интеграции с Ghost Admin. Перейдите в «Интеграции» и нажмите «Добавить новую интеграцию». Назовите интеграцию соответствующим образом и нажмите «Создать».

Наконец, настройте желаемый URL-адрес в siteConfig.js , чтобы ссылки (например, канонические) генерировались правильно. Вы также можете обновить в этом файле другие значения по умолчанию, например, postsPerPage .

Чтобы использовать этот стартер без проблем, ваша установка Ghost должна быть как минимум версии 2.10.0 .

Версия Ghost по умолчанию, используемая для этого стартового приложения, — 5.x Если у вас установлен Ghost более ранней версии, вам нужно будет передать свойство version в настройках .ghost.json :

Призрак >=2.10.0 <5.0.0

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

Призрак >=5.0.0

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

Развертывание с помощью Netlify

Стартер содержит три файла конфигурации специально для развертывания с помощью Netlify. Файл netlify.toml для настроек сборки, файл /static/_headers с заголовками безопасности по умолчанию, установленными для всех маршрутов, и /static/_redirects для настройки перенаправлений пользовательского домена Netlify.

Чтобы выполнить развертывание в своей учетной записи Netlify, нажмите кнопку ниже.

Ключи API контента, как правило, не считаются конфиденциальной информацией, они существуют для того, чтобы их можно было изменить в случае злоупотреблений; поэтому большинство людей фиксируют его непосредственно в своем конфигурационном файле .ghost.json . Если вы предпочитаете хранить эту информацию в своем репозитории, вы можете удалить эту конфигурацию и вместо этого установить переменные Netlify ENV для производственных сборок.

После развертывания вы можете настроить интеграцию Ghost + Netlify, чтобы использовать перехватчики развертывания из Ghost для запуска перестроений Netlify. Таким образом, при каждом изменении данных в Ghost ваш сайт будет перестроен на Netlify.

Оптимизация

Вы можете отключить интерфейс темы Ghost Handlebars по умолчанию, включив флажок Make this site private в настройках Ghost. Это включает защиту паролем перед установкой Ghost и устанавливает <meta name="robots" content="noindex" /> чтобы ваш интерфейс Gatsby стал источником истины для SEO.

Дополнительные опции

 # Run a production build, locally
gatsby build

# Serve a production build, locally
gatsby serve

develop Gatsby использует конфигурацию development в .ghost.json , а build Gatsby использует конфигурацию production .

Авторские права и лицензия

Авторские права (c) 2013–2025 Ghost Foundation — выпущено по лицензии MIT.