<?xml version="1.0"?> <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ <!ENTITY app "Dictionary"> <!ENTITY applet "Dictionary Applet"> <!ENTITY appversion "1.10"> <!ENTITY date "July 2015"> <!ENTITY legal SYSTEM "legal.xml"> <!ENTITY manrevision "1.10.0"> ]> <!-- This file describes the Dictionary applet and application. --> <!-- (Do not remove this comment block.) Maintained by the MATE Documentation Project http://wiki.mate-desktop.org/dev-doc:doc-team-guide Template version: 2.0 beta Template last modified 11 April, 2002 --> <!-- =============Document Header ============================= --> <article id="index" lang="en"> <!-- please do not change the id; for translations, change language to --> <!-- appropriate code --> <articleinfo> <title>&app; Manual</title> <abstract role="description"> <para> Dictionary enables you to look up definitions and correct spellings of words. </para> </abstract> <copyright lang="en"> <year>2015</year> <holder>MATE Documentation Project</holder> </copyright> <copyright> <year>2005</year> <holder>Emmanuele Bassi</holder> </copyright> <!-- translators: uncomment this: <copyright> <year>2006</year> <holder>ME-THE-TRANSLATOR (Latin translation)</holder> </copyright> --> <publisher> <publishername>MATE Documentation Project</publishername> </publisher> <publisher> <publishername>GNOME Documentation Project</publishername> </publisher> &legal; <authorgroup> <author role="maintainer" lang="en"> <surname>MATE-Dokumentationsteam</surname> <affiliation> <orgname>Mate desktop</orgname> </affiliation> </author> <author role="maintainer"> <firstname>Emmanuele</firstname> <surname>Bassi</surname> <affiliation> <address><email>ebassi@gmail.com</email></address> </affiliation> </author> <!-- This is appropriate place for other contributors: translators, maintainers, etc. Commented out by default. <othercredit role="translator"> <firstname>Latin</firstname> <surname>Translator 1</surname> <affiliation> <orgname>Latin Translation Team</orgname> <address> <email>translator@gnome.org</email> </address> </affiliation> <contrib>Latin translation</contrib> </othercredit> --> </authorgroup> <revhistory> <revision lang="en"> <revnumber>Dictionary Manual V1.10.0</revnumber> <date>July 2015</date> <revdescription> <para role="author" lang="en">Wolfgang Ulbrich </para> <para role="publisher" lang="en">MATE Documentation Project</para> </revdescription> </revision> <revision> <revnumber>&app; Manual V&manrevision;</revnumber> <date>&date;</date> <revdescription> <para role="author">Emmanuele Bassi</para> <para role="publisher">GNOME Documentation Project</para> </revdescription> </revision> </revhistory> <releaseinfo>This manual describes version &appversion; of &app;.</releaseinfo> <legalnotice> <title>Feedback</title> <para>To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the <ulink url="help:mate-user-guide/feedback" type="help">MATE Feedback Page</ulink>.</para> <!-- Translators may also add here feedback address for translations --> </legalnotice> </articleinfo> <indexterm> <primary>Dictionary</primary> </indexterm> <!-- ============= Document Body ============================= --> <!-- ============= Introduction ============================== --> <sect1 id="mate-dictionary-introduction"> <title>Introduction</title> <para>The <application>&app;</application> application enables you to search words and terms on a dictionary source.</para> </sect1> <!-- ============= Getting Started =========================== --> <sect1 id="mate-dictionary-getting-started"> <title>Getting Started</title> <!-- ============= To Start Dictionary ======================= --> <sect2 id="mate-dictionary-start-application"> <title>To Start &app;</title> <para>You can start <application>&app;</application> in the following ways:</para> <variablelist> <varlistentry> <term><guimenu>Applications</guimenu> menu</term> <listitem> <para>Choose <menuchoice><guisubmenu>Accessories</guisubmenu> <guimenuitem>Dictionary</guimenuitem></menuchoice>. </para> </listitem> </varlistentry> <varlistentry> <term>Command line</term> <listitem> <para>Execute the following command: <command>mate-dictionary</command></para> </listitem> </varlistentry> </variablelist> <para>Once started, the <application>&app;</application> window is displayed:</para> <figure id="mate-dictionary-fig"> <title>&app; Window</title> <screenshot> <mediaobject> <imageobject> <imagedata fileref="figures/mate-dictionary-application.png" format="PNG"/> </imageobject> <textobject><phrase>Shows &app; main window.</phrase></textobject> </mediaobject> </screenshot> </figure> </sect2> </sect1> <!-- ============= Usage ===================================== --> <sect1 id="mate-dictionary-usage"> <title>Usage</title> <sect2 id="mate-dictionary-lookup"> <title>Looking up a word</title> <para>To look up a word, type it into the <guilabel>entry field</guilabel> and press <keycap>Enter</keycap>.</para> <para>If some definition for the word is found, it will appear inside the main window area:</para> <figure id="mate-dictionary-lookup-fig"> <title>&app; Window</title> <screenshot> <mediaobject> <imageobject> <imagedata fileref="figures/mate-dictionary-lookup.png" format="PNG"/> </imageobject> <textobject><phrase>Shows a definition inside the &app; main window.</phrase></textobject> </mediaobject> </screenshot> </figure> <para>Otherwise, an error dialog will appear, with a message explaining the nature of the error.</para> </sect2> <sect2 id="mate-dictionary-save"> <title>Save look up results</title> <para>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> </sect2> <sect2 id="mate-dictionary-print"> <title>Print look up results</title> <para>To print the results of a look up, choose <menuchoice><guimenu>File</guimenu><guimenuitem>Print</guimenuitem></menuchoice>.</para> <para>Inside the <guilabel>Print</guilabel> dialog you can select the printer to use, the paper format, the number of copies.</para> <para>To see a preview of what will be printed, click <guibutton>Preview</guibutton>.</para> <para>To print, click <guibutton>Print</guibutton>.</para> </sect2> <sect2 id="mate-dictionary-find"> <title>Find Text</title> <figure id="mate-dictionary-find-fig"> <title>&app; Window</title> <screenshot> <mediaobject> <imageobject> <imagedata fileref="figures/mate-dictionary-find.png" format="PNG"/> </imageobject> <textobject><phrase>Shows the &app; Find pane inside the main window.</phrase></textobject> </mediaobject> </screenshot> </figure> <para>To find text inside the results of a look up, perform the following steps:</para> <orderedlist> <listitem><para>Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Find</guimenuitem> </menuchoice> to display the <guilabel>Find</guilabel> pane.</para></listitem> <listitem><para>Type the text you want to find inside the <guilabel>Search</guilabel> entry.</para></listitem> <listitem><para>To find the next occurrence of the text, click <guibutton>Next</guibutton>. To find the previous occurrence of the text, click <guibutton>Previous</guibutton>.</para></listitem> </orderedlist> </sect2> </sect1> <!-- ============= Preferences =============================== --> <sect1 id="mate-dictionary-preferences"> <title>Preferences</title> <para>To change the <application>&app;</application> application preferences, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>.</para> <!-- ============= Source Tab ================================ --> <sect2 id="mate-dictionary-source-tab"> <title>Dictionary Sources</title> <figure id="mate-dictionary-sources-fig"> <title>&app; Window</title> <screenshot> <mediaobject> <imageobject> <imagedata fileref="figures/mate-dictionary-preferences-source.png" format="PNG"/> </imageobject> <textobject><phrase>Shows the Source tab of the Preferences dialog.</phrase></textobject> </mediaobject> </screenshot> </figure> <para>To change the dictionary source used to look up words, select the desired source from the list.</para> </sect2> <!-- ============= Add Source ================================ --> <sect2 id="mate-dictionary-add-source"> <title>Adding a new source</title> <figure id="mate-dictionary-add-source-fig"> <title>&app; Window</title> <screenshot> <mediaobject> <imageobject> <imagedata fileref="figures/mate-dictionary-add-source.png" format="PNG"/> </imageobject> <textobject><phrase>Shows the Add Source dialog.</phrase></textobject> </mediaobject> </screenshot> </figure> <para>To add a new dictionary source, perform the following steps:</para> <orderedlist> <listitem><para>Click on the <guibutton>Add</guibutton> button</para></listitem> <listitem><para>Edit the name of the new source inside the <guilabel>Description</guilabel> entry</para></listitem> <listitem><para>Change the transport type of the new source using the <guilabel>Transport</guilabel> combo box</para></listitem> <listitem><para>Edit the attributes of the new source</para></listitem> <listitem><para>Click <guibutton>Add</guibutton></para></listitem> </orderedlist> <para>Different source transport types uses different attributes. This is the list of available attributes per transport type:</para> <informaltable frame="all"> <tgroup cols="2" colsep="1" rowsep="1"> <thead> <row valign="top"> <entry><para>Transport</para></entry> <entry><para>Attributes</para></entry> </row> </thead> <tbody> <row valign="top"> <entry><para>Dictionary Server</para></entry> <entry> <para>Hostname: the hostname of the dictionary server</para> <para>Port: the port of the dictionary server</para> </entry> </row> </tbody> </tgroup> </informaltable> </sect2> <!-- ============= Remove Source ============================= --> <sect2 id="mate-dictionary-remove-source"> <title>Removing a source</title> <para>To remove a dictionary source, perform the following steps:</para> <orderedlist> <listitem><para>Select the source you wish to remove</para></listitem> <listitem><para>Click the <guibutton>Remove</guibutton> button</para></listitem> </orderedlist> <warning><para>If you remove a dictionary source it will be permanently deleted from the list of available sources. Also, as some sources might be defined system-wide you may actually not be able to remove them unless you have the right ownership privileges.</para></warning> </sect2> <!-- ============= Print Tab ================================= --> <sect2 id="mate-dictionary-print-tab"> <title>Print Options</title> <figure id="mate-dictionary-print-fig"> <title>&app; Window</title> <screenshot> <mediaobject> <imageobject> <imagedata fileref="figures/mate-dictionary-preferences-print.png" format="PNG"/> </imageobject> <textobject><phrase>Shows the Print tab inside the Preferences dialog.</phrase></textobject> </mediaobject> </screenshot> </figure> <para>If you want to change the font name and size used when printing, perform the following steps:</para> <orderedlist> <listitem><para>Click on the <guilabel>Print Font</guilabel> button</para></listitem> <listitem><para>Select the font and size you wish to use</para></listitem> <listitem><para>Click <guibutton>Ok</guibutton></para></listitem> </orderedlist> </sect2> </sect1> <!-- ============= Dictionary Applet ======================== --> <sect1 id="mate-dictionary-applet"> <title>The &applet;</title> <para>The <application>&app;</application> application comes with a panel applet, the <application>&applet;</application>. You can add the <application>&applet;</application> applet to a panel and look up words in dictionaries.</para> <figure id="mate-dictionary-applet-fig"> <title>&applet; Window</title> <screenshot> <mediaobject> <imageobject> <imagedata fileref="figures/mate-dictionary-applet.png" format="PNG"/> </imageobject> <textobject><phrase>Shows &applet;.</phrase></textobject> </mediaobject> </screenshot> </figure> <!-- ============= Dictionary Applet Start ================== --> <sect2 id="mate-dictionary-applet-start"> <title>To Start &applet;</title> <para>To add <application>&applet;</application> to a panel, right-click on the panel, then choose <guimenuitem>Add to Panel</guimenuitem>. Select &applet; in the <application>Add to the panel</application> dialog, then click <guibutton>OK</guibutton>.</para> </sect2> <!-- ============= Dictionary Applet Start ================== --> <sect2 id="mate-dictionary-applet-usage"> <title>Using the &applet;</title> <para>To look up a word, type it into the <guilabel>entry field</guilabel>, and press <keycap>Enter</keycap> or right-click on the dictionary icon and then choose <guimenuitem>Look up</guimenuitem>. </para> <para>If some definition for the word was found, a window will appear, with the text of the definitions:</para> <figure id="mate-dictionary-applet-window-fig"> <title>&applet; Window</title> <screenshot> <mediaobject> <imageobject> <imagedata fileref="figures/mate-dictionary-applet-window.png" format="PNG"/> </imageobject> <textobject><phrase>Shows &applet; main window.</phrase></textobject> </mediaobject> </screenshot> </figure> <para>Click <guibutton>Save</guibutton> to save the definitions to a text file. Click <guibutton>Print</guibutton> to print the definitions. Click <guibutton>Clear</guibutton> to clear the definitions.</para> <para>You can make the window disappear by left-clicking on the dictionary icon or by pressing <keycap>Esc</keycap>.</para> </sect2> <sect2 id="mate-dictionary-applet-preferences"> <title>Preferences</title> <para>To configure the <application>&applet;</application>, right-click on the dictionary icon, then choose <guimenuitem>Preferences</guimenuitem>.</para> <para>The <guilabel>Preferences</guilabel> dialog is the same used by the <application>&app;</application> application, so refer to <xref linkend="mate-dictionary-preferences"/></para> </sect2> </sect1> </article>