# StarDict Manual V3.0.4

2003
2004
2005
2006
2007
2008
2009
2010
胡正
GNOME Documentation Project

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.2 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS distributed with this manual.

This manual is part of a collection of GNOME manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the license to the manual, as described in section 6 of the license.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and the members of the GNOME Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.

DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:

1. DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND

2. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.

胡
正
GNOME Documentation Project

     huzheng001@gmail.com

Will
Robinson
Stanford University

     wsr23@stanford.edu

Cleaning up English
Новица
Наков
Слободен софтвер Македонија

     acivon@mail.com.mk

Македонски превод
Ruud
Slaats
Eurotech Group

     ruudslaats@eurotechgroup.nl

Nederlandse vertaling
Александр
Мурыгин
AITOC

     murygin@aitoc.com

Русский перевод
Сергій
Дубик
ЛНБ

     dubyk@library.lviv.ua

український переклад
星際譯王 使用手冊 V2.4.2
Nov 2003

胡正

GNOME Documentation Project

StarDict Manual V3.0.2
Jan 2011
This manual describes version 3.0.4 of StarDict.

## 提出意見

提出關於星際譯王或本文件的建議或者報告臭蟲請與下面地址聯絡： GNOME 意見頁。

User manual for the StarDict dictionary.

## 簡介

星際譯王是一個用Gtk2開發的跨平台的國際化的辭典軟體。她具有強大的功能，如“萬用字元匹配”，“掃描選擇”，“模糊查詢”，等等。

## 啟動

### Starting StarDict

你可以從以下幾種方式啟動星際譯王 :

應用程式選單

  選擇附屬應用程式星際譯王。

指令行

  輸入`stardict`，然後按回車鍵。

  You can specify a word to query too:

  `stardict word`

  or a Glob-style pattern matching string:

  `stardict wo?d*`

  or do a fuzzy query:

  `stardict /word`

If StarDict is already running. In Windows edition StarDict activates the first instance of StarDict, then terminates. In Gnome edition StarDict actives the first instance of StarDict, queries the word in that instance if one was supplied on the command line, then terminates.

See for complete description of command line options.

### StarDict Main window

When you start StarDict, the following window appears.

#### StarDict Main Window

Shows 星際譯王 main window. Contains Search field, Tool buttons, Word list, Definition area and Setting buttons.

The StarDict Main window consists of the following elements:

Top bar

  The top bar consists of the Search field and a number of buttons. Here they are in the order from left to right.

  Clear

    Clears the Search field.

  Search field

    Use the Search field to enter the word that you want to look up. You can also access recently-queried words through the dropdown box.

  Fuzzy Query

    Fuzzy queries the word entered into the Search field.

  Go Back

    Go back to the word you queried before. Right-click to see a list of words you queried earlier.

  Main menu

    A button on the right end of the Top bar. It pops up the StarDict Main menu.

Left bar

  The Left bar contains a number of buttons, here they are in the order from top to bottom:

  單詞列表

    Opens a list words that have been found in search.

  Results list

    Opens a list of sources, mainly dictionaries, where the current word has been found. The Definition area combines results from all the sources. Clicking a source in the list scrolls the Definition area window to the definition from that source.

  Full-Text Translation

    Switches to the Full-text translation mode that allows to translate blocks of text, see .

  Dictionary groups

    Shows a pop-up menu that allows to select a group of dictionaries where to search words. The menu also contains a checkbox to enable network dictionaries. See for information about network dictionaries and how to configure them.

  Previous word and Next word

    These buttons are at the bottom part of the Left bar. They work with the Word list and allow to switch to previous and next words in the Word list.

Bottom bar

  The left part of the bar in the order from left to right:

  Scan selection checkbox

    Enable and disables the Scan mode. Checking the Scan selection check button will cause StarDict to automatically look up words that you highlight in any application. See for more details about the Scan mode.

  Info

    Shows an introduction to using StarDict in the Definition area.

  Quit

    Quits StarDict.

  The right part of the bar in the order from left to right:

  Internet search

    Click the button to initiate Internet search. By default, the first website is used, but you may select any configured website right-clicking the button. StarDict queries the word in the Search field sending a GET request to the configured web page. Result are shown in a web browser. To configure the list of websites see .

  StarDict project website

    Opens StarDict project website in a web browser.

  Manage dictionaries

    Opens Manage dictionaries dialog that allows to configure dictionaries to use, organize them in groups and more.

  偏好設定

    Opens the Preferences dialog that allows to configuration a multitude of parameters pertaining to StarDict. See .

單詞列表

  The smallest half of the StarDict Main window on the left. It contains a list of words that have been found in search. Click a word to show the related articles in the Definition area. You may use a spliter in the middle of the StarDict Main window to divide the space between the Word list and the Definition area.

釋義區

  The largest half of the StarDict Main window on the right. StarDict displays definition of a word in this area of the window. You may use a spliter in the middle of the StarDict main window to divide the space between the Word list and the Definition area. The Definition area has its own bars: a top toolbar (see ) and a bottom search bar (only visible when you search in the Definition area).

The following hotkeys are available in the Main window.

#### Hotkeys

middle mouse button

  This hotkey applies to the Definition area only.

  Query the text selected in the Definition area into the Main window. In Windows edition of StarDict, if there is no selected text, query clipboard content into the Main window.

right mouse button

  Show pop-up menu.

### Definition area toolbar

The Definition area toolbar is at the top of the Definition area. It contains a number of buttons. Here they are in the left-to-right order.

Hide(Show) the Word list

  Hide or show the Word list or the Results list, depending on what is active now.

Copy

  Copy the Definition area text into clipboard, all the text.

Pronounce the word

  This is a button with an additional dropdown menu. Clicking the button you make StarDict pronounce the current word using the first TTS engine that can do that. The dropdown menu allows you to select the TTS engine to use.

  #### TTS engines

  Real People TTS

    This engine use sound samples performed by real people.

  Espeak TTS

    Espeak TTS plugin.

  Festival TTS

    Festival TTS plugin.

  Command TTS

    TTS command you may specify in the Preferences dialog. See .

  Depending on configuration settings, installed plugins and other factors, the list of TTS engines may be shorter.

Save to file

  Save Definition area text into a file. The new text is appended to the end of the file. The file to use is specified in the section of the Preferences dialog. You may also specify to export only the found word, not its definition. StarDict exports not the word you searched for but the word that was found, the one which translation is shown in the Definition area. When "export only word" is not specified, selection is taken into account. When text is selected in the Definition area, the selected text is exported prepended with the found word. When there are no selected text, all text of the Definition area is exported.

  Hotkey: Alte

Search in the Definition text

  Search for text in the Definition area. This button opens the Definitiona area Search bar at the bottom of the Definition area where you may type a word to search.

  Hotkey: Ctrlf

### 狀態通知區圖示

StarDict will also add an icon to the Notification area. When you iconify the Main window, the window will be hiden. After you click the icon, the window will be shown again. If you right click this icon, it will popup a menu where you can choose to toggle Scan selection, or to Quit. You can toggle Scan selection directly by ctrl-clicking the icon. Clicking the middle mouse button on the icon will query the selected word.

#### 星際譯王的狀態通知區圖示

星際譯王's notification area icon.

### 選擇取詞

StarDict can automatically scan selections. This means that when you select a word or phrase in StarDict or in any other application, StarDict will get the text that you selected and search for it, then display the Floating window containing the result of the search.

