1<?xml version="1.0" encoding="utf-8"?>
2<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
3<!ENTITY app "Dictionary">
4<!ENTITY applet "Dictionary Applet">
5<!ENTITY appversion "1.10">
6<!ENTITY date "July 2015">
7<!ENTITY legal SYSTEM "legal.xml">
8<!ENTITY manrevision "1.10.0">
9]>
10<!-- This file describes the Dictionary applet and application. -->
11<!--
12      (Do not remove this comment block.)
13  Maintained by the MATE Documentation Project
14  http://wiki.mate-desktop.org/dev-doc:doc-team-guide
15  Template version: 2.0 beta
16  Template last modified 11 April, 2002
17
18-->
19<!-- =============Document Header ============================= -->
20<article id="index" lang="cy">
21<!-- please do not change the id; for translations, change language to -->
22<!-- appropriate code -->
23  <articleinfo>
24    <title lang="en">Dictionary Manual</title>
25
26    <abstract role="description">
27      <para lang="en">
28        Dictionary enables you to look up definitions and correct spellings
29        of words.
30      </para>
31    </abstract>
32
33    <copyright lang="en">
34      <year>2015-2021</year>
35      <holder>MATE Documentation Project</holder>
36    </copyright>
37    <copyright lang="en">
38      <year>2005</year>
39      <holder>Emmanuele Bassi</holder>
40    </copyright>
41
42<!-- translators: uncomment this:
43
44  <copyright>
45   <year>2006</year>
46   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
47  </copyright>
48
49   -->
50
51    <publisher>
52      <publishername lang="en">MATE Documentation Project</publishername>
53    </publisher>
54    <publisher>
55      <publishername lang="en">GNOME Documentation Project</publishername>
56    </publisher>
57
58
59    <authorgroup>
60      <author role="maintainer" lang="en">
61	<surname>MATE Documentation Team</surname>
62	<affiliation>
63	  <orgname>Mate desktop</orgname>
64	</affiliation>
65      </author>
66      <author role="maintainer" lang="en">
67	<firstname>Emmanuele</firstname>
68	<surname>Bassi</surname>
69	<affiliation>
70	  <address><email>ebassi@gmail.com</email></address>
71	</affiliation>
72      </author>
73
74<!-- This is appropriate place for other contributors: translators,
75      maintainers,  etc. Commented out by default.
76       <othercredit role="translator">
77	<firstname>Latin</firstname>
78	<surname>Translator 1</surname>
79	<affiliation>
80	  <orgname>Latin Translation Team</orgname>
81	  <address> <email>translator@gnome.org</email> </address>
82	</affiliation>
83	<contrib>Latin translation</contrib>
84      </othercredit>
85-->
86
87    </authorgroup>
88
89    <revhistory>
90      <revision lang="en">
91	<revnumber>Dictionary Manual V1.10.0</revnumber>
92	<date>July 2015</date>
93	<revdescription>
94	  <para role="author" lang="en">Wolfgang Ulbrich
95	  </para>
96	  <para role="publisher" lang="en">MATE Documentation Project</para>
97	</revdescription>
98      </revision>
99      <revision lang="en">
100	<revnumber>Dictionary Manual V1.10.0</revnumber>
101	<date>July 2015</date>
102	<revdescription>
103	  <para role="author" lang="en">Emmanuele Bassi</para>
104	  <para role="publisher" lang="en">GNOME Documentation Project</para>
105	</revdescription>
106      </revision>
107    </revhistory>
108
109    <releaseinfo lang="en">This manual describes version 1.10 of Dictionary.</releaseinfo>
110    <legalnotice>
111      <title lang="en">Feedback</title>
112      <para lang="en">To report a bug or make a suggestion regarding the Dictionary
113      application or this manual, follow the directions in the
114      <ulink url="help:mate-user-guide/feedback" type="help">MATE Feedback
115      Page</ulink>.</para>
116
117<!-- Translators may also add here feedback address for translations -->
118    </legalnotice>
119  </articleinfo>
120
121  <indexterm lang="en">
122    <primary>Dictionary</primary>
123  </indexterm>
124
125<!-- ============= Document Body ============================= -->
126<!-- ============= Introduction ============================== -->
127  <sect1 id="mate-dictionary-introduction">
128    <title lang="en">Introduction</title>
129
130    <para lang="en">The <application>Dictionary</application> application enables you to
131    search words and terms on a dictionary source.</para>
132
133  </sect1>
134
135<!-- ============= Getting Started =========================== -->
136  <sect1 id="mate-dictionary-getting-started">
137    <title lang="en">Getting Started</title>
138
139<!-- ============= To Start Dictionary ======================= -->
140    <sect2 id="mate-dictionary-start-application">
141      <title lang="en">To Start Dictionary</title>
142
143      <para lang="en">You can start <application>Dictionary</application> in the following
144      ways:</para>
145
146      <variablelist>
147        	<varlistentry>
148        	  <term lang="en"><guimenu>Applications</guimenu> menu</term>
149        	  <listitem>
150        	    <para lang="en">Choose <menuchoice><guisubmenu>Accessories</guisubmenu>
151        	      <guimenuitem>Dictionary</guimenuitem></menuchoice>.
152        	    </para>
153        	  </listitem>
154        	</varlistentry>
155    	<varlistentry>
156    	  <term>Llinell orchymyn</term>
157    	  <listitem>
158    	    <para lang="en">Execute the following command: <command>mate-dictionary</command></para>
159    	  </listitem>
160    	</varlistentry>
161      </variablelist>
162
163      <para lang="en">Once started, the <application>Dictionary</application> window is
164      displayed:</para>
165
166      <figure id="mate-dictionary-fig">
167        <title lang="en">Dictionary Window</title>
168        <screenshot>
169          <mediaobject lang="en">
170            <imageobject>
171              <imagedata fileref="figures/mate-dictionary-application.png" format="PNG"/>
172            </imageobject>
173            <textobject><phrase>Shows Dictionary main window.</phrase></textobject>
174          </mediaobject>
175        </screenshot>
176      </figure>
177
178    </sect2>
179
180  </sect1>
181
182<!-- ============= Usage ===================================== -->
183  <sect1 id="mate-dictionary-usage">
184    <title lang="en">Usage</title>
185
186    <sect2 id="mate-dictionary-lookup">
187      <title lang="en">Looking up a word</title>
188
189      <para lang="en">To look up a word, type it into the <guilabel>entry field</guilabel>
190      and press <keycap>Enter</keycap>.</para>
191
192      <para lang="en">If some definition for the word is found, it will appear inside
193      the main window area:</para>
194
195      <figure id="mate-dictionary-lookup-fig">
196        <title lang="en">Dictionary Window</title>
197        <screenshot>
198          <mediaobject lang="en">
199            <imageobject>
200              <imagedata fileref="figures/mate-dictionary-lookup.png" format="PNG"/>
201            </imageobject>
202            <textobject><phrase>Shows a definition inside the Dictionary main window.</phrase></textobject>
203          </mediaobject>
204        </screenshot>
205      </figure>
206
207      <para lang="en">Otherwise, an error dialog will appear, with a message explaining the
208      nature of the error.</para>
209
210    </sect2>
211
212    <sect2 id="mate-dictionary-save">
213      <title lang="en">Save look up results</title>
214
215      <para lang="en">To save the results of a look up, choose <menuchoice><guimenu>File</guimenu><guimenuitem>Save a Copy</guimenuitem></menuchoice>. Enter a name for the file in the <guilabel>Save a Copy</guilabel> dialog, then click <guibutton>Save</guibutton>.</para>
216
217    </sect2>
218
219    <sect2 id="mate-dictionary-print">
220      <title lang="en">Print look up results</title>
221
222      <para lang="en">To print the results of a look up, choose <menuchoice><guimenu>File</guimenu><guimenuitem>Print</guimenuitem></menuchoice>.</para>
223
224      <para lang="en">Inside the <guilabel>Print</guilabel> dialog you can select the
225      printer to use, the paper format, the number of copies.</para>
226
227      <para lang="en">To see a preview of what will be printed, click
228      <guibutton>Preview</guibutton>.</para>
229
230      <para lang="en">To print, click <guibutton>Print</guibutton>.</para>
231
232    </sect2>
233
234    <sect2 id="mate-dictionary-find">
235      <title lang="en">Find Text</title>
236
237      <figure id="mate-dictionary-find-fig">
238        <title lang="en">Dictionary Window</title>
239        <screenshot>
240          <mediaobject lang="en">
241            <imageobject>
242              <imagedata fileref="figures/mate-dictionary-find.png" format="PNG"/>
243            </imageobject>
244            <textobject><phrase>Shows the Dictionary Find pane inside the main window.</phrase></textobject>
245          </mediaobject>
246        </screenshot>
247      </figure>
248
249
250      <para lang="en">To find text inside the results of a look up, perform the following
251      steps:</para>
252
253      <orderedlist>
254        <listitem><para lang="en">Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Find</guimenuitem> </menuchoice>
255        to display the <guilabel>Find</guilabel> pane.</para></listitem>
256        <listitem><para lang="en">Type the text you want to find inside the <guilabel>Search</guilabel>
257        entry.</para></listitem>
258        <listitem><para lang="en">To find the next occurrence of the text, click <guibutton>Next</guibutton>.
259        To find the previous occurrence of the text, click
260        <guibutton>Previous</guibutton>.</para></listitem>
261      </orderedlist>
262
263    </sect2>
264
265  </sect1>
266
267<!-- ============= Preferences =============================== -->
268  <sect1 id="mate-dictionary-preferences">
269    <title>Hoffterau</title>
270
271    <para lang="en">To change the <application>Dictionary</application> application
272    preferences, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>.</para>
273
274<!-- ============= Source Tab ================================ -->
275    <sect2 id="mate-dictionary-source-tab">
276      <title lang="en">Dictionary Sources</title>
277
278      <figure id="mate-dictionary-sources-fig">
279        <title lang="en">Dictionary Window</title>
280        <screenshot>
281          <mediaobject lang="en">
282            <imageobject>
283              <imagedata fileref="figures/mate-dictionary-preferences-source.png" format="PNG"/>
284            </imageobject>
285            <textobject><phrase>Shows the Source tab of the Preferences dialog.</phrase></textobject>
286          </mediaobject>
287        </screenshot>
288      </figure>
289
290      <para lang="en">To change the dictionary source used to look up words, select
291      the desired source from the list.</para>
292    </sect2>
293
294<!-- ============= Add Source ================================ -->
295    <sect2 id="mate-dictionary-add-source">
296      <title lang="en">Adding a new source</title>
297
298      <figure id="mate-dictionary-add-source-fig">
299        <title lang="en">Dictionary Window</title>
300        <screenshot>
301          <mediaobject lang="en">
302            <imageobject>
303              <imagedata fileref="figures/mate-dictionary-add-source.png" format="PNG"/>
304            </imageobject>
305            <textobject><phrase>Shows the Add Source dialog.</phrase></textobject>
306          </mediaobject>
307        </screenshot>
308      </figure>
309
310      <para lang="en">To add a new dictionary source, perform the following steps:</para>
311
312      <orderedlist>
313        <listitem><para lang="en">Click on the <guibutton>Add</guibutton> button</para></listitem>
314	<listitem><para lang="en">Edit the name of the new source inside the <guilabel>Description</guilabel> entry</para></listitem>
315	<listitem><para lang="en">Change the transport type of the new source using the <guilabel>Transport</guilabel> combo box</para></listitem>
316	<listitem><para lang="en">Edit the attributes of the new source</para></listitem>
317	<listitem><para lang="en">Click <guibutton>Add</guibutton></para></listitem>
318      </orderedlist>
319
320      <para lang="en">Different source transport types uses different attributes.  This
321      is the list of available attributes per transport type:</para>
322
323      <informaltable frame="all">
324        <tgroup cols="2" colsep="1" rowsep="1">
325	  <thead>
326	    <row valign="top">
327	      <entry><para>Cludiant</para></entry>
328	      <entry><para lang="en">Attributes</para></entry>
329	    </row>
330	  </thead>
331	  <tbody>
332	    <row valign="top">
333	      <entry><para lang="en">Dictionary Server</para></entry>
334	      <entry>
335	        <para lang="en">Hostname: the hostname of the dictionary server</para>
336		<para lang="en">Port: the port of the dictionary server</para>
337              </entry>
338	    </row>
339	  </tbody>
340	</tgroup>
341      </informaltable>
342
343    </sect2>
344
345<!-- ============= Remove Source ============================= -->
346    <sect2 id="mate-dictionary-remove-source">
347      <title lang="en">Removing a source</title>
348
349      <para lang="en">To remove a dictionary source, perform the following steps:</para>
350
351      <orderedlist>
352        <listitem><para lang="en">Select the source you wish to remove</para></listitem>
353	<listitem><para lang="en">Click the <guibutton>Remove</guibutton> button</para></listitem>
354      </orderedlist>
355
356      <warning><para lang="en">If you remove a dictionary source it will be permanently
357      deleted from the list of available sources.  Also, as some sources might
358      be defined system-wide you may actually not be able to remove
359      them unless you have the right ownership privileges.</para></warning>
360
361    </sect2>
362
363<!-- ============= Print Tab ================================= -->
364    <sect2 id="mate-dictionary-print-tab">
365      <title lang="en">Print Options</title>
366
367      <figure id="mate-dictionary-print-fig">
368        <title lang="en">Dictionary Window</title>
369        <screenshot>
370          <mediaobject lang="en">
371            <imageobject>
372              <imagedata fileref="figures/mate-dictionary-preferences-print.png" format="PNG"/>
373            </imageobject>
374            <textobject><phrase>Shows the Print tab inside the Preferences dialog.</phrase></textobject>
375          </mediaobject>
376        </screenshot>
377      </figure>
378
379      <para lang="en">If you want to change the font name and size used when printing,
380      perform the following steps:</para>
381
382      <orderedlist>
383        <listitem><para lang="en">Click on the <guilabel>Print Font</guilabel> button</para></listitem>
384	<listitem><para lang="en">Select the font and size you wish to use</para></listitem>
385	<listitem><para lang="en">Click <guibutton>Ok</guibutton></para></listitem>
386      </orderedlist>
387
388    </sect2>
389
390  </sect1>
391
392<!-- ============= Dictionary Applet ======================== -->
393  <sect1 id="mate-dictionary-applet">
394  <title lang="en">The Dictionary Applet</title>
395
396  <para lang="en">The <application>Dictionary</application> application comes with a
397  panel applet, the <application>Dictionary Applet</application>.  You can add
398  the <application>Dictionary Applet</application> applet to a panel and look
399  up words in dictionaries.</para>
400
401  <figure id="mate-dictionary-applet-fig">
402    <title lang="en">Dictionary Applet Window</title>
403    <screenshot>
404      <mediaobject lang="en">
405        <imageobject>
406          <imagedata fileref="figures/mate-dictionary-applet.png" format="PNG"/>
407        </imageobject>
408        <textobject><phrase>Shows Dictionary Applet.</phrase></textobject>
409      </mediaobject>
410    </screenshot>
411  </figure>
412
413
414<!-- ============= Dictionary Applet Start ================== -->
415    <sect2 id="mate-dictionary-applet-start">
416      <title lang="en">To Start Dictionary Applet</title>
417
418      <para lang="en">To add <application>Dictionary Applet</application> to a panel, right-click
419      on the panel, then choose <guimenuitem>Add to Panel</guimenuitem>.
420      Select Dictionary Applet in the <application>Add to the panel</application>
421      dialog, then click <guibutton>OK</guibutton>.</para>
422
423    </sect2>
424
425<!-- ============= Dictionary Applet Start ================== -->
426    <sect2 id="mate-dictionary-applet-usage">
427      <title lang="en">Using the Dictionary Applet</title>
428
429      <para lang="en">To look up a word, type it into the <guilabel>entry field</guilabel>,
430      and press <keycap>Enter</keycap> or right-click on the dictionary icon
431      and then choose <guimenuitem>Look up</guimenuitem>.
432      </para>
433
434      <para lang="en">If some definition for the word was found, a window will appear,
435      with the text of the definitions:</para>
436
437      <figure id="mate-dictionary-applet-window-fig">
438        <title lang="en">Dictionary Applet Window</title>
439        <screenshot>
440          <mediaobject lang="en">
441            <imageobject>
442              <imagedata fileref="figures/mate-dictionary-applet-window.png" format="PNG"/>
443            </imageobject>
444            <textobject><phrase>Shows Dictionary Applet main window.</phrase></textobject>
445          </mediaobject>
446        </screenshot>
447      </figure>
448
449      <para lang="en">Click <guibutton>Save</guibutton> to save the definitions to a
450      text file.  Click <guibutton>Print</guibutton> to print the definitions.
451      Click <guibutton>Clear</guibutton> to clear the definitions.</para>
452
453      <para lang="en">You can make the window disappear by left-clicking on the dictionary
454      icon or by pressing <keycap>Esc</keycap>.</para>
455
456    </sect2>
457
458    <sect2 id="mate-dictionary-applet-preferences">
459      <title>Hoffterau</title>
460
461      <para lang="en">To configure the <application>Dictionary Applet</application>, right-click on
462      the dictionary icon, then choose <guimenuitem>Preferences</guimenuitem>.</para>
463
464      <para lang="en">The <guilabel>Preferences</guilabel> dialog is the same used by
465      the <application>Dictionary</application> application, so refer to
466      <xref linkend="mate-dictionary-preferences"/></para>
467
468    </sect2>
469
470  </sect1>
471
472</article>
473