Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LATEX2RTF(1)			  User Commands 		    LATEX2RTF(1)

NAME
     latex2rtf - Convert a LaTeX file to an RTF file

SYNTAX
     latex2rtf [-hlpFSVW] [ -d# ] [ -D# ] [ -M# ]  [ -se#] [ -sf#] [ -t# ] [ -Z#
     ]	[ -a auxfile ] [ -b bblfile ] [ -C codepage ]  [ -i language ] [ -o out-
     putfile ] [ -P /path/to/cfg ] [ -T /path/to/tmp ] [ inputfile ]

DESCRIPTION
     The latex2rtf command converts a LaTeX file into RTF text format. The  text
     and much of the formatting information is translated to RTF.

     -a auxfile
	    Used  to specify a particular cross-referencing file.  When this op-
	    tion is omitted, the auxfile is assumed to be the same as  inputfile
	    with the .tex suffix replaced by .aux.

     -b bblfile
	    Used  to  specify a particular bibliography file When this option is
	    omitted, the bblfile is assumed to be the same as inputfile with the
	    .tex suffix replaced by .bbl.

     -C codepage
	    used to specify the character set (code page) used in the LaTeX doc-
	    ument for non-ansi characters.  codepage may be one of  the  follow-
	    ing:  ansinew, applemac, cp437, cp437de, cp850, cp852, cp855, cp865,
	    cp866, decmulti, cp1250, cp1252,  koi8-r,  koi8-u,	latin1,  latin2,
	    latin3,  latin4,  latin5, latin9, maccyr, macukr, next, raw, raw437,
	    raw852, raw1250, raw1251, and raw1253.  The default behavior  is  to
	    use  ansinew  (same  as  cp1252).  For convenience, just the numbers
	    437, 437de, 850, 852, 855, 866, 1250 or 1252 may be specified.

	    The raw character set encoding prevents any 8-bit character transla-
	    tion.  The RTF file is marked to use the same encoding  as	the  de-
	    fault  encoding  for the program interpreting the RTF file.  This is
	    particularly useful when translating a file written  in  a	language
	    (e.g.,  czech)  that maps poorly into the ansinew (western european)
	    character set.

     -d#    Write extra debugging output to stderr.  Higher numbers  cause  more
	    debugging  output and range from 0 (only errors) to 6 (absurdly many
	    messages). The default is 1 (Warnings and Errors only).

     -D dots_per_inch
	    Used to specify the number of dots per inch in  equations  that  are
	    converted  to  bitmaps and for graphics that must be converted.  De-
	    fault is 300 dpi.

     -E#    where # selects the type of figure handling desired.  RTF  does  not
	    support insertion of PS, PDF, or EPS file types.  These figures must
	    be	converted to a bitmap format and then inserted.  One trick is to
	    insert the filenames into the RTF file and then in	post-processing,
	    insert the file.  These options can be added together.
	    -E3 insert all figures (DEFAULT)
	    -E0 no figures in the RTF
	    -E1 insert figures having RTF-supported formats
	    -E2 convert and insert unsupported figure formats
	    -E4 insert only filenames for supported file formats
	    -E8 insert only filenames for unsupported file formats

     -f use fields
	    -f0 do not use fields in RTF.  This is handy when primitive RTF edi-
	    tors are being used to view the RTF output.
	    -f1 use fields for equations but not \ref and \cite.
	    -f2 use fields for \ref and \cite but not equations.
	    -f3  use fields when possible.  This is the default and is most use-
	    ful when the RTF file is being exported to be used	in  Word.   This
	    retains the most information from the original LaTeX file.

     -F     use  LaTeX	to  create  bitmaps for all figures.  This may help when
	    figures are not translated properly.

     -h     Print a short usage note

     -i language
	    used to set the idiom or language used in the  LaTeX  document  lan-
	    guage may be one of the following afrikaans, bahasa, basque, brazil,
	    breton, catalan, croatian, czech, danish, dutch, english, esperanto,
	    estonian,  finnish, french, galician, german, icelandic, irish,ital-
	    ian, latin, lsorbian, magyar, norsk, nynorsk, polish, portuges,  ro-
	    manian, russian, samin, scottish, serbian, slovak, slovene, spanish,
	    swedish, turkish, usorbian, welsh.	The default is english.

     -l     Assume  LaTeX  source  uses  ISO 8859-1 (Latin-1) special characters
	    (default behavior).

     -o outputfile
	    Redirect output to outputfile Unless an outputfile is specified with
	    the -o option, the resulting RTF is produced in a file with .tex re-
	    placed by .rtf.

     -M#    where # selects the type of equation conversion.
	    -M1 displayed equations to RTF
	    -M2 inline equations to RTF
	    -M4 displayed equations to bitmap
	    -M8 inline equations to bitmap
	    -M16 insert Word comment field containing the raw LaTeX equation
	    -M32 insert raw LaTeX equation delimited by $...$ and \[...\]
	    -M64 displayed equations to EPS files with filenames in RTF
	    -M128 inline equations to EPS files with filenames in RTF

     These options may be added together to get different results
	    -M0 no equations fields in the RTF.
	    -M3 converts both inline and displayed equations to RTF (DEFAULT).
	    -M12 converts inline and displayed equations to bitmaps.
	    -M192 converts inline and displayed equations to eps files	and  in-
	    serts a tag in RTF.
	    Bitmap  conversion	requires  a working latex2png script.  Producing
	    bitmaps is slow.

     -p     Escape printed parentheses in mathematical formulas,  as  some  ver-
	    sions  of Word (e.g Word 2000) have deep psychological problems with
	    EQ fields using quoted parentheses.  If Word displays some	formulas
	    with  parentheses as 'Error!', try this option.  See also the -S op-
	    tion.

     -P /path/to/cfg
	    used to specify the directory that contains the @code{.cfg} files

     -se#   selects the scale for equation conversion, where # is the scale fac-
	    tor (default 1.00).

     -sf#   selects the scale for figure conversion, where # is the scale factor
	    (default 1.00).

     -S     Use semicolons to separate arguments in RTF fields.  This is  needed
	    when  the  machine	opening  the RTF file has a version of Word that
	    uses commas for decimal points.  This also can fix	displaying  some
	    formulas as 'Error!'  You may also need to try the -p option.

     -t#    selects the type of table conversion.
	    -t1 convert tables to RTF (default)
	    -t2 convert tables to bitmaps

     -T /path/to/tmp
	    used to specify the folder where to put temporary files.

     -V     Prints version on standard output and exits.

     -W     Emit  warnings directly in RTF file.  Handy for catching things that
	    do not get translated correctly.

     -Z#    Add # close braces to end of RTF file.  (Handy when file is not con-
	    verted correctly and will not open in another word processor.)

