Instalación y configuración de Kirby en el entorno de ServBay

¿Qué es Kirby?

Kirby es un sistema de gestión de contenido (CMS) flexible y potente, impulsado por archivos, ideal para construir todo tipo de sitios web. Kirby no depende de una base de datos, sino que usa el sistema de archivos para almacenar el contenido, lo cual lo hace muy ligero y fácil de desplegar.

Pasos para instalar Kirby

En este artículo, explicaremos cómo instalar y configurar Kirby 4.2 usando Composer en un entorno 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-kirby-app
cd servbay-kirby-app

Paso 2: Crear el proyecto Kirby con Composer

ServBay ya tiene Composer integrado, por lo que podemos usar Composer para crear el proyecto Kirby directamente:

composer create-project getkirby/starterkit .

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 Kirby Site
   • Dominio: servbay-kirby.local
   • Tipo de sitio web: PHP
   • Versión de PHP: 8.2
   • Directorio raíz del sitio web: /Applications/ServBay/www/servbay-kirby-app

2. Guardar configuración

   Guarda la configuración.

Paso 4: Configurar Kirby

1. Crear directorio de contenido

   En el directorio raíz del proyecto, el directorio content ya ha sido creado por Kirby Starterkit.

Paso 5: Ejecutar Kirby

1. Acceder a Kirby

   Abre el navegador y accede a https://servbay-kirby.local, donde verás la página de bienvenida predeterminada de Kirby.

Paso 6: Instalar el panel de Kirby (opcional)

Si deseas usar el panel de administración de Kirby, puedes seguir los siguientes pasos para instalarlo:

1. Acceder al panel de Kirby

   Abre el navegador y accede a https://servbay-kirby.local/panel, verás la página de instalación del panel de Kirby.

2. Crear cuenta de administrador

   Sigue las indicaciones de la página para crear una cuenta de administrador, completando el nombre de usuario, contraseña y dirección de correo electrónico, luego haz clic en "Crear cuenta".

Construir un sitio web con Kirby

Ahora que has instalado y configurado Kirby con éxito en el entorno de ServBay, puedes empezar a usarlo para construir tu sitio web. A continuación, se mencionan algunas operaciones comunes:

Crear páginas y contenido

1. Crear una página

   En el directorio content, crea un nuevo directorio de página. Por ejemplo, crea una página about:

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

2. Editar plantilla

   En el directorio site/templates, crea o edita archivos de plantilla. Por ejemplo, crea una plantilla about.php:

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

Configurar el menú de navegación

1. Editar plantilla

   En el directorio site/templates, edita el archivo de plantilla principal, por ejemplo default.php, para agregar el menú de navegación:

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

1. Agregar estilos

   En el directorio assets/css, crea un archivo CSS y referencia en el archivo de plantilla. Por ejemplo, crea style.css:

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

   Y referencia el archivo CSS en el archivo de plantilla:

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

2. Agregar scripts

   En el directorio assets/js, crea un archivo JavaScript y referencia en el archivo de plantilla. Por ejemplo, crea script.js:

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

   Y referencia el archivo JavaScript en el archivo de plantilla:

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

Siguiendo estos pasos, has instalado y configurado Kirby con éxito en el entorno de ServBay y has empezado a usarlo para construir tu sitio web. La flexibilidad y la arquitectura impulsada por archivos de Kirby lo convierten en una elección ideal para construir diversos tipos de sitios web.