In Windows the Scan mode works differently. It has nothing to do with selection in fact. StarDict extracts the text under the pointer when you pause the mouse for a while. Normally StarDict looks up a word under the pointer, if the pointer is not over a word, then words to the left and the right of the pointer are considered. It is time to say what StarDict considers as a word. StarDict gives a number of tries. First, it considers a word may include anything but spaces and punctuations; second, a word consisting of only letters; a word of lower case letters; a word of upper case letters; a capitalized word of letters. Finally, StarDict uses one of the tried word to find the longest prefix making a word. You may help StarDict to extract the right word or a part of a word selecting it. Although StarDict does not work with selections, selection may effect the text StarDict gets.

Scanning in Windows may not work with some applications. For example, it's known that scanning does not work with FireFox 3.x and Windows Console (cmd.exe process). The scanning feature depends on the way application outputs text. If scanning does not work, you may harness another StarDict feature ‒ Clipboard scanning, see .

In Windows StarDict works specially with some applications. First, StarDict itself. To scan a word in StarDict Main window you need to select it. The Scan mode in StarDict Main window works exactly as it should in general case, the fact that it's Windows does not matter. You can not scan in other StarDict windows however.

Second, there is special plugin to scan in PDF documents, see .

#### StarDict Floating Window

Shows 星際譯王 the Floating window. Contains Tool buttons and Definition area.

#### Usage tips

- You may drag the Floating window to move it.

- The Floating window will disappear when you move your pointer some distance away.

- You may configure StarDict so it will do scanning only when a special modifier key is held down. See .

- You may switch the Scan mode on and off by pressing the CtrlAltx shortcut. See .

