在 ServBay 环境中安装和配置 Kirby

什么是 Kirby？

Kirby 是一个灵活且强大的文件驱动内容管理系统（CMS），适用于构建各种类型的网站。Kirby 不依赖数据库，而是使用文件系统来存储内容，这使得它非常轻量且易于部署。

安装 Kirby 的步骤

在这篇文章中，我们将介绍如何在 ServBay 环境中使用 Composer 安装和配置 Kirby 4.2。

步骤 1：创建项目目录

首先，在 ServBay 的 www 目录中创建一个新的项目目录：

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

步骤 2：使用 Composer 创建 Kirby 项目

ServBay 已经自带 Composer，因此我们可以直接使用 Composer 来创建 Kirby 项目：

composer create-project getkirby/starterkit .

步骤 3：配置 Web 服务器

1. 添加新网站

   打开 ServBay，点击「主机」标签，添加一个新的网站：

   • 名字：My Kirby Site
   • 域名：servbay-kirby.local
   • 网站类型：PHP
   • PHP 版本：8.2
   • 网站根目录：/Applications/ServBay/www/servbay-kirby-app

2. 保存配置

   保存配置。

步骤 4：配置 Kirby

1. 创建内容目录

   在项目根目录中，content 目录已经由 Kirby Starterkit 创建。

步骤 5：运行 Kirby

1. 访问 Kirby

   打开浏览器，访问 https://servbay-kirby.local，你将看到 Kirby 的默认欢迎页面。

步骤 6：安装 Kirby 面板（可选）

如果你想使用 Kirby 的管理面板，可以按照以下步骤进行安装：

1. 访问 Kirby 面板

   打开浏览器，访问 https://servbay-kirby.local/panel，你将看到 Kirby 面板的安装页面。

2. 创建管理员账户

   按照页面提示创建管理员账户，填写用户名、密码和邮箱地址，然后点击「创建账户」。

使用 Kirby 构建网站

现在你已经成功在 ServBay 环境中安装和配置了 Kirby，可以开始使用它来构建你的网站了。以下是一些常见的操作：

创建页面和内容

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. 添加样式

   在 assets/css 目录中创建 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. 添加脚本

   在 assets/js 目录中创建 JavaScript 文件，并在模板文件中引用。例如，创建 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>

通过以上步骤，您成功在 ServBay 环境中安装和配置了 Kirby，并开始使用它来构建你的网站。Kirby 的灵活性和文件驱动的架构使其成为构建各种类型网站的理想选择。