コンテンツにスキップ

Zola

Zola ↗ は、すべてが組み込まれた単一のバイナリで動作する高速な静的サイトジェネレーターです。このガイドでは、新しい Zola アプリケーションを作成し、Cloudflare Pages を使用してデプロイします。zola CLI を使用して新しい Zola サイトを作成します。

Zola のインストール

まず、インストール ↗ の手順に従って、あなたのオペレーティングシステムに応じた zola CLI をインストールします。

macOS (Homebrew)

パッケージマネージャー Homebrew ↗ を使用している場合は、ターミナルで brew install コマンドを実行して Zola をインストールします:

Terminal window
brew install zola

Windows (Chocolatey)

パッケージマネージャー Chocolatey ↗ を使用している場合は、ターミナルで choco install コマンドを実行して Zola をインストールします:

Terminal window
choco install zola

Windows (Scoop)

パッケージマネージャー Scoop ↗ を使用している場合は、ターミナルで scoop install コマンドを実行して Zola をインストールします:

Terminal window
scoop install zola

Linux (pkg)

あなたの Linux ディストリビューションのパッケージマネージャーに Zola が含まれている場合があります。この場合、ディストリビューションのパッケージマネージャーを使用して直接インストールできます。例えば、pkg を使用して、ターミナルで次のコマンドを実行します:

Terminal window
pkg install zola

もしあなたのパッケージマネージャーに Zola が含まれていない場合や、リリースを直接ダウンロードしたい場合は、以下の 手動 セクションを参照してください。

手動インストール

Zola の GitHub リポジトリには、さまざまなオペレーティングシステム用の Zola コマンドラインツールのプリビルドバージョンが含まれており、リリースページ ↗ で見つけることができます。

これらのリリースのインストールに関する詳細な手順については、Zola のインストールガイド ↗ を参照してください。

新しいプロジェクトの作成

Zola をインストールしたら、デフォルトのテンプレートを使用してターミナルで zola init コマンドを実行して新しいプロジェクトを作成します:

Terminal window
zola init my-zola-project

zola init を実行すると、3つの質問が表示されます:

  1. あなたのサイトの URL は何ですか? (https://example.com ↗): これは今のところ空白のままで大丈夫です。

  2. Sass コンパイルを有効にしますか? [Y/n]: Y

  3. 構文ハイライトを有効にしますか? [y/N]: y

  4. コンテンツの検索インデックスを構築しますか? [y/N]: y

Before you continue

All of the framework guides assume you already have a fundamental understanding of Git ↗. If you are new to Git, refer to this summarized Git handbook ↗ on how to set up Git on your local machine.

If you clone with SSH, you must generate SSH keys ↗ on each computer you use to push or pull from GitHub.

Refer to the GitHub documentation ↗ and Git documentation ↗ for more information.

Create a GitHub repository

Create a new GitHub repository by visiting repo.new ↗. After creating a new repository, go to your newly created project directory to prepare and push your local application to GitHub by running the following commands in your terminal:

Terminal window
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git branch -M main
git push -u origin main

Cloudflare Pages でのデプロイ

サイトを Pages にデプロイするには:

  1. Cloudflare ダッシュボード ↗ にログインし、アカウントを選択します。
  2. アカウントホームで、Workers & Pages > アプリケーションを作成 > Pages > Git に接続 を選択します。
  3. 作成した新しい GitHub リポジトリを選択し、ビルドとデプロイの設定 セクションで次の情報を提供します:
Configuration option Value
Production branch main
Build command zola build
Build directory public

設定の下で、ZOLA_VERSION を指定するための 環境変数 (高度な設定) を設定することを忘れないでください。

例えば、ZOLA_VERSION: 0.17.2。

サイトの設定が完了したら、最初のデプロイを開始できます。Cloudflare Pages が zola、プロジェクトの依存関係をインストールし、サイトをビルドしてからデプロイするのを見ることができるでしょう。

サイトをデプロイした後、プロジェクト用のユニークなサブドメインが *.pages.dev で提供されます。

そのサブドメインを config.toml ファイルの base_url として追加できます。

例えば:

# サイトがビルドされる URL
base_url = "https://my-zola-project.pages.dev"

Zola サイトに新しいコードをコミットするたびに、Cloudflare Pages は自動的にプロジェクトを再ビルドしてデプロイします。また、新しいプルリクエストで プレビュー デプロイメント にアクセスできるため、変更が本番環境にデプロイされる前にサイトにどのように表示されるかをプレビューできます。

Learn more

By completing this guide, you have successfully deployed your Zola site to Cloudflare Pages. To get started with other frameworks, refer to the list of Framework guides.