]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/commitdiff
rename and comments
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>
Tue, 16 Jan 2007 03:21:33 +0000 (03:21 +0000)
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>
Tue, 16 Jan 2007 03:21:33 +0000 (03:21 +0000)
doc/plugins/contrib/table.mdwn [new file with mode: 0644]
doc/plugins/contrib/table/discussion.mdwn [new file with mode: 0644]
doc/plugins/contrib/table___40__third-party_plugin__41__.mdwn [deleted file]

diff --git a/doc/plugins/contrib/table.mdwn b/doc/plugins/contrib/table.mdwn
new file mode 100644 (file)
index 0000000..6497557
--- /dev/null
@@ -0,0 +1,61 @@
+[[meta title="table (third-party plugin)"]]
+
+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.
+- _format_ (optional): format name of the data. By default is `auto` and the options are `csv` or `dsv`.
+- _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. 
+
+Note: the format detection mechanism is still very rudimentary. 
+
+## Changelog
+
+### version 0.5
+
+* Remove a call to a inexistent Text::CSV method.
+* Added the sep_char parameter.
+* Parse CVS data in binary mode.
+* Added a format detection mechanism.
+* Default format now is 'auto'.
+
+## 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/>
+
diff --git a/doc/plugins/contrib/table/discussion.mdwn b/doc/plugins/contrib/table/discussion.mdwn
new file mode 100644 (file)
index 0000000..f0ebb6d
--- /dev/null
@@ -0,0 +1,7 @@
+Well, that's an one workaround for (some versions of) markdown's
+lack of tables..
+
+Interesting that you chose to use CSV format. Seems there are advantages
+(standardisation) and disadvantages (limited to simple tables).
+
+--[[Joey]]
diff --git a/doc/plugins/contrib/table___40__third-party_plugin__41__.mdwn b/doc/plugins/contrib/table___40__third-party_plugin__41__.mdwn
deleted file mode 100644 (file)
index 16529f1..0000000
+++ /dev/null
@@ -1,59 +0,0 @@
-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.
-- _format_ (optional): format name of the data. By default is `auto` and the options are `csv` or `dsv`.
-- _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. 
-
-Note: the format detection mechanism is still very rudimentary. 
-
-## Changelog
-
-### version 0.5
-
-* Remove a call to a inexistent Text::CSV method.
-* Added the sep_char parameter.
-* Parse CVS data in binary mode.
-* Added a format detection mechanism.
-* Default format now is 'auto'.
-
-## 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/>
-