1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
|
<!DOCTYPE html>
<html>
<head>
<title></title>
<meta name="generator" content="Bluefish 2.2.16" >
<meta name="author" content=Alex Fomin"">
<meta name="date" content="2025-01-20T19:27:23+0300" description" content="Quick start guide">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
</head>
<body>
<h1 align="center">'forwords' Help</h1>
<table><h2 align="center">Description</h2>
<tr>
<td><h3>About:</h3></td>
</tr>
<tr>
<td>
This program is a very simple but quite effective tool when you are learning a foreign language.
It helps you to expand your foreign word bank with three simple tests.
The program is written using 'Qt' library and has some speech ability with 'espeak'.
</td>
</tr>
<tr>
<td><h3>How it works:</h3></td>
</tr>
<tr>
<td>
'Forwords' doesn't have any internal set of words, so you have to create your own dictionary
for every lesson you want to pass. When created, it is added to the topic list of a language you are learning.
When you've chosen a language and its topic, you can select one of three tests to pass.
The tests are as follows: 'Direct test', 'Reverse test' and 'Written test'. Every test shows a score and statistics.
</td>
</tr>
<tr>
<td><h3>Direct test:</h3></td>
</tr>
<tr>
<td>
Show the foreign word and five possible translations. You must choose one.
If it is not right choice, you will see a prompt and this word will appear
again later till you make the right choice. For this test, a speech is available.
</td>
</tr>
<tr>
<td><h3>Reverse test:</h3></td>
</tr>
<tr>
<td>
It is very similar to 'Direct test' but shows you a translation instead.
You have to choose a proper foreign word. Speech isn't available.
</td>
</tr>
<tr>
<td><h3>Written test:</h3></td>
</tr>
<tr>
<td>
For a given translation, you have to type down the appropriate foreign word.
If you make a mistake, a prompt will be shown, and you have to repeat this word again later.
</td>
</tr>
<tr>
<td><h3>Where your data is saved:</h3></td>
</tr>
<tr>
<td>
Your added languages are saved as a folder in your <em><strong>Home_directory/ForWords</strong></em>
folder as a default. You can change this directory into a 'settings' dialog if necessary.
Every topic file added to your language is saved inside the language folder as a file <topicName.tof>
</td>
</tr>
<tr>
<td><h3>How to add a language folder:</h3></td>
</tr>
<tr>
<td>
In the main window, click on '+' button in the Language group box.
Type the language name in the appearing dialog box and press OK.
The language folder will be created, and the language name will be added to the Language drop out box.
</td>
</tr>
<tr>
<td><h3>Topic file:</h3></td>
</tr>
<tr>
<td>
It is a simple formatted text file which contains as many strings as your foreign word quantity.
Every string has two parts separated by a < <strong>Tab</strong> > symbol. The first part keeps the foreign word.
The second part keeps translation. <br>
Note: the content of every part of a string can be either a single word or contain a multi-word
expression and can contain any symbols except < <strong>Tab</strong> >. < <strong>Tab</strong> > is reserved as a separator.
</td>
</tr>
<tr>
<td><h3>Create and Edit topic file:</h3></td>
</tr>
<tr>
<td>
There are two ways to create a topic file. First way - create using 'forwords'.
Second way - create using either any file manager or text editor.
File shall have FileName as a topic name and <strong>*.tof</strong> extension. The same approach is true for editing.
By a simple internal editor or by any external text editor. Files shall be placed in a language folder.
</td>
</tr>
<tr>
<td><h3>Internationalisation:</h3></td>
</tr>
<tr>
<td>
Translation files can be found in the folders,
<strong>~/.config/Forwords</strong> or
<strong>/ust/share/forwords/translations</strong>,
as < <strong>language >.lp</strong> files.
In <strong>~/.config/Forwords</strong> folder the < <strong>English</strong> > translation file is located.
You can use it as a template file to create your own translation file.
The translation file has a '<strong>Json</strong>' format.
A created custom translation file can be placed to
either of the forementioned folders.
The translation file can be created by any text editor.
No any special software to do with this file is required.
</td>
</tr>
<tr>
<td><h3>Known issues:</h3></td>
</tr>
<tr>
<td>
With some hardware, the 'espeak' engine doesn't work and causes program
frizzing.<br>
In this case, don't use a speech engine (don't check
the "Speech" checkbox on test dialogs).
</td>
</tr>
<tr>
<td><h3>Copyright:</h3></td>
</tr>
<tr>
<td align="center">
Copytight (C) 2024 Alexander Fomin - <a href="mailto:fomin_alex@yahoo.com">fomin_alex@yahoo.com</a><br><br>
This program is free software: you can redistribute it and/or modify<br>
it under the terms of the GNU General Public License as published by<br>
the Free Software Foundation, either version 3 of the License, or<br>
(at your option) any later version.<br><br>
This program is distributed in the hope that it will be useful,<br>
but WITHOUT ANY WARRANTY; without even the implied warranty of<br>
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br>
GNU General Public License for more details.<br><br>
You should have received a copy of the GNU General Public License<br>
along with this program. If not, see <a href="https://www.gnu.org/licenses">www.gnu.org/licenses</a>.
</td>
</tr>
</table>
<table align="center">
<tr>
<td><h2 align="center">Quick start guide</h2></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td align="center">
On the very first time you start this application, it creates a working folder <strong>~/ForWords</strong>
in your home folder and will shows information offering to add language you want to learn.<br>
<img src="pictures/01.png" width="609" height="284" alt=""></td>
</tr>
<tr>
<td align="center">
With the appeared input dialog, type the language name you want to learn, and press <strong>Ok</strong> button or press <strong>Cancel</strong> to make it later.<br>
<img src="pictures/02.png" width="368" height="229" alt=""></td>
</tr>
<tr>
<td align="center">
For example, we study "arabic".<br>
<img src="pictures/03.png" width="378" height="240" alt=""></td>
</tr>
<tr>
<td align="center">
Then the next info box offers to add the first topic file.<br>
<img src="pictures/04.png" width="623" height="291" alt=""></td>
</tr>
<tr>
<td align="center">
Write in the name you want and press <strong>Ok</strong>, or press <strong>Cancel</strong> to do it later.<br>
For example, we name it "myFirstLesson".<br>
<img src="pictures/05.png" width="303" height="232" alt=""></td>
</tr>
<tr>
<td align="center">
If you have skipped creating a "language" or "topic", you can add them by pressing "+" button next to the "Language" or "Topic" comboBox respectively.<br>
When a topic has been created you can start to edit it by pressing button "Edit".<br>
<img src="pictures/06.png" width="585" height="664" alt=""></td>
</tr>
<tr>
<td align="center">
'forWords' has its own simple editor, but you can use any external text editor as well.<br>
The topic file rules are simple. Every line contains a foreign word or expression and a native translation separated by <Tab> simbol.<br>
The foreign part comes first.<br>
<img src="pictures/07.png" width="633" height="599" alt=""></td>
</tr>
<tr>
<td align="center">
The topic file can contain as many lines as you want,<br>
but not less than five.<br>
Do not forget to save your file, or you will lose all the data entered.<br>
<img src="pictures/08.png" width="645" height="598" alt=""></td>
</tr>
<tr>
<td align="center">
When the topic file is completed, you can start learning your words.<br>
Let's start with the "direct test".<br>
<img src="pictures/09.png" width="557" height="625" alt=""></td>
</tr>
<tr>
<td align="center">
With the "direct test", we can use a speech ability<br>
if it is configured in the settings<br>
<img src="pictures/10.png" width="507" height="585" alt=""></td>
</tr>
<tr>
<td align="center">
'direct test' dialog shows you a foreign word and pronounces it if speech is enabled.<br>
You have to choose the right answer from the five given.<br>
You can repeat the speech by pressing a foreign word button.<br>
<img src="pictures/12.png" width="507" height="599" alt=""></td>
</tr>
<tr>
<td align="center">
After every attempt, the common statistic is calculated.<br>
When the test is completed, press "Exit" button to close dialog.<br>
<img src="pictures/13.png" width="526" height="594" alt=""></td>
</tr>
<tr>
<td align="center">
The 'reverse test' uses the same dialog box,<br>
but show you a native word instead of a foreign.<br>
You have to choose a proper foreign word.<br>
For this test, a speech is not available.<br>
<img src="pictures/14.png" width="479" height="562" alt=""></td>
</tr>
<tr>
<td align="center">
The 'Written test' shows you a native word.<br>
You have to type down a foreign word properly.<br>
<img src="pictures/15.png" width="462" height="517" alt=""></td>
</tr>
<tr>
<td align="center">
Pressing the "Settings" button, you open the setting dialog.<br>
Here you can change your working folder.<br>
<img src="pictures/16.png" width="818" height="600" alt=""></td>
</tr>
<tr>
<td align="center">
You can delete a language folder.<br>
<img src="pictures/17.png" width="903" height="587" alt=""></td>
</tr>
<tr>
<td align="center">
You can delete a topic.<br>
<img src="pictures/18.png" width="675" height="585" alt=""></td>
</tr>
<tr>
<td align="center">
You can choose a speech engine for each language separately.<br>
There are only two speech engines supported at the moment, 'espeak' and 'espeak-ng'.<br>
It is recommended to use the 'espeak-ng' engine as more advanced.<br>
If you don't have any speech engine installed,<br>
speech engine combobox will be empty.<br>
<img src="pictures/19.png" width="604" height="659" alt=""></td>
</tr>
<tr>
<td align="center">
If the speech engine is set, you can choose a voice.<br>
The voice can be set for each language separately.<br>
When you have done with settings, do not forget to save your choice.<br>
<img src="pictures/20.png" width="588" height="818" alt=""></td>
</tr>
<tr>
<td align="center">
From the main menu 'Appearance', you can change the GUI language.<br>
<img src="pictures/21.png" width="566" height="654" alt=""></td>
</tr>
<tr>
<td></td>
</tr>
</table>
</body>
</html>
|
