Skip to content
/ learning-with-texts Public
forked from edoreld/learning-with-texts

Learning with Texts (LWT) is a tool for Language Learning.

0 stars 7 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

OrionRandD/learning-with-texts

BranchesTags
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
anki
anki
 
 
css
css
 
 
icn
icn
 
 
img
img
 
 
iui
iui
 
 
js
js
 
 
php-mobile-detect
php-mobile-detect
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 
UNLICENSE.txt
UNLICENSE.txt
 
 
ajax_add_term_transl.php
ajax_add_term_transl.php
 
 
ajax_chg_term_status.php
ajax_chg_term_status.php
 
 
ajax_edit_impr_text.php
ajax_edit_impr_text.php
 
 
ajax_save_impr_text.php
ajax_save_impr_text.php
 
 
ajax_save_setting.php
ajax_save_setting.php
 
 
ajax_show_sentences.php
ajax_show_sentences.php
 
 
ajax_show_similar_terms.php
ajax_show_similar_terms.php
 
 
ajax_update_media_select.php
ajax_update_media_select.php
 
 
ajax_word_counts.php
ajax_word_counts.php
 
 
all_words_wellknown.php
all_words_wellknown.php
 
 
backup_restore.php
backup_restore.php
 
 
check_text.php
check_text.php
 
 
connect_easyphp.inc.php
connect_easyphp.inc.php
 
 
connect_mamp.inc.php
connect_mamp.inc.php
 
 
connect_wordpress.inc.php
connect_wordpress.inc.php
 
 
connect_xampp.inc.php
connect_xampp.inc.php
 
 
dbutils.inc.php
dbutils.inc.php
 
 
delete_mword.php
delete_mword.php
 
 
delete_word.php
delete_word.php
 
 
display_impr_text.php
display_impr_text.php
 
 
display_impr_text_header.php
display_impr_text_header.php
 
 
display_impr_text_text.php
display_impr_text_text.php
 
 
do_test.php
do_test.php
 
 
do_test_header.php
do_test_header.php
 
 
do_test_table.php
do_test_table.php
 
 
do_test_test.php
do_test_test.php
 
 
do_text.php
do_text.php
 
 
do_text_header.php
do_text_header.php
 
 
do_text_text.php
do_text_text.php
 
 
edit_archivedtexts.php
edit_archivedtexts.php
 
 
edit_languages.php
edit_languages.php
 
 
edit_mword.php
edit_mword.php
 
 
edit_tags.php
edit_tags.php
 
 
edit_texts.php
edit_texts.php
 
 
edit_texttags.php
edit_texttags.php
 
 
edit_tword.php
edit_tword.php
 
 
edit_word.php
edit_word.php
 
 
edit_words.php
edit_words.php
 
 
empty.htm
empty.htm
 
 
favicon.ico
favicon.ico
 
 
glosbe_api.php
glosbe_api.php
 
 
index.php
index.php
 
 
info.htm
info.htm
 
 
info_export_template.htm
info_export_template.htm
 
 
inline_edit.php
inline_edit.php
 
 
insert_word_ignore.php
insert_word_ignore.php
 
 
insert_word_wellknown.php
insert_word_wellknown.php
 
 
install_demo.php
install_demo.php
 
 
install_demo_db.sql.gz
install_demo_db.sql.gz
 
 
langdefs.inc.php
langdefs.inc.php
 
 
long_text_import.php
long_text_import.php
 
 
mobile.php
mobile.php
 
 
new_word.php
new_word.php
 
 
print_impr_text.php
print_impr_text.php
 
 
print_text.php
print_text.php
 
 
save_setting_redirect.php
save_setting_redirect.php
 
 
select_lang_pair.php
select_lang_pair.php
 
 
set_test_status.php
set_test_status.php
 
 
set_text_mode.php
set_text_mode.php
 
 
set_word_status.php
set_word_status.php
 
 
settings.inc.php
settings.inc.php
 
 
settings.php
settings.php
 
 
show_word.php
show_word.php
 
 
simterms.inc.php
simterms.inc.php
 
 
start.php
start.php
 
 
statistics.php
statistics.php
 
 
table_set_management.php
table_set_management.php
 
 
trans.php
trans.php
 
 
upload_words.php
upload_words.php
 
 
utilities.inc.php
utilities.inc.php
 
 
wp_logincheck.inc.php
wp_logincheck.inc.php
 
 
wp_lwt_start.php
wp_lwt_start.php
 
 
wp_lwt_stop.php
wp_lwt_stop.php
 
 

Repository files navigation

Mirror of version 1.6.3 of the Sourceforge-hosted LWT project.

Logo

