goldendict-ng/docs/options.html
2023-03-26 00:13:19 +08:00

110 lines
15 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<!-- gdhelp_en.qdoc -->
<title>06 Preferences | GoldenDict</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="sidebar"><div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">06 Preferences</h1>
<!-- $$$options.html-description -->
<div class="descr" id="details">
<p>GoldenDict preferences dialog can be called via menu &quot;Edit&quot; -&gt; &quot;Preferences..&#x2e;&quot; or by shortcut &quot;F4&quot;. In contains several tabs.</p>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>6.1 Interface</p>
<p>Here you can tune GoldenDict interface.</p>
<p class="centerAlign"><img src="images/opt1.png" alt="" /></p><p><b>Open new tabs in background</b>. If this option is set the current tab still active when you open new tab. Else you will be switched to new tab immediately.</p>
<p><b>Open new tabs after the current one</b>. If this option is set the new tab will be placed after current one else after last one.</p>
<p><b>Hide single tab</b>. If this option is set the tab bar will be hidden if the only tab is opened.</p>
<p><b>Ctrl-Tab navigate tabs in MRU order</b>. If this option is set the Ctrl+Tab hotkey will switch tabs as ones was used else as ones placed in the tab bar.</p>
<p><b>Enable system tray icon</b>. If this option is set GoldenDict will create icon in the system tray at it start.</p>
<p><b>Start to system tray</b>. If this option is set GoldenDict will be started in minimized to system tray state.</p>
<p><b>Close to system tray</b>. If this option is set GoldenDict will minimize to system tray else to system taskbar.</p>
<p><b>Start with system</b>. If this option is set GoldenDict will be started automatically after operation system start.</p>
<p><b>Double-click translates the word clicked</b>. If this option is set the double click on word calls it translation. If Ctrl or Shift key is pressed for translation will be created a new tab.</p>
<p><b>Select word by single click</b>. If this option is set the single click on word will select it.</p>
<p><b>Context menu dictionaries limit</b>. This option set the maximum number of dictionaries in context menus.</p>
<p><b>Interface language</b>. This option select the language for GoldenDict interface. After changing of language GoldenDict should be restarted.</p>
<p><b>Display style</b>. This option select one from internal interface styles.</p>
<p><b>Help language</b>. This option select the language for GoldenDict reference. &quot;Default&quot; means the interface language will be used as reference language. If no such reference exists the English reference will be used.</p>
<p><b>Add-on style</b>. This option shows when the folder &quot;styles&quot; inside GoldenDict configuration folder contains at least one folder with user style. Such user style can include the &quot;qt-style.css&quot; file (interface tuning), &quot;article-style.css&quot; file (articles presentation tuning) and some extra files (icons, fonts etc.)&#x2e;</p>
<p>Note: To open the GoldenDict configuration folder you can use &quot;Help&quot; -&gt; &quot;Configuration Folder&quot; menu command.</p>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>6.2 Scan popup</p>
<p class="centerAlign"><img src="images/opt2.png" alt="" /></p><p><b>Enable <a href="popup.html" translate="no">scan popup functionality</a></b>. If this option is set the <img src="images/wizard.png" alt="" /> button will be shown on toolbar. This button turn on/off scanning of word under mouse cursor (only under Windows and MacOS), text selection (only under Linux X11) and clipboard changing.</p>
<p>Note: This option don't affect calling popup window by hotkey.</p>
<p><b>Start with scan popup turned on</b>. If this option is set the scanning mode will be turned on at GoldenDict start.</p>
<p><b>Only show popup when all selected keys are kept pressed</b>. If this option is set the popup will not be shown until all selected keys are pressed.</p>
<p><b>Keys may also be pressed afterwards, within ..&#x2e; sec</b>. This option set the maximum time after word selecting when selected in previous option keys should be pressed to call popup window (only under Linux X11).</p>
<p><b>Send translated word to main window</b>. If this option is set the main GoldenDict window will be activated instead of popup window. The target word will be placed into search line of main window.</p>
<p><b>Show scan flag when word is selected</b> (only under Linux X11). If this option is set the small icon window <img src="images/scanflag.png" alt="" /> will be shown instead of popup window. Click on this window will show popup window.</p>
<p>Note: &quot;Only show popup when all selected keys are kept pressed&quot; and &quot;Show scan flag when word is selected&quot; are mutually exclusive. Only one can be turned on in the same instant time.</p>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>6.3 Hotkeys</p>
<p class="centerAlign"><img src="images/opt3.png" alt="" /></p><p>Here you can set hotkeys to call popup window and/or to show/hide the main window. Just select corresponding line and press keys. These hotkeys are global and works from other applications.</p>
<p>If hotkey contains two parts it first part transfer to other applications and can work in ones as separate hotkey. To correct work of this procedure under Windows 8 and later start GoldenDict with rights of administrator.</p>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>6.4 Audio Here you can set parameters for playback of sound files from dictionaries.</p>
<p class="centerAlign"><img src="images/opt4.png" alt="" /></p><p><b>Auto-pronounce words in main window</b>. If this options is set the first found pronunciation will be automatically played after articles loading to main window.</p>
<p><b>Auto-pronounce words in scan popup</b>. If this options is set the first found pronunciation will be automatically played after articles loading to popup window.</p>
<p><b>Use internal player</b>. If this option is set the internal player will be used for playback. You can choose FFMpeg-based engine or Qt Multimedia (only for Qt5-based GoldenDict).</p>
<p><b>Use external program</b>. If this option is set the sound file to play will be transferred to specified application as command line parameter.</p>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>6.5 Network Here you can set GoldenDict network parameters.</p>
<p class="centerAlign"><img src="images/opt5.png" alt="" /></p><p><b>Use proxy server</b>. If this option is set GoldenDict will use network connections via proxy server. You can use system proxy settings as well as set custom settings.</p>
<p><b>Disallow loading content from other sites</b>. If this option is set GoldenDict will block access from loaded page to other sites.</p>
<p><b>Enable web plugins</b>. This option allow GoldenDict to use NPAPI plugins installed in operation system to handle loaded pages.</p>
<p><b>Don't identify GoldenDict in HTTP headers</b>. If this option is set GoldenDict will don't identify itself via HTTP headers. It usable if some website block requests from GoldenDict.</p>
<p><b>Maximum network cache size</b>. Maximum disk space occupied by GoldenDict's network cache. If set to 0 the network disk cache will be disabled.</p>
<p><b>Clear network cache on exit</b>. When this option is enabled, GoldenDict clears its network cache from disk during exit.</p>
<p><b>Check for new program releases periodically</b>. If this option is set GoldenDict will periodically check the new release presence on goldendict.org site. Check interval is 2 days (or 2 hours if site now is inaccessible).</p>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>6.6 Full-text search Here you can set the full-text search parameters.</p>
<p class="centerAlign"><img src="images/opt6.png" alt="" /></p><p><b>Allow full-text search for:</b> If this option is don't set the full-text search completely blocked. If it is set below you can select local dictionary typed for full-text search.</p>
<p><b>Don't search in dictionaries containing more than ..&#x2e; articles</b> This option allow to turn off full-text search in huge dictionaries like local Wikipedia or Wiktionary. Such huge dictionaries requires long time and many resources to index and may don't index at all if no memory enough.</p>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>6.7 Advanced Here you can set some other GoldenDict parameters.</p>
<p class="centerAlign"><img src="images/opt7.png" alt="" /></p><p><b>Scan popup extra technologies</b> (only under Windows). Here you can turn on/off additional technologies of retrieving word under mouse cursor in addition to classic technology with dll injecting and intercepting screen output functions. Such classic technology is not usable for many modern applications.</p>
<ul>
<li><b>Use IAccessibleEx</b>. This option allows GoldenDict to ask other applications via IAccessibleEx interface. In order to this technology works well the corresponding interface must be implemented in target application. For example via such technology GoldenDict can interact with Internet Explorer 9 and later.</li>
<li><b>Use UIAutomation</b>. This option allows GoldenDict to ask other applications via UIAutomation interface. In order to this technology works well the corresponding interface must be implemented in target application. For example via such technology GoldenDict can interact with MS Visual Studio editor.</li>
<li><b>Use GoldenDict message</b>. This option allows GoldenDict to ask other applications by sending user message registered in Windows. In order to this technology works well a target application must can recognize such messages and reply to its. For example via such technology GoldenDict retrieve words from own article pages.</li>
</ul>
<p><b>History</b>. Here you can tune storing history of requests to dictionaries.</p>
<ul>
<li><b>Store history</b>. If this option don't set GoldenDict will don't log requests to dictionaries at all.</li>
<li><b>Maximum history size</b>. Here you can set the maximum number of records in history. After the history size reach this value new records will replace oldest records.</li>
<li><b>Maximum history size</b>. Here you can set the maximum number of records in history. After the history size reach this value new records will replace oldest records.</li>
<li><b>Save every ..&#x2e; minutes</b>. Here you can set the interval of saving history to file. If interval set to 0 history will be saved only when program will be closed. If GoldenDict will crash all not saved history records will be lost.</li>
</ul>
<p><b>Favorites</b>. Here you can tune GoldenDict Favorites.</p>
<ul>
<li><b>Save every ..&#x2e; minutes</b>. Here you can set the interval of saving Favorites to file. If interval set to 0 the Favorites will be saved only when program will be closed. If GoldenDict will crash all changes since last save will be lost.</li>
<li><b>Confirmation for items deletion</b>. If this option is set GoldenDict will ask confirmation for every operation of items deletion. Otherwise items will be deleted immediately.</li>
</ul>
<p><b>Articles</b>. Here you can set some options for articles presentation.</p>
<ul>
<li><b>Expand optional parts</b>. This option affect dictionaries which mark some article areas as optional (now only ABBYY Lingvo .dsl dictionaries). If it is set these marks will be ignored and article will be shown completely. Else areas marked as optional will be hide and beside article header will be shown button <img src="images/expand_opt.png" alt="" /> . When you press this button the hidden areas will be shown and button will be changed to <img src="images/collapse_opt.png" alt="" /> . When you press this button the hidden areas will be hide again.</li>
<li><b>Collapse articles more than ..&#x2e; symbols</b>. If this option is set GoldenDict will automatically collapse more long articles. Such collapsed articles indicated by <img src="images/arrow.png" alt="" /> icon in &quot;From dictionary..&#x2e;&quot; heading above article text. When you press this icon or header article will be expanded and icon will be changed to <img src="images/downarrow.png" alt="" /> . When you press <img src="images/downarrow.png" alt="" /> icon article will be collapsed.<p>Note: If only one article have found it will not be collapsed regardless of it size.</p>
</li>
<li><b>Ignore diacritics while search</b>. If this option is set GoldenDict will ignore diacritics in headwords while articles search. This option affect the <a href="formats.html#formats" translate="no">local dictionaries</a> only.</li>
<li><b>Ignore input phrases longer than ..&#x2e; symbols</b>. If this option is set GoldenDict will ignore text longer than presented length. This option affect the text transmitted via mouse-over, selection, clipboard or command line.</li>
</ul>
<p><b>Extra search via synonyms</b>. Turn this option on to enable extra articles search via synonym lists from Stardict, Babylon and GLS dictionaries.</p>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>6.8 Options adjustable via config file Some GoldenDict preferences can be changed only by manual editing of configuration file. This file have name &quot;config&quot; and located in GoldenDict configuration folder. You can find this folder via &quot;Help&quot; -&gt; &quot;Configuration Folder&quot; menu command.</p>
<div class="table"><table class="generic">
<thead><tr class="qt-style"><th >Parameter</th><th >Meaning</th></tr></thead>
<tr valign="top" class="odd"><td >maxPictureWidth</td><td >This parameter set maximum image width in ABBYY Lingvo .dsl dictionaries. More width images will be resized to this width. Mouse click on such resized image will create new tab with full-size image. If this parameter is 0 no images will be resized.<p>Default value: 0</p>
</td></tr>
<tr valign="top" class="even"><td >maxHeadwordSize</td><td >This parameter set maximum headword length for ABBYY Lingvo .dsl dictionaries. More long headwords will be ignored while dictionary indexing.<p>Default value: 256</p>
</td></tr>
<tr valign="top" class="odd"><td >trackClipboardChanges<p>(only under Windows and MacOS)</p>
</td><td >This parameter turn on/off tracking of clipboard changing. If <a href="popup.html" translate="no">popup window</a> is enabled and tracking is enabled the popup window will be shown when clipboard content have changed.<p>Allowed values: 0 - tracking is off, 1 - tracking is on.</p>
<p>Default value: 0</p>
</td></tr>
<tr valign="top" class="even"><td >maxHeadwordsToExpand</td><td >This parameter set maximum number of dictionary headwords when GoldenDict create additional index entries for multi-word headwords which allow to search such headwords via its middle words. Creating of the such entries simplify headwords search but require more memory for indexing. It is strongly recommended to change this parameter only if some dictionary can't be indexed because lack of memory and only for indexing of this dictionary (and return parameter to default value after indexing). Value 0 means no limit.<p>Note 1: This parameter affect indexing of the Aard, Slob, StarDict and Zim dictionaries.</p>
<p>Note 2. This parameter don't affect already indexed dictionaries.</p>
<p>Default value: 0 (no limit).</p>
</td></tr>
</table></div>
<p>Note: Before manual editing of the configuration file GoldenDict must be closed or all changes will be cancelled.</p>
</div>
<!-- @@@options.html -->
</body>
</html>