安装

Zola 在 GitHub 发布页面 上提供了适用于 MacOS、Linux 和 Windows 的预构建二进制文件。

🔗macOS

Zola 可通过 Brew 获取：

$ brew install zola

Zola 也可通过 MacPorts 获取：

$ sudo port install zola

🔗Arch Linux

Zola 已收录在官方 Arch Linux 仓库中。

$ pacman -S zola

🔗Alpine Linux

自 Alpine v3.13 起，Zola 已收录在官方 Alpine Linux 社区仓库中。

如有必要，请参阅 Alpine Wiki 的这一部分，了解如何启用社区仓库：https://wiki.alpinelinux.org/wiki/Repositories#Enabling_the_community_repository

$ apk add zola

🔗Debian

Zola 可在 barnumbirr/zola-debian 获取。 下载适用于您的 Debian 版本的最新 .deb 包，然后运行：

$ sudo dpkg -i zola_<version>_amd64_debian_<debian_version>.deb

🔗Gentoo

Zola 可通过 GURU 获取。

请参阅最终用户文档以了解如何启用 GURU 仓库。之后只需运行：

$ sudo emerge --ask www-apps/zola

🔗Void Linux

Zola 已收录在官方 Void Linux 仓库中。

$ sudo xbps-install zola

🔗FreeBSD

Zola 已收录在官方软件包仓库中。

$ pkg install zola

🔗OpenBSD

Zola 已收录在官方软件包仓库中。

$ doas pkg_add zola

🔗openSUSE

🔗openSUSE Tumbleweed

Zola 已收录在官方 openSUSE Tumbleweed 主 OSS 仓库中。

$ sudo zypper install zola

🔗openSUSE Leap

Zola 已收录在官方实验性 utilities 仓库中。

$ sudo zypper addrepo https://download.opensuse.org/repositories/utilities/15.6/utilities.repo
$ sudo zypper refresh
$ sudo zypper install zola

🔗pkgsrc

Zola 已收录在官方软件包仓库中，可通过 pkgin 安装。

$ pkgin install zola

🔗Snapcraft

Zola 可在 snapcraft 上获取：

$ snap install --edge zola

🔗Flatpak

Zola 作为 flatpak 可在 flathub 上获取：

$ flatpak install flathub org.getzola.zola

要使用 zola：

$ flatpak run org.getzola.zola [command]

为了避免每次都输入这个命令，可以在 ~/.bashrc 中创建一个别名：

$ alias zola="flatpak run org.getzola.zola"

🔗NixOS / Nixpkgs

Zola 已收录 在 nixpkgs 仓库中。如果您使用的是 NixOS，可以通过将以下内容添加到 /etc/nixos/configuration.nix 来安装 Zola：

environment.systemPackages = [
  pkgs.zola
];

如果您在其他操作系统中使用 Nix 作为包管理器，可以使用以下命令安装：

nix-env -iA nixpkgs.zola

🔗通过 Github Actions

Zola 可以通过 taiki-e/install-action 在 GHA 工作流中安装。 只需将其添加到您的 CI 配置中，例如：

jobs:
  foo:
    steps:
      - uses: taiki-e/install-action@v2
        with:
          tool: zola@0.19.1
      # ...

查看 action 仓库以获取文档和更多示例。

🔗Docker

Zola 可在 GitHub 容器注册表上获取。 它没有 latest 标签，您需要指定特定的版本来拉取。

$ docker pull ghcr.io/getzola/zola:v0.19.1

🔗构建 (Build)

$ docker run -u "$(id -u):$(id -g)" -v $PWD:/app --workdir /app ghcr.io/getzola/zola:v0.19.1 build

🔗服务 (Serve)

$ docker run -u "$(id -u):$(id -g)" -v $PWD:/app --workdir /app -p 8080:8080 ghcr.io/getzola/zola:v0.19.1 serve --interface 0.0.0.0 --port 8080 --base-url localhost

您现在可以浏览 http://localhost:8080。

🔗多阶段构建

由于 Zola docker 镜像中没有 shell，如果您想在 Dockerfile 中使用它，必须使用 RUN 的 exec 形式，如下所示：

FROM ghcr.io/getzola/zola:v0.19.1 as zola

COPY . /project
WORKDIR /project
RUN ["zola", "build"]

🔗Windows

Zola 可以使用官方 Winget 命令安装：

$ winget install getzola.zola

也可以在 Scoop 上获取：

$ scoop install zola

以及 Chocolatey：

$ choco install zola

Zola 在 PowerShell ISE 中无法工作。

🔗从源码构建

要从源码构建 Zola，您需要安装 Rust 和 Cargo。

在终端中，您现在可以运行以下命令：

$ cargo install --locked --git https://github.com/getzola/zola
$ zola --version

如果您遇到类似 error: failed to run custom build command for 'ring v0.16.20' 的编译错误，可以尝试以下命令：

$ cargo install --locked --no-default-features --features=native-tls --git https://github.com/getzola/zola

Cargo 会将 zola 二进制文件安装在 ~/.cargo/bin/ 中。 如果需要，您可以将其移动到站点的仓库中。