]> git.scottworley.com Git - tablify/blobdiff - README.md
Release 0.6.0
[tablify] / README.md
index 94752af5bc578021690bba2a9fd09e46ff5a4238..e93375d30f6670da6a4dce2a3f23951c04477a3f 100644 (file)
--- a/README.md
+++ b/README.md
@@ -2,6 +2,25 @@
 
 Display a flat text log as an HTML table.
 
+Input format:
+
+    row 1 label
+      column label for a thing
+      column label for a different thing: cell contents
+
+    row 2 label
+      column label for a thing
+      ...
+
+Several bang-commands are available to control output formatting:
+
+* `!col <column>` to force column ordering, overriding frequency-ordering.
+* `!colsep` to leave a insert a gap between columns (skip two lines to leave a gap between rows).
+* `!col_threshold <N>` to set the threshold at which entries get columns rather than being left as notes on the right.  Default: 2
+* `!hide <column>` to omit a column
+* `!label <column>:<new label>` to change a column's label without needing to change all the input occurrences.
+* `!mark <column>:<mark>` to change the character that is used as the tally-mark for that column
+
 (For the other `tablify` that makes ascii-art tables, see [Text-RecordParser][].)
 
 [Text-RecordParser]: https://metacpan.org/dist/Text-RecordParser/view/bin/tablify