在 ServBay 环境中安装和配置 Sculpin
什么是 Sculpin?
Sculpin 是一个基于 PHP 的静态网站生成器,适用于构建博客、文档和其他静态网站。它使用 Twig 模板引擎和 YAML 前端数据,使得网站开发变得非常灵活和强大。
安装 Sculpin 的步骤
在这篇文章中,我们将介绍如何在 ServBay 环境中安装和配置 Sculpin。
步骤 1:创建项目目录
首先,在 ServBay 的 www
目录中创建一个新的项目目录:
cd /Applications/ServBay/www
mkdir servbay-sculpin-app
cd servbay-sculpin-app
2
3
步骤 2:使用 Composer 创建 Sculpin 项目
ServBay 已经自带 Composer,因此我们可以直接使用 Composer 来创建 Sculpin 项目:
composer create-project sculpin/sculpin-blog-skeleton .
步骤 3:配置 Web 服务器
添加新网站
打开 ServBay,点击「主机」标签,添加一个新的网站:
- 名字:
My Sculpin Site
- 域名:
servbay-sculpin.local
- 网站类型:
PHP
- PHP 版本:选择对应的 PHP 版本
- 网站根目录:
/Applications/ServBay/www/servbay-sculpin-app/output_dev
- 名字:
保存配置
保存配置并重启 ServBay。
步骤 4:构建 Sculpin 网站
安装依赖
在项目目录中运行以下命令来安装依赖:
bashcomposer install
1构建网站
运行以下命令来构建 Sculpin 网站:
bashvendor/bin/sculpin generate --watch --server
1
步骤 5:运行本地开发服务器
启动本地开发服务器
运行以下命令来启动本地开发服务器:
bashvendor/bin/sculpin generate --server --watch
1访问开发服务器
打开浏览器,访问
https://servbay-sculpin.local
,你将看到 Sculpin 网站的本地开发版本。
步骤 6:自定义 Sculpin 网站
编辑内容
在
source
目录中编辑 Markdown 文件和 Twig 模板文件,以自定义你的网站内容和布局。添加新页面
在
source
目录中创建新的 Markdown 文件,以添加新页面。例如,创建一个about.md
文件:markdown--- title: "About Us" --- # About Us This is the about page.
1
2
3
4
5
6
7配置导航菜单
在
source/_layouts
目录中编辑导航菜单的 Twig 模板文件,以添加新的导航链接。重新构建网站
每次修改内容或模板后,重新运行以下命令来构建 Sculpin 网站:
bashvendor/bin/sculpin generate
1
使用 Sculpin 构建网站
现在你已经成功在 ServBay 环境中安装和配置了 Sculpin,可以开始使用它来构建你的网站了。以下是一些常见的操作:
创建博客文章
创建文章
在
source/_posts
目录中创建新的 Markdown 文件,以添加博客文章。例如,创建一个2024-06-06-my-first-post.md
文件:markdown--- title: "My First Post" date: 2024-06-06 --- # My First Post This is the content of my first post.
1
2
3
4
5
6
7
8重新构建网站
运行以下命令来构建 Sculpin 网站:
bashvendor/bin/sculpin generate
1
自定义样式和脚本
编辑样式
在
source/assets/css
目录中编辑 CSS 文件,以自定义网站的样式。编辑脚本
在
source/assets/js
目录中编辑 JavaScript 文件,以自定义网站的交互行为。编译资源
运行以下命令来编译 CSS 和 JavaScript 文件:
bashvendor/bin/sculpin generate
1
通过以上步骤,您成功在 ServBay 环境中安装和配置了 Sculpin,并开始使用它来构建你的网站。Sculpin 的灵活性和强大功能使其成为构建静态网站的理想选择。