编辑:对原始版本进行了大量编辑以澄清问题。
背景
我写了两个小的python包手册sphinx
(http://sphinx-doc.org/) 一个帮助编写源代码文档的程序。除其他功能外,sphinx
它还允许根据其自己的文档类并在样式文件中定义将手册输出到 LaTeX。
我目前正在撰写论文,并希望在文档的附录中介绍手册。sphinx latex 文件的格式对于其用途来说很方便,但我不想在论文的其余部分使用它。然而,在手册中,我想坚持使用 sphinx 格式。
问题
有没有办法将完整文档纳入主文档,这样它们就可以保持其格式而不会干扰主文档?类似的问题是将经过评审的论文纳入其中,例如论文,这样它就可以保持期刊的格式。
笔记
包含 tex 格式的文件并将其与主文档一起编译将允许引用以及正确编号页面并包含在目录中。
编辑:
以下评论中的选项:
独立这个软件包看起来很有希望。但是我仍然遇到问题(见下文)。(还有https://tex.stackexchange.com/a/12268/27635)
combine
我觉得制作类似会议论文集的东西,用同一种格式的多个文件,还是挺有用的。而且,它只在一般目录中列出标题。单独编译手册并将其作为 pdf 包含在主文本中。如果可能的话,我宁愿不使用此选项。
可能的竞争者:独立
我不确定这是否是正确的方法。据我所知,这standalone
会从文件的子文件中加载前言main.tex
。这就是我想避免的。然而,到目前为止,我设法使用独立模式将手册包含到我的主要手册中,但样式与主文本相同,否则这就是我要搜索的。这是我的当前设置main.tex
:
\documentclass[12pt, twoside, paper=A4, final]{scrbook}
\usepackage{standalone}
\usepackage{load other packages ...}
\begin{document}
Mainmatter
\input{manual}
\end{document}
和我的manual.tex
:
\documentclass[subpreamble]{standalone}
\usepackage{sphinx}
\standaloneconfig{class=sphinxmanual}
\begin{document}
manual content
\end{document}
我不确定我是否正确地声明了独立的文档类以及是否\standaloneconfig
会接受它。
答案1
对于完全独立的文档,您可以单独编译它们,然后将它们包含在pdf页面。 使用arara
使编译更容易
\documentclass{article}
\usepackage{pdfpages}
\begin{document}
\clearpage
\includepdf[pages={-}]{docA.pdf}
\clearpage
\includepdf[pages={-}]{docB.pdf}
\clearpage
\includepdf[pages={-}]{docC.pdf}
\end{document}
% arara: pdflatex: { files: [ docA.tex ] }
% arara: pdflatex: { files: [ docB.tex ] }
% arara: pdflatex: { files: [ docC.tex ] }
% arara: pdflatex
事实上,如果您希望文档完全独立,您可以编写自己的arara
规则来arara
调用 docA、docB 和 docC。