Cài đặt và cấu hình Sculpin trong môi trường ServBay

Sculpin là gì?

Sculpin là một trình tạo trang web tĩnh dựa trên PHP, thích hợp cho việc xây dựng blog, tài liệu và các trang web tĩnh khác. Nó sử dụng Twig template engine và YAML front matter, làm cho quá trình phát triển trang web trở nên rất linh hoạt và mạnh mẽ.

Các bước cài đặt Sculpin

Trong bài viết này, chúng ta sẽ hướng dẫn cách cài đặt và cấu hình Sculpin trong môi trường ServBay.

Bước 1: Tạo thư mục dự án

Đầu tiên, tạo một thư mục dự án mới trong thư mục www của ServBay:

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

Bước 2: Sử dụng Composer để tạo dự án Sculpin

ServBay đã có sẵn Composer, vì vậy chúng ta có thể sử dụng Composer để tạo dự án Sculpin:

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

Bước 3: Cấu hình máy chủ Web

1. Thêm trang web mới

   Mở ServBay, chọn tab "Hosts", thêm một trang web mới:

   • Tên: My Sculpin Site
   • Tên miền: servbay-sculpin.local
   • Loại trang web: PHP
   • Phiên bản PHP: Chọn phiên bản PHP phù hợp
   • Thư mục gốc trang web: /Applications/ServBay/www/servbay-sculpin-app/output_dev

2. Lưu cấu hình

   Lưu cấu hình và khởi động lại ServBay.

Bước 4: Xây dựng trang web Sculpin

1. Cài đặt phụ thuộc

   Trong thư mục dự án, chạy lệnh sau để cài đặt các phụ thuộc:

   composer install

2. Xây dựng trang web

   Chạy lệnh sau để xây dựng trang web Sculpin:

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

Bước 5: Chạy máy chủ phát triển cục bộ

1. Khởi động máy chủ phát triển cục bộ

   Chạy lệnh sau để khởi động máy chủ phát triển cục bộ:

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

2. Truy cập máy chủ phát triển

   Mở trình duyệt và truy cập https://servbay-sculpin.local, bạn sẽ thấy phiên bản phát triển cục bộ của trang web Sculpin.

Bước 6: Tùy chỉnh trang web Sculpin

1. Chỉnh sửa nội dung

   Chỉnh sửa các tệp Markdown và tệp Twig template trong thư mục source để tùy chỉnh nội dung và bố cục trang web.

2. Thêm trang mới

   Tạo các tệp Markdown mới trong thư mục source để thêm các trang mới. Ví dụ, tạo tệp about.md:

   ---
   title: "About Us"
   ---
   
   # About Us
   
   Đây là trang giới thiệu.

3. Cấu hình menu điều hướng

   Chỉnh sửa tệp Twig template của menu điều hướng trong thư mục source/_layouts để thêm các liên kết điều hướng mới.

4. Xây dựng lại trang web

   Sau mỗi lần chỉnh sửa nội dung hoặc template, chạy lệnh sau để xây dựng lại trang web Sculpin:

   vendor/bin/sculpin generate

Sử dụng Sculpin để xây dựng trang web

Bây giờ bạn đã cài đặt và cấu hình thành công Sculpin trong môi trường ServBay, bạn có thể bắt đầu sử dụng nó để xây dựng trang web của mình. Dưới đây là một số thao tác phổ biến:

Tạo bài đăng blog

1. Tạo bài đăng

   Tạo tệp Markdown mới trong thư mục source/_posts để thêm bài đăng blog. Ví dụ, tạo tệp 2024-06-06-my-first-post.md:

   ---
   title: "Bài viết đầu tiên của tôi"
   date: 2024-06-06
   ---
   
   # Bài viết đầu tiên của tôi
   
   Đây là nội dung của bài viết đầu tiên của tôi.

2. Xây dựng lại trang web

   Chạy lệnh sau để xây dựng lại trang web Sculpin:

   vendor/bin/sculpin generate

Tùy chỉnh kiểu dáng và kịch bản

1. Chỉnh sửa kiểu dáng

   Chỉnh sửa tệp CSS trong thư mục source/assets/css để tùy chỉnh kiểu dáng trang web.

2. Chỉnh sửa kịch bản

   Chỉnh sửa tệp JavaScript trong thư mục source/assets/js để tùy chỉnh hành vi tương tác của trang web.

3. Biên dịch tài nguyên

   Chạy lệnh sau để biên dịch các tệp CSS và JavaScript:

   vendor/bin/sculpin generate

Thông qua các bước trên, bạn đã thành công cài đặt và cấu hình Sculpin trong môi trường ServBay và bắt đầu sử dụng nó để xây dựng trang web của mình. Sculpin với sự linh hoạt và tính năng mạnh mẽ là một lựa chọn lý tưởng để xây dựng các trang web tĩnh.