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 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
|
Thoughts on Source Configuration
================================
Since there has been a request for multiple back-end support inside MATE
Dictionary, and since Gdict makes the addition of such back-ends a possibility,
we need a way to configure these back-ends.
My plan is to use .desktop files in a standard location, such as
/usr/share/mate-dictionary and $HOME/.config/mate/mate-dictionary. By dropping a
correctly-formatted .desktop file inside these locations, you can enable a new
dictionary source inside MATE Dictionary.
* Syntax
========
** General keys
===============
A .desktop file is parsable using the GKeyFile class of GLib. Please remember
that a .desktop file is case sensitive. A standard .desktop file for
Dictionary must have the "Dictionary" group; only this group should be parsed,
and other groups should be ignored.
The mandatory name of the dictionary source is specified by the "Name" key;
it may be localized.
An optional description of the dictionary source is specified by the
"Description" key; also this may be localized.
The type of back-end to use is specified by the mandatory "Transport" key; at
this moment, only the "dictd" value is permitted.
An optional default database to be used with the dictionary source is specified
by the "Database" key; if no default database is specified, assume the default
database for the transport.
An option default match strategy to be used with the dictionary source is
specified by the "Strategy" key; if no default strategy is specified, assume
the default strategy for the transport.
** Transport-specific keys
==========================
These are the keys defined for the "dictd" transport:
"Hostname" [mandatory]
holds the hostname of the dictionary server to connect to;
"Port" [optional]
holds the port of the dictionary server to connect to; if omitted,
the default port should be used.
** Example
==========
Dictionary source for dict.org:
[Dictionary]
_Name: Default
_Description: Default dictionary server
Transport: dictd
Hostname: dict.org
Port: 2628
$ Last updated: 2005-12-07 19:00 (+0100) ebassi $
|