Instalando e Configurando o Sculpin no Ambiente ServBay

O que é o Sculpin?

Sculpin é um gerador de sites estáticos baseado em PHP, adequado para construir blogs, documentação e outros sites estáticos. Ele usa o mecanismo de templates Twig e dados front-end YAML, tornando o desenvolvimento do site muito flexível e poderoso.

Passos para Instalar o Sculpin

Neste artigo, vamos mostrar como instalar e configurar o Sculpin no ambiente ServBay.

Passo 1: Criar um Diretório de Projeto

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

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

Passo 2: Usar o Composer para Criar um Projeto Sculpin

ServBay já vem com o Composer incluso, então podemos usar o Composer diretamente para criar um projeto Sculpin:

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

Passo 3: Configurar o Servidor Web

1. Adicionar um Novo Site

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

   • Nome: My Sculpin Site
   • Domínio: servbay-sculpin.local
   • Tipo de Site: PHP
   • Versão do PHP: Selecione a versão do PHP correspondente
   • Diretório Root do Site: /Applications/ServBay/www/servbay-sculpin-app/output_dev

2. Salvar Configuração

   Salve a configuração e reinicie o ServBay.

Passo 4: Construir o Site Sculpin

1. Instalar Dependências

   Execute o seguinte comando no diretório do projeto para instalar as dependências:

   composer install

2. Construir o Site

   Execute o comando abaixo para construir o site Sculpin:

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

Passo 5: Rodar o Servidor de Desenvolvimento Local

1. Iniciar o Servidor de Desenvolvimento Local

   Execute o seguinte comando para iniciar o servidor de desenvolvimento local:

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

2. Acessar o Servidor de Desenvolvimento

   Abra o navegador e acesse https://servbay-sculpin.local para ver a versão local do site Sculpin.

Passo 6: Personalizar o Site Sculpin

1. Editar Conteúdo

   Edite arquivos Markdown e arquivos de template Twig no diretório source para personalizar o conteúdo e layout do seu site.

2. Adicionar uma Nova Página

   Crie um novo arquivo Markdown no diretório source para adicionar uma nova página. Por exemplo, crie um arquivo about.md:

   ---
   title: "About Us"
   ---
   
   # About Us
   
   This is the about page.

3. Configurar o Menu de Navegação

   Edite o arquivo de template Twig do menu de navegação no diretório source/_layouts para adicionar novos links de navegação.

4. Reconstruir o Site

   Sempre que modificar o conteúdo ou templates, execute novamente o comando abaixo para construir o site Sculpin:

   vendor/bin/sculpin generate

Usando o Sculpin para Construir um Site

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

Criar Post de Blog

1. Criar Post

   Crie um novo arquivo Markdown no diretório source/_posts para adicionar um post no blog. Por exemplo, crie um arquivo 2024-06-06-my-first-post.md:

   ---
   title: "My First Post"
   date: 2024-06-06
   ---
   
   # My First Post
   
   This is the content of my first post.

2. Reconstruir o Site

   Execute o comando abaixo para construir o site Sculpin:

   vendor/bin/sculpin generate

Personalizar Estilos e Scripts

1. Editar Estilos

   Edite os arquivos CSS no diretório source/assets/css para personalizar os estilos do site.

2. Editar Scripts

   Edite os arquivos JavaScript no diretório source/assets/js para personalizar o comportamento interativo do site.

3. Compilar Recursos

   Execute o comando abaixo para compilar os arquivos CSS e JavaScript:

   vendor/bin/sculpin generate

Seguindo os passos acima, você instalou e configurou o Sculpin no ambiente ServBay com sucesso e começou a usá-lo para construir seu site. A flexibilidade e o poder do Sculpin fazem dele uma escolha ideal para construir sites estáticos.