Pemasangan dan Konfigurasi Kirby CMS di Persekitaran ServBay

Kirby ialah sistem pengurusan kandungan (CMS) yang fleksibel dan berkuasa, dipacu oleh fail, sesuai untuk membina pelbagai jenis laman web. Tidak seperti CMS berasaskan pangkalan data tradisional, Kirby menyimpan kandungan dalam sistem fail, menjadikannya sangat ringan, mudah untuk kawalan versi dan proses penyebaran yang ringkas.

Panduan ini akan menerangkan cara memasang dan mengkonfigurasi Kirby 4.2 Starterkit menggunakan Composer dalam persekitaran pembangunan web tempatan ServBay—sebuah platform yang telah dipratetapkan PHP, pelayan web (seperti Caddy atau Nginx), dan Composer, sesuai untuk pembangunan Kirby secara setempat.

Keperluan Asas

Sebelum memulakan, pastikan anda telah:

Memasang dan menjalankan ServBay di macOS.
Mengaktifkan versi PHP yang diperlukan dalam ServBay (PHP 8.2 digunakan dalam contoh ini).
Composer telah tersedia dalam ServBay, tiada pemasangan tambahan diperlukan.

Langkah-langkah Pemasangan Kirby

Berikut adalah cara terperinci memasang dan mengkonfigurasi Kirby dalam persekitaran ServBay:

Langkah 1: Cipta Direktori Projek

Mula-mula, buka aplikasi Terminal. Navigasi ke direktori root laman web lalai ServBay /Applications/ServBay/www dan cipta satu direktori projek baharu. Kita akan namakan projek contoh ini sebagai servbay-kirby-app.

bash

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

Langkah 2: Cipta Projek Kirby Menggunakan Composer

Composer telah diintegrasikan ke dalam ServBay, jadi anda boleh gunakannya terus di Terminal. Dalam direktori projek servbay-kirby-app, jalankan perintah Composer berikut untuk memuat turun dan memulakan projek Kirby Starterkit:

bash

composer create-project getkirby/starterkit .

Perintah ini akan memuat turun fail teras Kirby, kebergantungan, serta Starterkit yang mengandungi kandungan dan templat asas ke dalam direktori semasa (.).

Langkah 3: Konfigurasi Pelayan Web (Tambah Laman Web di ServBay)

Supaya pelayan web ServBay (seperti Caddy atau Nginx) dapat memaparkan projek Kirby anda, anda perlu menambah konfigurasi laman baharu dalam aplikasi ServBay.

Buka aplikasi ServBay: Jalankan aplikasi ServBay.
Masuk ke Pengurusan Laman: Klik tab "Laman Web" di bar navigasi kiri tetingkap ServBay.
Tambahkan Laman Baharu: Klik butang "+" di bawah antara muka atau pilih opsyen tambah laman yang sepadan.
Isikan Maklumat Laman: Dalam tetingkap konfigurasi yang muncul, lengkapkan maklumat berikut:
- Nama: Berikan nama yang mudah dikenali, seperti Laman Kirby Saya.
- Domain: Tetapkan domain pembangunan tempatan. Disarankan menggunakan akhiran .local atau .servbay.demo. Contoh: servbay-kirby.local. ServBay akan uruskan DNS tempatan secara automatik.
- Jenis Laman: Pilih PHP, kerana Kirby ialah aplikasi PHP.
- Versi PHP: Pilih versi PHP yang dikehendaki, contohnya 8.2. Pastikan versi ini memenuhi keperluan minimal Kirby.
- Direktori Root Laman: Pilih direktori yang mengandungi fail index.php projek Kirby anda. Untuk Starterkit, ini ialah direktori root projek yang dibuat pada Langkah 1: /Applications/ServBay/www/servbay-kirby-app.
Simpan Konfigurasi: Selepas maklumat disahkan betul, klik butang simpan. ServBay akan menerapkan konfigurasi baharu, dan mungkin perlu memulakan semula pelayan web berkenaan.

