Instalando e Configurando o Kirby no Ambiente ServBay

O que é Kirby?

Kirby é um sistema de gerenciamento de conteúdo (CMS) flexível e poderoso, baseado em arquivos, ideal para construir diversos tipos de sites. O Kirby não depende de um banco de dados, utilizando o sistema de arquivos para armazenar o conteúdo, tornando-o muito leve e fácil de implantar.

Passos para Instalar o Kirby

Neste artigo, vamos abordar como instalar e configurar o Kirby 4.2 no ambiente ServBay usando o Composer.

Passo 1: Criar o Diretório do Projeto

Primeiro, crie um novo diretório de projeto no diretório www do ServBay:

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

Passo 2: Criar o Projeto Kirby Usando Composer

O ServBay já vem com o Composer instalado, então podemos usar o Composer para criar o projeto Kirby diretamente:

composer create-project getkirby/starterkit .

Passo 3: Configurar o Servidor Web

1. Adicionar um Novo Site

   Abra o ServBay, clique na aba "Host", e adicione um novo site:

   • Nome: Meu Site Kirby
   • Domínio: servbay-kirby.local
   • Tipo de Site: PHP
   • Versão do PHP: 8.2
   • Diretório Raiz do Site: /Applications/ServBay/www/servbay-kirby-app

2. Salvar Configuração

   Salve as configurações.

Passo 4: Configurar o Kirby

1. Criar o Diretório de Conteúdo

   No diretório raiz do projeto, o diretório content já foi criado pelo Kirby Starterkit.

Passo 5: Executar o Kirby

1. Acessar o Kirby

   Abra o navegador e acesse https://servbay-kirby.local, você verá a página de boas-vindas padrão do Kirby.

Passo 6: Instalar o Painel Kirby (Opcional)

Se você quiser usar o painel administrativo do Kirby, siga os passos abaixo para instalá-lo:

1. Acessar o Painel Kirby

   Abra o navegador e acesse https://servbay-kirby.local/panel, você verá a página de instalação do painel do Kirby.

2. Criar Conta de Administrador

   Siga as instruções na página para criar uma conta de administrador, preenchendo o nome de usuário, senha e endereço de e-mail, e clique em "Criar Conta".

Usando o Kirby para Construir um Site

Agora que você instalou e configurou o Kirby com sucesso no ambiente ServBay, pode começar a usá-lo para construir seu site. A seguir, estão algumas operações comuns:

Criar Páginas e Conteúdo

1. Criar Página

   No diretório content, crie um novo diretório de página. Por exemplo, para criar uma página "about":

   mkdir content/about
   echo "Title: About Us\n----\nEsta é a página sobre." > content/about/about.txt

2. Editar Template

   No diretório site/templates, crie ou edite os arquivos de template. Por exemplo, crie um template about.php:

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

Configurar o Menu de Navegação

1. Editar Template

   No diretório site/templates, edite o arquivo de template principal, por exemplo, default.php, para adicionar um menu de navegação:

   <!-- 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>

Personalizar Estilos e Scripts

1. Adicionar Estilos

   No diretório assets/css, crie arquivos CSS e os referencie nos arquivos de template. Por exemplo, crie style.css:

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

   Nos arquivos de template, referencie o arquivo CSS:

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

2. Adicionar Scripts

   No diretório assets/js, crie arquivos JavaScript e os referencie nos arquivos de template. Por exemplo, crie script.js:

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

   Nos arquivos de template, referencie o arquivo JavaScript:

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

Com esses passos, você instalou e configurou o Kirby no ambiente ServBay com sucesso e começou a usá-lo para construir seu site. A flexibilidade e a arquitetura baseada em arquivos do Kirby o tornam uma escolha ideal para construir diversos tipos de sites.