Skip to content

Commit

Permalink
feat: write word to Program dictionary's stdin in UTF-8 instead of lo…
Browse files Browse the repository at this point in the history
…cal 8 bit
  • Loading branch information
shenlebantongying committed Sep 3, 2024
1 parent ea4f45a commit c336cf6
Show file tree
Hide file tree
Showing 3 changed files with 19 additions and 3 deletions.
2 changes: 1 addition & 1 deletion src/dict/programs.cc
Original file line number Diff line number Diff line change
Expand Up @@ -164,7 +164,7 @@ bool RunInstance::start( Config::Program const & prg, QString const & word, QStr

process.start( programName, args );
if ( writeToStdInput ) {
process.write( word.toLocal8Bit() );
process.write( word.toUtf8() );
process.closeWriteChannel();
}

Expand Down
File renamed without changes.
20 changes: 18 additions & 2 deletions website/docs/manage_sources.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,9 +68,10 @@ 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 the dictionary list and application type.
Here you can add external applications. To add such an application, you should set the command line for its launch, name for the dictionary list and application type.

The `%GDWORD%` in command line will be replaced by word from search line.

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.

| Program type | Purpose |
|--------------|---------------------------------------------------------------------------------------|
Expand All @@ -83,6 +84,21 @@ 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.

!!!note

The word will be written to `stdin` in UTF-8 if the command line doesn't contain `%GDWORD%`.

In rare situations on Windows, some programs may not read `stdin` as UTF-8. In this case, you need to do some adjustments.

For Python3.6+, reading `stdin` as UTF-8 is the default behaviour. For older versions, you may need to change [PYTHONIOENCODING](https://docs.python.org/3/using/cmdline.html#envvar-PYTHONIOENCODING).

For Node.js, try `process.stdin.setEncoding('utf8');`.

In case stdin encoding cannot be changed, try read the `stdin` as bytes and call related methods that interpret bytes as UTF-8 strings.

If you cannot access the source code, you can also try set "Beta: Use Unicode UTF-8 for worldwide language support." in Windows settings.


## 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.
Expand Down

0 comments on commit c336cf6

Please sign in to comment.