Установка и настройка Sculpin в среде ServBay

Что такое Sculpin?

Sculpin — это статический генератор сайтов на основе PHP, предназначенный для создания блогов, документации и других статических сайтов. Он использует шаблонный движок Twig и данные YAML, что делает разработку сайтов очень гибкой и мощной.

Шаги установки Sculpin

В этой статье мы расскажем, как установить и настроить Sculpin в среде ServBay.

Шаг 1: Создание директории проекта

Сначала создайте новую директорию проекта в каталоге www на ServBay:

cd /Applications/ServBay/www
mkdir servbay-sculpin-app
cd servbay-sculpin-app

Шаг 2: Создание проекта Sculpin с помощью Composer

ServBay уже включает Composer, поэтому мы можем напрямую использовать Composer для создания проекта Sculpin:

composer create-project sculpin/sculpin-blog-skeleton .

Шаг 3: Настройка веб-сервера

1. Добавление нового сайта

   Откройте ServBay, нажмите на вкладку «Хосты» и добавьте новый сайт:

   • Название: My Sculpin Site
   • Домен: servbay-sculpin.local
   • Тип сайта: PHP
   • Версия PHP: выберите соответствующую версию PHP
   • Корневая директория сайта: /Applications/ServBay/www/servbay-sculpin-app/output_dev

2. Сохранение конфигурации

   Сохраните конфигурацию и перезагрузите ServBay.

Шаг 4: Сборка сайта Sculpin

1. Установка зависимостей

   Выполните следующую команду в каталоге проекта для установки зависимостей:

   composer install

2. Сборка сайта

   Выполните следующую команду для сборки сайта Sculpin:

   vendor/bin/sculpin generate --watch --server

Шаг 5: Запуск локального сервера разработки

1. Запуск локального сервера разработки

   Выполните следующую команду для запуска локального сервера разработки:

   vendor/bin/sculpin generate --server --watch

2. Доступ к серверу разработки

   Откройте браузер и перейдите по адресу https://servbay-sculpin.local, чтобы увидеть локальную версию сайта Sculpin.

Шаг 6: Настройка сайта Sculpin

1. Редактирование контента

   Редактируйте файлы Markdown и шаблоны Twig в каталоге source, чтобы настроить контент и макет вашего сайта.

2. Добавление новых страниц

   Создайте новые файлы Markdown в каталоге source, чтобы добавить новые страницы. Например, создайте файл about.md:

   ---
   title: "О нас"
   ---
   
   # О нас
   
   Это страница "О нас".

3. Настройка навигационного меню

   Отредактируйте шаблон файла навигационного меню в каталоге source/_layouts, чтобы добавить новые ссылки.

4. Сборка сайта

   Каждый раз после изменения контента или шаблонов, заново выполняйте следующую команду для сборки сайта Sculpin:

   vendor/bin/sculpin generate

Использование Sculpin для создания сайта

Теперь, когда вы успешно установили и настроили Sculpin в среде ServBay, вы можете начать использовать его для создания вашего сайта. Вот несколько обычных операций:

Создание блог-поста

1. Создание поста

   Создайте новый файл Markdown в каталоге source/_posts для добавления блог-поста. Например, создайте файл 2024-06-06-my-first-post.md:

   ---
   title: "Первый пост"
   date: 2024-06-06
   ---
   
   # Первый пост
   
   Это содержимое моего первого поста.

2. Сборка сайта

   Выполните следующую команду для сборки сайта Sculpin:

   vendor/bin/sculpin generate

Настройка стилей и скриптов

1. Редактирование стилей

   Отредактируйте файлы CSS в каталоге source/assets/css, чтобы настроить стили вашего сайта.

2. Редактирование скриптов

   Отредактируйте файлы JavaScript в каталоге source/assets/js, чтобы настроить взаимодействие вашего сайта.

3. Компиляция ресурсов

   Выполните следующую команду для компиляции файлов CSS и JavaScript:

   vendor/bin/sculpin generate

Следуя этим шагам, вы успешно установили и настроили Sculpin в среде ServBay и начали использовать его для создания вашего сайта. Гибкость и мощные функции Sculpin делают его идеальным выбором для создания статических сайтов.