lyxport.1

用于OMNeT++的模板

.\" Automatically generated by Pod::Man version 1.02
.\" Thu Jul 19 23:20:32 2001
.\"
.\" Standard preamble:
.\" ======================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R

.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used
.\" to do unbreakable dashes and therefore won't be available.  \*(C` and
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` `
.    ds C' '
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
.\" index entries marked with X<> in POD.  Of course, you'll have to process
.\" the output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
.    .
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it
.\" makes way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.bd B 3
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ======================================================================
.\"
.IX Title "LYXPORT 1"
.TH LYXPORT 1 "perl v5.6.0" "2001-07-19" "User Contributed Perl Documentation"
.UC
.SH "NAME"
\&\fBlyxport\fR \- Export a LyX or LaTeX file to \s-1HTML\s0, PostScript and \s-1PDF\s0.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBlyxport\fR [options] \fIfile\fR
.PP
Perl script which takes a LyX or LaTeX file as its only argument and produces
\&\s-1HTML\s0, PostScript and \s-1PDF\s0 versions of the document. The name is short for \*(L"lyx
export\*(R".
.PP
You can call \fBlyxport\fR with a filename with or without extension: \fIfile\fR,
\&\fIfile.lyx\fR and \fIfile.tex\fR will all work. \fBlyxport\fR will update the LaTeX
file if there is a corresponding LyX file with a newer timestamp.
.PP
Use \fBlyxport \-\-help\fR for more information, and \fBlyxport \-\-man\fR for a full
man page.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
.Sh "Purpose"
.IX Subsection "Purpose"
LyX ( http://www.lyx.org ) is a wonderful document processor, which can produce
from a single source multiple versions for different purposes: a PostScript
file for printing on a Unix-type system, a \s-1PDF\s0 file for distribution across
multiple operating systems, or an \s-1HTML\s0 file for Internet display. It
accomplishes this by exporting its own file format to a LaTeX file and then
running various converters on this resulting file.
.PP
However, it turns out that this process isn't exactly foolproof, as these
converters have all sorts of little quirks which can produce anything from
surprises in the way the final result looks like to outright failure of the
export process. The purpose of \fBlyxport\fR is to serve as a \*(L"smart wrapper\*(R"
around those export facilities which LyX normally uses, trying to massage the
LaTeX file that everything starts from in the hopes of having better success
in producing \s-1HTML\s0 and \s-1PDF\s0 (PostScript usually poses no problems). 
.PP
\&\fBlyxport\fR also allows you to keep around only the LyX file, and possibly any
ancillary figure files. \fBlyxport\fR takes care of generating (and removing
afterwards if instructed to do so) any intermediate files necessary for the
export process.
.PP
For example, in order to make \s-1PDF\s0 from a LaTeX file, any included eps figures
need to be converted to pdf format. But LyX likes to have the figures in eps
format for on-screen display, which is a great feature to have. \fBlyxport\fR
allows you to keep your LyX file as usual (with references to .eps figures)
and will make .pdf versions of any included figure on the fly as needed. You
can even ask it to remove those pdf files after it finishes, if you really
want to maintain a minimum of files around (though it will have to remake them
again if you ever need to update your pdf exported document).
.Sh "Command line use"
.IX Subsection "Command line use"
If you simply type \fBlyxport\fR \fIfile\fR, it will try to make PostScript, \s-1HTML\s0,
and \s-1PDF\s0 versions of your file, putting them all in a single directory named
\&\fIfile\fR (without a .lyx or .tex extension if your file had one). But it has
command line options for making only the
formats you want, and fairly detailed control over its behavior.
.Sh "If you don't have LyX"
.IX Subsection "If you don't have LyX"
Despite its name, if you are a regular LaTeX user and don't even have LyX
installed in your system, \fBlyxport\fR can still be useful to you. In fact,
\&\fBlyxport\fR only uses LyX once in each run: if there is no \fIfile.tex\fR or if
\&\fIfile.lyx\fR file is newer than \fIfile.tex\fR, \fBlyxport\fR updates \fIfile.tex\fR
from \fIfile.lyx\fR. But if there is no \fIfile.lyx\fR at all it will simply use
\&\fIfile.tex\fR and proceed with all its functionality intact.
.SH "OPTIONS AND ARGUMENTS"
.IX Header "OPTIONS AND ARGUMENTS"
Single letter options (preceded by a single dash \fB-\fR) can be bundled: \fB\-pf\fR
is equivalent to \fB\-p \-f\fR. Long options (preceded by two dashes \fB\--\fR) can be
abbreviated to as few letters as needed to clear ambiguity.
.Ip "\fB\-r \-\-runs\fR \fI\s-1NUM\s0\fR" 4
.IX Item "-r --runs NUM"
Set number of latex runs by hand (otherwise auto-determined).
.Ip "\fB\-o \-\-opts_l2h\fR \fI'string'\fR" 4
.IX Item "-o --opts_l2h 'string'"
String with options to be passed to \fBlatex2html\fR. This string should be
protected by single quotes to allow double quotes inside of it.
.Sp
For example, if you want to pass to \fBlatex2html\fR the option \fB\-info \*(L"my
info\*(R"\fR you can do so with \fBlyxport \-o ' \-info \*(L"my info\*(R" '\fR (the extra spaces
around the quote marks are not needed, they are here only for the sake of
clarity).
.Sp
\&\fBlatex2html\fR has \fImany\fR command-line options. For a project you are working
constantly on, it may be more convenient to permanently set some of those
options via a file called \fI.latex2html-init\fR which \fBlatex2html\fR always
reads at startup. See the \fBlatex2html\fR man page or the excellent online
documentation kept at http://www-texdev.mpce.mq.edu.au/l2h/docs/manual for
full details.
.Ip "\fB\-h \-\-html\fR" 4
.IX Item "-h --html"
Export to \s-1HTML\s0.
.Ip "\fB\-p \-\-ps\fR" 4