Hakyll静态网站生成器安装指南

什么是Hakyll

Hakyll是一个基于Haskell语言的静态网站生成器，特别适合技术博客、文档网站和个人作品集的构建。它借鉴了Jekyll等静态网站生成器的理念，但提供了Haskell强大的类型系统和函数式编程能力，让网站构建过程更加可靠和可定制。

安装Hakyll的三种方式

1. 使用Cabal安装

Cabal是Haskell的包管理系统，安装步骤如下：

1. 首先确保已安装GHC和Cabal
2. 执行以下命令安装Hakyll：

   cabal new-install hakyll
   

2. 使用Stack安装

Stack是另一个Haskell构建工具，提供更可靠的依赖管理：

stack install hakyll

3. 通过Linux发行版包管理器安装

各主流Linux发行版通常也提供Hakyll的包：

• Debian/Ubuntu: apt install haskell-hakyll
• Fedora: dnf install ghc-hakyll
• Arch Linux: pacman -S haskell-hakyll
• NixOS: nix-env -iA nixos.haskellPackages.hakyll

创建示例网站

安装完成后，可以使用hakyll-init命令快速创建一个示例网站：

hakyll-init my-site

这会在当前目录下创建一个名为my-site的文件夹，包含网站的基本结构和配置文件。

构建和预览网站

使用Cabal构建

1. 进入项目目录：

   cd my-site
   

2. 构建网站：

   cabal new-run site build
   

3. 启动本地预览服务器：

   cabal new-run site watch
   

使用Stack构建

1. 进入项目目录并初始化Stack：

   cd my-site
   stack init
   

2. 构建项目：

   stack build
   

3. 构建网站：

   stack exec site build
   

4. 启动本地服务器：

   stack exec site watch
   

NixOS用户的注意事项

在NixOS上使用Stack时，需要特别注意locale设置：

1. 确保locale设置正确：

   stack --nix exec -- locale
   

2. 如果locale设置不正确，可以在项目的shell.nix中添加：

   shellHook = ''
     export LOCALE_ARCHIVE="${pkgs.glibcLocales}/lib/locale/locale-archive";
     export LANG=en_US.UTF-8
   '';
   

3. 在stack.yaml中添加必要的Nix包：

   nix:
     enable: true
     packages: [zlib.dev, zlib.out]
   

常见问题解决

1. 找不到hakyll-init命令：确保~/.ghcup/env已正确加载到shell环境中
2. 构建失败：尝试更新Haskell工具链和依赖包
3. NixOS上的locale问题：如前述方法设置正确的locale环境变量

通过以上步骤，你应该能够成功安装Hakyll并创建第一个静态网站。Hakyll的强大之处在于它的灵活性和可定制性，后续你可以通过修改site.hs文件来完全控制网站的生成逻辑和内容处理流程。