pdf - pandoc 在转换为 pdf 时不会对代码块进行文本换行

Question

我正在使用带有 xelatex 引擎的 pandoc 将 markdown 转换为 pdf。我正在像这样运行 pandoc：

pandoc -s 'backbone-fundamentals'.md -o 'backbone-fundamentals'.pdf \
    --title-prefix 'Developing Backbone.js Applications' \
    --normalize \
    --smart \
    --toc \
    --latex-engine=`which xelatex`

如果代码行比 pdf 文档的宽度长，它就会被截断。反正有 pandoc 文本包装长代码行吗？

Answer 1

如果您最近安装了包含fvextra包的 LaTeX，那么有一个简单的解决方案，最近由 jannick0 建议。

修改您的YAML 标头选项以包含

\usepackage{fvextra}
\begin{Highlighting}[breaklines,numbers=left]

并用 xelatex 编译。

例如，

---
header-includes:
 - \usepackage{fvextra}
 - \DefineVerbatimEnvironment{Highlighting}{Verbatim}{breaklines,commandchars=\\\{\}}
---

~~~~~{.java}
this is a very long long long long long long long long long long long long long line which is broken
~~~~~~

编译时

pandoc input.md --pdf-engine=xelatex -o output.pdf

给

如果你有.numberLines选择，即

---
header-includes:
 - \usepackage{fvextra}
 - \DefineVerbatimEnvironment{Highlighting}{Verbatim}{breaklines,commandchars=\\\{\}}
---


~~~~~{.java .numberLines}
this is a very long long long long long long long long long long long long long line which is broken
~~~~~~

那么同样的命令会产生

Answer 2

不包装文本是代码块的（部分）要点。据我所知，包装代码的唯一方法是手动。对于大多数语言，不超过一定的行长无论如何都被认为是好的风格。

如果您的行有长度限制，但对于 LaTeX 生成的 pdf 来说仍然太长，请考虑减小代码块的字体大小。为此，您需要更改 pandoc 使用的 LaTeX 模板。看看这个答案“如何在 Beamer 演示文稿中为所有逐字设置字体大小？” 应该让你开始。