1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21 """
22 This module implements basic functionality to support placeables.
23
24 A placeable is used to represent things like:
25 1. Substitutions
26
27 For example, in ODF, footnotes appear in the ODF XML
28 where they are defined; so if we extract a paragraph with some
29 footnotes, the translator will have a lot of additional XML to with;
30 so we separate the footnotes out into separate translation units and
31 mark their positions in the original text with placeables.
32
33 2. Hiding of inline formatting data
34
35 The translator doesn't want to have to deal with all the weird
36 formatting conventions of wherever the text came from.
37
38 3. Marking variables
39
40 This is an old issue - translators translate variable names which
41 should remain untranslated. We can wrap placeables around variable
42 names to avoid this.
43
44 The placeables model follows the XLIFF standard's list of placeables.
45 Please refer to the XLIFF specification to get a better understanding.
46 """
47
48 import base
49 import interfaces
50 import general
51 import xliff
52 from base import *
53 from base import __all__ as all_your_base
54 from strelem import StringElem
55 from parse import parse
56
57 __all__ = ['base', 'interfaces', 'general', 'parse', 'StringElem', 'xliff'] + all_your_base
58