Vocatra

Introduction

Vocatra is a console-based vocabulary trainer. It takes one or more vocabulary files, queries you for each word and lets you try to give the correct answer. You can enable different learning modes. If you prefer to learn sequentially it has an order mode. Otherwise, there is also a random mode available. You can find other preferences and more details in the man-page.

Get Vocatra

Source packages are available on SourceForge. The current development source code can be checked out from the Subversion repository. If you find a bug, want to request a new feature or would like to share your vocabulary files with others, please do so on Vocatra's Tickets system.

Compile Vocatra from Source

If you have downloaded the source distribution, you need the following packages to build the executable.

• The GNU C++ Compiler g++
• GNU make
• The gettext package

The installation is done by following the next steps:

1. Unpack the archive, unless you have already done that:

   tar -xzf vocatra-$VERSION.tar.gz   #gzip archive OR
   tar -xjf vocatra-$VERSION.tar.bz2  #bzip archive

2. Run the configure script:

   ./configure

   For an overview of configuration options use:

   ./configure --help

3. Compile Vocatra by running make:

   make

4. Install Vocatra:

   make install

If you want to uninstall Vocatra, use the next command:

make uninstall

Install deb or rpm package

If you have downloaded the deb or rpm package you have to run following command with root rights to install them:

dpkg -i vocatra_$VERSION_i386.deb  #debian package
rpm -i vocatra-$VERSION.i386.rpm   #rpm package

Installation on Ubuntu systems

If you want to install Vocatra on Ubuntu, add following lines to your /etc/apt/sources.list:

deb http://ppa.launchpad.net/sao/ppa/ubuntu hardy main
deb-src http://ppa.launchpad.net/sao/ppa/ubuntu hardy main

use following command to add key for verification:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 5C4ECE3E

and easily install Vocatra with following commands:

sudo apt-get update
sudo apt-get install vocatra

For more details go to https://launchpad.net/~sao/+archive/ppa.

How to use Vocatra

Before you can start using Vocatra, you have to create your own vocabulary file. To do so, you simply open your favorite text editor and add words (one word per line) in the following format:

Chef=chief,boss

As you can see, the two languages are separated with an equal sign (=). Furthermore, you can define synonyms by separating them with a comma (,). In addition, lines can be commented out by adding a number sign (#) in front of them. Download a vocabulary file from here for more examples.

As soon as you have created your vocabulary file, you can start your learning process with the following command:

vocatra vocabulary-file.txt

For Developers

Vocatra is written in C++ and the source code stands under the GPL Licence. If you want to know more about Vocatra's inside go to classes or files. If you have already read the documentation and you still have questions, please do not hesitate to file a new ticket on Trac.