1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
Simple Latex to Text Converter
------------------------------
.. automodule:: pylatexenc.latex2text
.. contents:: Contents:
:local:
Custom latex conversion rules: A simple template
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Here is a short introduction on how to customize the way that
:py:class:`~pylatexenc.latex2text.LatexNodes2Text` converts LaTeX constructs
(macros, environments, and specials) to unicode text. You can start off with
the example template below and adapt it to your needs.
Macros, environments and specials are parsed as corresponding node objects by
the parser (see :py:class:`pylatexenc.latexwalker.LatexMacroNode`,
:py:class:`pylatexenc.latexwalker.LatexEnvironmentNode`, and
:py:class:`pylatexenc.latexwalker.LatexSpecialsNode`). These node objects are
then converted to unicode text by the
:py:class:`~pylatexenc.latex2text.LatexNodes2Text` object.
You can define new macros, environments, or specials, or override existing
definitions. The definitions need to be provided twice. First, at the level of
the parser using the :py:mod:`~pylatexenc.macrospec` module; the parser needs to
know the argument structure of your macros, environments, and specials, along
with which characters to recognize as "specials". Second, at the level of
`latex2text`, you need to specify what the replacement strings are for the
different LaTeX constructs after they have been parsed into the latex node tree
by the parser.
The following template is a simple illustrative example that implements the
following definitions:
- A new macro ``\putinquotes[`][']{text}`` that puts its mandatory argument
into quotes defined by the two optional arguments. Let's say that the
default quotes that are used are `````` and ``''``. Another simpler macro
``\putindblquotes{text}`` is also provided for the sake of the example.
- A new environment ``\begin{inquotes}[`]['] ... \end{inquotes}`` that does
the same thing as its macro equivalent. Another simpler environment
``\begin{indblquotes}...\end{indblquotes}`` is also provided for the sake of
the example.
- The usual LaTeX quote symbols `````, ``````, ``'``, and ``''`` for unicode
quotes. (See also issue :issue:`39`)
Here is the code (see also docs for :py:class:`pylatexenc.macrospec.MacroSpec`,
:py:class:`pylatexenc.macrospec.EnvironmentSpec`,
:py:class:`pylatexenc.macrospec.SpecialsSpec`, as well as
:py:class:`pylatexenc.latex2text.MacroTextSpec`,
:py:class:`pylatexenc.latex2text.EnvironmentTextSpec`,
:py:class:`pylatexenc.latex2text.SpecialsTextSpec`):
.. literalinclude:: example_latex2text_custom_quotes.py
:language: python
Latex to Text Converter Class
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. autoclass:: pylatexenc.latex2text.LatexNodes2Text
:members:
.. autofunction:: pylatexenc.latex2text.get_default_latex_context_db
Define replacement texts
~~~~~~~~~~~~~~~~~~~~~~~~
.. autoclass:: pylatexenc.latex2text.MacroTextSpec
:members:
.. autoclass:: pylatexenc.latex2text.EnvironmentTextSpec
:members:
.. autoclass:: pylatexenc.latex2text.SpecialsTextSpec
:members:
Obsolete members
~~~~~~~~~~~~~~~~
.. autofunction:: pylatexenc.latex2text.EnvDef
.. autofunction:: pylatexenc.latex2text.MacroDef
.. autodata:: pylatexenc.latex2text.default_env_dict
:annotation:
.. autodata:: pylatexenc.latex2text.default_macro_dict
:annotation:
.. autodata:: pylatexenc.latex2text.default_text_replacements
:annotation:
|
