Includes allow to use the same shortcut properties in different shortcuts. They are heavily used for dictionary shortcuts.
Includes are defined with
include:. For example, dcm contains:
Additionally, there is:
Both are separate shortcuts and can be called individually. But
en-de 1 includes from
de-en 1 all properties that it does not define itself. In this case, these are
This way, the shortcut URL needs to be maintained only once.
Includes with variables
include.key may also use variables:
If the language from settings is e.g.
de, it includes from
en-de 1. (And if
en-de 1 contains
include:, it also includes from there, and so on.)
Includes from another namespace
include may also include from another namespace:
This can for example be set in one's user settings, to ensure using leo.org as the dictionary for English, no matter what is used in the site namespaces.
Multiple include propositions
include: may instead of only one
namespace:) also contain several ones. For instance, in o we have:
This shortcut for an Arabic dictionary tries first to include from ard, the namespace for arabdict.com. And there also exists:
However, this namespace only contains Arabic dictionaries for a few languages (
If the user's language is e.g.
pl, the include process will fail at this point, as there is no
ar-pl 1 in this namespace.
In this case, the process goes back to o and tries the second entry:
As dcm does contain
ar-pl 1, this inclusion succeeds, and the Arabic dictionary is taken from dict.com.