Dean Nelson - 2016-06-09

Readme file for TableMD

TableMD is a simple CSV table converter. It takes a Comma-Separated-Value (CSV) file as input and processes it into a Markdown or Docbook table.

The CSV text strings should be double quoted to help procesing. If it is not and the processor encounters a comma, it will signal the end of that field.

Example : in.csv (located in the test directory)
** Num,File,sequence **
** 1,Piggy.out,"1,2,3,4"
2,"Fast.in",2
"3",Wiffle.z,"5,6,7,8,9,9,9,"**

In this example the header would be the top row and that would define the columns. Everthig after that would be expected to follow that pattern of columns.

After processing it with TableMD it will look like this:

Num File sequence
1 Piggy.out 1,2,3,4
2 Fast.in 2
3 Wiffle.z 5,6,7,8,9,9,9,

If TableMD cannot make sense of a line because of missplaced or nonexistant double quotes, it will then just replace commas with bars and try to format it as best it can.

Versions
1.01 Initial release
1.02 Fixed install issues
1.10 Added Docbook table support

Questions & Comments?
email: deannelson@users.sourceforge.net

__Building From Source __
To build from source you will need the following:
1. Working QT4 or Qt5 environment
2. Linux or WIndows platform
3. QtCreator or command line

If you are using QtCreator
1. Load the tablemd.pro project in QtCreator
2. Select "Build All"
3. After it compiles, look in "Release" directory for the executable (under windows) or in the same directory (under Linux).

If you are using command line compilation, use the following commands to build tableMD:
cd tablemd
qmake
make

 

Last edit: Dean Nelson 2016-06-09