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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
NAME
latexpand - Flatten LaTeX file by expanding \include and \input, ... and
remove comments
SYNOPSIS
latexpand [options] FILE...
Options:
--verbose show what's going on
--keep-comments don't strip comments (comments are lines
starting with %, and anything below
\end{document})
--empty-comments keep empty comments (i.e. % at end of lines) for clarity
--keep-includes don't expand \input and \include directives
--expand-usepackage
Expand \usepackage{...} directives if the
corresponding .sty file is found in
$TEXINPUTS (or the current directory if
$TEXINPUTS is not set)
--expand-bbl FILE
Expand the bibliography by inlining FILE
(should be a *.bbl file)
--biber FILE Include \bibliography{} with FILE's content,
as needed by biblatex with the biber backend.
(similar to --expand-bbl FILE, but for
biber+biblatex).
--help this help message
--define <key>=<val>, -d <key>=<val>
defines a macro key to be replaced by value, e.g.,
when called with -d foo=bar would replace all occurences
of \foo in the code with bar. Can be supplied multiple times.
--output <file>, -o <file>
generate output in <file>
--explain generate explanatory comments in output
--show-graphics show included graphics
--graphics_extensions
colon-separated list of possible graphics extensions
(used by --show-graphics to find the actual graphics files)
--fatal Die in case a file can't be found.
--makeatletter Insert a \makeatletter in the preamble. In some
rare cases it may break your document, but it
may help fixing bad interactions between
@-commands and inclusion (see BUGS section).
--in-encoding FMT, --out-encoding FMT
File encoding used by input and output files.
This uses the same syntax as PerlIO's layers.
Example:
--in-encoding 'encoding(UTF-8)'
The default is 'bytes' and should always work.
USES
The most common use of latexpand is to simplify distribution of source
LaTeX files, typically to satisfy the requirement of editors and
archival sites (springer, arXiv.org, ...) who force the authors to
submit sources. One does not necessarily want to submit sources with
comments, and uploading a document made of several files including each
other is a bit painful. By default, latexpand answers both problems by
outputing a single LaTeX file that contain no comment.
GETTING LATEXPAND
The latest version of latexpand is available here:
https://gitlab.com/latexpand/latexpand
Versions are uploaded to ctan.org from time to time:
http://www.ctan.org/pkg/latexpand
BUGS
Please, report bugs on the issue tracker on the project site:
https://gitlab.com/latexpand/latexpand/issues
Known bugs
Verbatim
latexpand currently ignores \begin{verbatim} ... \end{verbatim}, and
will therefore process any \include, \input, ... directives that appear
within verbatim environments (while it shouldn't).
LaTeX comments inside verbatim environments are also incorrectly
stripped. You can use --keep-comments as a workaround to avoid this.
Comment environment
It would be nice to remove code between \begin{comment} and
\end{comment} too if \usepackage{comment} is used.
Code like
foo%
\begin{comment}
will produce the incorrect
foo\begin{comment}
A workaround is to use --empty-comments when such tricky usage of the
comments package is done.
\makeatletter and use with transfig/xfig with \scalebox{}
If \input{} or \include{} appears as argument to a command, and the file
included contains \makeatletter, then after expansion, the \makeatletter
and the @-command appear as argument to the command, which is forbidden
because the argument is parsed (and the @-command badly tokenized)
before being executed.
This happens with
\scalebox{ \input{file-generated-by-xfig.pdf_t} }
Workaround: add \makeatletter before the scalebox manually in your code,
like
\makeatletter{}
\scalebox{ \input{file-generated-by-xfig.pdf_t} }
\makeatother{}
In the case of xfig generated files, it is necessary only for the first
occurence.
A more brute-force workaround is to use latexpand --makeatletter.
SEE ALSO
Instructions to include only the relevant .bib items (french):
https://lacl.fr/~caubert/notes/portabilite-du-tex.html#dependances
VERSION
This is latexpand version v1.7.2.
|
