
Palabra
=======

Palabra is a crossword editor written in Python. It is free software and
it is licensed under the GNU General Public License, version 3 or any later
version.

Requirements
============

- Python 2.6
- PyGTK 2.8
- lxml package, also known as python-lxml in repositories.
  It can also be found here: http://pypi.python.org/pypi/lxml.

Palabra should work with the above versions of the software packages but they
may need to be refined further (please contact me). In any case,

Palabra is known to work with:

- Python 2.6.4
- GTK+ 2.18.3
- PyGTK 2.16.0

How to install/run
==================

- In the directory of Palabra, run the following command:

  python setup.py build
  
- You can now install Palabra using:

  python setup.py install
  
- After that, you can run palabra using:

  palabra

Getting started
===============

Placing a block:
    - Left-click on a cell and press '.', or
    - Hold SHIFT and left-click on a cell

Removing a block:
    - Hold SHIFT and right-click on a cell

Change typing direction:
    - Press TAB.

Entering a character in a cell:
    - Left-click on the cell and type the character.

Move the selection to a nearby cell:
    - Use the ARROW KEYS for left, right, up, and down.

Deleting a character:
    - Left-click on a cell and press BACKSPACE or DELETE.
    - You can also press BACKSPACE repeatedly to remove the whole slot.

Jump to the first cell of a slot:
    - Press HOME.
    
Jump to the last cell of a slot:
    - Press END.
  
Contact
=======

E-mail: simeonvisser@gmail.com

For bugs/comments, see Development below.

Development
============

Development takes place at:

  http://bitbucket.org/svisser/palabra/

For reporting issues and requesting features:
  
  http://bitbucket.org/svisser/palabra/issues/
