在 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 的靈活性和文件驅動的架構使其成為構建各種類型網站的理想選擇。