summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multidoc.html
blob: f5ee627147b1483345b4a6aefb27c2fc24257e27 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
<head>
<title>UK TeX FAQ -- question label multidoc</title>
</head><body>
<h3>A &lsquo;report&rsquo; from lots of &lsquo;article&rsquo;s</h3>
<p/>This is a requirement, for example, if one is preparing the
proceedings of a conference whose papers were submitted in LaTeX.
<p/>The nearest things to canned solutions are Peter Wilson&rsquo;s
<i>combine</i> and Federico Garcia&rsquo;s <i>subfiles</i> classes.
<p/><i>Combine</i> defines the means to &lsquo;<code>\</code><code>import</code>&rsquo; entire documents,
and provides means of specifying significant features of the layout of
the document, as well as a global table of contents, and so on.  An
auxiliary package, <i>combinet</i>, allows use of the <code>\</code><code>title</code>s
and <code>\</code><code>author</code>s (etc.) of the <code>\</code><code>import</code>ed documents to appear in
the global table of contents.
<p/><i>Subfiles</i> is used in the component files of a multi-file
project, and the corresponding <i>subfiles</i> is used in the
master file; arrangements may be made so that the component files will
be typeset using different page format, etc., parameters than those
used when they are typeset as a part of the main file.
<p/>A more &lsquo;raw&rsquo; toolkit is offered by Matt Swift&rsquo;s <i>includex</i> and
<i>newclude</i> packages, both part of the <i>frankenstein</i>
bundle.  Note that Matt believes <i>includex</i> is obsolete
(though it continues to work for this author); furthermore, its
replacement, <i>newclude</i> remains &ldquo;in development&rdquo;, as it has
been since 1999.
<p/>Both <i>includex</i> and <i>newclude</i> enable you to
&lsquo;<code>\</code><code>includedoc</code>&rsquo; complete articles (in the way that you
&lsquo;<code>\</code><code>include</code>&rsquo; chapter files in an ordinary report).  The preamble
(everything up to <code>\</code><code>begin{document}</code>), and everything after
<code>\</code><code>end{document}</code>, is ignored by both packages.  Thus the
packages don&rsquo;t &ldquo;do the whole job&rdquo; for you, though: you need to
analyse the package use of the individual papers, and ensure that a
consistent set is loaded in the preamble of the main report.  (Both
packages require <i>moredefs</i>, which is also part of the bundle.)
<p/>A completely different approach is to use the <i>pdfpages</i>
package, and to include articles submitted in PDF format into a
a PDF document produced by PDFLaTeX.  The package
defines an <code>\</code><code>includepdf</code> command, which takes arguments similar to
those of the <code>\</code><code>includegraphics</code> command.  With keywords in the
optional argument of the command, you can specify which pages you want
to be included from the file named, and various details of the layout
of the included pages.
<dl>
<dt><tt><i>combine.cls</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/combine.zip">macros/latex/contrib/combine</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/combine.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/combine/">browse</a>)
<dt><tt><i>combinet.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/combine.zip">macros/latex/contrib/combine</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/combine.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/combine/">browse</a>)
<dt><tt><i>includex.sty</i></tt><dd>Distributed in the &ldquo;unsupported&rdquo; part of
  <a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/frankenstein.zip">macros/latex/contrib/frankenstein</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/frankenstein.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/frankenstein/">browse</a>)
<dt><tt><i>moredefs.sty</i></tt><dd>Distributed as part of <a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/frankenstein.zip">macros/latex/contrib/frankenstein</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/frankenstein.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/frankenstein/">browse</a>)
<dt><tt><i>newclude.sty</i></tt><dd>Distributed as part of <a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/frankenstein.zip">macros/latex/contrib/frankenstein</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/frankenstein.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/frankenstein/">browse</a>)
<dt><tt><i>pdfpages.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/pdfpages.zip">macros/latex/contrib/pdfpages</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/pdfpages.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/pdfpages/">browse</a>)
<dt><tt><i>subfiles.cls, etc.</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/subfiles.zip">macros/latex/contrib/subfiles</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/subfiles.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/subfiles/">browse</a>)
</dl>
<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multidoc">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multidoc</a>
</body>