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

时间:2019-01-24 02:08:19

标签: haskell pandoc asciidoc hakyll

我跟随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的问题吗? 可以将asciidochakyll一起使用吗?

1 个答案:

答案 0 :(得分:5)

当前的Pandoc可以编写Asciidoc,但无法读取它:Issue

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

但是,Hakyll具有unixFilter,它可以使用任何从stdin输入并输出到stdout的命令。因此,您可以调用asciidoctor命令来转换.asciidoc文件。

这是步骤:

1。安装asciidoctor

的Ubuntu

$ apt-get install asciidoctor

软呢帽

$ dnf install asciidoctor

Arch Linux

$ pacman -S asciidoctor

红宝石宝石

$ 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

pandocCompiler中的site.hs替换为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