- StarDict remembers the last text looked up in the Floating window and will not lookup it again. If you need to see the translation again, you should lookup another word first (it's not enough to simply change selection) and then lookup the original word. Another possibility is to middle-click on the Notification area icon, StarDict will lookup the selection unconditionally.

The StarDict Floating window consists of the following elements:

Tool buttons bar

  A bar at the top of the Floating window. The bar will be hidden automatically to save display space. When your mouse pointer enters the Floating window, the Tool buttons bar will appear immediately, and disappear again as the mouse pointer leaves.

  You can click these buttons to query a word in the Main window, copy the query result to clipboard, pronounce the word, stop selection scanning, etc. To the far right is the Lock floating window button. If the Floating window is locked, it will always be shown there.

釋義區

  查詢的結果會顯示在這個區域。

### WordPick Adobe Acrobat plugin

StarDict includes an Abode Acrobat plugin that can be used to extract and translate text from Portable Document Format (PDF) documents. The WordPick plugin is available in Windows edition of StarDict only. The main text extration mechanism does not work with PDF documents in Windows.

#### Limitations

WordPick plugin requires non-free edition of Acrobat like Acrobat Stardard, Pro or richer, it does not work with the free Acrobat Reader product. The plugin is know to work with versions 7-9 of Acrobat. PDF document security restrictions must allow extracting document content.

WordPick plugin embeds an icon into the stardard Acrobat toolbar near the Hand Tool. In Acrobat Reader you will not see that icon ‒ plugin is not available. If the current document does not allow for text extraction, the icon is disabled, the plugin is not operational.

#### Adobe Acrobat Toolbar with WordPick plugin icon

Shows Adobe Acrobat Toolbar with WordPick plugin icon.

#### How to inspect document security permissions

In the main menu open File, Document properties. Document properties dialog pops up. Proceed to Security tab. Look into Document Restrictions Summary group. Content Copying or Extraction must be allowed.

#### Translate text with WordPick plugin

1. Select WordPick and Select tools. Cursor changes to a vertical bar. Now you can select text with mouse.

2. Start StarDict if you have not already done that, and enable Scan mode.

3. Select a word in the PDF document, StarDict shows the Floating window with translation if the word is found.

You may select consecutive words and phrases. If StarDict is unable to find the phrase, it tries to cut words from the end. You will be shown translation of the first word if nothing else has been found.

Note that the Scan modifier key () has no effect in Acrobat. WordPick search for text when you select something in the document regardless of the state of modifiers. To turn off the text translation mode, deselect the WordPick tool on the toolbar, deselecting the Select tool is not necessary.

### Full-Text Translation

StarDict provides full-text translation service. It allows you to translate short texts with up to 2000 characters approximately. The exact limit depends on the translation engine and other factors. To switch to Full-Text Translation mode click the Full-Text Translation button on the Left bar in StarDict Main window.

StarDict uses online translation services available for free on the Web to perform translation. StarDict collects text, source and target languages, constructs an HTTP request and sends it to online translation service. The application receives response of the service and shows results in a window. You may see StarDict interface to Full-Text Translation service below.

#### Full-Text Translation Mode

Shows 星際譯王 in Full-Text Translation mode.

The top line of the window from left to right contains: engine selection combobox, source language combobox, and target language combobox. Below you see a text area for the text to translate. The bottom part of the window contains a text area for translation results. The Translate button in the middle of the window initiates translation request. The bottom line of the window provides a link to the online translation engine. It opens in a web browser.

To translate something, first select a translation engine. You have the following choice: Google, Yahoo, Excite Japan. Select source and target languages. Available source and target languages depend on selected engine. Available target languages depend on source language as well. Type the text to translate into the source text area. Click the Translate button to start translation. You'll see results in the result text area. Sometimes it may show you Not found! text. It means that translation failed. There can be a number of reasons: source text is too long, the online service is down, the service has changed output format and StarDict is unable to parse it. You may see other errors in the results area.

## 使用方法

### 查詢單詞

要查詢一個單詞的釋義，可以按照下列步驟進行：

1. Type the word that you want to look up in the Search field.

2. 星際譯王會立即顯示所有的釋義。如果沒有找到，你可以按回車鍵來進行模糊查詢或者按一下模糊查詢按鈕。

3. Use the scrollbar to scroll through the definition. Select the words in the Word list to view the related words.

### 清除單字輸入框內容

To clear the text of the Search field, click the Clear button on the left, or just press Alt-C or ESC.

### 複製文本

There are two ways to copy the text in the Definition area to another application:

- To copy all of the text, click the Copy button by the top of the Definition area.

- 選擇你想複製的文本，然後按一下鼠標的右鍵並選擇複製。

### To Find Text in the Definition Area

To find text in the Definition area, perform the following steps:

1. 按一下位於釋義區頂部的查找按鈕。

2. 在查找文本框中輸入你想要查找的單詞或詞組，然後按回車鍵。但不可以使用萬用字元。

3. 要查找下一個單詞，再按回車鍵即可。

### Scanning: operation guide

- Scenarios below assume that you make selection with mouse.

- Scan key is the modifier set by the "Scan modifier key" option, see .

#### Scanning in Linux and Unix

##### Case 1. "Only scan while modifier key is being pressed" option is off

1. Select text to translate.

2. Wait for a few seconds. The Floating Window pops up.

##### Case 2. "Only scan while modifier key is being pressed" option is on

1. Press and hold the Scan key.

2. Select the text.

3. Wait for a few seconds. The Floating Window pops up.

4. Release the Scan key.

##### Case 2.1. "Only scan while modifier key is being pressed" option is on. A variation

1. Select the text and do not release the mouse button yet.

2. Press and hold the Scan key.

3. Release the mouse button.

4. Wait for a few seconds. The Floating Window pops up.

5. Release the Scan key.

Selection is made when you release mouse button. This is the time when the Scan key must be pressed down. It takes some time for StarDict to inspect selection, you must hold the Scan key all this time. What is why you need to hold the key for a few seconds after selection.

#### Scanning in Windows

##### Case 1. "Only scan while modifier key is being pressed" option is off

1. Place the mouse pointer over the word you want to traslate.

2. Do not move the mouse for a few seconds. The Floating Window pops up.

##### Case 2. "Only scan while modifier key is being pressed" option is on

1. Place the mouse pointer over the word you want to traslate.

2. Press and hold the Scan key.

3. Do not move the mouse for a few seconds. The Floating Window pops up.

4. Release the Scan key.

For scanning in PDF documents see .

### Toggle Scan Mode

There are a number of ways to enable or disable the Scan selection mode. When in Scan mode, StarDict shows translation of the text you select in different windows. See .

#### Ways to enable the Scan mode

- Toggle the Scan selection checkbox at the bottom left corner of the StarDict Main window.

- Right-click the Notification area icon and check Scan in the pop-up menu.

- Press CtrlAltx shortcut (it toggles the Scan mode). To configure the shortcut see .

### Main window hotkeys

Ctrlq

  Quit StarDict.

Altx

  Minimize to tray. StarDict Main window is closed, taskbar item disappears, but the application continues to run. You may open the Main window again clicking on the Notification area icon.

Altz

  Iconify the application. The Main window is hidden, the taskbar item remains.

Alte

  Save word definition to a file. See for more details.

F1

  Show help.

Ctrlf

  Search in the Definition area. See for more details.

AltLeft

  Go Back. Return to the word that was queried before.

AltUp

  Previous word. Query the previous word in the Word index.

AltDown

  Next word. Query the next word in the Word index.

Altm

  Menu. Show the Main menu.

Ctrlv

  Query clipboard text in StarDict.

Ctrlu

  Clear the Search field and focus it.

BackSpace

  The same as Ctrlu.

Enter

  1. The focus is in the Word list.

     If the selected index item has children, expand or collapse the item. If the selected index item has no children, query the item in the main window.

  2. The focus is in the Definition area.

     Requery the text in the Search field.

Space

  Focus the Search field.

Escape

  1. The focus is in Definition area Search bar.

     Hide the search bar.

  2. Otherwise, this hotkey has the same effect as Ctrlu.

CtrlAltz

  Open the Main window of StarDict. The Main window may be iconified, or StarDict may only exist as a Notification area icon. In all the cases pressing this hotkey presents the Main window to the user. You may change the hotkey in the Preferences dialog, see .

CtrlAltx

  Toggle the Scan mode. You may change the hotkey in the Preferences dialog, see .

### Installing new dictionaries

Dictionaries for StarDict you download are normally packed in archives. You must unpack them and copy into one of the StarDict dictionary directories. If you simply copy an archive file into the dictionary directory, StarDict will not find the dictionary. It is recommended to place each dictionary in its own directory. You may build a hierarchy of directories to organize your dictionary collection. StarDict search directories recursively. See also .

#### Installing a dictionary

1. Download a dictionary. Normally a dictionary is packed in an archive file, for example, `WineEnRu.zip`.

2. Unpack the archive in a new directory. You may name the directory after the archive name, though that is not required.

       WineEnRu/WineEnRu.dict
       WineEnRu/WineEnRu.idx
       WineEnRu/WineEnRu.ifo

3. Copy the dictionary directory into one of StarDict dictionary directories, see .

4. Restart StarDict. The new dictionary will be added into the default dictionary group.

#### Broken dictionaries

Some dictionaries you may find on Internet violate restrictions of StarDict dictionary file format. Using such a dictionary may result in StarDict crash. If StarDict becomes unstable, check your dictionaries, especially new ones, with StarDict Editor or stardict-verify command line tool.

### Removing dictionaries

To remove a dictionary it's enough to remove all files belonging to that dictionary. All files of a dictionary share the same base name, for example.

    WineEnRu.dict
    WineEnRu.idx
    WineEnRu.idx.oft
    WineEnRu.ifo

Some dictionaries may include resource database that is named differently. For complete list of file see . If you follow the rule "one dictionary ‒ one directory", removing a dictionary will be easer.

#### Removing a dictionary

1. Quit StarDict. Make sure that StarDict has really terminated, not just minimized into tray icon!

2. Remove dictionary files.

## 偏好設定

To configure StarDict, click the Preferences button at the right-bottom corner of the Main window or click the Main menu button and choose Preferences.

### 辭典

#### 選擇區取詞

Only scan while modifier key is being pressed.

  Only do scanning while the modifier key being pressed. The modifier key is set by the option.

  預設：否。

Hide floating window when modifier key released.

  When this option is set, the Floating window is hidden when user releases the modifier key. Note: the window is hidden only if the pointer has the same position it had when the window was shown. In addition to hiding the window, the last selected text is forgotten, which allow you to lookup the same text again simply pressing the modifier key. When this option is not set, releasing the modifier key has no effect on the Floating window.

  This option has effect only if is checked.

  預設：是。

Scan modifier key

  This option allows to choose a modifier keys or a key combination that enables scanning.

  This option has effect only if is checked.

  Default key: Win (depends on StarDict edition).

Scan clipboard.

  Enables Clipboard scanning. If enabled, when new text is copied into the clipboard, StarDict lookup the text into the Floating window.

  This option is only available in Windows edition of StarDict.

  預設：否。

Scan mode shortcut

  The Scan mode shortcut enables or disables the Scan mode. Check the Use scan hotkey checkbox to enable this shortcut. You may change the shortcut in the field to the right of the label. Click inside the field and press the key combination you want to assign to this action.

  Default: TRUE

  Default shortcut: CtrlAltx.

#### 字型

使用自訂的字型。

  Allows you to override the system's default for StarDict. If this option is turned on, the font selelected in the Dictionary font option will be used instead of the system font.

  Font settings apply immediately.

  預設：否。

#### Cache

Create cache files to speed up loading.

  Opening a dictionary the first time, StarDict does some calculations to access dictionary contents speedily. StarDict may save the results in special cache files that will be used the next time StarDict starts. With cache files StarDict starts quicker, since it does not need to do the same calculations again. It's highly recommended to enable caching. In the first place, StarDict tries to save a cache file along with the dictionary. If it fails, for example, because the directory is write-protected, StarDict creates a file under the user home directory, in StarDict's directory.

  預設：是。

Sort word list by collation function.

  Normally, StarDict uses an index of words to look up a word in a dictionary. When the word is present in the index, the corresponding article is shown. Otherwise adjacent words will be checked and may be used as result. StarDict uses heuristic algorithms to decide whether the particular word may be suggested as result of the search or not. The order of words in an index is very important and it would be handy if index items were sorted by alphabet or according to other rules. Collation functions allows you to specify a number of predefined sorting orders, that may be helpful when working with particular languages.

  To use a collation function check the Sort word list by collation function checkbox and select the desired function from the Collation function list. The collation function will be applied as soon as you close the Preferences dialog. It may take a considerable amount of time to apply the new collation function, please, be patient.

  It's highly recommended to enable the option, otherwise StarDict will do sorting each time the application starts.

  預設：否。

Clean all cache files

  Remove all StarDict cache files.

#### Export

StarDict may export search results into a file. You have two options: export only the found word or export the entire search result, the contents of the Definition area.

Only export words.

  When this option is set, StarDict exports only the found word, otherwise exports the complete article.

  預設：是。

File name

  Name of the file where to export data.

#### 音效

There are a number of cases when StarDict needs to play sound files. StarDict may accompany GUI actions with sounds. StarDict may pronounce the words you search in the dictionary. Some articles may contain linked sound files you can play.

To play sound files StarDict may harness platform-specific services or use commands you specify on this page.

This page allows to configure some aspects of the TTS subsystem. The TTS subsystem is used to pronounce words by computer.

開啟事件音效。

  Whether to enable sound events. StarDict will play sound event when button is active, released, and when a menu pops up.

  預設：是。

Command for playing sound files:

  Specifies a command for playing sound files. You may specify a program name (with or without full path) accompaned with any options required. The file name to play will be appended to this command at run time.

Always use sound play command

  On some platforms StarDict use platform-specific services to play sound files first, then retreats to the custom command provided by the user if the service is unable to play the file. You may specify to always use the custom command selecting this option.

  預設：否。

RealPeopleTTS search path:

  Allows to specify locations of RealPeopleTTS bundles. RealPeopleTTS bundle is a collection of sound files containing speech samples performed by real people. Normally, one file contains one recoded word, the file is named after that word. Sound files are organized into a number of directories. In the text field you must specify a path to the top level directory of the bundle. The order of paths in the text field is important. StarDict checks directories from top to bottom, the first found file will be used.

  ##### Default:

  In Windows edition of StarDict

    `C:\Program Files\WyabdcRealPeopleTTS`, `C:\Program Files\OtdRealPeopleTTS`, `WyabdcRealPeopleTTS`, `OtdRealPeopleTTS`

  In other editions of StarDict

    `/usr/share/WyabdcRealPeopleTTS`, `/usr/share/OtdRealPeopleTTS`

Enable TTS program.

  Allows to use the command below to read words. You need to restart StarDict for changes to take effect.

  預設：否。

TTS Command line:

  This field allows to specify a command to use to pronounce words. You need to provide a print-like string, with "%s" specifing the place where the word (or phrase) to pronounce will be inserted. You need to restart StarDict for changes to take effect. Do not forget to check the checkbox above if you want to use this command.

  Default: nothing.

#### Video

Command for playing video files:

  Specifies a command for playing video files. You may specify a program name (with or without full path) accompaned with any options required. The file name to play will be appended to this command at run time. Video files may be linked with dictionary articles.

#### Article rendering

Highlight search term

  Whether to highlight the search term in the Definition area. A search term is a word that was found in dictionaries, a head word of an article.

  預設：否。

#### Dict management

Add new dictionaries to active dictionary group

  At start time StarDict scans known directories for dictionary files. This options specifies what to do with new dictionaries. When this option is on, new dictionaries are added to the active dictionary group. Otherwise you have to add new dictionaries to a group manually.

  Disabling this option may be useful if you have multiple groups and you want to control precisely what each group contains. Often the last active dictionary group is not appropriate for new dictionaries.

  預設：是。

Add new plug-ins to active dictionary group

  At start time StarDict scans known directories for plug-in files. This options specifies what to do with new plug-ins (belonging to Virtual Dictionary and Network dictionary plug-in categories). When this option is on, new plug-ins are added to the active dictionary group. Otherwise you have to add new plug-ins to a group manually.

  Disabling this option may be useful if you have multiple groups and you want to control precisely what each group contains. Often the last active dictionary group is not appropriate for new plug-ins.

  預設：是。

### Network

#### Net Dict

StarDict may look up words in network dictionaries using a custom StarDict network protocol. This configuration page allows you to register an account, select a server to use, and specify other related parameters.

At the present time StarDict may be configured to query only one server. When network dictionaries are enabled, each time you ask StarDict to lookup a word or phrase, the application sends a request to the configured server. Note that network dictionaries are enabled globally, they are used in both Main and Floating windows, they do not depend on the dictionary group selected.

To configure the list of dictionaries on the server, use the Manage Dictionaries dialog, Network dictionaries tab.

You need to register on the server to use this feature. Click Register an account button on this page to register an account.

Enabling network dictionaries poses a security risk. Your text will be sent to remote servers. Additionally, since network requests do not use any encryption, anyone able to sniff communication can see that text.

Enable network dictionaries

  Enables network dictionaries.

  預設：否。

#### Web browser

StarDict may need to open a web link to start Internet search, show StarDict project website, show a web page to download new dictionaries, new version of the application and for other reasons. This configuration page allows to specify how a web link should be opened.

Command for opening URLs

  This option allows you to specify a command to use for opening URLs. Some editions of StarDict use platform-specific services for opening URLs by default. To use the custom command you need to check the checkbox below. For other editions of StarDict the custom command is the only way to open a web link.

  You may specify a program name (with or without full path) accompaned with any options required. The URL to open will be appended to this command at run time.

  Default: `firefox` (depends on edition).

Always use this command for opening URLs.

  This option is only available in editions of StarDict that can use other ways to open a web link.

  Check this option to use the custom command to open web links instead of platform-specific services.

  預設：否。

### 主視窗

#### Input

Search while typing

  When this option is checked, StarDict search for the word you are typing in the search field automatically. StarDict monitors key-press events, it starts searching the word entered as soon as there is no activity for more than a specified amount of time. The time span can be changed in the field below. If the time span is 0, search is started immediately after you change the search field.

  When this option is not checked, you need to press Enter in order for StarDict to start searching the word.

  Default: TRUE

Word change timeout

  A word change timeout in milliseconds. See the option above for details.

  Default: 300 ms

Show the first word when not found.

  When StarDict is unable to find the exact word requested, the application may propose another word that is close to the original. When this option is checked, the closest word will be shown in the Definition area, otherwise, StarDict tells that the original word is not found. Note, that this option applies to simple queries only, that is the queries that do not use regular expressions, patterns, fuzzy matchs and so on.

  Default: TRUE

#### 選項

Skin

  Allows to customize graphical appearance of the application. Select the Default item to restore the original appearance of StarDict, no skins applied. You need to restart the application in order for changes to take effect. For instructions on how to prepare a custom skin see the `doc/Skins` file in StarDict sources.

  Default: Default.

啟動星際譯王時隱藏主視窗。

  Controls whether the Main window appears when you first start the program. If you select this option, you will only see the Notification area icon after starting StarDict. You may still get to the Main window by clicking on this icon.

  預設：否。

Use open main window hotkey

  This option enable the hotkey that opens the Main window, and allows to change that hotkey. When enabled, when user presses the hotkey, the Main window is presented to the user.

  預設：是。

  Default hotkey: CtrlAltz

Transparency

  Allows to make the Main window transparent. Moving the slider you may change transparency degree. Transparency is measured in percents, it can range from 0 to 80, where 0 ‒ fully opaque, 80 ‒ almost fully transparent. Moving the slider has an immediate effect on the window.

  On X11 this has any effect only on X screens with a compositing manager running. On Windows it should work always.

  Default: 0 ‒ fully opaque.

#### Search website

StarDict may use Web search engines, Web dictionaries, databases providing web-based interface and other web sites providing information by request. The text to search is incorporated into URL. Normally, the text is assigned to a GET request parameter. For example, to search for word stardict in Google search engine you may use the following URL `http://www.google.com/search?q=stardict`. You can search websites in StarDict right-clicking the Internet search button in the Main window.

StarDict does not handle the web request itself, it only composes a URL and invokes an external program like a web browser or use platform-specific services to open the URL.

On this page you may see a list of websites. Use Add and Remove buttons to add new sites and remove existing records. Use Up and Down arrow buttons to reorder records in the list. Each record consists of three items:

##### Website record

Website name

  This is a label you see in menu. Use a meaningful name.

Website link

  Link to the main page of the website. This link is opened when there is nothing to search for, the Search field is empty.

Website search link

  Link to perform request. %s identifies the place where to insert the search text. For example, `http://www.google.com/search?q=%s`.

### 狀態通知區圖示

#### 選項

When middle mouse button is clicked:

  Specifies an action to perform when user clicks the middle mouse button on the Notification area icon. There are the following choices:

  - Query selection in floating window

  - Query selection in main window

  - Do nothing

  In the Do nothing case StarDict simply ignores middle button clicks, otherwise StarDict get text of the current selection, search for it and displays the results either in the Floating window or in the Main window.

  In case there are a number of windows on desktop having text selected, there might be a confusion what text will be used. StarDict works with the X Primary selection. Only one application can own a selection at a time, so when you select something in an application that application becomes the selection owner, the previous owner loses selection ownership. Now back to the question. StarDict will use the text that was selected last.

  Default: Query selection in floating window.

### 浮動視窗

#### 選項

Pronounce the word when it pops up.

  When set, pronounce the word when the Floating window shows translation.

  預設：否。

Show floating window if word not found.

  This option allows to configure what to do if the word to be shown in the Floating window is not found. You have two choices: 1) do not show the Floating window at all ‒ this option is unset, 2) show the Floating window with text indicating that the word was not found ‒ this option is set.

  預設：是。