▶ **Preface**
  • I started this software application in 2010 as a hobby project for my personal learning (reading & listening to foreign texts, saving & reviewing new words and expressions).
  • In June 2011, I decided to publish the software in the hope that it will be useful to other language learners around the world.
  • The software is 100 % free, open source, and in the public domain. You may do with it what you like: use it, improve it, change it, publish an improved version, even use it within a commercial product.
  • English is not my mother tongue - so please forgive me any mistakes.
  • A piece of software will be never completely free of "bugs" - please inform me of any problem you will encounter. Your feedback and ideas are always welcome.
  • My programming style is quite chaotic, and my software is mostly undocumented. This will annoy people with much better programming habits than mine, but please bear in mind that LWT is a one-man hobby project and completely free.
  • Thank you for your attention. I hope you will enjoy this application as I do every day.
▶ **Current Version**
▶ **Important Links**
▶ **Abstract**

  • Learning with Texts (LWT) is a tool for Language Learning, inspired by:

  • You define languages you want to learn and import texts you want to use for learning.

  • While listening to the audio (optional), you read the text, save, review and test "terms" (words or multi word expressions, 2 to 9 words).

  • In new texts all your previously saved words and expressions are displayed according to their current learn statuses, tooltips show translations and romanizations (readings), editing, changing the status, dictionary lookup, etc. is just a click away.

  • Import of terms in TSV/CSV format, export in TSV format, and export to Anki (prepared for cloze tests), are also possible.

  • **MOST IMPORTANT:

    To run LWT, you'll need:**

    (1) A modern web browser.
    I recommend (in this order)

▶ **Features**
  • You define languages you want to learn.
  • You define the web dictionaries you want to use.
  • You define how sentences and words in the language will be split up.
  • You upload texts, and they are automatically split into sentences and words! Later re-parsing is possible.
  • Optional: Assign the URL of an mp3 audio file of the text (Dropbox, local server, ...) in order to listen while reading the text.
  • You read the text while listening to the audio, and you see immediately the status of every word (unknown, learning, learned, well-known, ignored).
  • You click on words, and you use the external dictionaries to find out their meanings.
  • You save words or expressions (2..9 words) with optional romanization (for asiatic languages), translations and example sentence, you change its status, you edit them whenever needed (like in LingQ).
  • You test your understanding of words and expressions within or without sentence context.
  • MCD (Massive-Context Cloze Deletion) testing, as proposed by Khatzumoto @ AJATT, built-in!
  • See your progress on the statistics page.
  • You may export the words and expressions and use them in Anki or other programs.
  • You may upload words and expressions into LWT (from LingQ or other sources, CSV/TSV) - they are immediately available in all texts!
  • New since Version 1.5.0: Create and edit an improved annotated text version (a hyperliteral translation as interlinear text) for online or offline learning. Read more here.
  • The application is 100 % free, open source, and in the Public Domain. Do with it what you like!
  • Prerequisites: a local webserver (Apache, PHP, mySQL), e.g. EasyPHP or XAMPP (Windows), MAMP (macOS), or a LAMP server (Linux).
  • Enjoy your language learning!
▶ **Restrictions**
  • Texts and vocabulary terms with Unicode characters outside the Basic Multilingual Plane (BMP; U+0000 to U+FFFF), i.e. with Unicode characters U+10000 and higher, are not supported. Therefore, characters for almost all modern languages, and a large number of symbols, are supported; but historic scripts, certain symbols and notations, and Emojis are not supported.
▶ **(Un-) License**

  • "Learning with Texts" (LWT) is free and unencumbered software released into the PUBLIC DOMAIN.
    Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
    In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
    Please read also the disclaimer.
    For more information, please refer to http://unlicense.org/.

  • The following software packages, bundled within the LWT software, have different licenses:

  • The icons in the "icn" subdirectory are Copyright © Yusuke Kamiyamane. All rights reserved. Licensed under a Creative Commons Attribution 3.0 license. The wizard icon "wizard.png" is the "Free Wizard Icon", free for commercial use, from icojam.com (Author: IcoJam / Andrew Zhebrakov).

  • The following examples, supplied within the LWT download package, have the following licenses:

    • Chinese: The Man and the Dog - Copyright © Praxis Language LLC, now ChinesePod Ltd., Source, MP3 licensed under a Creative Commons 3.0 Unported license.
    • German: Die Leiden des jungen Werther by Johann Wolfgang von Goethe - in the Public Domain, Source: Text, Audio.
    • French: Mon premier don du sang - Copyright © France Bienvenue, Source. License: "Bien sûr, les enseignants de FLE peuvent utiliser nos enregistrements et nos transcriptions pour leurs cours. Merci de mentionner notre site !".
    • Korean, Japanese, Thai, Hebrew - own creations from different sources.
▶ **Disclaimer**
  • THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
