palabra/README at master · klochner/palabra · GitHub

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

Palabra
=======

Palabra is a crossword editor with a focus on professional crossword
development. Palabra is written in Python and C. 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.14
- lxml package, also known as python-lxml in repositories.
  It can also be found here: http://pypi.python.org/pypi/lxml.
- python-dev from the repositories.

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

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

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

  python setup.py build
  mac:  env ARCHFLAGS="-arch i386" python setup.py build

- You can now install Palabra using:

  python setup.py install

- After that, you can run palabra using:

  palabra

If you have trouble installing and you get errors about missing distribution
options, try upgrading the setup script with:

  sudo python ez_setup.py -U setuptools

For the latest installation instructions, visit:

  https://bitbucket.org/svisser/palabra/wiki/Home


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.

File formats
============

Palabra supports the file formats XPF and ipuz (experimental).

- XFP (http://xwordinfo.com/xpf)
- ipuz (http://www.ipuz.org/)

ipuz is a trademark of Puzzazz, Inc., used with permission.

Note: All information can currently be saved with XPF while
not all information (such as explanations for clues) can currently
be saved with ipuz.

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/