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 <tr> and
</tr>. Occurrences of tabulator will be interpreted as column
separators and replaced by <td> and </td>.

The first line will be treaded as header and surrounded by
<thead></thead> tags. The rest of the table will be included into
<tbody></tbody>.


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 :)

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 Subversion repository at
Sourceforge.net. Get the code from:

svn checkout
http://geany-plugins.svn.sourceforge.net/svnroot/geany-plugins/trunk/geany-plugins/tableconvert

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 <thead> and <tbody> 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.