#### Settings

最大視窗寬度。

  Sets the Floating window's max width.

  預設：320。

最大視窗高度。

  Sets the Floating window's max height.

  預設：240。

Use custom background color:

  Enables to use custom color for background in the Floating window and select that color.

  預設：否。

Transparency

  Allows to make the Floating window transparent. Moving the slider you may change transparency degree. Transparency is measured in percents, it can range from 0 to 80, where 0 ‒ fully opaque, 80 ‒ almost fully transparent. Moving the slider has an immediate effect on the window.

  On X11 this has any effect only on X screens with a compositing manager running. On Windows it should work always.

  Default: 0 ‒ fully opaque.

## Manage dictionaries

This section of the manual describes the Manage dictionaries dialog that allows you to view and organize all dictionaries available in StarDict. You may work with the following types of dictionaries: normal (index-based) dictionaries, virtual plugins, network plugins, network dictionaries, tree dictionaries. The dialog consists of 4 tabs: , , , . Each tab is described in details below.

### Dict list tab

Dict list tab allows you to view and reorder a list of all dictionaries of the following types: normal (index-based) dictionaries, virtual plugins, network plugins. Dictionaries of these types may be organized into groups. To work with dictionaries groups, switch to . This tab shows all dictionaries that are known to StarDict, irrespective of whether they are used in some dictionary group or not.

