Main
Download
Inst/Conf
gherwI'
Not yet...
Last Update 15.11.2015
Deutsches Holghoj + deutsche Vokabeln
Update 15.08.2015
Both programs are changed.
Datafiles are cleaned up (removed useless pictures)
Added a reward at 10k points

Holghoj

The multimedial vocabulary trainer

The upper row of squares are the answers - click them or use the numbers #1-#4 The lower two rectangles are the question and the hint, which complements the question (#5).
Hold CTRL and the corresponding number to play media files.
(Or hover to use the play button)

This is an improved version of Holghoj and a radically different version of gherwI'(voc file creator). Download both anew even if you have them already.

The main idea behind Holghoj is that having mere text for question and answer is boring and repetitive. Also, some vocabulary trainers are somewhat "dumb", only showing you "card language A" and "card language B" not knowing what exactly they are showing you - when you have to pick the noun out of three prefixes and one noun, it's not really a challenge. Or a training.

Holghoj is capable of "knowing" the type of word it's showing, and will try to pick misleading answers out of the same grammatical group and, if provided, category. That means that if you are supposed to provide the name of the klingon dish that is shown to you, the program will try to give you three other foodstuffs to choose from.

By default, the creator program, gherwI', will create rather simple "View/read, choose answer" questions, but you can also define questions that require or allow two answers, as well as use a custom text for specific questions.

Multimedial

Holghoj can make use of pictures, audio files, and video files. It does so by using the .Net class "MediaElement", which basically calls your Windows Media Player - any media file your system can play, Holghoj can play as well.
Multimedia is not mandatory, though. A vocabulary file might just as well contain only text. (In fact, the program has a text-only vocabulary file built-in.)

Rewards

Learning vocabulary is boring. Even if it's made more palatable by enhancing text with multimedia. Intellectually, being able to memorize more words should be enough reward. But emotionally, it's dry and liveless.
Holghoj tries to spicen it up by allowing the creator of the vocabulary file to add in rewards that are shown when a point threshold is reached.
These rewards can be multimedia as well, of course.
There is no limit to the amount of rewards, albeit only one can be shown at a time.

Downloads

Main program plus two vocabulary files The program itself can actually be used on its own - it has a text-only vocabulary file built-in. In this zip are also two "compressed vocabulary" files which contain multimedia files.
KCDVocabulary.hgmz contains all the words of Klingon CD, together with pictures, videos and audio files.
ComplexQuestions.hgmz contains only four rather simple questions, despite the name, but it is used to demonstrate the ability and shortcomings of the complex question system. In this case you will see that several answers are blocked, this is because I told gherwI' to only save used resources into the HGMZ file to make it small - so the program is now unable to show additional fake answers.)
The vocabulary creator plus resources gherwI' is the program that can be used to create new vocabulary files for Holghoj. Accompanying it are example files and the media files from KCD. More on this below.
Deutsche Version des Programms Neue Version, das Programm ist praktisch vollständig in Deutsch (sollte was englisch sein sagt es mir bitte)
Aktuelle Vokabeln aus boQwI' auf Deutsch (mit einigen Ausnahmen wo es offenbar kein deutsche Übersetzung gab).Es sollten praktisch alle Vokabeln enthalten sein, über 3000 - mein Extraktor kann allerdings derzeit nur die direkten Einträge übernehmen.
Nur Text.
Vokabeln aus KCD, Deutsch Die Vokabeln aus KCD auf Deutsch, mit Medien

Installation and configuration

Installation is simple - download the program, extract, run.
The program will only write a file when you tell it to save the results. It will need .Net 4.0, but any modern computer should have that - if enough people say that it's a problem, I'll try to compile it to a lower version.
There is no real configuration because although a lot of possible options are built into the program, I found it too difficult to provide a useable interface for them. I may add a list of potential features later, if there is interest.

How to use it?

At the very basic, just run the program. Either it finds a vocabulary file by itself (looking in the same directory) or it'll open the built-in text file.
You can also drag a HGMZ(vocabulary) file onto the running program or its icon.
Please note that the program is unable to offer you a choice of file, it'll take the first it sees in the directory. I might add that later.

The idea behind the program is simple - read the question/instruction at the bottom and select the correct answer from the top row.