▶ **Installation on MS Windows, macOS, Linux**
▶ **How to learn with LWT**

  • Find an interesting text (preferably with an mp3 audio file) in the Internet and load it into LWT. If you are a beginner, look for beginner courses or podcasts in the Internet.

  • You don't know where to find texts with audio? The LingQ Library has many (only a free registration is needed). Or look into this thread in the LingQ Forum, you will find there lots of great links to resources. Or click (within the LingQ library) on "My Imports" - you will find a list of links of "Suggested resources".

  • Read the text, look up the new words and expressions (=terms) and save them for review and test.

  • The good thing with LWT: Every saved term will show up with its translation, status, etc. in all other occurrences of the same text and every other text! So you'll see immediately what you already know and how well you know it. And of course you'll see what you don't know!

  • Load the MP3 file also on your portable MP3 player and listen to it often.

  • Review (by reading again) or test your saved words and expressions.

  • Listen ▶ Read ▶ Review/Test.
    Listen ▶ Read ▶ Review/Test.
    ......

  • That's it. It's that simple.

  • If you want to know more, watch Steve Kaufmann's videos on YouTube: "The 7 secrets of language learning", "Language learning FAQ", and many more.

▶ **How to use**

  • LWT home screen after installation

    This is home screen of LWT if the database is empty. Please install the demo database or start with the definition of a language you want to learn.

    Image

  • LWT home screen

    This is normal home screen of LWT. You may choose a language here, but you can do this also later. If you you choose a language, the language filter is pre-set to that language in some other screens. The last text you've read or tested is shown, and you may jump directly into reading, testing or printing of this last text.

    Image

  • My Languages

    The list of languages. Here you can add a new or edit an existent language. If no texts and no saved terms in a language exist, you can delete a language. If you change a language, all texts may be be automatically reparsed to refresh (and correct) the cache of sentences and text items (depends on what language settings you have changed). You can do this also manually by clicking on the yellow flash icon. You can also test all (due) terms of a language or set a language as "current" language.

    Image

  • New/Edit Language

    This is the place to define or edit a language you want to study.

    If you are new to the system, use the "Language Settings Wizard" first. You only select your native (L1) and study (L2) languages, and let the wizard set all language settings that are marked in yellow. You can always adjust the settings afterwards.

    Explainations of the input fields - please read also this section:

    • The three Uniform Resource Identifiers (URIs) are URIs to three web dictionaries (the second and third is optional). Use ### as a placeholder for the searchword in the URIs. If ### is missing, the searchword will be appended. If the URI to query "travailler" in WordReference is "http://www.wordreference.com/fren/travailler", you enter: "http://www.wordreference.com/fren/###" or "http://www.wordreference.com/fren/". Another example: The URI to query "travailler" in sansagent is "http://dictionary.sensagent.com/travailler/fr-en/", so you enter in LWT "http://dictionary.sensagent.com/###/fr-en/".

      As URI No. 3 ("Google Translate URI") is also used to translate whole sentences, I would recommend to enter here always the link to Google Translate, like shown in the examples. The link to Google Translate is "http://translate.google.com/?ie=UTF-8&sl=..&tl=..&text=###", where the two-character codes after "sl=" and "tl=" designate the language codes (or "subtags") for the source and the target language. But a different third web dictionary is of course possible, but sentence translations may not work.

      If the searchword in the three URIs needs to be converted into a different encoding (standard is UTF-8), you can use ###encoding### as a placeholder. Normally you see this right away if terms show up wrongly in the web dictionary. Example: Linguee expects the searchword in ISO-8859-15, not in UTF-8, so you define it this way: "http://www.linguee.de/search?direction=auto&query=###ISO-8859-15###". A list of encodings can be found here.

      IMPORTANT: Some dictionaries (including "Google Translate") don't allow to be opened within a frame set. Put an asterisk * in front of the URI (Examples: *http://mywebdict.com?q=### or *http://translate.google.com/?ie=UTF-8&sl=..&tl=..&text=###) to open such a dictionary not within the frame set but in a popup window (please don't forget to deactivate popup window blocking in your browser!).

      One dictionary (Glosbe) has been closely integrated into LWT via the Glosbe API. To use this dictionary, input the "special" dictionary link "glosbe_api.php?from=...&dest=...&phrase=###" (NO "http://" at the beginning!!) with from: "L2 language code" (the language of your texts) and dest: "L1 language code" (e.g. mother tongue). To find the language codes, open this page to select the "from" (L2) language. On the next page, select the "L2 - L1" language pair. The URL of the next page shows the two language codes, here as an example "French - English": http://glosbe.com/**fr**/**en**/. The "from" code is "fr", the "dest" code is "en". Using this dictionary makes the transfer of translation(s) from the Glosbe to LWT very easy: just click on the icon next to the translations to copy them into the LWT edit screen. I recommend to use the LWT-integrated Glosbe dictionary as the "Dictionary 1 URI". Note: I cannot guarantee that the Glosbe API and this special integration will work in the future! glosbe_api.php is just an example how one can integrate a dictionary into LWT.

      You don't know how and where to find a good web dictionary? Try these dictionary directories:

    • The entry "Text Size" defines the relative font size of the text. This is great for Chinese, etc.

    • "Character Substitutions" is an optional list of "from=to" items with "|" as list separator. The "from" character is replaced by the "to" character ("to" may be also empty). So different kinds of apostrophes can unified or deleted.

    • "RegExp Split Sentences" is a list of characters that signify a sentence ending (ALWAYS together with a following space or newline!). The space can be omitted (and it is normally), if you set "Make each character a word" to Yes (see below). Whether you include here ":" and ";" - that's your decision. See also this table. Characters can be also defined in Unicode form: "\x{....}"; the Chinese/Japanese full stop "。" is then "\x{3002}" (always without "). Please inform yourself about Unicode here (general information) and here (Table of Unicode characters).

    • "Exceptions Split Sentences" are a list of exceptions that are NOT to be treated as sentence endings with "|" as list separator. [A-Z] is a character range. If you don't want to split sentences after Mr. / Dr. / A. to Z. / Vd. / Vds. / U.S.A., then you should specify these here: "Mr.|Dr.|[A-Z].|Vd.|Vds.|U.S.A." (without ").

    • "RegExp Word Characters" is a list of characters OR character ranges "x-y" that defines all characters in a word, e.g. English: "a-zA-Z", German: "a-zA-ZaöüÄÖÜß", Chinese: 一-龥. See also this table. Characters can be also defined in Unicode form: "\x{....}"; the Chinese/Japanese character "one" "一" is then "\x{4E00}" (always without "). So the above specification for the range of characters in Chinese "一-龥" can also be specified: "\x{4E00}-\x{9FA5}".

    • "Make each character a word" is a special option for Chinese, etc. This makes EVERY character a single word (normally words are split by any non-word character or a space). See also this table.

    • "Remove spaces" is another option for Chinese, etc. It removes all spaces from the text (and the example sentences). See also this table.

    • "Right-To-Left Script" must be set to "Yes" if the language/script is written from right to left, like Arabic, Hebrew, Farsi, Urdu, etc.

    • "Export Template". The export template controls "Flexible" Term Exports for the terms of that language. It consists of a string of characters. Some parts of this string are placeholders that are replaced by the actual term data, see this table. For each term (word or expression), that has been selected for export, the placeholders of the export template will be replaced by the term data and the string will be written to the export file. If the export template is empty, nothing will be exported.
      To understand all these options, please study also this, look at the examples and play around with different settings and different texts.

    Image

  • My Texts

    The list of texts. You can filter this list according to language, title (wildcard = *) or text tag(s) (see also below). The most important links for each text are "Read" and "Test" - that's the place to read, to listen, to save terms and to review and test your terms in sentence context. To see all terms of a text that you have saved, click on the numbers in column "Saved Wo+Ex". To print, archive, edit (and reparse), or to delete a text, click on the icons in column "Actions". There are more actions available, see "Multi Actions".

    Image

    Multi Actions for marked texts

    You can test the terms of the marked texts, delete or archive the marked texts. "Reparse Texts" rebuilds the sentence and the text item cache for all marked texts. "Set Term Sentences" sets a valid sentence (with the term in {..}) for all those saved or imported terms that occur in the text and that do not have a sentence at all or none with {term}. This makes it easy to "create" sentence examples for imported terms.

    Image

  • My Text Tags

    The list of your text tags. You can manage your text tags here. With text tags, it will be easier to categorize and organize your texts. The tags are case sensitive, have 1 to 20 characters, and must not contain any spaces or commas.

    Image

  • New/Edit Text (with Check)

    This is the screen to input, check or edit a single text. Try to store not too long texts (the maximum length is 65,000 Bytes). If texts are very long (> 1000 words), certain operations (e.g. loading a text for reading, calculation of known/unknown words) may be quite slow. An audio URI and a link to the text source can also be defined. The best place to store your audios is the "media" subdirectory below the installation directory "lwt" (you have to create it yourself, and you have to copy the audio files into this directory; click Refresh if you don't see just copied media). But a cloud webspace service like DropBox is also possible. In the moment there is no possibility to import/upload an audio file within the LWT application. By the way, you can use MP3, WAV, or OGG media files, but be aware that not all browsers and/or operating systems support all media types! If you click "Check", the text will be parsed and split into sentences and words according to your language settings. Nothing will be stored if you check a text. You can see whether your text needs some editing, or whether your language settings (especially the ones that influence parsing/splitting) need an adjustment. Words (not expressions) that are already in your word list are displayed in red, and the translation is displayed. The Non-Word List shows all stuff between words. The "Check a Text" function can also be started directly from the main menu. If you click on "Change" or "Save", the text will be only saved. If you click on "Change and Open" or "Save and Open", the text will be saved and opened right away.

    Image

    You can also import a longer text into LWT with the possibility to split it up into several smaller texts. Click on "Long Text Import". You must specify the maximum number of sentences per text, and the handling of newlines for paragraph detection. It is not possible to specify audio files or URIs.

    Image

  • Read a Text

    This is your "working area": Reading (and listening to) a text, saving/editing words and expressions, looking up words, expressions, sentences in external dictionaries or Google Translate. To create an expression, click on the first word. You see "Exp: 2..xx 3..yy 4..zz ...". Just click on the number of words (2..9) of the desired expression you want to save. The dictionary links for multi word expressions are always in the edit frame! You can also use the Keyboard in the text frame, see Key Bindings. Double clicking on a word sets the audio position approximately to the text position, if an audio was defined. The other audio controls are self-explanatory: automatic repeat, rewind and move forward n seconds, etc.).

    Image

    Reading a Right-To-Left Script (Hebrew):

    Image

    With the checkbox [Show All] you can switch the display of text:

    [Show All] = ON (see below): All terms are shown, and all multi-word terms are shown as superscripts before the first word. The superscript indicates the number of words in the multi-word term.

    Image

    [Show All] = OFF (see below): Multi-word terms now hide single words and shorter or overlapping multi-word terms. This makes it easier to concentrate on multi-word terms while displaying them without superscripts, but creation and deletion of multi-word terms can be a bit slow in long texts.

    Image

  • Test terms

    Tests are only possible if a term has a translation. Terms with status "Ignored" and "Well Known" are never tested, and terms with a positive or zero score are not tested today. In summary, the term score must fall below zero to trigger the test. See also Term scores. Terms that are due today are marked with a red bullet in the term table. Terms that are due tomorrow are marked with a yellow bullet in the term table.

    During a test, a status display (at the bottom of the test frame) shows you the elapsed time "mm:ss", a small bar graph, and the total, not yet tested, wrong and correct terms in this test.

    In the following, L1 denotes you mother tongue (= translations), and L2 the language you want to learn (= the terms (words and expressions).

  • Test terms in a text (L2 -> L1)

    This is Test #1 or #4: L2 -> L1 (recognition) - to train your ability to recognize a L2 term. You may test within sentence context (Button "..[L2].."), or just the term (Button "[L2]"). You can also use the Keyboard in the test frame, see Key Bindings.

    Image

  • Test terms in a text (L1 -> L2)

    This is Test #2 or #5: L1 -> L2 (recall) - to train your ability to produce a term from L1. You may test within sentence context (Button "..[L1].."), or just the term (Button "[L1]"). You can also use the Keyboard in the test frame, see Key Bindings.

    Image

  • Test terms in a text (••• -> L2)

    This is test #3: ••• -> L2 (recall) - to train your ability to produce a term only from the sentence context (Button "..[••].."). If you hover over "[•••]", a tooltip displays the translation of the term. You can also use the Keyboard in the test frame, see Key Bindings.

    Image

  • Test yourself in a table / word list format (Button "Table")

    This is test #6: The selected terms and expressions are presented as a table. You can make invisible either the columns "Term" or "Translation", and you can hide or show the columns "Sentence", "Romanization", "Status" and "Ed" (Edit). To reveal the invisible solution ("Term" or "Translation"), you just click into the empty table cell. You can review or test yourself with or without changing the status by clicking "+" or "-" in the "Status" column. A status in red signifies that the term is due for testing. You can also edit the term by clicking the yellow "Edit" icon. Columns 2 to 6 may also my sorted by clicking on the header row. The initial sort order is according to term score.

    Image

  • Print a text

    Here you print a text. Optional: an inline annotation (translation and/or romanization) of terms that are of specified status(es). This screen is also great to just read or study a text.

    Chinese Text with annotation (Romanization/Pinyin and translation):

    Image

    Chinese Text with annotation (only Romanization/Pinyin):

    Image

    How to create, edit, and use an Improved Annotated Text:

    Motivation: Annotated texts (as interlinear text) have been used for language learning for a long time. One example are the word-by-word translations in Assimil courses. The German V. F. Birkenbihl proposes the creation of interlinear word-by-word or hyperliteral translations (calling this creation "decoding") in foreign language learning. Learning Latin or Ancient Greek via interlinear texts is quite old as you can see in this YouTube video.

    LWT's old "Print Screen" offers annotations, but it displays ALL translations of a term. The Improved Annotated Text feature enables you to select the best translation for every word in the text. As a result, you create an L1 word-by-word translation that is displayed above the L2 text. This interlinear text is better suited for language study, especially for beginners.

    Method: While listening to the audio, first follow the blue annotations in your native language while listening and understanding. Later, after understanding the text fully, you read the foreign language text alone. Repeat this often. After these steps, you listen to the text passively or do shadowing.

    On the Print Screen, click on "Create" an Improved Annotated Text. The system creates a default annotated text.

    Edit Mode:

    Image

    Within the "Improved Annotated Text - Edit Mode", you can select the best term translation by clicking on one of the radio buttons. To be able to do this, multiple translations must be delimited by one of the delimiters specified in the LWT Settings (currently: /;|). You can also type in a new translation into the text box at the end (this does not change your saved term translation), or you may change your term by clicking on the yellow icon or add a translation by clicking on the green "+" icon (this does change your saved term translation), and select it afterwards. The "Star" icon indicated that you want the term itself as annotation. Important: It's not possible to create new terms here - please do this in the "Read text" screen. Changing the language settings (e.g. the word characters) may have the effect that you have to start from scratch. The best time for the creation of an improved annotated text is after you have read the text completely and created all terms and expressions in the "Read text" screen.

    Warning: If you change the text, you will lose the saved improved annotated text!
    All changes in the Edit screen are saved automatically in the background!

    To leave the Edit mode, click on "Display/Print Mode". You may then print or display (with audio) the text, and work with the text online or offline.

    Print Mode:

    Image

    Display Mode (with audio player) in a separate window. Clicking the "T" or "A" lightbulb icons hides/shows the text or the blue annotations. You may also click on a single term or a single annotation to show or to hide it. This enables you to test yourself or to concentrate on one text only. Romanizations, if available, appear while hovering over a term.

    Image

  • My Terms

    The list of your saved words or expressions (= terms). You may filter the list of terms by language, text, status, term/romanization/translation (wildcard * possible) or term tag(s). Different sort orders are possible. You can do "multi actions" only on the marked or on all terms (on all pages!). "Se?" displays a green dot if a valid sentences with {term} exists. "Stat/Days" displays the status and the number of days since the last status change. The score of a term is a rough measure (in percent) how well you know a term. Read more about term scores here. Terms with zero score are displayed red and should be tested today.

    Image

    Multi Actions for marked terms

    Most actions are self-explanatory. "Test Marked Terms" starts a test with all marked terms. You may delete marked terms and change the status of marked terms. "Set Status Date to Today" is some kind of "trick" for vacations, illnesses, etc.

    "Export Marked Texts (Anki)" exports all terms that have been marked AND have a valid sentence with {term} for Anki. Terms that do not have a sentence with {term} will NOT be exported. Cloze testing of terms within sentence context can so be easily done in Anki. The export is tab-delimited: (1) term, (2) translation, (3) romanization, (4) Sentence without term (question of cloze test), (5) Sentence with term (answer of cloze test), (6) Language, (7) ID Number, (8) Tag list. Anki template decks (for Anki Version 1 and 2) are provided: "LWT.anki" and "LWT.apkg" in directory "anki".

    "Export Marked Texts (TSV)" exports all terms that have been marked. The export is tab-delimited: (1) term, (2) translation, (3) sentence, (4) romanization, (5) status, (6) language, (7) ID Number, (8) tag list.

    Image

    Multi Actions for all terms on all pages of the current query

    Explanations see above.

    Image

  • My Term Tags

    The list of your term tags. You can manage your term tags here. With term tags, it will be easier to categorize and organize your terms. The tags are case sensitive, have 1 to 20 characters, and must not contain any spaces or commas.

    Image

  • My Text Archive

    The list of archived texts. To unarchive, to edit or to delete a text, click on the icon under "Actions". There are also "Multi Actions" available.

    What is the difference between (active) texts and archived texts?

    • (Active) texts

      • They have been parsed and tokenized according to the rules defined for the language.
      • The result is stored in a cache of sentences and text items.
      • They use a lot of space in the database.
      • Reading with term creation/editing and dictionary lookup is possible.
      • Testing of a stored term that occurs in the text, is possible. A terms will be tested within the context of any sentence(s) in all active texts (the number of sentences may be set (1, 2, or 3) as a preference).

    • Archived texts

      • They are not parsed and tokenized, only the text is stored.
      • Compared with active texts, they don't use much space in the database, because no sentences and no text items are stored.
      • Reading with term creation/editing and dictionary lookup is not possible.
      • Testing of a stored term, that occurs in the text, is possible, but a term will be tested ONLY within the context of the sentence(s) that has/have been stored with the term in the sentence field, if the term does not occur in any active text.

    Image

    Multi Actions for marked archived texts

    Image

  • My Statistics

    It's self-explanatory and shows your performance. The numbers in the first table are links, by clicking on them you jump to the table of all terms in that status and language.

    Image

  • Import Terms

    Import a list of terms for a language, and set the status for all to a specified value. You can specify a file to upload or type/paste the data directly into the textbox. Format: one term per line, fields (columns) are separated either by comma ("CSV" file, e.g. used in LingQ as export format), TAB ("TSV" file, e.g. copy and paste from a spreadsheet program, not possible if you type in data manually) or # (if you type in data manually). The field/column assignment must be specified on the left. Important: You must import a term. The translation can be omitted if the status should be set to 98 or 99 (ignore/well known). Translation, romanization and sentence are all optional, but please understand that tests are only possible if terms have a translation. If a term already exists in the database (comparison is NOT case sensitive), it will not be overwritten; the line will be ignored. You can change this by setting "Overwrite existent terms" to "Yes". Be careful using this screen, a database backup before the import and double-checking everything is always advisable!

    Image

  • Backup/Restore/Empty Database

    This screen offers a possibility to save, restore or empty the LWT database (ONLY the current table set!). This makes it easy to try out new things or just to make regular backups. "Restore" only accepts files that have been created with the "Backup" function above. "Empty Database" deletes the data of all tables (except the settings) of the current table set, and you can start from scratch afterwards. Be careful: you may lose valuable data!

    Image

  • Settings/Preferences

    In this screen you can adjust the program according to your needs. The geometric properties of the Read Text and Test screens can be changed. This is important because different browsers and font sizes may result in an unpleasant viewing experience. The waiting time to display the next test and to hide the old message after a test assessment can also be changed. The number of sentences displayed during testing and generated during term creation can be set to 1 (default), 2 or 3; if set to 2 or 3 you are able to do "MCD" (Massive-Context Cloze Deletion) testing, proposed by Khatzumoto @ AJATT. The number of items per page on different screens can be set, and you can decide whether you want to see the word counts on the textpage immediately (page may load slow) or later (faster initial loading).

    Image

  • Multiple LWT table sets

    WARNING: The use of the "Multiple LWT table sets" feature on an external web server may cause a monstrous database size if some users import many or large texts. Without further improvements (e. g. user quotas, etc.), LWT with activated "Multiple LWT table sets" is in its current version not suitable to be run in a public environment on an external web server!

    When you start using LWT, you store all your data in the "Default Table Set" within the database you have defined in the file "connect.inc.php" during the LWT installation.

    Beginning with LWT Version 1.5.3, you are able to create and to use unlimited LWT table sets within one database (as space and MySQL limitations permit). This feature is especially useful for users who want to set up a multi user environment with a set of tables for each user. You can also create one table set for every language you study - this allows you to create different term/text tags for each language. If you don't need this feature, you just use LWT like in earlier versions with the "default table set". Please observe that the "Backup/Restore/Empty Database" function only works for the CURRENT table set, NOT for ALL table sets you have created!

    Just click on the link at the bottom of the LWT home screen where the current table set name (or "Default") is displayed. In a new screen "Select, Create or Delete a Table Set" you may switch and manage table sets. A table set name is max. 20 characters long. Allowed characters are only: a-z, A-Z, 0-9, and the underscore "_".

    Image

    If you want "switch off" this feature, and use just one table set, you may define the name in the file "connect.inc.php":

    $tbpref = ""; // only the default table set

    $tbpref = "setname"; // only the table set "setname"

    After adding such a line in the file "connect.inc.php", you are not able to select, create or delete table sets anymore. Only the one you have defined in "connect.inc.php" will be used. Please observe the rules for table set names (see above)!!

    If more than one table set exists, and $tbpref was NOT set to a fixed value in "connect.inc.php", you can select the desired table set via "start.php" (use this as start page if several people use their own table set), or by clicking on the LWT icon or title in the LWT menu screen "index.php".

    By hovering over the LWT icon in the top left corner of every screen, you can display the current table set in a yellow tooltip.

▶ **Questions and Answers**

  • I want to use LWT, and I see something like this:

    Image

    Answer: Your local webserver (Apache) is not running. Please start it via EasyPHP or MAMP control program/panel.

  • I want to use LWT, and I see something like this:

    Image

    Answer: The server is running, but the application is not found. Maybe the Uniform Resource Identifier (URI) is wrong or misspelled. Please check/correct it. Or the URI is correct, and the application is installed, but not in the correct directory lwt below htdocs. Please install/copy/move it into the correct directory.

  • I want to use LWT, and I see this:

    Image

    Answer: Either the database (MySQL) is not running, or the database connection parameters in ../htdocs/lwt/connect.inc.php are wrong. Please check/correct the database connection parameters and/or start MySQL via the MAMP or EasyPHP control program/panel.

  • I want to use LWT, and I see this:

    Image

    Answer: The Webserver and the database is running, but the database connection parameter file ../htdocs/lwt/connect.inc.php is not found. Please rename one of the connection files (according to your server) to ../htdocs/lwt/connect.inc.php.

  • I have installed or updated LWT on Linux, but the application does not run as expected:

    Answer 1: The Webserver does not have full access to all LWT files (insufficient rights). Open a terminal window, go to the directory where the directory "lwt" has been created with all LWT files, e. g.
    cd /var/www/html
    Now execute:
    sudo chmod -R 755 lwt.

    Answer 2: The PHP "mbstring" extension is not installed. Please install it; see this article.

▶ **Setup for Tablets**
  • If you want to use LWT on a tablet: that's possible (even the audio player works!).
  • In "Settings/Preferences", set the "Frame Set Display Mode" to "Auto" or "Force Mobile". On other mobile devices, you may also try "Force Non-Mobile" if you are unhappy with the results.
  • Try to reduce the length of your texts to reduce scrolling.
  • It's also a good idea to install and run LWT at a web hoster. So you can access LWT easily if you are often on the go.
  • I hope you will enjoy using LWT on a tablet although creating new terms and copy & paste can be a bit tedious.
▶ **Language Setup**

  • This section shows some language setups ("RegExp Split Sentences", "RegExp Word Characters", "Make each character a word", "Remove spaces") for different languages. They are only recommendations, and you may change them according to your needs (and texts). See also here.

  • If you are unsure, try the "Language Settings Wizard" first. Later you can adjust the settings.

  • Please inform yourself about Unicode here (general information) and here (Table of Unicode characters) and about the characters that occur in the language you learn!

    Language RegExp Split Sentences RegExp Word Characters Make each character a word Remove spaces
    Latin and all languages with a Latin derived alphabet (English, French, German, etc.) .!?:; a-zA-ZÀ-ÖØ-öø-ȳ No No
    Languages with a Cyrillic-derived alphabet (Russian, Bulgarian, Ukrainian, etc.) .!?:; a-zA-ZÀ-ÖØ-öø-ȳЀ-ӹ No No
    Greek .!?:; \x{0370}-\x{03FF}\x{1F00}-\x{1FFF} No No
    Hebrew (Right-To-Left = Yes) .!?:; \x{0590}-\x{05FF} No No
    Thai .!?:; ก-๛ No Yes
    Chinese .!?:;。！？：； 一-龥 Yes or No Yes
    Japanese .!?:;。！？：； 一-龥ぁ-ヾ Yes or No Yes
    Korean .!?:;。！？：； 가-힣ᄀ-ᇂ No No or Yes

  • "'" = Apostrophe, and/or "-" = Dash, may be added to "RegExp Word Characters", then words like "aujourd'hui" or "non-government-owned" are one word, instead of two or more single words. If you omit "'" and/or "-" here, you can still create a multi-word expression "aujourd'hui", etc., later.

  • ":" and ";" may be omitted in "RegExp Split Sentences", but longer example sentences may result from this.

  • "Make each character a word" = "Yes" should only be set in Chinese, Japanese, and similar languages. Normally words are split by any non-word character or whitespace. If you choose "Yes", then you do not need to insert spaces to specify word endings. If you choose "No", then you must prepare texts without whitespace by inserting whitespace to specify words. If you are a beginner, "Yes" may be better for you. If you are an advanced learner, and you have a possibility to prepare a text in the above described way, then "No" may be better for you.

  • "Remove spaces" = "Yes" should only be set in Chinese, Japanese, and similar languages to remove whitespace that has been automatically or manually inserted to specify words.

▶ **Term Scores**

  • The score of a term is a rough measure (in percent) how well you know a term. It is displayed in "My Terms", and it is used in tests to decide which terms are tested next.

  • The score is calculated as follows:

    Image

    Terms with status 1 are tested either today (if not created today) or tomorrow (if created today, or a test failed today). Terms set to status 2 should be retested after 2 days. Terms set to status 3 should be retested after 9 days. Terms set to status 4 should be retested after 27 days. Terms set to status 5 should be retested after 72 days.

  • Example 1: Five terms were tested today; they are now in status 1, 2, 3, 4, and 5. The term with status 1 is still unknown (failed the test, so the score is still 0 %). The term with status 5 is well known (score: 100 %).

    Image

  • Example 2: Five terms were not tested for some time; they are in status 1, 2, 3, 4, and 5. All of them have a score of 0, because the number of days indicate that you may have forgotten them. Therefore all should be retested today.

    Image

▶ **Key Bindings**

  • Important: Before using the keyboard you must set the focus within the frame by clicking once on the frame!

  • Key Bindings in the TEXT Frame

    Key(s) Action(s)
    RETURN The next UNKNOWN (blue) word in the text will be shown for creation
    RIGHT or SPACE Mark next SAVED (non-blue) term (*)
    LEFT Mark previous SAVED (non-blue) term (*)
    HOME Mark first SAVED (non-blue) term (*)
    END Mark last SAVED (non-blue) term (*)
    1, 2, 3, 4, 5 Set status of marked term to 1, 2, 3, 4, or 5
    I Set status of marked term to "Ignored"
    W Set status of marked term to "Well Known"
    E Edit marked term
    A Set audio position according to position of marked term.
    ESC Reset marked term(s)

    (*) Only saved terms with the status(es) defined/filtered in the settings are visited and marked!

  • Key Bindings in the TEST Frame

    Key(s) Action(s)
    SPACE Show solution
    UP Set status of tested term to (old status plus 1)
    DOWN Set status of tested term to (old status minus 1)
    ESC Do not change status of tested term
    1, 2, 3, 4, 5 Set status of tested term to 1, 2, 3, 4, or 5
    I Set status of tested term to "Ignored"
    W Set status of tested term to "Well Known"
    E Edit tested term

About

Learning with Texts (LWT) is a tool for Language Learning.

Resources

Readme
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

2 tags

Packages

No packages published

Languages

  • PHP 73.4%
  • JavaScript 14.3%
  • HTML 9.9%
  • CSS 2.4%