---
name: "LaTeX::Decode"
section: "3pm"
platform: "linux"
package: "liblatex-decode-perl"
version: "0.05-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/LaTeX::Decode"
---

# LaTeX::Decode(3pm)

Decode from LaTeX to Unicode

## NAME

LaTeX::Decode - Decode from LaTeX to Unicode

## VERSION

Version 0.05

## SYNOPSIS

```
    use LaTeX::Decode;
    my $latex_string = 'Mu\\d{h}ammad ibn M\\=us\=a al-Khw\\=arizm\\={\\i}';
    my $new_string   = latex_decode($latex_string); # => 'MuXammad ibn MXsX al-KhwXrizmX'
```

## DESCRIPTION

## EXPORT

## FUNCTIONS

### latex\_decode($text, %options)

Decodes the given text from LaTeX to Unicode.

The function accepts a number of options:

```
    * normalize => $bool (default 0)
        whether the output string should be normalized with Unicode::Normalize
    * normalization => <normalization form> (default 'NFC')
        and if yes, the normalization form to use (see the Unicode::Normalize documentation)
    * strip_outer_braces => $bool (default 0)
        whether the outer curly braces around letters+combining marks should be
        stripped off. By default "fut{\\'e}" becomes fut{e}, to prevent something
        like '\\textuppercase{\\'e}' to become '\\textuppercasee'. Setting this option to
        TRUE can be useful for instance when converting BibTeX files.
```

## GLOBAL OPTIONS

The decoding scheme can be set with\
   `$LaTeX::Decode::DefaultScheme` = '\<name\>'; Possible values are 'base', 'extra' and 'full'; default value is 'extra'.

TODO : explain these scheme!

base  =\> Most common macros and diacritics (sufficient for Western languages\
          and common symbols)

extra =\> Also converts punctuation, larger range of diacritics and macros (e.g. for IPA, Latin Extended\
          Additional, etc.)

full  =\> Also converts symbols, Greek letters, dingbats, negated symbols, and\
          superscript characters and symbols ...

## AUTHOR

Francois Charette, `"<firmicus@cpan.org>"`

## BUGS

Please report any bugs or feature requests to `"bug-latex-decode at` `rt.cpan.org"`, or through the web interface at \<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=LaTeX-Decode\>.  I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

## COPYRIGHT & LICENSE

Copyright 2009-2015 Francois Charette, all rights reserved.

This module is free software.  You can redistribute it and/or modify it under the terms of the Artistic License 2.0.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.