是否可以将 asciidoc 与 hakyll 一起使用？

Question

我跟着 this tutorial 使用 hakyll 创建了一个基本的静态网页。它包括许多从 posts 目录中的 markdown 呈现的页面，例如2015-08-12-spqr.markdown.

我更喜欢 asciidoc 而不是 markdown，并尝试将 asciidoc 2018-01-23_adoc-user-manual.asciidoc 添加到 post 目录。但是，hakyll 在尝试编译页面时抛出错误：

Initialising...
  Creating store...
  Creating provider...
  Running rules...
Checking for out-of-date items
Compiling
  updated templates/default.html
  updated about.rst
  updated templates/post.html
  updated posts/2015-08-12-spqr.markdown
  updated posts/2015-10-07-rosa-rosa-rosam.markdown
  updated posts/2015-11-28-carpe-diem.markdown
  updated posts/2015-12-07-tu-quoque.markdown
  [ERROR] Hakyll.Web.readPandocWith: I don't know how to read a file of the type Binary for: posts/2018-01-23_adoc-user-manual.asciidoc
CallStack (from HasCallStack):
  error, called at lib/Hakyll/Web/Pandoc.hs:66:31 in hakyll-4.12.5.0-8ZITvFN5YREEKv6B76SCAd:Hakyll.Web.Pandoc

这个问题是pandocCompiler无法解决的asciidoc吗？是否可以将 asciidoc 与 hakyll 一起使用？

Answer 1

当前的 Pandoc 可以写 Asciidoc 但不能读：Issue.

此外，似乎没有用Haskell编写的Asciidoc解析器，所以没有纯粹的Haskell解决方案。

然而，Hakyll 有 unixFilter 可以使用任何从 stdin 输入并输出到 stdout 的命令。因此，您可以调用asciidoctor命令转换.asciidoc文件。

步骤如下：

1。安装 asciidoctor

Ubuntu

$ apt-get install asciidoctor

软呢帽

$ dnf install asciidoctor

拱门 Linux

$ pacman -S asciidoctor

Ruby Gem

$ gem install asciidoctor

2。定义 pandocCompilerWithAsciidoctor

将以下代码添加到 site.hs

pandocCompilerWithAsciidoctor :: Compiler (Item String)
pandocCompilerWithAsciidoctor = do
  extension <- getUnderlyingExtension
  if extension == ".asciidoc" then
    getResourceString >>= withItemBody (unixFilter "asciidoctor" ["-"])
  else
    pandocCompiler

将site.hs中的pandocCompiler替换为pandocCompilerWithAsciidoctor

3。重新编译

$ stack build
$ stack exec site rebuild

注意文件名必须是 2018-01-23-adoc-user-manual.asciidoc 而不是 2018-01-23_adoc-user-manual.asciidoc，否则会出现错误：[ERROR] Missing field $date$ in context for item posts/2018-01-23_adoc-user-manual.asciidoc

是否可以将 asciidoc 与 hakyll 一起使用？

Is it possible to use asciidoc with hakyll?

haskell

asciidoc

pandoc

hakyll

1。安装 asciidoctor

2。定义 pandocCompilerWithAsciidoctor

3。重新编译