#### Dict list tab

Columns of the dictionary list as self-explaining. Dictionary name ‒ name of the dictionary for a normal dictionary and the name of plugin for plugins. Word count ‒ number of word in a normal dictionary. For plugins this column always contains 0. Type ‒ type of the dictionary Local for normal dictionaries, Virtual for Virtual plugins, Network for Network plugins.

You may reorder dictionaries in the list with buttons on the right or using drag and drop technology. Note that you can select only one dictionary at a time. This list specifies the default order of dictionaries for Add dictionary dialog. That dialog is used to add new dictionaries to groups, see . The order of dictionaries is saved between application restarts. Note, however, that virtual and network plugins are always appear at the end of the list. Their order is not saved, StarDict saves only the order of normal dictionaries.

To get detailed information about a dictionary, double-click on a list item. Dictionary information dialog appears. Here you may see dictionary name, word count, author, email and other fields.

### Manage dict tab

This tab allows you organize all dictionaries listed on in groups. By default StarDict has one group including all dictionaries. You may create new groups to organize your dictionaries better. Switching dictionary group allows you to quickly change a set of dictionaries where StarDict searches words. See , Left bar for information about how to switch dictionary group. For example, you may organize your dictionaries by a language pairs: English to Chinese, Chinese to German, German to Russian, etc.

#### Manage dict tab

Each group consists of two subgroups: Query Dict and Scan Dict. The first subgroups is used for queries in the Main window, while the second is used in Scan mode. Subgroups contain lists of dictionaries. The order of dictionaries this dialog correspond to the order of results in Main window or Floating window, depending on subgroup. Note, however, that results from Network plugins are always added at the bottom. That is because response from a Network plugin is normally asynchronous and comes with unpredictable delay.

Dictionary list is organized in a tree, you may collapse groups and subgroups to save space. You may reorder dictionary groups and dictionaries inside a subgroup using buttons at the right or using drag and drop technology. Note, that can select only one item at a time. You cannot move dictionaries between groups and subgroups.

To get detailed information about a dictionary, double-click on a row, or select a row and click the button with a bulb, or click Show information in context menu.

To remove a dictionary from a subgroup, or to remove a group, select that list item, then click on the button with a trash can. Note that removing a dictionary does not affect the corresponding file on the hard disk. Clicking the remove button on a subgroup, removes all dictionaries from that subgroup.

Each dictionary in the list can be independently enabled/disabled. Disabling a dictionary has the same effect as removing it from the list, it will not be used to search words when the corresponding dictionary group is selected. Disabled dictionary retains its position in the list, you can easily enable it later. In the context menu you may find Select all, Unselect all items. They select (unselect) all dictionaries in a subgroup.

To add new dictionaries into subgroup, you need to select a subgroup or a dictionary inside it, and click the button with a plus sign. Add dictionary dialog appears. Here you see a list of all dictionaries that are not yet added to the selected subgroup. The order of dictionaries is the same as on . You may select any number of items in this list. Some columns are clickable. Clicking on a column title sort the list by that column. Sorting by Path column is especially useful if your dictionaries are organized in directories corresponding to dictionary groups. After sorting all dictionaries from the same directory will be located in adjacent rows.

#### Add dictionary dialog

To rename a group, select it, then click on the selected row again. Now you may edit the group name in place.

### Tree dictionaries tab

On this tab you may see a list of all tree dictionaries. Tree dictionaries are not used when you type a word into the Main window or use the Scan feature. Tree dictionaries are shown on a tab of its own in the Main window, see , Tree button on the Left bar.

#### Tree dictionary tab

You may reorder dictionaries with the buttons on the right or using drag and drop technology.

To get detailed information about a dictionaries, double-click on it or select Show information from the context menu.

You may disable any dictionaries using a checkbox in the first column. In the context menu you may find Select all, Unselect all items that selects/unselect all dictionaries in the list.

### Network dictionaries tab

Network dictionaries tab contains a list of network dictionaries. As the name implies, network dictionaries are not installed on your machine, they reside on a server in Internet. StarDict uses a custom protocol to query remote dictionaries and get results. Before you can add dictionaries into this list, you need to register on the server, see .

#### Network dictionaries tab

You may reorder the dictionaries using the buttons on the right of the dialog or using drag and drop technology.

To get detailed information about a dictionary, double-click on it.

It's perfectly normal that StarDict does not react immediately to your activity. Many action in this dialog require access to the remote server. The response comes with unpredictable delay.

To add new dictionaries, click on the Add button. Browse dictionaries dialog appears.

In Browse dictionaries dialog, expand dictionary groups to see dictionaries. To get information about a dictionary, select a dictionary, then click the Information button. To add a dictionary, select a dictionary on the list, then click the Add button.

#### Browse dictionaries dialog

To remove dictionaries from your list, click on the Remove button.

## Manage Plugins

Mange plug-in dialog allows you to view, configure, enable/disable StarDict plug-ins. Plug-ins extends StarDict functionality, they may be independently turned on and off. Some plug-ins provides a number of options that may be configured via a GUI dialog. Some settings take effect immediately, other may require restarting StarDict. List of available plug-in depends on StarDict edition. If you build StarDict from source, you may permanently disable some plug-ins, they will not be available in the Mange Plugins dialog.

Selecting a plug-in in the list activates two functions. You may see plug-in details, clicking on Plug-in Details link at the bottom of the dialog. Here you may see short plug-in description, author, web site and file name. Configure Plug-in button is made available for plug-ins that have configurable options.

### Plugin categories

Virtual Dictionary

  A plug-in of this category acts like as a normal dictionary, it returns some information per key phrase, but it does not use a StarDict dictionary. Plug-in may take information from different sources: a database file, OS service, it may generate response on the fly. For example, Man plug-in displays system man pages.