Langkah 4: Konfigurasi Asas Kirby

Konfigurasi utama Kirby dikendalikan melalui fail site/config/config.php. Untuk Starterkit, konfigurasi asas sudah lengkap dan boleh terus dijalankan. Anda boleh menambah tetapan seperti berikut:

Aktifkan mod debug (c::set('debug', true);)
Konfigurasi bahasa panel
Mendefinisikan laluan khusus dan sebagainya

Direktori content telah diwujudkan secara automatik oleh Starterkit Kirby, berfungsi untuk simpanan semua kandungan halaman.

Langkah 5: Jalankan dan Akses Laman Kirby

Dengan konfigurasi ServBay selesai, laman Kirby anda boleh diakses menggunakan domain yang telah anda tentukan.

Pastikan ServBay Berjalan: Sahkan aplikasi ServBay sedang berjalan, serta pelayan web (Caddy atau Nginx) dan pakej PHP berkaitan telah diaktifkan.
Akses Laman Web: Buka pelayar web anda dan masukkan domain yang telah disediakan pada Langkah 3, contoh: https://servbay-kirby.local.

Anda sepatutnya melihat halaman selamat datang Kirby Starterkit. ServBay mengaktifkan HTTPS secara lalai, jadi digalakkan untuk menggunakan https://.

Langkah 6: Pasang dan Guna Panel Kirby (Pilihan)

Kirby menawarkan panel pengurusan yang berkuasa bagi memudahkan anda urus kandungan, pengguna dan tetapan laman anda.

Akses Halaman Pemasangan Panel: Selepas domain laman web dibuka, tambah laluan /panel pada URL, contohnya https://servbay-kirby.local/panel.
Cipta Akaun Admin: Jika ini kali pertama mengakses /panel, anda akan diarahkan ke halaman pemasangan. Ikut arahan untuk mengisi maklumat (nama pengguna, kata laluan, alamat emel) dan mencipta akaun admin pertama anda.
Log Masuk ke Panel: Selepas akaun dicipta, anda boleh log masuk ke panel Kirby dan mula mengurus kandungan laman melalui antara muka grafik.

Membangun Laman Web dengan Kirby

Kini anda telah berjaya memasang dan mengkonfigurasi Kirby di persekitaran ServBay. Anda boleh memanfaatkan kelebihan fail didorong Kirby untuk membina laman web mengikut keperluan. Berikut beberapa konsep dan operasi asas pembangunan Kirby:

Struktur Kandungan (Content)

Kandungan dalam Kirby disimpan dalam direktori content. Setiap halaman diwakili oleh satu folder di dalamnya. Kandungan halaman biasanya dalam fail teks (seperti page.txt) yang menggunakan format mirip Markdown.

Contoh: Cipta Halaman "Tentang Kami"

Dalam Terminal:

bash

cd /Applications/ServBay/www/servbay-kirby-app
mkdir content/about
echo "Title: Tentang Kami\n----\nIni adalah kandungan halaman tentang kami." > content/about/about.txt

Akses https://servbay-kirby.local/about (jika templat anda menyokongnya).

Templat (Templates)

Fail templat terletak di site/templates dan menentukan cara halaman dipaparkan. Nama fail biasanya sepadan dengan nama folder kandungan atau nama blueprint (contoh, about.php untuk folder content/about atau halaman dengan blueprint about).

Contoh: Cipta Templat about.php

Dalam fail site/templates/about.php:

php

<?php snippet('header') ?>

<main>
  <h1><?= $page->title() ?></h1>
  <div class="text">
    <?= $page->text()->kt() // Paparkan teks menggunakan KirbyText ?>
  </div>
</main>

<?php snippet('footer') ?>

Di sini, fungsi snippet() digunakan untuk menyertakan bahagian boleh guna semula seperti header dan footer.

Blueprint (Blueprints)

Fail blueprints berada di site/blueprints dan menentukan struktur, medan, serta opsyen halaman dalam panel. Ia disusun dalam format YAML.

