web commit by http://victormoral.myopenid.com/: New third party plugin

1 files changed, 48 insertions, 0 deletions

diff --git a/doc/plugins/contrib/table___40__third-party_plugin__41__.mdwn b/doc/plugins/contrib/table___40__third-party_plugin__41__.mdwn
new file mode 100644
index 000000000..9651a91e2
--- /dev/null
+++ b/doc/plugins/contrib/table___40__third-party_plugin__41__.mdwn
@@ -0,0 +1,48 @@
+This plugin allows build html tables from data in csv (comma-separated values) or dsv (delimiter-separated values) formats.
+
+It need the perl module [[cpan Text::CSV]] for the csv data. 
+
+## usage
+
+In any source page include the following:
+
+    The next table show the results:
+
+    \[[table class="myclass" format=dsv data="""
+    Custom|Amount|
+    Fulanito|134,34|
+    Menganito|234,56|
+    """]]
+
+    This is my last acquisition:
+
+    [[table class="book_record" format=csv file="data/books/record1"]]
+
+    And the record1 page should be similar to:
+
+    "Title","Perl Best Practices"
+    "Author","Damian Conway"
+    "Publisher","O’Reilly"
+
+The parameters are:
+
+- _data_: Contains the values for the table
+- _file_: Wiki page whom contains the data.
+- _delimiter_ (optional): Define the character used for separated the fields. By default is the vertical barr "|" in DSV format and the comma "," for the CSV format.
+- _class_ (optional):  CSS class for the table html element
+- _caption_ (optional):   Text string with the table caption.
+- _no\_header_: This switch disable the generation of table header elements. By default this switch is enabled, and the header cells come from the firts data line.
+
+Obviously, the _data_ and _file_ parameters are mutually exclusive. 
+
+## Links
+
+- Information about the formats in Wikipedia:
+    - [[wikipedia CSV]]
+    - [[wikipedia DSV]]
+
+- Download of the tar file from <http://taquiones.net/files/misc/>
+- Debian package in <http://taquiones.net/files/debian/>
+
+
+