☰

Markdown -> Latex -> PDF：md 内联代码片段超出页面界限

tag-icon • tag-icon listings line-breaking code markdown
Markdown -> Latex -> PDF：md 内联代码片段超出页面界限

问题

我有一堆用于我们软件的 changelog.md 文件，这些文件使用反引号表示内联代码。我将它们作为文档构建过程的一部分提取出来，并用 latex 编译成 PDF。如屏幕截图所示，Latex 似乎无法正确地换行这些内联代码片段。有谁知道解决这个问题的办法吗？有时它们会完全超出页面，具体取决于长度。对于较长的片段，我们使用列表，但对于这些内联代码片段，这不是一个选项。此外，我们的开发人员在 github-markdown 中编写他们的更改日志，不会包含任何类型的 latex 提示或任何内容，因此我需要通过 latex 管道将常规 gh-markdown 转换为 PDF。所以我无法转到 latex 代码中的特定位置并将受影响的行包装到特殊的环境/命令中。

字符串超出范围

markdown 中的相应行如下：

- the connection name to the PLC must be identical (see ```opvconfig\opvbase\devices\...\config.json```), because it is the first element of ```target_ref ```

为了在 Latex 中使用 Markdown，我们使用“标准”Markdown 包：http://ctan.mirror.norbert-ruehl.de/macros/generic/markdown/markdown.html

要设置 markdown 包的配置，我们使用以下命令：

\markdownSetup{
      fencedCode=true,
      renderers = {
        interblockSeparator = {},
        headingOne = \chapter*{#1},
        headingTwo = \section*{#1},
        headingThree = \subsection*{#1},
        headingFour = \subsubsection*{#1},
        headingFive = \paragraph*{#1},
        headingSix = #1,
      }
    }

我迄今为止尝试过

  • 用一个反引号替换了 3 个反引号，但不起作用
  • 尝试了几种不同的 markdownSetup 选项
  • 尝试了几个 lstset 选项（包括 breaklines=true）
  • 找到了这个问题换行较长的行并添加背景颜色 并尝试了他们在挑战下发布的一些链接

从我目前所读到的内容来看，我感觉无法实现我想要的效果，我应该“直接切换到 pandoc”，但不幸的是 pandoc 不是一个选项。我甚至尝试过 pandoc，但它带来了更多问题，比如列表无法正常工作。（我们使用类似https://github.com/xgirma/latex-javaScript）

相关内容