Базовый стартовый набор для статических сайтов на базе Gatsby.js.
Начать разработку.
Перейдите в каталог вашего нового сайта и запустите его.
cd my-site/
gatsby develop
Откройте исходный код и начните редактирование!
Ваш сайт теперь работает по адресу http://localhost:8000
!
Примечание. Вы также увидите вторую ссылку: http://localhost:8000/___graphql
. Это инструмент, который вы можете использовать для экспериментов с запросами данных. Узнайте больше об использовании этого инструмента в учебнике Gatsby.
Откройте каталог my-site
в выбранном вами редакторе кода и отредактируйте src/pages/index.js
. Сохраните изменения, и браузер обновится в режиме реального времени!
Краткий обзор файлов и каталогов верхнего уровня, которые вы увидите в проекте Gatsby.
.
├── node_modules
├── src
├── .gitignore
├── .prettierrc
├── gatsby-browser.js
├── gatsby-config.js
├── gatsby-node.js
├── gatsby-ssr.js
├── LICENSE
├── package-lock.json
├── package.json
├── README.md
└── yarn.lock
/node_modules
: этот каталог содержит все модули кода, от которых зависит ваш проект (пакеты npm), которые устанавливаются автоматически.
/src
: этот каталог будет содержать весь код, связанный с тем, что вы увидите во внешней части вашего сайта (то, что вы видите в браузере), например, заголовок вашего сайта или шаблон страницы. src
— это соглашение об «исходном коде».
.gitignore
: этот файл сообщает git, какие файлы он не должен отслеживать/не поддерживать историю версий.
.prettierrc
: это файл конфигурации Prettier. Prettier — это инструмент, который помогает поддерживать единообразие форматирования вашего кода.
gatsby-browser.js
: в этом файле Gatsby ожидает найти любое использование API-интерфейсов браузера Gatsby (если таковые имеются). Они позволяют настраивать/расширять настройки Gatsby по умолчанию, влияя на браузер.
gatsby-config.js
: это основной файл конфигурации сайта Gatsby. Здесь вы можете указать информацию о вашем сайте (метаданные), например название и описание сайта, какие плагины Gatsby вы хотели бы включить и т. д. (более подробную информацию можно найти в документации по конфигурации).
gatsby-node.js
: в этом файле Гэтсби ожидает найти любое использование API узла Гэтсби (если таковые имеются). Они позволяют настраивать/расширять настройки Gatsby по умолчанию, влияя на части процесса создания сайта.
gatsby-ssr.js
: в этом файле Gatsby ожидает найти любое использование API-интерфейсов рендеринга на стороне сервера Gatsby (если таковые имеются). Они позволяют настраивать параметры Gatsby по умолчанию, влияющие на рендеринг на стороне сервера.
LICENSE
: Гэтсби лицензируется по лицензии MIT.
package-lock.json
(сначала см. package.json
ниже). Это автоматически созданный файл на основе точных версий ваших зависимостей npm, которые были установлены для вашего проекта. (Вы не будете изменять этот файл напрямую).
package.json
: файл манифеста для проектов Node.js, который включает в себя такие вещи, как метаданные (имя проекта, автор и т. д.). Этот манифест позволяет npm узнать, какие пакеты установить для вашего проекта.
README.md
: текстовый файл, содержащий полезную справочную информацию о вашем проекте.
yarn.lock
: Yarn — это менеджер пакетов, альтернатива npm. Вы можете использовать пряжу или npm, хотя вся документация Gatsby ссылается на npm. Этот файл по сути служит той же цели, что и package-lock.json
, только для другой системы управления пакетами.
Для развертывания вы можете использовать Gitlab CI. В проекте есть два файла — образец .gitlab-ci.yml
и для развертывания S3 .gitlab-ci-s3.yml
.