ServBay 環境での Sculpin のインストールと設定

Sculpin とは？

Sculpin は、ブログ、ドキュメント、その他の静的サイトの構築に適した PHP ベースの静的サイトジェネレーターです。Twig テンプレートエンジンと YAML フロントマターを使用しているため、サイト開発が非常に柔軟かつ強力です。

Sculpin のインストール手順

この記事では、ServBay 環境で Sculpin をインストールして設定する方法を紹介します。

手順 1：プロジェクトディレクトリを作成

まず、ServBay の www ディレクトリに新しいプロジェクトディレクトリを作成します：

bash

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

手順 2：Composer を使用して Sculpin プロジェクトを作成

ServBay にはComposer が組み込まれているので、Composer を使用して Sculpin プロジェクトを作成できます：

bash

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 サイトをビルド

依存関係をインストール
プロジェクトディレクトリで以下のコマンドを実行し、依存関係をインストールします：
bash
```
composer install
```
1
サイトをビルド
以下のコマンドを実行して Sculpin サイトをビルドします：
bash
```
vendor/bin/sculpin generate --watch --server
```
1

手順 5：ローカル開発サーバーを実行

ローカル開発サーバーを開始
以下のコマンドを実行してローカル開発サーバーを開始します：
bash
```
vendor/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 サイトをビルドします：
bash
```
vendor/bin/sculpin generate
```
1

Sculpin を使ったサイト構築

これで、ServBay 環境に Sculpin をインストールして設定できました。次に、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 サイトをビルドします：
bash
```
vendor/bin/sculpin generate
```
1

スタイルとスクリプトのカスタマイズ

スタイルを編集
source/assets/css ディレクトリで CSS ファイルを編集して、サイトのスタイルをカスタマイズします。
スクリプトを編集
source/assets/js ディレクトリで JavaScript ファイルを編集して、サイトのインタラクションをカスタマイズします。
リソースのコンパイル
以下のコマンドを実行して、CSS と JavaScript ファイルをコンパイルします：
bash
```
vendor/bin/sculpin generate
```
1

これらの手順を実行することで、ServBay 環境で Sculpin をインストールおよび設定し、サイト構築を開始することができます。Sculpin の柔軟性と強力な機能により、静的サイトの構築には最適な選択肢となります。

ServBay 環境での Sculpin のインストールと設定 ​

Sculpin とは？ ​

Sculpin のインストール手順 ​

手順 1：プロジェクトディレクトリを作成 ​

手順 2：Composer を使用して Sculpin プロジェクトを作成 ​

手順 3：Web サーバーを設定 ​

手順 4：Sculpin サイトをビルド ​

手順 5：ローカル開発サーバーを実行 ​

手順 6：Sculpin サイトをカスタマイズ ​

Sculpin を使ったサイト構築 ​

ブログ投稿を作成 ​

スタイルとスクリプトのカスタマイズ ​