c5e5b2c57a2edae23ff76aebf901775eaf9f1c2e
[mdictionary] / www / howto.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
3 <head>
4         <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
5         <meta http-equiv="content-language" content="EN" />
6         <meta name="description" content="Home page for mDictionary project -
7                     mobile multilingual dictionary for maemo.org platform
8                     (previously known as a 'WhiteStork')" />
9         <meta name="keywords" content="mdictionary whitestork maemo n770
10                     n800 n810 dictionary xdxf stardict mobile linux comarch" />
11         <meta name="language" content="English" />
12         <meta name="owner" content="ComArch S.A." />
13         <meta name="copyright" content="ComArch, 2006-2007. All rights Reserved."/>
14
15         <link rel="shortcut icon" href="images/favicon.png" type="image/x-icon"></link>
16         <link rel="stylesheet" href="styles/main.css" type="text/css"></link>
17         <!--[if IE 6]>
18                 <link rel="stylesheet"
19                       type="text/css"
20                       href="styles/main_ie.css" />
21
22                 <script src="scripts/pngfix.js" type="text/javascript"></script>
23         <![endif]-->
24         <script language="JavaScript" src="scripts/javascripts.js" ></script>
25
26         <title>
27                 mDictionary - multilingual dictionary for Maemo
28         </title>
29 </head>
30 <body>
31 <div id="webContainer">
32         <div id="topBar">
33                 <img src="images/mLogo_ie24.png" style="float:left;"></img>
34         <div class="installs">
35                 INSTALL:
36                 <a href="files/mdictionary.install"
37                    class="install" style="margin-top:4px;"
38                    title="Click to install mDictionary on OS2006"><span>OS2006</span>
39                 </a>
40                 <a href="files/mdictionary.install"
41                    class="install" style="clear:both; margin-top:4px;"
42                    title="Click to install mDictionary on OS2007"><span style="letter-spacing:0px;">OS2007</span>
43                 </a>
44                 <a href="files/mdictionary2008.install"
45                    class="install" style="clear:both; margin-top:4px;"
46                    title="Click to install mDictionary on OS2008"><span style="letter-spacing:0px;">OS2008</span>
47                 </a>
48                 <span style="clear:both;text-align:center;display:block;font-size:9px;"><a href="howto.html" style="font-size:9px;text-decoration:none;">(read How To... first)</a></span>
49         </div>
50                 <div style="display:block;height:100px;">
51                         <p class="title">
52                                 mDictionary
53                         </p>
54                         <p class="description">
55                                 multilingual dictionary for <a href="http://www.maemo.org" target="_blank"><img align="top" border="0" src="images/maemo_logo.png" ></a>(N770, N800 &amp; N810)
56                         </p>
57                 </div>
58                 <div id="topBarLinks">
59                         <a href="index.html">Home</a>
60                         <a href="download.html">Download</a>
61                         <a href="howto.html" class="current">How to...</a>
62                         <a href="screen800.html">Screenshots</a>
63                         <a href="userguide.html">User Guide</a>
64                         <a href="faq.html">FAQ</a>
65                         <a href="devhowto.html">Development</a>
66                         <a href="contact.html">Contact</a>
67                 </div>
68
69         </div>
70         <div id="contentContainer">
71                 <h1>
72                         mDictionary Multilingual Dictionary Installation.
73                 </h1>
74                 <p>
75                         <strong>mDictionary</strong> consists of three modules:
76                         <br /><br />
77                                 mdictionary - core application<br />
78                                 mdictionarygui - the graphical user interface<br />
79                                 mdictionaryplugins - engines<br />
80                         <br />
81                         All of them are placed in one binary package - mDictionary.
82                 </p>
83                 <h1>
84                         Nokia N770 &amp; N800 &amp; N810 installation
85                 </h1>
86                 <h2 style="color:#953;text-align:center;">
87                         mDictionary installation steps for OS2008
88                 </h2>
89                 <p> 
90                 Mdictionary requires libbz2 library to be able to work. To install libbz library repository with libbz package should be added to application catalogue and „Red pill mode” should be activated.
91                 To add the repository with libbz2 package you can click on <a href="files/chinook.install">INSTALL</a> or perform following steps to add repository manually:
92                 <ol style="margin-left: 25px; margin-top: -5px margin-bottom: 5px;">
93                 <li>Go to Main Menu -> Setting -> Applications manager</li>
94                 <li>Go to Tools -> Application catalogue...</li>
95                 <li>Click New and enter:
96                                 <br />Catalogue name: Maemo Chinook
97                                 <br />Web address: http://repository.maemo.org
98                                 <br />Distribution: chinook
99                                 <br />Components: free non-free
100                                 <br />Be sure that this repository was not added before !
101                 </li>
102                 </ol>
103                 
104                 <br />To activate „Red pill mode” follow this steps:
105                 <ol style="margin-left: 25px; margin-top: 10px; margin-bottom: -5px;">
106                 <li>Go to Main Menu -> Setting -> Applications manager</li>
107                 <li>Go to Tools -> Application catalogue...</li>
108                 <li>Click New and enter matrix into Web address (remember to remove http:// entry)</li>
109                 <li>Click on Cancel. Question about pill should be displayed. Click on Red. To deactivate „Red pill mode” repeat above steps but in last step Click on Blue.</li>
110                 </ol>
111                 <br />Now click on Browse installable applications go to Tools->Search and enter libbz2 into Search word field and click OK. Click and install  libbz2-1.0 package.
112                 <br />After successful installation of libz2 package you should be able to install mdctionary without any problems by clicking on <a href="files/mdictionary2008.install">INSTALL</a>.<br />
113                 </p>
114                 
115                 <h2 style="color:#953;text-align:center;">
116                         mDictionary installation steps for OS2007 and OS2006
117                 </h2>
118                 <p>
119                         In order to install our application click <a href="files/mdictionary.install">INSTALL</a> or make the following steps:<br />
120                 <ol style="margin-left: 25px;">
121                 <li>Download the binary package from our download section</li>
122                 <li>Open the file manager and double click on downloaded file.</li>
123                 <li>A window will pop up notifying you that the package hasn't been verified by Nokia. In order to install the dictionary you will have to ignore these warnings.</li>
124                 </ol>
125                 </p>
126
127                 <h1>
128                         Scratchbox installation
129                 </h1>
130                         - Download the binary package from our download section
131                 <br /> - Log into scratchbox and become root by issuing the command: <span class="code">fakeroot su</span>
132                 <br /> - Install mDictionary package mentioned above by using: <span class="code">dpkg -i package_name</span>.<br />
133                 <br />
134
135                 <p>
136                         Our application allows for using various parsing engines, so that different dictionary formats could be used. We have included a XDXF and StarDict format parsing engine to provide an example and to make it usable.
137                 </p>
138
139                 <h1>
140                         Installing new dictionaries
141                 </h1>
142
143                 <p>
144                         Dictionaries in mDictionary are files containing the words database. For now we have only included a package containing a XDXF and StarDict format parser. You are welcome to contribute new parsing engines and we hope you will find our API documentation useful in development process. In order to add new dictionaries you'll have to download files containing the words database and make sure you have the appropriate parsing engine installed. As far as the XDXF and StarDict formats are concerned, they can be found under this address:
145                         <a href="http://xdxf.revdanica.com/down">http://xdxf.revdanica.com/down </a>
146                 </p>
147                 <p>
148                         Place the dictionary file wherever you wish, however it has to be reachable by the application. In order to register new file in our dictionary, choose the Load Dictionary option from the application menu. To make <u>XDXF</u> dictionaries to work faster, you can optimize them (a special dialog will lead you through this procces). <u>StarDict dictionaries do not require optimalization</u> (there is no difference if you enable optimizing or not). If you would like to exclude a dictionary from searching, use the Select Dictionary option from the menu and check/uncheck a box next to your desired file.
149                 </p>
150                 <p>
151                         In order to unregister dictionary from mDictionary, use the Remove Dictionary option. This will not erase the file however, you will have to do it manually if you want to remove it from your device.
152                 </p>
153                 <h1>
154                         Uninstalling the application
155                 </h1>
156
157                 <p>
158                         Uninstalling mDictionary can be performed using the Application Manager. Enter the Show Installed Applications item and uninstall  mdictionary package.
159                 </p>
160         </div>
161         <div id="footer">
162                         <p>Copyright &copy; 2006 - 2008 ComArch S.A.</p>
163                         <br>
164                         <a href="http://www.comarch.com"><img src="images/comarch.png"
165                              alt="ComArch Information Technology"
166                              width="150px"
167                              height="36px"
168                                  border="0"
169                                  >
170                         </a>
171                 </div>
172         </div>
173 </div>
174 <br>
175 </body>
176 </html>