aboutsummaryrefslogtreecommitdiff
path: root/README
blob: c06a78a739f3f12cfbebe72dcc73f79f2b11615d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Migrating from legacy binary document formats to ODF can be a pain if documents
use fonts that only support some non unicode encodings (e.g. armscii or
viscii). 
Odfrecode allows to remap these characters sets to the appropriate unicode
codepoints after they've been converted to ODF and makes it therefore possible
to get rid of the legacy fonts used in this documents.

There are two tools available:

* odfrecode is non interactive and can be used for batch conversion
* odfrecode-gtk shows a dialog after conversion which allows the user to
  direclty open the converted Document in OpenOffice (or another ODF capable
  application). This can e.g. be used in a Nautilus/Konqueror/Dolphin context menu.

The following example recodes foo.odt from armscii8 to unicode:

    odfrecode-gtk --recoder=armscii8 foo.odt

New converters can easily be added. For a simple example have a look at
odfrecode/recoders/romanian.py.

For more information see

    https://honk.sigxcpu.org/piki/odfrecode/