| 1 |
[If this text appears garbled on a Windows system, use Wordpad to open it] |
| 2 |
|
| 3 |
1. The CSS view (quick and dirty) |
| 4 |
|
| 5 |
You should be able to see the contents of the dictionary in your browser |
| 6 |
(Firefox and Opera have no problem with it; IE 8.0 doesn't work perfectly), |
| 7 |
thanks to the CSS style sheet (make sure that the DTD file is also present |
| 8 |
in the same directory/folder; sometimes, you may have to rename the .tei file |
| 9 |
to .xml). The browser view is merely a working view, with some of the text |
| 10 |
supplied by the CSS -- that's why copying from the browser won't yield the |
| 11 |
results you'd expect (some brackets and some text may be missing). Also, the |
| 12 |
CSS view may be difficult to use for large databases, unless you have lots |
| 13 |
of RAM. |
| 14 |
|
| 15 |
The CSS view is triggered by the following line at the very top of the dictionary: |
| 16 |
<?xml-stylesheet type="text/css" href="freedict-dictionary.css"?> |
| 17 |
|
| 18 |
If in your dictionary this line is missing, you can safely add it somewhere below |
| 19 |
the line: |
| 20 |
<?xml version="1.0" encoding="UTF-8"?> (which always needs to be at the very top) |
| 21 |
|
| 22 |
Obviously, the CSS view requires a CSS stylesheet, which in FreeDict is called |
| 23 |
freedict-dictionary.css by default. |
| 24 |
|
| 25 |
If any of the above is missing in the dictionary you are viewing, please be so kind |
| 26 |
as to report this fact to us (see the bottom of this file for directions). |
| 27 |
|
| 28 |
Please note that the CSS view may need to be customized for your particular |
| 29 |
dictionary. If you are a developer of this dictionary and decide to customize |
| 30 |
the CSS view, please delete the symlink, copy the .css from /shared and have a go |
| 31 |
at it. |
| 32 |
|
| 33 |
|
| 34 |
2. The DICT view |
| 35 |
|
| 36 |
One way to access the dictionary properly is to use the DICT database |
| 37 |
generated from the TEI source. The database is offered in a separate |
| 38 |
download and it can be accessed online, e.g. at |
| 39 |
|
| 40 |
* http://freedict.org/dict (official Freedict WWW front-end) |
| 41 |
|
| 42 |
* http://www.dict.org/bin/Dict (official DICT WWW front-end) |
| 43 |
|
| 44 |
(make sure to check the version of the dictionary: these online |
| 45 |
repositories may sometimes offer earlier versions!) |
| 46 |
|
| 47 |
You can also download a desktop/plugin client, see |
| 48 |
|
| 49 |
* http://www.dict.org/w/software/software for a long list, and |
| 50 |
* https://github.com/freedict/fd-dictionaries/wiki/Dictionary-Clients for a short one. |
| 51 |
|
| 52 |
Very often, you will have to tell the client which DICT server it |
| 53 |
should use; look for "Freedict" in the server description. The relatively |
| 54 |
current list of Freedict servers that identified themselves to us is |
| 55 |
available at http://luetzschena-stahmeln.de/dictd/index.php?freedictonly |
| 56 |
|
| 57 |
Apart from using DICT databases online, you can also access them on your own |
| 58 |
computer. To do that, you will sometimes need to run a server (don't worry, |
| 59 |
they are small programs; see the list at http://www.dict.org/w/software/software or |
| 60 |
https://github.com/freedict/fd-dictionaries/wiki/DICT-servers and |
| 61 |
choose something suitable for your platform) and set the client to use the localhost, |
| 62 |
rather than an online server. |
| 63 |
|
| 64 |
Some clients read dictionary databases directly (no server is needed). This is not verified |
| 65 |
information, but look among GoldenDict, OpenDict or StarDict. |
| 66 |
|
| 67 |
3. Schemas (DTD, RNG), ODD |
| 68 |
|
| 69 |
The dictionary should standardly come equipped with a schema, in the form of a DTD (deprecated) |
| 70 |
or a RelaxNG document. The standard way to associate a DTD with a dictionary is with the line |
| 71 |
<!DOCTYPE TEI SYSTEM "freedict-P5.dtd"> somewhere near the very top of the file. There is currently |
| 72 |
no standard way to associate a RelaxNG schema (freedict-P5.rng) - this is still editor- or tool-dependent, |
| 73 |
but the W3C is slowly working on changing that. Some dictionaries may be equipped with a freedict-P5.sch |
| 74 |
file -- such files contain a Schematron schema. |
| 75 |
|
| 76 |
The schemas are derived from what you may think of as the meta-spec for schemas, namely the TEI P5 ODD file, |
| 77 |
named freedict-P5.xml. This is usable with e.g. the Roma application at http://www.tei-c.org/Roma/ |
| 78 |
|
| 79 |
Because the ODD and the schema files (as well as the CSS file and the document you are reading right now) |
| 80 |
sometimes get modified, they are kept in a single place across the project, namely the shared/ directory |
| 81 |
of the SVN repository. If you are using SVN, you should see them as symlinks (they may refuse to work under |
| 82 |
Windows). But if you have downloaded a .tar or .zip archive, they should be contained in it in their full |
| 83 |
form (copied at the moment when the archive was created). |
| 84 |
|
| 85 |
If you notice that this information |
| 86 |
appears to be outdated, *please* file an issue at |
| 87 |
https://github.com/freedict/fd-dictionaries/issues |
| 88 |
or mail [email protected]. Thanks! |