Tableconvert
============

.. contents::

About
-----

Tableconvert is a plugin which helps on converting a tabulator
separated selection into a table.

Installation
------------

This version of the plugin is installed with the combined
geany-plugins release. Please check README of this package

Usage
-----

After the plugins has been installed successfully, load the plugin
via Geany's plugin manager. This will add a new keybinding into
Geany's list of keybindings inside the preferences dialog. You might
like to set up a keybinding for the function. Once this is done, the
plugin is ready to use.

When using the plugin, just mark the area you like to transform and
push your keybinding. All line endings will be taken as end of a row
and therefor transformed to fitting row endings.

Currently the plugin is supporting
* HTML
* LaTeX
* SQL

HTML
^^^^

When transforming HTML, line endings will be replace with  and

. Occurrences of tabulator will be interpreted as column
separators and replaced by   and .

The first line will be treaded as header and surrounded by

 tags. The rest of the table will be included into

.

LaTeX
^^^^^

In case of working with LaTeX line endings will be replaced with \\
and tabulators with &.

Rectangle selections are currently not supported and might lead to
some weird output you didn't expect -- just don't try it if you have
heart issues or working on an important document :)

However, after you transformed your selection to a table you might 
want to update the number and orientation of columns at begin of 
tabular-environment.

SQL
^^^

At SQL line endings will be replaced with with closing braces )
followed by a komma if is not the last line.

Tabulators will be repace with ', ', so in the end, a tabulator
seperated liste as e.g.

foo	baa
baa foo

will be transformed to

(
	('foo', 'baa'),
	('baa', 'foo')
)

Development
-----------

You can checkout the current source code from the git repository at
github.com. Get the code by:

git clone https://github.com/geany/geany-plugins.git

If you want to create a patch, please respect the license of
Tableconvert as well as intellectual property of third. Patches that
should be included to the default distribution must be licensed under
the same conditions as Tableconvert by the copyright owner (GPL2+).

Known issues
------------

The plugin currently is not supporting rectangle selections very
well. Also it is not able to support 
 and 
 at the
moment. However, at least the second point is planned for some later
release.

For more recent information all reported issues will be tracked at
http://sourceforge.net/tracker/?group_id=222729

License
-------

Tableconvert and all its parts is distributed under the terms of the
GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any
later version. A copy of this license can be found in the file COPYING
included with the source code of this program. If not, you will be
able to get a copy by contacting the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Bugs, questions, bugs, homepage
-------------------------------

If you found any bugs or want to provide a patch, please contact Frank
Lanitz (frank(at)geany(dot)org). Please also do so, if you got any
questions.
