.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.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.  \*(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-
.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" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "LaTeX::ToUnicode 3pm"
.TH LaTeX::ToUnicode 3pm "2022-10-13" "perl v5.34.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
LaTeX::ToUnicode \- Convert LaTeX commands to Unicode
.SH "VERSION"
.IX Header "VERSION"
version 0.11
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  use LaTeX::ToUnicode qw( convert );
\&
\&  convert( \*(Aq{\e"a}\*(Aq           ) eq \*(Aqä\*(Aq;  # true
\&  convert( \*(Aq"a\*(Aq, german => 1 ) eq \*(Aqä\*(Aq;  # true, \`german\*(Aq package syntax
\&  convert( \*(Aq"a\*(Aq,             ) eq \*(Aq"a\*(Aq;  # not enabled by default
\&  
\&  # more generally:
\&  my $latexstr;
\&  my $unistr = convert($latexstr);
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module provides a method to convert LaTeX-style markups for accents etc.
into their Unicode equivalents. It translates commands for special characters
or accents into their Unicode equivalents and removes formatting commands.
It is not at all bulletproof or complete.
.PP
This module converts values from BibTeX files into plain text. If your
use case is different, \s-1YMMV.\s0
.PP
In contrast to TeX::Encode, this module does not create \s-1HTML\s0 of any
kind, including for \s-1HTML/XML\s0 metacharacters such as <, >, \f(CW\*(C`&\*(C'\fR,
which can appear literally in the output. Entities are other handling
for these has to happen at another level, if need be.
.SH "FUNCTIONS"
.IX Header "FUNCTIONS"
.ie n .SS "convert( $latex_string, %options )"
.el .SS "convert( \f(CW$latex_string\fP, \f(CW%options\fP )"
.IX Subsection "convert( $latex_string, %options )"
Convert the text in \f(CW$string\fR that contains LaTeX into a plain(er)
Unicode string. All escape sequences for accented and special characters
(e.g., \ei, \e"a, ...) are converted. Basic formatting commands (e.g. {\eit
\&...}) are removed.
.PP
\&\f(CW%options\fR allows you to enable additional translations. These keys are
recognized:
.ie n .IP """german""" 4
.el .IP "\f(CWgerman\fR" 4
.IX Item "german"
If this option is set, the commands introduced by the package `german'
(e.g. \f(CW\*(C`"a\*(C'\fR eq \f(CW\*(C`ä\*(C'\fR, note the missing backslash) are also
handled.
.SH "AUTHOR"
.IX Header "AUTHOR"
Gerhard Gossen <gerhard.gossen@googlemail.com> and
Boris Veytsman <boris@varphi.com>
<https://github.com/borisveytsman/bibtexperllibs>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
This software is copyright (c) 2010\-2020 by Gerhard Gossen and Boris Veytsman
.PP
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.