Apart from the unusual layout, the answer being on top with the question below, it is designed to be rather userfriendly.
The answer can be selected by clicking with a mouse, or by using the numbers 1-4 - numpad or above the alphanumeric block. You can acknowledge/check your answer by pressing enter/return or space. Or click the "check answer" button with your mouse.
The first click will reveal the correct answer, the next will call up the next question (if there is one).
In case of a video or audio file, you will see a play button when you hover over the tile. Alternately you can press CTRL + the corresponding number (5 being the hint).
Usually there is only one correct answer, but vocabulary files may also request two answers - in that case, the second answer is not required, but will give bonus points.
If you only know the second answer, the program will still treat the question as answered, but you'll only get the points for the second-best answer of course.
Basically, while the primary answer might be the absolutely correct answer, the secondary answer is still not wrong, though not what was expected. Best example might be a question with a picture of a bowl full of qagh. The correct answer would of course be "serpent, worm", but "food" wouldn't be wrong either.
Of course, this has to be implemented by the author of the vocabulary file :-)

gherwI' - the helpful program to create vocabulary files

This is a quick overview, go
here for more details.

Since Holghoj is supposed to be intelligent, the vocabulary files it uses cannot be simple text files with two columns. Fortunately, the raw data doesn't have to be much more complex than that - gherwI' will do the rest.
The vocabulary files are called HGMZ files, which stands for HolGhojMedia file Zipped - I won't bore you with the details, to keep it simple: the HGMZ file contains both the XML with the meta/text data for the vocabulary as well as the questions and required media files.
That way you only need a single file.
Previously the program used the more simple HGM file - which is the same XML file, but uncompressed, and with media files only referenced (via file path).
HGMZ files are in my opinion easier to handle (just one file, nothing to care about), which is why they are the preferred output format of gherwI'.
For some stupid reasons, it's not possible to load a media file from another file, so Holghoj actually sets up a local webserver to serve the files to itself - you can check that by using a browser to access this URL: http://localhost:57050/HolghojMedia/GetList
This is also a good way to see if it works, or if maybe your firewall is overzealous and blocks this local-to-local connection.

gherwI' Interface

Most of the parameters are optional - to produce a regular HGMZ file all you need is a resources file. The parameters are for finetuning.
For gherwI', a resource is a word or concept, which may possess multiple facets. For example, you could have the word "yuch" and its translation "chocolate", but also a picture and perhaps a video of Gowron saying "yuch".
gherwI' will take these facets and create multiple entries for Holghoj that are all interconnected so the program knows not to display two of them at the same time, or one as the answer of the other.
I've tried to keep the resource file as simple as possible. An example file is provided, both as XLS and CSV format - while gherwI' can only open the CSV, it is more comfortable to edit the XLS. I've added notes in it that should further explain how the file works.
Note that the CSV file should be in UTF-8 format, and you may have to manually adjust the separator sign. Commas are unfortunately not the best choice for a file full of text - the program would get confused by any text with a comma in it.
I recommend using the TAB or perhaps a semi-colon. Unless you specify something different, gherwI' will try to figure it out itself, by trying each separator.

Basics of the resource(groundwork for the vocabulary) file

(There is more, but this is the minimum.)
See this page for a detailed explanation of the resource files.

Stuff I planned but have not yet implemented:

I tried to write the program in a way that is easy to update and enhance, but even so this takes time to write and test. So here are a few things I laid the groundwork for, but have not yet built. Depending on feedback (i.e. you saying "We need THIS or THAT"), I might work on it sooner or later.

Different UI languagesImplemented, but neither fully tested, nor accessible. So far, the program uses a built-in XML file for english texts. An external file could be supplied, but the names are likely to change. If you want to try it, drop me a line and I copy the XML file.
Configuration fileThe functionality is implemented, but not really tested, and it doesn't do much right now. You can force creation of a config file with command line argument "writeconfig", but I can't guarantee that all configuration options are respected.
In-program help/tutorialNothing usable. I made a few attempts, but so far nothing really worked out. Sorry.
Built-in vocabulary creatorNot much so far. The separate program uses the same base components, so it would be possible to integrate it into the main program, but I've rewritten the GUI of the creator program several times now and I don't want to spoil the main program.
More configurability for gherwI'.The previous version did have many options - the program ended up having THREE screens to accomodate all the options...


Any questions? Feel free to
Mail me.