haskell - 如何在 Hakyll 中使用 Pandoc 过滤器？

Question

我很抱歉问这样的问题。但我对 Haskell 真的很陌生。我在互联网上搜索了一整天，但没有找到任何示例。

我有一个用 python 编写的 pandoc 过滤器( tikzcd.py )。我想使用该过滤器来处理我的博客文章。

我想我需要使用 unixFilter或 pandocCompileWithTransform但是我对 Haskell 的了解真的不足以自己找到解决方案。

那么，有人可以给我举个例子吗？

- - - - - -更新 - - - - - - - -

@Michael 使用 pandocCompileWithTransformM 给出了解决方案和 unixFilter .有用。但有一个问题。

从命令行使用过滤器时，我要做的是

pandoc -t json -READEROPTIONS input.markdown | ./filter.py | pandoc -f JSON -WRITEROPTIONS -o output.html

or equivalently

pandoc --filter ./filter.py -READEROPTIONS -WRITEROPTIONS -o html

This command is shorter but it doesn't show the procedures.

但与 pandocCompilerTransformM ，它做类似的事情

pandoc -t html -READEROPTIONS -WRITEROPTIONS input.mardown | pandoc -t JSON | ./filter.py | pandoc -f JSON -WRITEROPTIONS -o output.html

不同的是传递给 filter.py的文本不同的是:一个是markdown直接生成的内容，另一个是markdown生成的HTML生成的一些文本。如您所知，来回转换某些东西总是会产生意想不到的问题。所以我认为可能有更好的解决方案。

附注。我一直盯着学习 Haskell。我希望有一天我能自己解决这个问题。谢谢!

Answer 1

最后，我认为您会同时使用两者。使用此 https://github.com/listx/listx_blog/blob/master/blog.hs作为模型，以下将与 transformer has in it 具有相同的形状. transformer用于 lines 69-80 for 'posts' -- 这是 pandocCompilerWithTransformM 的第三个参数，这是一个 (Pandoc -> Compiler Pandoc)在这里，您需要将绝对路径添加到您的 python 过滤器——或者名称，如果它在 $PATH 中——以及读取器和写入器选项(例如 defaultHakyllReaderOptions 和 defaultHakyllWriterOptions )

import Text.Pandoc
import Hakyll

type Script = String 

transformer
  :: Script         -- e.g. "/absolute/path/filter.py"
  -> ReaderOptions  -- e.g.  defaultHakyllReaderOptions
  -> WriterOptions  -- e.g.  defaultHakyllWriterOptions
  -> (Pandoc -> Compiler Pandoc)
transformer script reader_opts writer_opts pandoc = 
    do let input_json = writeJSON writer_opts pandoc
       output_json <- unixFilter script [] input_json
       return $ 
          -- either (error.show) id $  -- this line needs to be uncommented atm.
          readJSON reader_opts output_json 

同样， (transformer "/usr/local/bin/myfilter.py" defaultHakyllReaderOptions defaultHakyllWriterOptions)可能用于 (return . pandocTransform)使用，在此 example gist 的第 125 行

为了调试，您可以将所有内容外包给 unixFilter :

transform :: Script -> String -> Compiler String
transform script md = do json0 <- unixFilter pandoc input_args md
                         json1 <- unixFilter script [] json0
                         unixFilter pandoc output_args json1
 where
   pandoc = "pandoc"
   input_args = words "-f markdown -t json" -- add others
   output_args = words "-f json -t html"    -- add others

do的三行块相当于 pandoc -t json | filter.py | pandoc -f json 中的 unix 管道阶段带有任何其他参数。

我想也许你是对的，这里有一层额外的 pandoc 来回。 pandocCompilerWithTransform(M)函数是直接用于 Pandoc-> Pandoc 函数 - 它将应用于 Pandoc hakyll 提出的。我认为我们应该放弃这个并直接使用 Pandoc 库。 unixCompile的使用可能是这样的。

transformXLVI :: Script -> ReaderOptions -> WriterOptions -> String  -> Compiler Html
transformXLVI script ropts wopts = fmap fromJSON . unixFilter script [] . toJSON 
  where 
    toJSON   = writeJSON wopts 
    --           . either (error . show) id -- for pandoc > 1.14
               . readMarkdown ropts 
    fromJSON = writeHtml wopts
    --           . either (error . show) id
               . readJSON ropts 

我希望这些原则能从这些变化中浮现出来!这应该与前面的 transform 几乎相同;我们使用 pandoc 库代替对 pandoc 的调用。可执行。