Contoh: Cipta Blueprint about.yml

Dalam fail site/blueprints/pages/about.yml:

yaml

title: Halaman Tentang

columns:
  - width: 2/3
    fields:
      text:
        label: Kandungan Teks
        type: textarea
        size: large
        buttons:
          - bold
          - italic
          - link
          - email

  - width: 1/3
    fields:
      # Medan sidebar seperti muat naik gambar
      cover_image:
        label: Imej Muka Depan
        type: files
        max: 1
        uploads:
          template: image

Selepas blueprint didaftarkan, apabila anda cipta halaman "Tentang" baru di panel, medan yang ditetapkan akan muncul.

Snippet (Potongan Kod)

Snippet ialah fail PHP boleh guna semula untuk bahagian seperti header, footer, navigasi, dan diletakkan di site/snippets.

Pengawal (Controllers) dan Model (Models)

Untuk logik lebih kompleks, gunakan pengawal (site/controllers) untuk memproses data laman, dan model (site/models) untuk mendefinisikan kelas halaman tersendiri.

Aset Statik (Assets)

Aset seperti CSS, JavaScript, dan imej biasanya diletakkan dalam folder assets di root projek. Dalam templat, gunakan fungsi pembantu url('assets/...') untuk mendapatkan URL aset tersebut.

Contoh: Pautkan CSS dan JS

Dalam site/templates/default.php atau site/snippets/header.php:

php

<link rel="stylesheet" href="<?= url('assets/css/style.css') ?>">
<script src="<?= url('assets/js/script.js') ?>"></script>

Rumusan

Melalui langkah-langkah ini, anda telah berjaya memasang serta mengkonfigurasi Kirby CMS dalam persekitaran pembangunan tempatan ServBay. Persekitaran terintegrasi ServBay memudahkan proses deployment dan pengurusan aplikasi PHP, membolehkan anda fokus kepada ciri-ciri hebat Kirby serta fleksibiliti berasaskan fail untuk membina dan membangun laman projek anda. Kini anda boleh terus menerokai konsep templat, blueprint, snippet dan banyak lagi untuk mereka bentuk struktur laman dan fungsi yang lebih canggih dalam Kirby.

Pemasangan dan Konfigurasi Kirby CMS di Persekitaran ServBay ​

Keperluan Asas ​

Langkah-langkah Pemasangan Kirby ​

Langkah 1: Cipta Direktori Projek ​

Langkah 2: Cipta Projek Kirby Menggunakan Composer ​

Langkah 3: Konfigurasi Pelayan Web (Tambah Laman Web di ServBay) ​

Langkah 4: Konfigurasi Asas Kirby ​

Langkah 5: Jalankan dan Akses Laman Kirby ​

Langkah 6: Pasang dan Guna Panel Kirby (Pilihan) ​

Membangun Laman Web dengan Kirby ​

Struktur Kandungan (Content) ​

Templat (Templates) ​

Blueprint (Blueprints) ​

Snippet (Potongan Kod) ​

Pengawal (Controllers) dan Model (Models) ​

Aset Statik (Assets) ​

Rumusan ​

Pemasangan dan Konfigurasi Kirby CMS di Persekitaran ServBay

Keperluan Asas

Langkah-langkah Pemasangan Kirby

Langkah 1: Cipta Direktori Projek

Langkah 2: Cipta Projek Kirby Menggunakan Composer

Langkah 3: Konfigurasi Pelayan Web (Tambah Laman Web di ServBay)

Langkah 4: Konfigurasi Asas Kirby

Langkah 5: Jalankan dan Akses Laman Kirby

Langkah 6: Pasang dan Guna Panel Kirby (Pilihan)

Membangun Laman Web dengan Kirby

Struktur Kandungan (Content)

Templat (Templates)

Blueprint (Blueprints)

Snippet (Potongan Kod)

Pengawal (Controllers) dan Model (Models)

Aset Statik (Assets)

Rumusan