Debian Codegraph @

eng-spa/INSTALL

raw
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!