Установка и настройка Kirby в окружении ServBay

Что такое Kirby?

Kirby - это гибкая и мощная файловая система управления контентом (CMS) для создания различных типов сайтов. Kirby не зависит от базы данных, а использует файловую систему для хранения контента, что делает его очень легким и простым в развертывании.

Шаги для установки Kirby

В этой статье мы расскажем, как установить и настроить Kirby 4.2 в окружении ServBay с помощью Composer.

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

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

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

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

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

composer create-project getkirby/starterkit .

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

1. Добавить новый сайт

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

   • Название: My Kirby Site
   • Домен: servbay-kirby.local
   • Тип сайта: PHP
   • Версия PHP: 8.2
   • Корневой каталог сайта: /Applications/ServBay/www/servbay-kirby-app

2. Сохранить настройки

   Сохраните настройки.

Шаг 4: Настройка Kirby

1. Создание директории контента

   В корневом каталоге проекта, каталог content уже создан стартовым комплектом Kirby.

Шаг 5: Запуск Kirby

1. Доступ к Kirby

   Откройте браузер и перейдите по адресу https://servbay-kirby.local, вы увидите приветственную страницу Kirby.

Шаг 6: Установка панели Kirby (необязательно)

Если вы хотите использовать панель администрирования Kirby, выполните следующие шаги:

1. Доступ к панели Kirby

   Откройте браузер и перейдите по адресу https://servbay-kirby.local/panel, вы увидите страницу установки панели Kirby.

2. Создание учетной записи администратора

   Следуйте указаниям на странице для создания учетной записи администратора, заполните имя пользователя, пароль и адрес электронной почты, затем нажмите «Создать учетную запись».

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

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

Создание страниц и контента

1. Создание страницы

   Создайте новый каталог страницы в директории content. Например, создайте страницу about:

   mkdir content/about
   echo "Title: About Us\n----\nThis is the about page." > content/about/about.txt

2. Редактирование шаблонов

   Создайте или отредактируйте файлы шаблонов в директории site/templates. Например, создайте шаблон about.php:

   <!-- site/templates/about.php -->
   <h1><?= $page->title() ?></h1>
   <p><?= $page->text() ?></p>

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

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

   Отредактируйте главный файл шаблона в директории site/templates, чтобы добавить навигационное меню, например default.php:

   <!-- site/templates/default.php -->
   <nav>
     <ul>
       <?php foreach ($site->children()->listed() as $item): ?>
         <li>
           <a href="<?= $item->url() ?>"><?= $item->title() ?></a>
         </li>
       <?php endforeach ?>
     </ul>
   </nav>

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

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

   Создайте файл CSS в директории assets/css и подключите его в файле шаблона. Например, создайте style.css:

   /* assets/css/style.css */
   body {
     font-family: Arial, sans-serif;
   }

   Подключите файл CSS в файле шаблона:

   <!-- site/templates/default.php -->
   <link rel="stylesheet" href="<?= url('assets/css/style.css') ?>">

2. Добавление скриптов

   Создайте файл JavaScript в директории assets/js и подключите его в файле шаблона. Например, создайте script.js:

   // assets/js/script.js
   document.addEventListener('DOMContentLoaded', function() {
     console.log('Hello, Kirby!');
   });

   Подключите файл JavaScript в файле шаблона:

   <!-- site/templates/default.php -->
   <script src="<?= url('assets/js/script.js') ?>"></script>

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