hashirama/goldendict-ng
hashirama/goldendict-ng
0
0
Fork 0
mirror of https://github.com/xiaoyifang/goldendict-ng.git synced 2024-11-23 20:14:05 +00:00
Code Issues Actions 1 Projects Releases Wiki Activity

doc: extra info about morphology

Browse source
This commit is contained in:
shenleban tongying 2024-05-02 10:45:34 -04:00
parent e78aff27cb
commit c062ab232d
2 changed files with 34 additions and 29 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
website/docs/dictformats.md
View file

@ -28,24 +28,7 @@ Popular dictionary formats are all supported.
## Other Sources
**Programs**
Any external apps can be added by setting a launch command. The `%GDWORD%` will be replaced by word from search line. If command line don't contains such template the word will be fed into standard input stream in 8-bit current locale encoding.
| Type | Notes |
|--|--|
| Audio| Application play sound. A sound icon will be provided as article, click it will trigger the program. |
| Text | Application output some plain text in 8-bit current locale encoding into standard output stream. This text will be shown as separate article. |
| Html | Application output some html code into standard output stream. This code will be shown as separate article. |
| Prefix | Application output some word list into standard output stream. This list will be added in common matches list.|
**System Text-to-speech engines**
Its capability is provided via Qt Speech.
On Windows & macOS, the system provides sounds.
On Linux, speech-dispatcher and flite are the backends.
Various special "dictionaries" can be added, such as Programs, TTS, Morphology, Transliteration, etc... Their doc located at [Sources Management](manage_sources.md)
## Additional info

44
website/docs/manage_sources.md
View file

@ -28,11 +28,21 @@ Goldendict will search through the sound file names when querying words.
## Morphology
Here you can turn on/off morphology dictionaries.
A word could have several forms, but sometimes a dictionary only contains one form that could not be found unless you search the normalized form.
You can specify a path that includes Hunspell format data files (.aff + .dic).
Morphology dictionary uses Hunspell's morphological analysis to obtain word's variant forms.
GoldenDict scan this folder and create list of available dictionaries. To turn on dictionary just set mark in corresponding column.
You can specify a path that includes Hunspell format data files (`.aff` + `.dic`). GoldenDict scan this folder and create a list of available dictionaries.
One possible source of Hunspell dictionaries is Libreoffice's [dictionaries](https://github.com/LibreOffice/dictionaries).
The detailed document about the affix file (`.aff`) and the dict file (`.dic`) can be found at [hunspell.5](https://man.archlinux.org/man/hunspell.5.en).
Note that lots of Hunspell's dictionaries are for mostly for spell checking, and they may lack special morphological rules (For example, related words don't share the same stem in `.dic` file).
There are some specially tailored hunspell dicts to use for Morphology. Such as
* <https://sourceforge.net/projects/goldendict/files/better%20morphologies/1.0/>
* <https://github.com/Ajatt-Tools/hunspell-ja>
## Websites
@ -58,17 +68,29 @@ In the "Icon" column you can set custom icon for every server. If you add icon f
## Programs
Here you can add external applications. To add such application you should set command line for its launch, name for dictionaries list and application type. The `%GDWORD%` template in command line will be replaced by word from search line. If command line don't contains such template the word will be fed into standard input stream in 8-bit current locale encoding.
Here you can add external applications. To add such application, you should set command line for its launch, name for the dictionary list and application type.
| Application type | The purpose of application |
|---|---|
| Audio | Application play sound. |
| Text | Application output some plain text in 8-bit current locale encoding into standard output stream. This text will be shown as separate article. |
| Html | Application output some html code into standard output stream. This code will be shown as separate article. |
| Prefix | Application output some word list into standard output stream. This list will be added in common matches list. |
The `%GDWORD%` in command line will be replaced by word from search line. If the command line doesn't contain such `%GDWORD%` the word will be fed into standard input stream in 8-bit current locale encoding.
In the "Icon" column you can set custom icon for every application. If you add icon file name without path GoldenDict will search this file in configuration folder.
| Program type | Purpose |
|--------------|---------------------------------------------------------------------------------------|
| Audio | Play sound. |
| Text | Text printed by the program will be shown as separate article. |
| HTML | HTML printed by the program Will be shown as separate article. |
| Prefix match | A list of words printed by the program will be added to search bar's completion list. |
Other than "Audio", the program should print the content to standard output.
In the "Icon" column, you can set a custom icon for every application. If you add icon file name without a path, GoldenDict will search this file in the configuration folder.
## Transliteration
Here you can add transliteration algorithms. To add algorithm into dictionaries list just set mark beside it. When such dictionary added into current dictionaries group GoldenDict will search word in the input line as well as result of its handling by corresponding transliteration algorithm.
## System Text-to-speech engines
Its capability is provided via Qt Speech.
On Windows & macOS, the system provides sounds.
On Linux, speech-dispatcher and flite are the backends.