update index.html file with latest help.html file
[querymee] / www / index.html
1 <HTML>
2 <HEAD>
3     <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
4     <TITLE>Querymee Help</TITLE>
5 </HEAD>
6 <BODY>
7  <H1>Querymee</H1>
8  <P>Vocabulary trainer for mobile devices, written in QT which
9  supports <A HREF="#KVTML">kvtml</A> files from the KDE (kdeedu) project, so many ready
10  made training files are available. Querymee allows you to train
11  languages and to memorize things.</P>
12
13  <P>Additionally the following file formats are supported (read only):
14     <ul>
15          <li><A HREF="#VOC">.voc</A> files from <A HREF="http://www.vokabeln.de/v1/download.htm">http://www.vokabeln.de/</A></li>
16          <li><A HREF="#TSV">.tsv</A> files (Tab Separated Values) created with openoffice.org calc, excel or any text editor</li>
17     </ul>
18  </P>
19  
20  <P>At the moment just multiple choice is supported, but so called
21  flash card learning is planned (we are looking for developers
22  to help with that).</P>
23
24  <P><H2><A name="KVTML">.kvtml files</A></H2></P>
25
26  <P>As main file format KDEs kvtml format is used (a XML format), so you can easily
27  edit and create your own files with <A HREF="http://edu.kde.org/parley/">Parley</A>
28  or <A HREF="http://edu.kde.org/kwordquiz/">KwordQuiz</A>. Parley
29  and KwordQuiz run also under windows (might be that not all
30  features are fully supported, but to create a kvtml file it is
31  sufficent), please see the
32  <A HREF="http://windows.kde.org/">The KDE on Windows Project</A>.</P>
33
34  <P>The program <A HREF="http://peterandlinda.com/wordquiz/">WordQuiz</A>
35  from Peter B. Hedlund also creates kvtml files. It works under
36  Windows and Mac OS X. It might be easier to
37  <A HREF="http://peterandlinda.com/wordquiz/download/">install</A>
38  than the KDE programs under Windows. It can be used to create your own
39  kvtml files.</P>
40
41  <P>Store your own kvtml files under MyDocs/Querymee in your N900 so
42  Querymee finds it and offers it in the pull-down menu. You can
43  store the file anywhere, then use the “open dictionary“ dialogue
44  from the menu to open it.
45
46  <P>Please make the files public available,
47  <A HREF="http://edu.kde.org/parley/">Parley</A>
48  has build in support to upload files. To upload files on kde-files.org you need
49  an account, you can register at:
50  <A HREF="http://kde-files.org/usermanager/new.php">http://kde-files.org/usermanager/new.php</A>.
51  You can upload files also via the web interface without Parley at:
52  <A HREF="http://kde-files.org/content/add.php">http://kde-files.org/content/add.php</A>.
53  It takes some time until the file shows up in the catalogue...</P>
54
55  <P>You can also use ready made kvtml files from the KDE project,
56  use the “Download KVTML files” dialogue from the menu. The first
57  time you open it the list will be empty, just click the button
58  “update list” and Querymee will download the freshest list from
59  the internet. Unfortunately some kvtml files are uploaded in
60  compressed form, Querymee is not yet able to handle these files.</P>
61
62  <P>You can also browse the lists here:<BR>
63  <A HREF="http://edu.kde.org/contrib/kvtml2/kvtml2.php">
64  http://edu.kde.org/contrib/kvtml2/kvtml2.php</A><BR>
65  <A HREF="http://edu.kde.org/contrib/kvtml.php">
66  http://edu.kde.org/contrib/kvtml.php</A><BR>
67  <A HREF="http://kde-files.org/">http://kde-files.org</A><BR>
68  <A HREF="http://opendesktop.org/?xcontentmode=687x694x693">
69  http://opendesktop.org/?xcontentmode=687x694x693</A></P>
70
71  <P><H2><A name="VOC">.voc files</A></H2></P>
72
73  <P>Querymee (starting from version 0.1.2) is able to open vocabulary files from
74  <A HREF="http://www.vokabeln.de/v1/funktionen.htm">Langenscheidt
75  Vokabeltrainer Version 1</A>. More than 150 ready made files are
76  listed on the <A HREF="http://www.vokabeln.de/v1/download.htm">download page.</A>
77  The files are zipped, so extract the .voc files first and store them under
78  MyDocs/Querymee in your N900 so Querymee finds it and offers it in the pull-down menu.
79  You can store the file anywhere, then use the “open dictionary“ dialogue
80  from the menu to open it.</P>
81
82  <P><H2><A name="TSV">.tsv files</A></H2></P>
83
84  <P>Querymee (starting from version 0.1.2) is able to open "Tab Separated Values"
85  vocabulary files. An example .tsv file can be found in the sources under
86  <A HREF="http://gitorious.org/querymee/querymee/blobs/master/doc/example.tsv">doc/example.tsv</A>.</P>
87
88  <P>The example, where <font color="red">&lt;TAB&gt;</font> denotes a TAB character (TAB-Key),
89  do not surround the values with any text indicating character like " or ':</P>
90
91  <pre>
92  Expression<font color="red">&lt;TAB&gt;</font>Translation 1<font color="red">&lt;TAB&gt;</font>Translation 2
93  ajaa<font color="red">&lt;TAB&gt;</font>fahren<font color="red">&lt;TAB&gt;</font>to drive
94  aloittaa<font color="red">&lt;TAB&gt;</font>anfangen<font color="red">&lt;TAB&gt;</font>to start
95  </pre>
96
97  <P>You can write such files with any text editor, but it's much easier with a spreadsheet application:
98     <ul>
99          <li><A HREF="http://www.openoffice.org/product/calc.html">OpenOffice.org Calc</A>:
100          <A HREF="http://user.services.openoffice.org/en/forum/viewtopic.php?f=5&t=2720&p=11987">
101          saving calc files as tab delimited</A><br>In short: To save it, you Save As a "Text CSV", and when asked for a Field Delimiter, select {Tab}, instead of ",".</li>
102          <li>Microsoft Office Excel:
103          <A HREF="http://blogs.howtogeek.com/mysticgeek/2008/08/03/convert-an-excel-spreadsheet-to-a-tab-delimited-text-file/">
104          Convert An Excel Spreadsheet To A Tab Delimited Text File</A></li>
105          <li><A HREF="http://www.koffice.org/kspread/">KOffice kspread</A></li>
106          <li><A HREF="http://projects.gnome.org/gnumeric/">Gnumeric</A>:
107          <A HREF="http://projects.gnome.org/gnumeric/doc/sect-file-textExport.shtml">Exporting Text Files</A></li>
108     </ul>
109  Just make sure you save your file with the file ending .tsv before you transfer it to the N900.
110  Store your own tsv files under MyDocs/Querymee in your N900 so
111  Querymee finds it and offers it in the pull-down menu. You can
112  store the file anywhere, then use the “open dictionary“ dialogue
113  from the menu to open it.</P>
114
115  <P><H2>Feedback</H2></P>
116
117  <P>Bugs can be reported here:<BR>
118  <A HREF="https://garage.maemo.org/tracker/?func=browse&amp;group_id=1694&amp;atid=5986">
119  https://garage.maemo.org/tracker/?func=browse&amp;group_id=1694&amp;atid=5986</A></P>
120
121  <P>Feature requests:<BR>
122  <A HREF="https://garage.maemo.org/tracker/?atid=5989&amp;group_id=1694&amp;func=browse">
123  https://garage.maemo.org/tracker/?atid=5989&amp;group_id=1694&amp;func=browse</A></P>
124
125  <P>Support requests:<BR>
126  <A HREF="https://garage.maemo.org/tracker/?atid=5987&amp;group_id=1694&amp;func=browse">
127  https://garage.maemo.org/tracker/?atid=5987&amp;group_id=1694&amp;func=browse</A></P>
128
129  <P><H2>Source code</H2>
130  <A HREF="http://gitorious.org/querymee/querymee">
131  Querymee on Gitorious</A></P>
132 </BODY>
133 </HTML>
134