Network Dictionary

  A plug-in of this category uses a network service or network dictionary as a source of information. Once you type a key phrase into the Search field of the Main window, the plug-in sends a network request to a service. Once response is received, result are displayed in StarDict. You need a working Internet connection for this type of plug-in.

Special Dictionary

  There currently only one dictionary assigned to this category ‒ WordNet dict rendering. It displays results in special interactive widget while other dictionaries produce static content.

TTS Engine

  Text to Speech engines. TTS Engines allows you to "Read" text. Plug-ins of this category do not add any content to the results window. To activate this type of plug-in, you need to click a button or a menu item, then you should hear sound.

Data Parsing Engine

  Plug-ins of the category convert contents of a dictionary into a format understandable by StarDict. Articles of StarDict dictionary may use a number of textual formats, like HTML, XDXF, WordNet, Wiki. In order for StarDict to be able to render the article, data must be converted to Pango text, that is the format StarDict now work with. If you do not have the required plug-in to render the dictionary article, instead of article you'll see a message like this, "XDXF data parsing plug-in is not found!".

Misc

  This is a category for plug-ins that do not fit into other categories.

### XDXF data parsing plug-in

This is a plug-in of Data Parsing Engine category that parses XDXF data format. This plug-in allows you to configure colors used to render an article.

#### XDXF plug-in options, colors

Abbreviation

  Abbreviations like n. (noun), v. (verb), adj. (adjective), etc.

Example

  Example that demonstrates use of the key phrase.

Extra key phrase

  The first key phrase is rendered uniformly for all articles, irrespective of the data format of the article, information source and other factors. Some articles may contain extra key phrases, you may assign special color to render them.

Emphasize

  An article may contain emphasized text. Normally the article specify the color to use for such text, but in case it is not specified, this color will be used.

Reference

  A web link or a link to other word in the dictionary.

## Details

### Command line options

StarDict usage:

`stardict options query_word`

query_word

  With query_word you request StarDict to look up the specified word just after startup. It has the same effect as if you had typed that word in the Search field. You may use pattens, fuzzy query and other supported modes.

-m, --message-level=integer

  This option specifies the minimum severity level of message that should be printed on console. The value may range from 0 to 6, where 0 means to suppress all output, 6 ‒ print all produced messages, including debug ones. Default value is 4 which passes informational messages, like what dictionaries are loaded during startup.

-l, --log-level=integer

  This option specifies the minimum severity level of message that should be logged. The value may range from 0 to 6, where 0 means to suppress all output, 6 ‒ print all produced messages, including debug ones. Default value is 0, that is log file is not used. See for details about StarDict log.

-h, --hide

  Do not show splash screen during startup and hide the Main window. Only notification area icon will be visible.

-n, --new

  Start a new instance of StarDict. By default StarDict checks if the application is already running and prevents starting the second instance.

  This option is only available in Windows edition and Gnome edition of StarDict.

-q, --quit

  Quit an existing instance of StarDict.

  This option is only available in Gnome edition of StarDict.

--dirs-config

  Specifies path to the StarDict directory configuration file. See for details about StarDict directories and configuration file.

  This option is only available in Windows edition of StarDict.

--portable-mode

  Activate portable mode, see . Specifying the option is not enough to make StarDict to be StarDict Portable. You should avoid using this option unless you know what you are doing.

  This option is only available in Windows edition of StarDict.

### 辭典管理

To manage the dictionaries, click the Manage dictionaries button at the bottom-right corner of the Main window, or click the Main menu button and choose Dict manage.

在辭典管理對話框中，你可以關掉不需要的辭典，你也可以設定辭典查詢的順序。

星際譯王將在 "/usr/share/stardict/dic" 和 "~/.stardict/dic" 目錄查找辭典檔案，在 "/usr/share/stardict/treedict" 和 "~/.stardict/treedict" 目錄查找樹型辭典檔案。

### Help

Inside StarDict you may open documentation either by pressing the F1 key or by clicking the Main menu button, then the Help item in the popup menu. StarDict documentation has different formats depending on application edition. The primary documentation format is DocBook. StarDict installs documentation in DocBook format only in Gnome edition. In this edition documentation seamlessly integrates with Gnome documentation system. It can be read through Help Browser. Documentation was translated into a number of languages. You are presented with localized version if it's available. Gnome allows to configure the prefered language.

In other editions of StarDict documentation is available in html format. You need to configure Web browser to view documentation, see . Choosing documentation language, StarDict roughly follows gettext package locale selection algorithm. The LANGUAGE enviroment variable is checked first. It's expected to contain a list of language codes in the order of preference. If the LANGUAGE variable is not set, the current locale is inspected. Finally, if documentation in prefered languages is not available, the english documentation is shown.

In Windows edition of StarDict the default language corresponds to the language selected in the Regional and Language Options dialog.

#### Changing default language

Open Control Panel, Regional and Language Options. Regional and Language Options dialog pops up. On the Regional Options tab select a language in the Stardards and formats group.

You may override the default language with the LANGUAGE environment variable.

Normally, help files can be found in the `C:\Program Files\StarDict\help` directory. Each directory corresponds to one language. Directories are named after language codes.

### StarDict directories

StarDict uses a number of directories to store application data, load and save configuration settings. Default directories are assigned at build time, but some of them can be overriden with `stardict-dirs.cfg` file. Overriding StarDict directories is useful for debugging, preparing special configurations like StarDict-portable for Windows, an ordinary user does not need this.

StarDict searches for the `stardict-dirs.cfg` file in the `user_config_dir` directory. You may override location of the `stardict-dirs.cfg` file with `STARDICT_DIRS_CONFIG_FILE` environment variable or with `--dirs-config` command line option. Command line option takes the highest precedence, then the environment variable is inspected, and finally the file in the `user_config_dir` directory. The first specified file wins, it will be probed as a configuration file. If load fails, no other files will be tried.

The `stardict-dirs.cfg` file is a .ini-like config file. The syntax of .ini files is described in detail in the Desktop Entry Specification. All keys must belong to general group.

Do not forget to double backslash characters in values. Backslash is used as path separator in Windows.

Example of `stardict-dirs.cfg` file for Windows:

    [general]
    data_dir=C:\\Program Files\\StarDict
    dll_dir=C:\\StarDict\\msvc_2008\\Debug
    plugin_dir=C:\\StarDict\\msvc_2008\\Debug

#### StarDict directories

user_config_dir

  A directory of configuration files.

  Windows default: `C:\Documents and Settings\%USERNAME%\Application Data\StarDict`.

  Other default: `~/.stardict`.

  Environment variable: `STARDICT_CONFIG_PATH`.

  `stardict-dirs.cfg` key: user_config_dir.

user_cache_dir

  User cache directory.

  Windows default: `C:\Documents and Settings\%USERNAME%\Temporary Internet Files\stardict`.

  Other default: `~/.cache/stardict`.

  `stardict-dirs.cfg` key: user_cache_dir.

data_dir

  Data directory.

  Windows default: `C:\Program Files\StarDict`.

  Other default: `/usr/share/stardict`.

  `stardict-dirs.cfg` key: data_dir.

dll_dir

  A directory of hook dlls, in Windows edition only.

  Windows default: `data_dir`.

  `stardict-dirs.cfg` key: dll_dir.

plugin_dir

  A directory of StarDict plugins.

  Windows default: `data_dir` + `"/plugins"`.

  Other default: `/usr/lib/stardict/plugins`.

  `stardict-dirs.cfg` key: plugins_dir.

help_dir

  A directory of help files, in all editions except Gnome edition.

  Default: `data_dir` + `"/help"`.

  `stardict-dirs.cfg` key: help_dir.

