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

95 lines
7.9 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<!-- gdhelp_en.qdoc -->
<title>02 Supported dictionary formats | GoldenDict</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="sidebar">
<div class="toc">
<h3 id="toc">Contents</h3>
<ul>
<li class="level1"><a href="#1-stardict">1. Stardict</a></li>
<li class="level1"><a href="#2-abbyy-lingvo">2. ABBYY Lingvo</a></li>
<li class="level1"><a href="#3-dictd-xdxf">3. DictD, Xdxf</a></li>
<li class="level1"><a href="#4-slob">4. Slob</a></li>
<li class="level1"><a href="#5-gls">5. GLS</a></li>
<li class="level1"><a href="#6-abbyy-lingvo-sound-archives">6. ABBYY Lingvo sound archives</a></li>
<li class="level1"><a href="#7-sound-files-in-separate-folders">7. Sound files in separate folders</a></li>
<li class="level1"><a href="#8-zips-sound-packs">8. Zips sound packs</a></li>
<li class="level1"><a href="#9-individual-dictionary-icons">9. Individual dictionary icons</a></li>
<li class="level1"><a href="#10-general-notes">10. General notes</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">02 Supported dictionary formats</h1>
<!-- $$$formats.html-description -->
<div class="descr" id="details">
<span id="formats"></span><p><b class="redFont"><code translate=\"no\">\chapter</code></b>Local dictionaries</p>
<ul>
<li>Babylon dictionaries (.BGL), complete with images and resources</li>
<li><a href="formats.html#stardict-features" translate="no">StarDict dictionaries</a> (.ifo/.dict./&#x2e;idx/.syn)</li>
<li><a href="formats.html#xdxf-features" translate="no">DictD dictionaries</a> (.index/.dict(.dz))</li>
<li><a href="formats.html#dsl-features" translate="no">ABBYY Lingvo source files</a> (.dsl(.dz)), together with abbreviations.</li>
<li><a href="formats.html#xdxf-features" translate="no">Xdxf dictionaries</a> (.xdxf(.dz))</li>
<li>AardDictionary dictionaries (.aar)</li>
<li>SDictionary dictionaries (.dct)</li>
<li>Zim dictionaries (.zim)</li>
<li>MDict dictionaries (.mdx/.mdd)</li>
<li>Epwing dictionaries</li>
<li><a href="formats.html#slob-features" translate="no">Slob dictionaries</a> (.slob)</li>
<li><a href="formats.html#gls-features" translate="no">Babylon source files</a> (.gls(.dz))</li>
<li><a href="formats.html#lsa-features" translate="no">ABBYY Lingvo sound archives</a> (.lsa/.dat)</li>
<li><a href="formats.html#sounddirs-features" translate="no">Sound files in separate folders</a></li>
<li><a href="formats.html#zips-features" translate="no">Zips sound packs</a> (.zips)</li>
</ul>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>Network resources</p>
<ul>
<li>Wikipedia and other Wiki-resources, which use Wiki engine.</li>
<li>Any sites which allow set target word in address line</li>
<li>DICT servers</li>
<li>Forvo site with pronunciations</li>
</ul>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>Other resources</p>
<ul>
<li>External programs</li>
<li>Text-to-speech engines (under Windows and MacOS)</li>
</ul>
<p><b class="redFont"><code translate=\"no\">\chapter</code></b>Local dictionary features <span id="stardict-features"></span></p>
<h2 id="1-stardict">1. Stardict</h2>
<p>Main file of Stardict dictionary (.dict) can be compressed by Dictzip program to reduce its size.</p>
<p>Additional dictionary resources (images, style sheets, etc.) placed in &quot;res&quot; folder also can be compressed into zip archive. This archive must be named &quot;res.zip&quot; and placed beside other dictionary files or inside &quot;res&quot; folder.</p>
<p>Size of such archive must not exceed 4 GB.</p>
<span id="dsl-features"></span><h2 id="2-abbyy-lingvo">2. ABBYY Lingvo</h2>
<p>Main file of ABBYY Lingvo dictionary (.dsl) can be compressed by Dictzip program to reduce its size.</p>
<p>Additional dictionary resources (images, sound files, etc.) also can be compressed into zip archive. This archive must be named on main dictionary file name (include extension) with adding &quot;.files.zip&quot; and placed beside other dictionary files. If main file of your dictionary, for example, named &quot;My_best_dictionary.dsl&quot; therefore archive with resources must be named &quot;My_best_dictionary.dsl.files.zip&quot;.</p>
<p>Size of such archive must not exceed 4 GB.</p>
<p>GoldenDict supports the &quot;#SOUND_DICTIONARY&quot; directive. Sounds missing in the resources of the dictionary will be searched first in the dictionary specified in this directive.</p>
<span id="xdxf-features"></span><h2 id="3-dictd-xdxf">3. DictD, Xdxf</h2>
<p>Main file of DictD dictionary (.dict) or Xdxf dictionary (.xdxf) can be compressed by Dictzip program to reduce its size.</p>
<span id="slob-features"></span><h2 id="4-slob">4. Slob</h2>
<p>GoldenDict can render formulas in TeX format via <a href="http://www.forkosh.com/mimetex.html" translate="no">Mimetex</a> program. Just place &quot;mimetex.cgi&quot; file beside GoldenDict executable file.</p>
<span id="gls-features"></span><h2 id="5-gls">5. GLS</h2>
<p>Main file of Babylon source dictionary must be in UTF-8 (or UTF-16 with BOM) encoding. It can be compressed by Dictzip program to reduce its size. Golden Dict read from dictionary header &quot;### Glossary title:&quot;, &quot;### Author:&quot;, &quot;### Description:&quot;, &quot;### Source language:&quot; and &quot;### Target language:&quot; fields only. Dictionary header must be concluded with &quot;### Glossary section:&quot; mark.</p>
<span id="lsa-features"></span><h2 id="6-abbyy-lingvo-sound-archives">6. ABBYY Lingvo sound archives</h2>
<p>ABBYY Lingvo sound archives are set of sound files packed into one file of some specific format. These files can be called directly from matches list or from dictionary articles.</p>
<span id="sounddirs-features"></span><h2 id="7-sound-files-in-separate-folders">7. Sound files in separate folders</h2>
<p>The separate folder with sound files can be added into GoldenDict dictionaries list. GoldenDict will handle this folders like ABBYY Lingvo sound archives (inapplicable in <a href="portable.html" translate="no">portable mode</a>).</p>
<span id="zips-features"></span><h2 id="8-zips-sound-packs">8. Zips sound packs</h2>
<p>Zips sound pack is zip archive with extension &quot;.zips&quot; contains set of sound files. To create suck pack it needs to compress sound files into zip archive and change extension of this archive to &quot;.zips&quot;. GoldenDict will handle such sound packs like ABBYY Lingvo sound archives.</p>
<p>Zips file size must not exceed 4 GB.</p>
<h2 id="9-individual-dictionary-icons">9. Individual dictionary icons</h2>
<p>Every local dictionary can have individual icon. BMP, PNG, JPG or ICO files can be used for this icon.</p>
<p>For Babylon, StarDict, DictD, ABBYY Lingvo, AardDictionary, SDictionary, Zim, MDict, Lsa, Zips, Slob, Gls dictionaries such graphics file must be named by main dictionary file name and places beside one. That is if main file of your dictionary, for example, named &quot;My_best_dictionary.dsl&quot; therefore icon file must be named &quot;My_best_dictionary.bmp&quot; (.png, .jpg etc.)&#x2e;</p>
<p>For Xdxf dictionaries icon file must be named &quot;icon16.png&quot; (for 16х16 images) or &quot;icon32.png&quot; (for 32х32 images) and placed into dictionary folder.</p>
<p>For Epwing dictionaries icon file must be named by name of folder with dictionary data beside &quot;catalogs&quot; file (a few folders can be presented, every folder is separate dictionary) and placed beside &quot;catalogs&quot; file.</p>
<p>If individual icon is not presented the default icon for this type of dictionaries will be used.</p>
<span id="common-features"></span><h2 id="10-general-notes">10. General notes</h2>
<p>At every launch GoldenDict scan folders with dictionaries to create dictionaries list. The more files in these folder is the more time for scanning. Therefore it is recommended to compress dictionary resources into zip archives and to use Zips sound packs instead of sound files in separate folders.</p>
</div>
<!-- @@@formats.html -->
</body>
</html>