NAME

A2E::U2tex - convert ideal LaTeX input to currently parsable LaTeX input

VERSION

This describes version 0.0.2 of A2E::U2tex

SYNOPSIS

u2tex [options] <file>

DESCRIPTION

u2tex expects a UTF-8-coded input file and rewrites this file in such a way that LaTeX (latex, pdflatex) can deal with it more easily, given current limitations such as

 - in the output, \"a looks better than ä, etc
   - we do what 'recode u8..tex' fails to do
 - OBOSLETE: section headings that contain multibyte UTF-8 characters can not be numbered (temporary solution: \section{漢字} --> \section*{漢字})
   - This problem is solved by using the package CJKutf8 instead of CJK
 - \usepackage[esperanto]{babel} seems to be incompatible with the CJK package
   - not addressed yet
 - possibly more

OPTIONS

--help | -h

Display short help and exit.

--manpage | -m

Display full documentation and exit.

General options:

--outfile <file> | -o <file>

Output to this file, rather than to the input file.

--lang <lang> | -l <lang>

Assume that the document is written in language <lang>.

--quiet | -q

Let me keep silent while I run.

--verbose | -v

Let me explain what I'm doing while I run.

--plain_headings | -p <level>

Force non-numbered headings.

level 0: never (default) level 1: always do it when CJK characters are found level 2: always do it

The default value used to be 1. It is now (since 2010-03-09) 0 because we do not need this kludge anymore since we have use the CJKutf8 package in our templates.

BUGS

Some accented characters are still missing. Ask phm to complete the list.

It is written quickly and runs slowly. The methods of dok:tratext/CString.pm should be used, rather than regex.

PREREQUISITES

    A2E::Prog(3)

SEE ALSO

    perldoc(1)

SCRIPT CATEGORIES

text processing

ENVIRONMENT

FILES
        /u2tex.konf
        ~/u2tex.konf
        ./@u2tex

These must contain the character transformation rules in the form

        texchars ĝ = \\^g
        texchars ç = \\c{c}

etc.

AUTHOR

    Hartmut Pilch

COPYRIGHT

Copyright (c) 2007-2010 Hartmut Pilch (phm)

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Function make_protect_headings_function

Function reskrib_fayl

rewrite the file

Function u2tex

rewrite all files.

THE END

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 26:

Non-ASCII character seen before =encoding in 'ä,'. Assuming UTF-8