summaryrefslogtreecommitdiff
path: root/README
blob: 0ed8fa8efe0122aae042c5fb39d4aeb6ca41ea2a (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
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
Oxford English Dictionary, 2nd Edition v3 converters
=================================================================

This is a collection of scripts to convert the Oxford English
Dictionary, 2nd Edition (software version v3) into the various
open formats: jargon, DICT, slob and stardict.

These formats can be loaded into a variety of free software. I
recommend:
- GoldenDict-ng (Linux / MacOS / Windows) [DICT or slob format]
- Aard 2 (Android) [slob format]
- KOReader (eReaders) [stardict format]

Being open formats the dictionary data can easily be analysed
by other programs or converted into other formats.

Dependencies
------------

- To create DICT files the `dictfmt` and `dictzip` tools need to
  be installed.

- To create slob and stardict files the `pyglossary` and `slob`
  tools need to be installed.

- The files 1-10.htm from the OED CDs need to be copied into this
  directory. Some are in the `Data` directory on the CDs.

Build
-----

To build all versions, run `make`.

Alternatively, you can build just the formats you want with
`make <target>`, where `<target>` is one of:
- `oed.jargon`: jargon file.
- `oed.dict`: DICT file
- `oed.dict.dz`: compressed DICT file
- `oed.slob`: slob file
- `stardict/oed.ifo`: stardict file

Naming
------

This project started out just converting to jargon and DICT
formats, hence the name oed2dict, but over time other formats
have gained prominence and utility, so it was expanded to
support them too.