log_dir

  A directory for log files.

  Windows default: `C:\Documents and Settings\%USERNAME%\Local Settings\Temp\StarDict`.

  Other default: `/var/tmp/stardict`.

  `stardict-dirs.cfg` key: log_dir.

Default values in the list above are given for the purpose of illustrating possible values of variables. Actual default value depends on a number of factors and cannot be computed easily. See AppDirs class in the `conf.h` file for details on how the default value is calculated.

### Logging

StarDict may log messages into a file. By default logging is turned off, you may enable it specifing non-zero log level with `--log-level` command line option, see .

By default messages are printed on to console, log file may be useful if console is not available like in Windows. Log may be useful in troubleshooting startup problems.

For default location of the log directory see , log_dir parameter. StarDict log files are named like `stardict-process_number.log`. We need to use process numbers to create unique log files, since multiple StarDict instances may run at the same time. To find the log file belonging to the most recently started instance of StarDict, consider file creation time.

### Interface language

This section describes the algorithm used to select interface language in StarDict.

1. Retrieve `STARDICTLANG` environment variable. Goto if the variable is defined.

2. Retrieve the user default locale (to set the default locale: Control Panel Regional and Language Options Regional Options Standards and formats Language ). If locale is not defined, use "en".

3. Assign the language code to the `LANG` environment variable.

4. Retrieve the value of the environment variable `LANGUAGE`. This is a GNU extension. Its value can be a colon-separated list of locale names. If defined, goto .

5. The value of the environment variable `LC_ALL`, `LC_xxx`, or `LANG`. More precisely, the first among these that is set to a non-empty value. This is how POSIX specifies it. The value is a single locale name. If defined, goto .

6. A system-dependent preference list of languages. Its value can be a colon-separated list of locale names. If defined, goto .

7. A system-dependent default locale name. If defined, goto .

8. Processes the found value as a colon-separated list of language codes. Select the first available language. If none is available, select no translation.

Steps through describe translation selection algorithm of the gettext package. The actual procedure may be different.

The best way to specify interface language of StarDict is to define `STARDICTLANG` environment variable. It should contain language code. See `$StarDictDataDir/locale` for the list of supported languages.

### StarDict dictionaries

StarDict supports two types of dictionaries: index (normal) dictionaries and tree dictionaries. The vast majority of dictionaries for StarDict you may find on Internet are of the index type. In fact, you hardly find a tree dictionary for StarDict. An index dictionary contain a list of words in one file and corresponding definitions in other file. That index of words is the reason we call it an index dictionary. An index dictionary may contain other data as well. In a tree dictionary data are organized in a tree that is why it name. StarDict searches index and tree dictionaries in different directories.

Almost all files constituting a dictionary are binary. It does not make sense to open them in a text editor. A notable exception is `.ifo` file, it contains dictionary description.

#### Index dictionary files and directories

dictname.ifo

  Information about the dictionary. This a text file, you may open it in a text editor. You may found useful information here like dictionary description, author name and e-mail.

dictname.idx or dictname.idx.gz

  Index of words available in the dictionary.

dictname.dict or dictname.dict.dz

  Main content of the dictionary ‒ articles.

dictname.syn

  Index of synonyms. Optional.

dictname.ind.oft

  Cache for the index file. This file is created by StarDict to speedup dictionaries loading. You should not redistribute this file.

dictname.syn.oft

  Cache for the synonyms file. This file is created by StarDict to speedup dictionaries loading. You should not redistribute this file.

dictname.ind.clt

  Collation file for the index file. This file is created by StarDict when you use collations to modify sorting order of words. You should not redistribute this file.

dictname.syn.clt

  Collation file for the synonyms file. This file is created by StarDict when you use collations to modify sorting order of words. You should not redistribute this file.

res.rifo, res.ridx, res.rdic

  Files of resource database. It contains resources like images, sound and video files used in the dictionary. Optional.

res.ridx.oft

  Cache for the resource index file. This file is created by StarDict to speedup resource database loading. You should not redistribute this file.

res

  A directory containing dictionary resources. This is alternative to `res.rifo`, `res.ridx`, `res.rdic` collection of files. Optional.

#### Tree dictionary files

dictname.ifo

  Information about the dictionary. This a text file, you may open it in a text editor. You may found useful information here like dictionary description, author name and e-mail.

dictname.tdx or dictname.tdx.gz

  A word list forming a tree.

dictname.dict or dictname.dict.dz

  Main content of the dictionary ‒ articles.

#### Directories

This section describes directories where StarDict searches dictionaries.

Under Unix, StarDict searches `~/.stardict/dic` and `/usr/share/stardict/dic` directories for index dictionaries and `~/.stardict/treedict` and `/usr/share/stardict/treedict` directories for tree dictionaries. If you build StarDict with non-standard prefix, the application searches a pair of additional directories for dictionaries. It checks ``$(datadir)`/dic` for index dictionaries and ``$(datadir)`/treedict` for tree dictionaries. Here `$(datadir)` is an autoconf directory variable.

Under Windows, StarDict searches `C:\Program Files\StarDict\dic` for index dictionaries and `C:\Program Files\StarDict\treedict` for tree dictionaries, assuming that StarDict was installed into `C:\Program Files\StarDict`. If you've install StarDict into a different directory, replace `C:\Program Files\StarDict` with real installation path.

Under Windows, you may overwrite `$data_dir` variable, see . By default it matches the StarDict installation directory. In this case StarDict will search ``$data_dir`\dic` for index dictionaries and ``$data_dir`\treedict` for tree dictionaries.

All directories are processed recusively.

## StarDict Portable

StarDict Portable is special edition of StarDict for Windows that works with any hardware you like (USB flash drive, portable hard drive, etc). Now you can carry StarDict along with all settings with you. Use them on any Windows computer. All personal data are saved along with application.

StarDict Portable relies on the PortableApps.com Platform. It provides convenient shell to start and configure portable applications. On the screenshot below you may see PortableApps.com menu with StarDict Portable and StarDict Editor portable. You may change interface language of the menu and StarDict Portable. To do that click Options Language and select the desired language.

### PortableApps.com menu

PortableApps.com menu with StarDict Portable.

### Differences from non-portable version

Functionality of StarDict Portable is almost identical to the non-portable version. Only features that ties application to the specific machine are disabled. The list below details the deferences.

#### StarDict Portable features

WordPick Adobe Acrobat plugin

  WordPick Adobe Acrobat plugin is disabled in portable version. Portable application policies forbids to modify the host machine.

Run StarDict when Windows starts

  This option is disabled in portable version. It does not make sense to autostart application residing on removable storage.

### Installing StarDict Portable

This section describes StarDict Portable installation procedure.

1. Download and install PortableApps.com Suite on a USB flash drive or wherever you want.

2. Download StarDict Portable package from StarDict website. The package file ends with `.paf.exe`, for example, `StarDictPortable-stardict.sourceforge.com_3.0.2.paf.exe`.

3. Launch PortableApps.com menu.

4. Click Options Install a New Apps . Select StarDict Portable package you've just downloaded, click OK and proceed with installer.

5. When installation completes, you will have two new items in the menu: StarDict Portable and StarDict Editor portable. You are ready to use StarDict Portable.

### Launching StarDict Portable directly

