CSV (Syntax)

Mit dem CSV-Plugin ist es möglich Komma-getrennte-Listen (fälschlich auch als EXcel-Listen bezeichnet) ohne umständliches Konvertieren direkt hier abzulegen und in Tabellenform anzeigen zu lassen.

Der frühere Default-Wert 'Komma-getrennt' sollte in das hier in DE gebräuchliche Semikolon geändert werden. Dies ist den Grundeinstellungen des Plugins bereits getan. Die erste Zeile wird voreingestellt als Tabellenkopf dargestellt. Dies kann man ändern (s.u.)

Übrigens: für alle Tabellen gilt, daß unterhalb der Tabelle kein zusätzlicher Platz freigehalten wird. Damit werden direkt untereinander stehende Tabellen ermöglicht. Um sich einen Abstand zum folgenden Text zu schaffen, muß ein Wiki-Seiten-Umbruch eingefügt werden '\\ ' (zwei Bachslash mit einem Leerzeichen!).

Einschränkungen

Leider ist es (noch) nicht möglich Wiki-Syntax und -Links mit einzubinden. D.h. Verlinkungen sind nicht möglich. Das Plugin 'Edit-Table' funktioniert hier natürlich nicht : ist ja auch keine Wiki-Tabelle.

erweitertes Beispiel

im Hinblick auf Assembly-Listen umgestrickt:

<acsv rowmark=^ marker=~ hdr_rows=1 hdr_cols=0 max_cols=7 border=0 firstno=1 fsize=90 calign=l,c,,-,l 
cwidth=6,4,18,15,12,80 hcolor=#f0f0fe rcolor=#e8fee8 mcolor=#fee0e0> ..data.. </csv>

1	COMMO-#	Qty.	Part	Value	Form	Designator
2
3			Circuit Board
4	3xxx	1	PCB	Rev.?
5
6			IC Big
7	390084-01	1	CPU MC6B000FN8	8MHZ	PLCC68	U1,
8	391105-01	2	DRAM	256K X 16 80NS	SMD	U16, U17,
9	391084-01	1	VIDEO ENCODER	CXA1145M	SO-24	U12,
10
11			IC Commo
12	390544-01	1	AGNUS PAL	8375R0 HR	PLCC84	U2,
13	391155-01	1	GAYLE	4145R0F020	PLCC84 ?	U5,
14	391081-01	1	DENISE	8375R4 HiRes	PLCC52	U4,
15	391077-01	1	PAULA	8364R7 SMT	PLCC52	U3,
16	391079-01	1	KEYBD UP	6571R4 UP	PLCC44	U13,
17	391078-01	2	8520R4 CIA 1MHZ	8520R4 CIA 1MHZ	PLCC44	U7, U8, U7, U8, U7	U8,
18	391304-01	1	ROM	KICKSTART V2.0	DIP40	U6,

Mit Absicht, um zu verdeutlichen, was ein Semikolon auch anstellen kann:
Hier in der roten Zeile ist aus einem Komma ein Semikolon geworden und damit werden die folgenden Werte ein Feld weiter angezeigt.

Syntax

Alle Parameter mit Leerzeichen trennen und Zuweisung: Name=Wert

*	Name	default	Beschreibung
	hdr_rows	1	Anzahl Kopfzeilen hervorheben (Fettschrift und alle zentriert)
	hdr_cols	0	bei Spalten
	delim	;	Trennzeichen (Semikolon dringend empfohlen (zur Not ''\|''))
	enclosure
	border	0	Rahmen- und Trennlinien-Dicke (0/0.5/1/1.5) in Arbeit
	firstno	0	für extra Zeilennummerierung dann Startwert größer Null setzen
s	max_cols	false	Tabelle fest auf eine bestimmte Anzahl Spalten trimmen
s	calign	false	Feld mit Ausrichtungen der Spalten
s	cwidth	false	Feld mit Breiten der Spalten
R	rowmark	false	Markierungszeichen z.B. '^' Gruppenzeilen
M	marker	false	Markierungszeichen z.B. '~' für hervorgehobene Zeile
	hcolor	#eee	Header-Farbe (die ggf. erste Zeile und ggf. erste Spalte)
R	rcolor	#f6f6f6	Abschnittszeilen-Farbe (z.B. Gruppen)
M	mcolor	#f0fef0	Markier-Farbe um bestimmte Zeilen hervorzuheben)
	fsize	90	Schriftgröße in % des normalen Wiki-Textes

Beispiel obige Tabelle <acsv hdr_cols=2>...</acsv>

ToDo: Verlinkungen und Wiki-Syntax ermöglichen.
CSS anpassen
… und vielleicht die Leerzeilen auf halbe Höhe setzen ?!

Standard-Syntax:

<acsv delim=;>
Spalte1;Spalte2;Spalte3
Wert1;Wert2;Wert3
</acsv>

Ergebnis:

Spalte1	Spalte2	Spalte3
Wert1	Wert2	Wert3

Spezial-Syntax:

<acsv delim=; border=0 hdr_rows=0>
Spalte1;Spalte2;Spalte3
Wert1;Wert2;Wert3
</acsv>

Ergebnis:

Spalte1	Spalte2	Spalte3
Wert1	Wert2	Wert3

So wird eine CSV-Tabelle generiert ohne Rahmen, ohne Hintergrundverfärbungen. Sehr hilfreich bei strukturiertem Aufbau (sicherer als Tabulatoren).
Ups … hier muß das CSS noch angepaßt werden. Sorry.

Variante:

<acsv delim=; border=0  hdr_rows=0 hdr_cols=1>
Spalte1;Spalte2;Spalte3
Wert1;Wert2;Wert3
</acsv>

Ergebnis:

Spalte1	Spalte2	Spalte3
Wert1	Wert2	Wert3

original Syntax

Kopie des Standard-Plugin-Textes FIXME

The <csv> tag allows for additional options to be specified as well as a file reference.

Option	Description	Default value
`hdr_rows=<n>`	Format the first <n> rows of data from the CSV as column headers	`1`
`hdr_cols=<n>`	Format the first <n> columns of each row as column headers	`0`
`span_empty_cols=[01]`	Create colspans for each empty (two adjacent commas) cell following a cell with content	`0`
`delim=<char>`	The delimiter used between cells. Specify `tab` for a tab separated file.	`,`

Cells that include a comma as part of the data are expected to be contained between double quotes, which is the typical behaviour of most systems when exporting .csv files.

Empty lines in the csv file or data are displayed as horizontal separators in the table.