|
0
|
1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22)
|
|
|
2 .\"
|
|
|
3 .\" Standard preamble:
|
|
|
4 .\" ========================================================================
|
|
|
5 .de Sp \" Vertical space (when we can't use .PP)
|
|
|
6 .if t .sp .5v
|
|
|
7 .if n .sp
|
|
|
8 ..
|
|
|
9 .de Vb \" Begin verbatim text
|
|
|
10 .ft CW
|
|
|
11 .nf
|
|
|
12 .ne \\$1
|
|
|
13 ..
|
|
|
14 .de Ve \" End verbatim text
|
|
|
15 .ft R
|
|
|
16 .fi
|
|
|
17 ..
|
|
|
18 .\" Set up some character translations and predefined strings. \*(-- will
|
|
|
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
|
|
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
|
|
|
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
|
|
|
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
|
|
|
23 .\" nothing in troff, for use with C<>.
|
|
|
24 .tr \(*W-
|
|
|
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
|
|
26 .ie n \{\
|
|
|
27 . ds -- \(*W-
|
|
|
28 . ds PI pi
|
|
|
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
|
|
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
|
|
31 . ds L" ""
|
|
|
32 . ds R" ""
|
|
|
33 . ds C` ""
|
|
|
34 . ds C' ""
|
|
|
35 'br\}
|
|
|
36 .el\{\
|
|
|
37 . ds -- \|\(em\|
|
|
|
38 . ds PI \(*p
|
|
|
39 . ds L" ``
|
|
|
40 . ds R" ''
|
|
|
41 'br\}
|
|
|
42 .\"
|
|
|
43 .\" Escape single quotes in literal strings from groff's Unicode transform.
|
|
|
44 .ie \n(.g .ds Aq \(aq
|
|
|
45 .el .ds Aq '
|
|
|
46 .\"
|
|
|
47 .\" If the F register is turned on, we'll generate index entries on stderr for
|
|
|
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
|
|
|
49 .\" entries marked with X<> in POD. Of course, you'll have to process the
|
|
|
50 .\" output yourself in some meaningful fashion.
|
|
|
51 .ie \nF \{\
|
|
|
52 . de IX
|
|
|
53 . tm Index:\\$1\t\\n%\t"\\$2"
|
|
|
54 ..
|
|
|
55 . nr % 0
|
|
|
56 . rr F
|
|
|
57 .\}
|
|
|
58 .el \{\
|
|
|
59 . de IX
|
|
|
60 ..
|
|
|
61 .\}
|
|
|
62 .\"
|
|
|
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
|
|
64 .\" Fear. Run. Save yourself. No user-serviceable parts.
|
|
|
65 . \" fudge factors for nroff and troff
|
|
|
66 .if n \{\
|
|
|
67 . ds #H 0
|
|
|
68 . ds #V .8m
|
|
|
69 . ds #F .3m
|
|
|
70 . ds #[ \f1
|
|
|
71 . ds #] \fP
|
|
|
72 .\}
|
|
|
73 .if t \{\
|
|
|
74 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
|
|
75 . ds #V .6m
|
|
|
76 . ds #F 0
|
|
|
77 . ds #[ \&
|
|
|
78 . ds #] \&
|
|
|
79 .\}
|
|
|
80 . \" simple accents for nroff and troff
|
|
|
81 .if n \{\
|
|
|
82 . ds ' \&
|
|
|
83 . ds ` \&
|
|
|
84 . ds ^ \&
|
|
|
85 . ds , \&
|
|
|
86 . ds ~ ~
|
|
|
87 . ds /
|
|
|
88 .\}
|
|
|
89 .if t \{\
|
|
|
90 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
|
|
91 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
|
|
92 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
|
|
93 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
|
|
94 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
|
|
95 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
|
|
96 .\}
|
|
|
97 . \" troff and (daisy-wheel) nroff accents
|
|
|
98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
|
|
99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
|
|
100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
|
|
101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
|
|
102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
|
|
103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
|
|
|
104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
|
|
105 .ds ae a\h'-(\w'a'u*4/10)'e
|
|
|
106 .ds Ae A\h'-(\w'A'u*4/10)'E
|
|
|
107 . \" corrections for vroff
|
|
|
108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
|
|
109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
|
|
110 . \" for low resolution devices (crt and lpr)
|
|
|
111 .if \n(.H>23 .if \n(.V>19 \
|
|
|
112 \{\
|
|
|
113 . ds : e
|
|
|
114 . ds 8 ss
|
|
|
115 . ds o a
|
|
|
116 . ds d- d\h'-1'\(ga
|
|
|
117 . ds D- D\h'-1'\(hy
|
|
|
118 . ds th \o'bp'
|
|
|
119 . ds Th \o'LP'
|
|
|
120 . ds ae ae
|
|
|
121 . ds Ae AE
|
|
|
122 .\}
|
|
|
123 .rm #[ #] #H #V #F C
|
|
|
124 .\" ========================================================================
|
|
|
125 .\"
|
|
|
126 .IX Title "TEXTFILESTOHTML 1"
|
|
|
127 .TH TEXTFILESTOHTML 1 "2015-03-29" "perl v5.14.2" "MayaChemTools"
|
|
|
128 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
|
|
129 .\" way too many mistakes in technical documents.
|
|
|
130 .if n .ad l
|
|
|
131 .nh
|
|
|
132 .SH "NAME"
|
|
|
133 TextFilesToHTML.pl \- Generate HTML table file(s) from TextFile(s)
|
|
|
134 .SH "SYNOPSIS"
|
|
|
135 .IX Header "SYNOPSIS"
|
|
|
136 TextFilesToHTML.pl ... TextFile(s)...
|
|
|
137 .PP
|
|
|
138 TextFilesToHTML.pl [\fB\-a, \-\-align\fR left | center | right,[top | middle | bottom]] [\fB\-b, \-\-border\fR borderwidth] [\fB\-\-cellpadding\fR padding]
|
|
|
139 [\fB\-\-cellspacing\fR spacing] [\fB\-\-footer\fR string] [\fB\-d, \-\-displaylinks\fR top | bottom | both]
|
|
|
140 [\fB\-\-displaylinksinfo\fR line | table | both] [\fB\-h, \-\-help\fR]
|
|
|
141 [\fB\-\-headeralign\fR left | center | right,[top | middle | bottom]] [\fB\-\-headercolor\fR \*(L"#RRGGBB\*(R"]
|
|
|
142 [\fB\-\-highlight\fR \*(L"fieldlabel,datatype,criterion,value,[fieldlabel,datatype,criterion,value,]...\*(R"]
|
|
|
143 [\fB\-\-highlightby\fR colnum | collabel] [\fB\-\-highlightcolor\fR \*(L"#RRGGBB,#RRGGBB\*(R"]
|
|
|
144 [\fB\-\-highlightstyle\fR text | background] [\fB\-\-indelim\fR comma | semicolon] [\fB\-m, \-\-mode\fR plain | shade | highlight | shadedhighlight]
|
|
|
145 [\fB\-n, \-\-numrows\fR number] [\fB\-o, \-\-overwrite\fR] [\fB\-r, \-\-root\fR rootname]
|
|
|
146 [\fB\-\-stylesheet\fR old | new | none] [\fB\-\-stylesheetname\fR filename] [\fB \-\-shadecolor\fR \*(L"#RRGGBB,#RRGGBB\*(R"]
|
|
|
147 [\fB\-t, \-\-title\fR string] [\fB\-\-titledisplay\fR yes | no] [\fB\-w, \-\-workingdir\fR dirname] TextFile(s)...
|
|
|
148 .SH "DESCRIPTION"
|
|
|
149 .IX Header "DESCRIPTION"
|
|
|
150 Generate \s-1HTML\s0 file(s) from \fITextFile(s)\fR. The \s-1HTML\s0 file(s) contain data tables and appropriate
|
|
|
151 navigational links to view other tables. These files can be generated for local viewing or
|
|
|
152 deployment on a web server. A variety of options are provided to control style and
|
|
|
153 appearence of tables.
|
|
|
154 .PP
|
|
|
155 Multiple \fITextFile(s)\fR names are separated by spaces. The valid file extensions are \fI.csv\fR and
|
|
|
156 \&\fI.tsv\fR for comma/semicolon and tab delimited text files respectively. All other file names
|
|
|
157 are ignored. All the text files in a current directory can be specified by \fI*.csv\fR,
|
|
|
158 \&\fI*.tsv\fR, or the current directory name. The \fB\-\-indelim\fR option determines the
|
|
|
159 format of \fITextFile(s)\fR. Any file which doesn't correspond to the format indicated
|
|
|
160 by \fB\-\-indelim\fR option is ignored.
|
|
|
161 .SH "OPTIONS"
|
|
|
162 .IX Header "OPTIONS"
|
|
|
163 .IP "\fB\-a, \-\-align\fR \fIleft | center | right,[top | middle | bottom]\fR" 4
|
|
|
164 .IX Item "-a, --align left | center | right,[top | middle | bottom]"
|
|
|
165 Horizontal and vertical alignment for table rows except for header row which is specified
|
|
|
166 using \fB\-\-headeralign\fR option. Possible horizontal alignment values: \fIleft, center, or right\fR.
|
|
|
167 Possible vertical alignment values: \fItop, middle, or bottom\fR.
|
|
|
168 .Sp
|
|
|
169 Default values: \fIleft,middle\fR
|
|
|
170 .IP "\fB\-b, \-\-border\fR \fIborderwidth\fR" 4
|
|
|
171 .IX Item "-b, --border borderwidth"
|
|
|
172 Table border width. Default value: 1 for \fIplain\fR and \fIhighlight\fR mode; 0 for \fIshade\fR
|
|
|
173 and \fIshadedhightlight\fR mode. Zero indicates no border.
|
|
|
174 .IP "\fB\-\-cellpadding\fR \fIpadding\fR" 4
|
|
|
175 .IX Item "--cellpadding padding"
|
|
|
176 Table cell padding. Default value: \fI2\fR.
|
|
|
177 .IP "\fB\-\-cellspacing\fR \fIspacing\fR" 4
|
|
|
178 .IX Item "--cellspacing spacing"
|
|
|
179 Table cell spacing. Default value: \fI1\fR.
|
|
|
180 .IP "\fB\-\-footer\fR \fIstring\fR" 4
|
|
|
181 .IX Item "--footer string"
|
|
|
182 Text string to be included at bottom of each \s-1HTML\s0 file. Default: none.
|
|
|
183 .IP "\fB\-d, \-\-displaylinks\fR \fItop | bottom | both\fR" 4
|
|
|
184 .IX Item "-d, --displaylinks top | bottom | both"
|
|
|
185 Specify where to display navigation links in each \s-1HTML\s0 file for accessing all other \s-1HTML\s0
|
|
|
186 files. Possible values: \fItop, bottom, or both\fR. Default value: \fIboth\fR. This option is
|
|
|
187 only valid during multiple \s-1HTML\s0 files generation for an input file.
|
|
|
188 .IP "\fB\-\-displaylinksinfo\fR \fIline | table | both\fR" 4
|
|
|
189 .IX Item "--displaylinksinfo line | table | both"
|
|
|
190 Control display of additional information along with navigational links: Showing line
|
|
|
191 n of m is displyed for line and showing table n of m for table. Possible values: \fIline
|
|
|
192 | table | both\fR. Default: \fIboth\fR. This option is only valid during multiple \s-1HTML\s0 files generation.
|
|
|
193 .IP "\fB\-h, \-\-help\fR" 4
|
|
|
194 .IX Item "-h, --help"
|
|
|
195 Print this help message
|
|
|
196 .IP "\fB\-\-headeralign\fR \fIleft | center | right,[top | middle | bottom]\fR" 4
|
|
|
197 .IX Item "--headeralign left | center | right,[top | middle | bottom]"
|
|
|
198 Horizontal and vertical alignment for table header rows. Possible horizontal alignment
|
|
|
199 values: \fIleft, center, or right\fR. Possible vertical alignment values: \fItop, middle, or bottom\fR.
|
|
|
200 .Sp
|
|
|
201 Default values: \fIcenter,middle\fR
|
|
|
202 .ie n .IP "\fB\-\-headercolor\fR \fI""#RRGGBB""\fR" 4
|
|
|
203 .el .IP "\fB\-\-headercolor\fR \fI``#RRGGBB''\fR" 4
|
|
|
204 .IX Item "--headercolor #RRGGBB"
|
|
|
205 Color used to fill background of table header row containing column labels
|
|
|
206 represented as a hexadecimal string. None for \fB\-m, \-\-mode\fR option value
|
|
|
207 of \fIplain\fR and \fI#ccccff\fR, light blue, for others.
|
|
|
208 .ie n .IP "\fB\-\-highlight\fR \fI""fieldlabel,datatype,criterion,value,[fieldlabel,datatype,criterion,value,]...""\fR" 4
|
|
|
209 .el .IP "\fB\-\-highlight\fR \fI``fieldlabel,datatype,criterion,value,[fieldlabel,datatype,criterion,value,]...''\fR" 4
|
|
|
210 .IX Item "--highlight fieldlabel,datatype,criterion,value,[fieldlabel,datatype,criterion,value,]..."
|
|
|
211 This value is mode specific. It specifies how to highlight various column values
|
|
|
212 for each text file. Same set of quartets values are applied to all \fITextFile(s)\fR.
|
|
|
213 .Sp
|
|
|
214 For \fIhighlightbycolnum\fR mode, input text format contains these quartets:
|
|
|
215 \&\fIcolnum,datatype,criterion,value,...\fR. Possible datatype values: \fInumeric or text\fR.
|
|
|
216 Possible criterion values: \fIle, ge, or eq\fR. Examples: \*(L"1,numeric,le,450>\*(R" or
|
|
|
217 \&\*(L"2,numeric,ge,150,6,numeric,le,10\*(R".
|
|
|
218 .Sp
|
|
|
219 For \fIhighlightbycollabel\fR mode, input text format contains these quartets:
|
|
|
220 \&\fIcollabel,datatype,criterion,value,...\fR.
|
|
|
221 .IP "\fB\-\-highlightby\fR \fIcolnum | collabel\fR" 4
|
|
|
222 .IX Item "--highlightby colnum | collabel"
|
|
|
223 This value is mode specific. It indicates how columns to be highlighted are specified
|
|
|
224 using \fB\-\-hightlight\fR option. Possible values: \fIcolnum or collabel\fR. Default value: \fIcolnum\fR.
|
|
|
225 .ie n .IP "\fB\-\-highlightcolor\fR \fI""#RRGGBB,#RRGGBB""\fR" 4
|
|
|
226 .el .IP "\fB\-\-highlightcolor\fR \fI``#RRGGBB,#RRGGBB''\fR" 4
|
|
|
227 .IX Item "--highlightcolor #RRGGBB,#RRGGBB"
|
|
|
228 Colors used to highlight column values during \fIhighlight\fR and \fIshadedhightlight\fR
|
|
|
229 mode represented as hexadecimal strings.
|
|
|
230 .Sp
|
|
|
231 For \fB\-\-highlighstyle\fR option values of \fItext\fR and \fIbackground\fR, these colors represent
|
|
|
232 text or background colors respectively. For a specific column, first color string is used for
|
|
|
233 values which meet criterion indicated by \fB\-\-highlight\fR option; the second color is used
|
|
|
234 for rest of the values.
|
|
|
235 .Sp
|
|
|
236 Default values for \fIbackground\fR \fB\-\-highlightstyle\fR: \fI#0fff0f,#ff0f0f\fR. And default values for
|
|
|
237 \&\fItext\fR \fB\-\-highlightstyle\fR: \fI#0fbb0f,#ff0f0f\fR. Hexadecimal strings for both \fB\-\-highlightstyle\fR
|
|
|
238 colors correspond to \fIreddish\fR and \fIgreenish\fR.
|
|
|
239 .IP "\fB\-\-highlightstyle\fR \fItext | background\fR" 4
|
|
|
240 .IX Item "--highlightstyle text | background"
|
|
|
241 This value is mode specific. It indicates highlight style used to differentiate column
|
|
|
242 values which pass a specified criterion from others. Possible values: \fItext or
|
|
|
243 background\fR. Default: \fIbackground\fR.
|
|
|
244 .IP "\fB\-\-indelim\fR \fIcomma | semicolon\fR" 4
|
|
|
245 .IX Item "--indelim comma | semicolon"
|
|
|
246 Input delimiter for \s-1CSV\s0 \fITextFile(s)\fR. Possible values: \fIcomma or semicolon\fR.
|
|
|
247 Default value: \fIcomma\fR. For \s-1TSV\s0 files, this option is ignored and \fItab\fR is used as a
|
|
|
248 delimiter.
|
|
|
249 .IP "\fB\-m, \-\-mode\fR \fIplain | shade | highlight | shadedhighlight\fR" 4
|
|
|
250 .IX Item "-m, --mode plain | shade | highlight | shadedhighlight"
|
|
|
251 Specify how to generate \s-1HTML\s0 table(s): plain tables with line borders, background of
|
|
|
252 alternate rows filled with a specified color, column values hightlighted using a specified
|
|
|
253 criteria, or combination of previous two styles.
|
|
|
254 .Sp
|
|
|
255 Possible values: \fIplain, shade, highlight, or shadedhighlight\fR. Default: \fIshade\fR.
|
|
|
256 .IP "\fB\-n, \-\-numrows\fR \fInumber\fR" 4
|
|
|
257 .IX Item "-n, --numrows number"
|
|
|
258 Maximum number of rows per table. Default value: \fI100\fR. Use 0 to put all rows into
|
|
|
259 one table. For \fITextFile(s)\fR with more than maximum number of specified rows,
|
|
|
260 multiple \s-1HTML\s0 tables, with appropriate navigation links, are created.
|
|
|
261 .IP "\fB\-o, \-\-overwrite\fR" 4
|
|
|
262 .IX Item "-o, --overwrite"
|
|
|
263 Overwrite existing files.
|
|
|
264 .IP "\fB\-r, \-\-root\fR \fIrootname\fR" 4
|
|
|
265 .IX Item "-r, --root rootname"
|
|
|
266 New file or directory name is generated using the root: <root>.html or <root>\-html.
|
|
|
267 Default new file name: <InitialTextFileName>.html. Default directory name:
|
|
|
268 <InitialTextFileName>\-html.
|
|
|
269 .Sp
|
|
|
270 For \fITextFile(s)\fR with more than maximum number of rows specified per table,
|
|
|
271 this directory tree is generated using <Name> where <Name> corresponds to <root>
|
|
|
272 or <InitialTextFileName>:Top dir \- <Name>\-html; Sub dirs \- html and mols. <Top dir> contains
|
|
|
273 <Name>.html and <Name>.css files and <sub dir> html conatins various
|
|
|
274 <Name>Lines<Start>To<End>.html files; <sub dir> mols is created as needed and contains
|
|
|
275 .Sp
|
|
|
276 This option is ignored for multiple input files.
|
|
|
277 .IP "\fB\-\-stylesheet\fR \fIold | new | none\fR" 4
|
|
|
278 .IX Item "--stylesheet old | new | none"
|
|
|
279 Controls usage of stylesheet for newly generated \s-1HTML\s0 file(s). Possible values: \fIold,
|
|
|
280 new, or none\fR. Default value: \fInew\fR.
|
|
|
281 .Sp
|
|
|
282 Stylesheet file contains various properties which control apperance of \s-1HTML\s0 pages:
|
|
|
283 type, size, and color of fonts; background color; and so on.
|
|
|
284 .Sp
|
|
|
285 For \fIold\fR value, an existing stylesheet file specified by \fB\-\-stylesheetname\fR option is
|
|
|
286 used for each \s-1HTML\s0 file; no new stylesheet file is created. This option is quite handy
|
|
|
287 for deploying \s-1HTML\s0 file(s) on a web server: assuming you specify a valid stylesheet
|
|
|
288 file location relative to your WWWRoot, a reference to this stylesheet is added to each
|
|
|
289 \&\s-1HTML\s0 file. For local deployment of \s-1HTML\s0 file(s), a complete path to a local stylesheet
|
|
|
290 is fine as well.
|
|
|
291 .Sp
|
|
|
292 For \fIcreate\fR value, a new stylesheet is created and reference to this local stylesheet
|
|
|
293 is added to each \s-1HTML\s0 file. Use option \fB\-\-stylesheetname\fR to specify name.
|
|
|
294 .Sp
|
|
|
295 For \fInone\fR value, stylesheet usage is completely ignored.
|
|
|
296 .IP "\fB\-\-stylesheetname\fR \fIfilename\fR" 4
|
|
|
297 .IX Item "--stylesheetname filename"
|
|
|
298 Stylesheet file name to be used in conjunction with \fB\-s \-\-stylesheet\fR option. It is only
|
|
|
299 valid for \fIold\fR value of \fB\-s \-\-stylesheet\fR option. Specify a valid stylesheet file location
|
|
|
300 relative to your WWWRoot and a reference to this stylesheet is added to each \s-1HTML\s0
|
|
|
301 file. Example: \*(L"/stylesheets/MyStyleSheet.css\*(R". Or a complete path name to a local
|
|
|
302 stylesheet file.
|
|
|
303 .Sp
|
|
|
304 For \fIcreate\fR value of \fB\-s \-\-stylesheet\fR option, a new stylesheet file is created using
|
|
|
305 \&\fB\-r \-\-root\fR option. And value of \fB\-\-stylesheetname\fR is simply ignored.
|
|
|
306 .ie n .IP "\fB \-\-shadecolor\fR \fI""#RRGGBB,#RRGGBB""\fR" 4
|
|
|
307 .el .IP "\fB \-\-shadecolor\fR \fI``#RRGGBB,#RRGGBB''\fR" 4
|
|
|
308 .IX Item " --shadecolor #RRGGBB,#RRGGBB"
|
|
|
309 Colors used to fill background of rows during \fIshade\fR and \fIshadedhightlight\fR mode
|
|
|
310 represented as a pair of hexadecimal string; the first and second color values
|
|
|
311 are used for odd and even number rows respectively.
|
|
|
312 .Sp
|
|
|
313 Default value: \fI\*(L"#ffffff,#e0e9eb\*(R"\fR \- it's white and very light blue for odd and even number rows.
|
|
|
314 .IP "\fB\-t, \-\-title\fR \fIstring\fR" 4
|
|
|
315 .IX Item "-t, --title string"
|
|
|
316 Title for \s-1HTML\s0 table(s). Default value: <TextFileName>. For multiple input files,
|
|
|
317 \&\fB\-r \-\-root\fR option is used to generate appropriate titles.
|
|
|
318 .IP "\fB\-\-titledisplay\fR \fIyes | no\fR" 4
|
|
|
319 .IX Item "--titledisplay yes | no"
|
|
|
320 Display title for \s-1HTML\s0 table(s). Possible values: \fIyes or no\fR. Default value: \fIyes\fR.
|
|
|
321 .IP "\fB\-w, \-\-workingdir\fR \fIdirname\fR" 4
|
|
|
322 .IX Item "-w, --workingdir dirname"
|
|
|
323 Location of working directory. Default: current directory.
|
|
|
324 .SH "EXAMPLES"
|
|
|
325 .IX Header "EXAMPLES"
|
|
|
326 To generate \s-1HTML\s0 tables with rows background filled with white and greyish colors and
|
|
|
327 navigation links on top and botton of each page, type:
|
|
|
328 .PP
|
|
|
329 .Vb 1
|
|
|
330 \& % TextFilesToHTML.pl \-o Sample1.csv
|
|
|
331 .Ve
|
|
|
332 .PP
|
|
|
333 To generate \s-1HTML\s0 tables with rows background filled with golden and greyish colors,
|
|
|
334 navigation links on top and botton of each page, 10 rows in each table, greyish header
|
|
|
335 row color, and cell spacing of 1, type:
|
|
|
336 .PP
|
|
|
337 .Vb 3
|
|
|
338 \& % TextFilesToHTML.pl \-o \-n 10 \-\-headeralign "center" \-\-headercolor
|
|
|
339 \& "#a1a1a1" \-\-shadecolor "#ddd700,#d1d1d1" \-\-cellspacing 1
|
|
|
340 \& Sample1.csv
|
|
|
341 .Ve
|
|
|
342 .PP
|
|
|
343 To generate plain \s-1HTML\s0 tables with 10 rows in each table and navigation links only at
|
|
|
344 the bottom, type:
|
|
|
345 .PP
|
|
|
346 .Vb 2
|
|
|
347 \& % TextFilesToHTML.pl \-o \-n 10 \-\-displaylinks bottom \-m plain
|
|
|
348 \& Sample1.csv
|
|
|
349 .Ve
|
|
|
350 .PP
|
|
|
351 To highlight values in column 3 using specified highlight criteria and fill in default background
|
|
|
352 colors, type:
|
|
|
353 .PP
|
|
|
354 .Vb 3
|
|
|
355 \& % TextFilesToHTML.pl \-n 10 \-\-highlight "3,numeric,le,450"
|
|
|
356 \& \-\-highlightby colnum \-\-highlightstyle background \-m
|
|
|
357 \& shadedhighlight \-o Sample1.csv
|
|
|
358 .Ve
|
|
|
359 .PP
|
|
|
360 To highlight values in column MolWeight using specified highlight criteria, color the text using
|
|
|
361 default colors, and add a footer message in every page, type:
|
|
|
362 .PP
|
|
|
363 .Vb 3
|
|
|
364 \& % TextFilesToHTML.pl \-n 4 \-\-highlight "MolWeight,numeric,le,500"
|
|
|
365 \& \-\-highlightby collabel \-\-highlightstyle text \-m shadedhighlight \-o
|
|
|
366 \& \-\-footer "Copyright (C) MayaChemTools" \-\-cellspacing 1 Sample1.csv
|
|
|
367 .Ve
|
|
|
368 .SH "AUTHOR"
|
|
|
369 .IX Header "AUTHOR"
|
|
|
370 Manish Sud <msud@san.rr.com>
|
|
|
371 .SH "SEE ALSO"
|
|
|
372 .IX Header "SEE ALSO"
|
|
|
373 JoinTextFiles.pl, MergeTextFilesWithSD.pl, ModifyTextFilesFormat.pl, SplitTextFiles.pl, SortTextFiles.pl
|
|
|
374 .SH "COPYRIGHT"
|
|
|
375 .IX Header "COPYRIGHT"
|
|
|
376 Copyright (C) 2015 Manish Sud. All rights reserved.
|
|
|
377 .PP
|
|
|
378 This file is part of MayaChemTools.
|
|
|
379 .PP
|
|
|
380 MayaChemTools is free software; you can redistribute it and/or modify it under
|
|
|
381 the terms of the \s-1GNU\s0 Lesser General Public License as published by the Free
|
|
|
382 Software Foundation; either version 3 of the License, or (at your option)
|
|
|
383 any later version.
|