You may use StarDict Portable without PortableApps.com menu. In the `$PortableAppsRoot\PortableApps\StarDictPortable-stardict.sourceforge.com` directory you may find two executables: `StarDictPortable.exe` and `StarDictEditorPortable.exe`, they start StarDict Portable and StarDict Editor Portable respectively. `$PortableAppsRoot` here is the directory where PortableApps.com suite was installed, normally this is the root of a drive, like `X:\`.

You may pass parameters to StarDict Portable as with normal StarDict, see . This maybe useful to enable logging, for example.

Do not start files in the `$PortableAppsRoot\PortableApps\StarDictPortable-stardict.sourceforge.com\App\StarDict` directory directly! In this case StarDict runs in normal non-portable mode, it will search applications settings and other data file in usually places on the host machine instead of directories near the portable application. First, your settings will not be found, second, new settings will be saved on the host machine.

### Interface language

This section describes the algorithm used to select interface language in StarDict Portable.

1. Inspect PortableApps.com suite interface language ( Options Language ). If the language is not selected, goto . If the language is "en_US", goto . Check if StarDict provides translation to the specified language. Goto if yes, and goto otherwise.

2. Read the `$PortableAppsRoot\PortableApps\StarDictPortable-stardict.sourceforge.com\Data\settings\StarDictPortableSettigns.ini` file. Inspect value of the `STARDICTLANG` option in the `Language` section. If the option is not specified, goto . If the value is "en_US", goto . Check if StarDict provides translation to the specified language. Goto if yes, and goto otherwise.

3. Assign the language code to the `STARDICTLANG` environment variable.

4. Launch StarDict executable, namely `stardict.exe`. For subsequent steps see .

## Troubleshooting

If you experience problems with StarDict, examine StarDict output. By default the application prints the most important messages to standard output and standard error. To see messages, start StarDict from the console. You may increase verbosity of the output using the `--message-level` command line option, see .

To see standard output and standard error on Windows, start StarDict from windows console and pass non-zero parameter to the `--message-level` command line option. Unfortunately, often windows console can not display all unicode characters that are sent to output. If this problem effects you, redirect output to a file or use StarDict logging facility.

### Starting StarDict from windows console

Starting 星際譯王 from windows console with --message-level option specified. Typical 星際譯王 output.

In some cases, StarDict prints nothing to console or console is not available. Then turn on logging function, see for details.

If StarDict fails to start, it's recommended to set the output message level to the highest value so you can see all produced messages. They may help in diagnosing the cause of the problem. StarDict loads a number of plug-ins at startup. A broken plug-in may crash or hang the entire application. Each plug-in prints `Loading PLUG-IN NAME plug-in...` at the very begging of the plug-in initialization process. `PLUG-IN NAME plug-in loaded.` message marks the end of the initialization process. If you do not see the paired message, the plug-in definitely fails to load. Plug-ins normally print error messages, they may help you to identify and fix the problem. On the other hand, you may simply remove the misbehaving plug-in. Just remove the corresponding library. All plug-in are optional, StarDict will work without plug-ins.

Typical StarDict output:

    [debug] Loading StarDict configuration...
    [debug] StarDict configuration loaded.
    [debug] Loading skin...
    [debug] Skin loaded.
    [debug] Loading Man plug-in...
    Man plug-in loaded.
    [debug] Loading WordNet dict rendering plug-in...
    WordNet dict rendering plug-in loaded.
    [debug] Loading Wiki data parsing plug-in...
    Wiki data parsing plug-in loaded.
    [debug] Loading Spelling plug-in...
    Spelling plugin loaded.
    [debug] Loading Gucharmap plug-in...
    Gucharmap plug-in loaded.
    [debug] Loading QQWry plug-in...
    QQWry plug-in loaded.
    [debug] Loading Dict.cn plug-in...
    Dict.cn plug-in loaded.
    [debug] Loading WordNet data parsing plug-in...
    WordNet data parsing plug-in loaded.
    [debug] Loading Festival plug-in...
    Festival plug-in loaded.
    [debug] Loading XDXF data parsing plug-in...
    XDXF data parsing plug-in loaded.
    [debug] Loading HTML data parsing plug-in...
    HTML data parsing plug-in loaded.
    [debug] Loading Espeak plug-in...
    Espeak plug-in loaded.
    [debug] Loading PowerWord data parsing plug-in...
    PowerWord data parsing plug-in loaded.
    bookname: StarDict dictionary, wordcount 9

## 相關專案

沒有其它專案的支持和幫助星際譯王不會出現。下面是幫助了星際譯王的專案的簡短列表。

馬
蘇安

    msa@wri.com.cn

### 星際譯王 1.31

最初寫於1999年的星際譯王1.31版是基於 Motif/LessTif 開發的。星際譯王 2 吸收了星際譯王1.31版的許多好想法，比如"掃描選擇區"。許多 星際譯王 2的重要特色，比如“模糊查詢”就來源於星際譯王1.31版。

王
煒

    Opera.Wang@motorola.com

### 星際譯王 1.33+

星際譯王1.33+版是對1.31的極大改進。她增加了許多辭典，這使我意識到辭典數據對於一個全新的、基於GTK2的辭典專案已經不再是一個障礙。如果沒有星際譯王1.33+版，我也不會開始星際譯王 2 專案。作者還幫助我把辭典的數據轉換到了星際譯王2。

### DICT 專案

很多編撰好的 dictd 辭典已經被轉換加入了星際譯王。來自 DICT 專案的 dictzip 也用在了星際譯王。

要獲得更多關於 DICT 專案的訊息，請訪問 www.dict.org。

### *Quick

wquick的許多辭典都轉換加入到了 星際譯王。

要獲得更多關於*Quick專案的訊息，請訪問 *Quick。

Terrence
Miao

    terence_miao@email.com

### Blowfish 專案

Blowfish 專案提供了牛津現代英漢雙解辭典。

要獲得更多關於 Blowfish 專案的訊息，請訪問 Blowfish 專案網站。

伏
建軍

    fujianjun@163.net

### XDICT

XDICT 的辭典已經被成功匯入星際譯王。

### cdict5

cdict5 的辭典已被成功匯入星際譯王。

Leon
Liang

    Liang.Lu@CERN.CH

#### xcdict-tcltk

xcdict-tcltk 網站

Borg
LU

    dystopia@iname.com

#### cdict5 v1.3

要獲得更多關於 cdict5 專案的訊息，請訪問 cdict5 專案網站。

Paul
Denisowski

    cedict@chinesetools.com

### CEDICT

CEDICT 的辭典已經被匯入了星際譯王。

要獲得更多關於 CEDICT 專案的訊息，請訪問 CEDICT 專案網站。

孔
暉

    konghui@xinhuanet.com

### CFFD

星際譯王的圖示是從這個軟體得來的。CFFD 同樣也為我提供了一些有用的訊息。

要獲得更多關於 CFFD 專案的訊息，請訪問 CFFD 專案網站。

胡
正

    huzheng001@gmail.com

## 開發者

To find more information about StarDict, please visit the StarDict Web site.

Send all comments, suggestions, and bug reports to Hu Zheng (huzheng001@gmail.com).

Македонскиот превод е направен од Новица Наков (acivon@mail.com.mk). Сите коментари и предлози околу овој превод праќајте ги на горната адреса.

Nederlandse vertaling is gedaan door Ruud Slaats (ruudslaats@eurotechgroup.nl). Stuur al u commentaar, suggesties betreffende deze vertaling naar ruudslaats@eurotechgroup.nl.

На русский язык переведено Александром Мурыгиным (murygin@aitoc.com). Пожалуйста присылайте все комментарии и предложения относящиеся к этому переводу на этот адрес.

На українську мову перекладено Сергієм Дубиком (dubyk@library.lviv.ua). Будь ласка присилайте всі коментарі та пропозиції, що відносяться до цього перекладу, на цю адресу.

中文翻译由耿军军完成 (geng82@163.com)。请将有关本翻译的评论和建议发到我的邮箱。

繁體中文翻譯由陳曉陽完成 (roy.chan@debian.org.hk)。請將有關本翻譯的評論和建議電郵給我。