在创建 pdf 文件的同时进行分页标记

我正在使用 doxygen (1.8.6)创建一个 pdf 的减价文本文件。现在我想得到在特定阶段的分页标记文件,我使用这个 链接

在给定的链接中,他们提到使用“ >”表示换行符。但是他们没有提到分页。是的,我可以使用’>’为分页,但我必须写这个符号5次或更多的降价文本文件,这使降价文件在怪异的外观。有没有其他方法可以在标记文件中获得分页符?

137894 次浏览

引号与换行符

在 Markdown 中,>不用于换行符,而是用于块引号

> A man provided with paper, pencil, and rubber, and
> subject to strict discipline, is in effect a universal machine.

变成了

提供纸、铅笔和橡胶的人 服从严格的纪律,实际上是一个普遍的机器。

(This is a 引自艾伦 · 图灵.)

请注意如何使用 Stack Overflow 呈现黄色背景。如果检查生成的标记,您将发现正在使用 <blockquote>标记。

通常可以通过以两个或多个空格结束一行(Markdown 语法)或使用原始 <br>标记(大多数 Markdown 处理器允许内联 HTML)来插入换行符。例如(使用 表示空格) ,这个 Markdown

123 Fake Street␣␣
Springfield, USA

变成了

假街123号
美国,斯普林菲尔德

分页

由于原始规范 Markdown 是为 HTML 输出设计的(它没有页面的概念) ,因此不支持分页。

氧气 使用 LaTeX 生成 PDF 文件。它似乎不支持内联 LaTeX1,但是您应该能够修改中间的 .tex文件,然后使用 pdflatex生成 PDF:

  1. 使用 Doxy生成 .tex文件
  2. Edit the .tex file manually add \newpage wherever you want page breaks
  3. 运行 pdflatex documentation.tex
  4. 检查 documentation.pdf

这个问题 对于上面的第3步可能是一个有用的参考。

1Doxy确实支持内联 LaTeX < em > 式 ,但是我找不到任何提到任意内联 LaTeX 命令的地方,比如在文本环境中操作的 \newpage

最后一个解决方案是手动编辑 HTML 输出,以便根据需要呈现为 PDF。

因为 Markdown 接受纯 HTML 和 CSS,所以只需在需要强制分页的地方添加这一行。

<div style="page-break-after: always;"></div>

如果您的 Markdown 编辑器无法正确导出 PDF,那么首先尝试导出为 HTML,然后用浏览器打开并打印为 PDF。

我遇到了同样的问题,并通过插入

分页

它实际上是一个 LaTeX 命令,而不是 Markdown 命令。

I Know that this is a dead question, but I've found a way that I think can be useful for other than me.

可以在不可见元素中使用命令 pagebreak。在这种方式下,它与乳胶和 html 一起工作。

<div style="page-break-after: always; visibility: hidden">
\pagebreak
</div>

虽然这些答案工作-他们打破了标记(MD)的目标之一,这是非常可读作为一个直文本文档,以及能够格式化成更丰富的演示文稿。

一旦你开始在文本中嵌入一堆 HTML/CSS,你就失去了 MD 的第一个方面。你也可以使用 Word,Libre,HTML/CSS 等等。

我认为 MD 最好添加一个分页序列,比如: <<<<>>>>或类似于格式化运算符。我在医学博士课文里用过。它不会导致 PDF 或 HTML 转换器中的页面中断,但是可以在这些转换器和纯文本表单中识别出来。

在我的 Markdown 文档中,page-break-after有时会在同一页上留下一两个标题。在这种情况下,page-break-before会将 <div>之后的所有内容适当地放在下一页:

<div style="page-break-before:always"></div>

To make tomodian's 回答 slightly cleaner, you can reference a CSS class:

文字:

<div class="pagebreak" />

Css:

.pagebreak { page-break-after: always; }