Instalar y Configurar Sculpin en el Entorno de ServBay

¿Qué es Sculpin?

Sculpin es un generador de sitios web estáticos basado en PHP, adecuado para construir blogs, documentación y otros sitios web estáticos. Utiliza el motor de plantillas Twig y datos frontales en YAML, lo que hace que el desarrollo web sea muy flexible y potente.

Pasos para Instalar Sculpin

En este artículo, explicaremos cómo instalar y configurar Sculpin en el entorno de ServBay.

Paso 1: Crear el Directorio del Proyecto

Primero, crea un nuevo directorio de proyecto en el directorio www de ServBay:

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

Paso 2: Crear un Proyecto Sculpin usando Composer

ServBay ya incluye Composer, por lo que podemos usar Composer para crear el proyecto Sculpin:

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

Paso 3: Configurar el Servidor Web

1. Agregar un nuevo sitio web

   Abre ServBay, haz clic en la pestaña "Host" y agrega un nuevo sitio web:

   • Nombre: My Sculpin Site
   • Dominio: servbay-sculpin.local
   • Tipo de sitio web: PHP
   • Versión de PHP: selecciona la versión correspondiente de PHP
   • Directorio raíz del sitio web: /Applications/ServBay/www/servbay-sculpin-app/output_dev

2. Guardar configuración

   Guarda la configuración y reinicia ServBay.

Paso 4: Construir el Sitio Sculpin

1. Instalar dependencias

   Ejecuta el siguiente comando en el directorio del proyecto para instalar las dependencias:

   composer install

2. Construir el sitio web

   Ejecuta el siguiente comando para construir el sitio web Sculpin:

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

Paso 5: Ejecutar el Servidor de Desarrollo Local

1. Iniciar el servidor de desarrollo local

   Ejecuta el siguiente comando para iniciar el servidor de desarrollo local:

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

2. Acceder al servidor de desarrollo

   Abre el navegador y visita https://servbay-sculpin.local, verás la versión de desarrollo local del sitio web Sculpin.

Paso 6: Personalizar el Sitio Sculpin

1. Editar contenido

   Edita los archivos Markdown y plantillas Twig en el directorio source para personalizar el contenido y la disposición de tu sitio web.

2. Agregar nuevas páginas

   Crea nuevos archivos Markdown en el directorio source para agregar nuevas páginas. Por ejemplo, crea un archivo about.md:

   ---
   title: "About Us"
   ---
   
   # Sobre Nosotros
   
   Esta es la página sobre nosotros.

3. Configurar el menú de navegación

   Edita el archivo de plantilla Twig del menú de navegación en el directorio source/_layouts para agregar nuevos enlaces de navegación.

4. Reconstruir el sitio web

   Cada vez que modifiques contenido o plantillas, ejecuta el siguiente comando para reconstruir el sitio web Sculpin:

   vendor/bin/sculpin generate

Usar Sculpin para Construir un Sitio Web

Ahora que has instalado y configurado Sculpin en el entorno de ServBay, puedes empezar a usarlo para construir tu sitio web. Aquí hay algunas operaciones comunes:

Crear Post de Blog

1. Crear un post

   Crea nuevos archivos Markdown en el directorio source/_posts para agregar post de blog. Por ejemplo, crea un archivo 2024-06-06-my-first-post.md:

   ---
   title: "My First Post"
   date: 2024-06-06
   ---
   
   # Mi Primer Post
   
   Este es el contenido de mi primer post.

2. Reconstruir el sitio web

   Ejecuta el siguiente comando para construir el sitio web Sculpin:

   vendor/bin/sculpin generate

Personalizar Estilos y Scripts

1. Editar estilos

   Edita los archivos CSS en el directorio source/assets/css para personalizar los estilos de tu sitio web.

2. Editar scripts

   Edita los archivos JavaScript en el directorio source/assets/js para personalizar el comportamiento interactivo de tu sitio web.

3. Compilar recursos

   Ejecuta el siguiente comando para compilar los archivos CSS y JavaScript:

   vendor/bin/sculpin generate

Siguiendo los pasos anteriores, has instalado y configurado con éxito Sculpin en el entorno de ServBay, y has comenzado a usarlo para construir tu sitio web. La flexibilidad y las potentes características de Sculpin lo convierten en una excelente opción para construir sitios web estáticos.