CONFIGURATION FILES
     The configuration files are searched first in any	directory  specified  by
     -P, then in the location specified by the environment variable RTFPATH, and
     finally  in  the location CFGDIR specified when latex2rtf was compiled.  If
     the configuration files are not found then latex2rtf aborts.  The	configu-
     ration  files  allow  additional  fonts to be recognized, additional simple
     commands to be translation, and additional commands to be ignored.

CAUTION
     The input file must be a valid LaTeX file. Use LaTeX to find and fix errors
     before converting with latex2rtf.

     The configuration files direct.cfg and fonts.cfg are in the correct  direc-
     tory.  You may have to change fonts.cfg or direct.cfg to suit your needs.

BUGS
     Some might consider RTF to be a bug.

     Some environments are currently ignored.

     Translation without a LaTeX generated .aux file is poor.

REPORTING BUGS
     Report   bugs   to   to   the   bug   tracking   system  at  http://source-
     forge.net/projects/latex2rtf/.  Only report bugs for the latest version  of
     latex2rtf that is available.  Please identify your operating system.

     If  the  program  produces wrong output or does not work for you, INCLUDE A
     SHORT LATEX FILE that demonstrates the  problem.	The  shorter  the  LaTeX
     file,  the quicker your bug will get addressed.  Bug reports with non-exis-
     tent LaTeX files are not welcomed by the developers.  Do not bother to send
     RTF files, since these are usually unhelpful.

SEE ALSO
     latex(1), rtf2LaTeX2e(1), LaTeX User's Guide & Reference Manual  by  Leslie
     Lamport

     For complete, current documentation, refer to the Info file latex2rtf.info,
     the  PDF  file latex2rtf.pdf or the HTML file latex2rtf.html which are made
     from the TeXInfo source file latex2rtf.texi.

latex2rtf 2.3			  October 2012			    LATEX2RTF(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=latex2rtf&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help