NAME

Biber::LaTeX::Recode - Encode/Decode chars to/from UTF-8/lacros in LaTeX

SYNOPSIS

use Biber::LaTeX:Recode
my $string = 'Muḥammad ibn Mūsā al-Khwārizmī';
my $latex_string = latex_encode($string);
    # => 'Mu\d{h}ammad ibn M\=us\=a al-Khw\=arizm\={\i}'
my $string = 'Mu\d{h}ammad ibn M\=us\=a al-Khw\=arizm\={\i}';
my $utf8_string   = latex_decode($string);
    # => 'Muḥammad ibn Mūsā al-Khwārizmī'

DESCRIPTION

Allows conversion between Unicode chars and LaTeX macros.

GLOBAL OPTIONS

Possible values for the encoding/decoding set to use are 'null', 'base' and 'full'; default value is 'base'.

null => No conversion

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

full => Also converts punctuation, larger range of diacritics and macros
(e.g. for IPA, Latin Extended Additional, etc.), symbols, Greek letters,
dingbats, negated symbols, and superscript characters and symbols ...

Initialise recoding sets. We can't do this on loading the module as we don't have the config
information to do this yet

* normalize => $bool (default 1)
    whether the output string should be normalized with Unicode::Normalize
* normalization => <normalization form> (default 'NFD')
    and if yes, the normalization form to use (see the Unicode::Normalize documentation)

AUTHOR

Philip Kime "<philip at kime.org.uk>"

BUGS

Please report any bugs or feature requests on our Github tracker at https://github.com/plk/biber/issues.

COPYRIGHT & LICENSE

Copyright 2009-2012 François Charette and Philip Kime, all rights reserved. Copyright 2012-2023 Philip Kime, 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.