-
Notifications
You must be signed in to change notification settings - Fork 3
/
ng2html.1
81 lines (74 loc) · 3.51 KB
/
ng2html.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
.TH ng2html 1 "3rd January 1997" v1.05
.SH NAME
ng2html \- Norton Guide to HTML Document Converter.
.SH SYNOPSIS
\fBng2html\fP guide-path
.SH DESCRIPTION
\fBng2html\fP allows you to take a Norton Guide database file and convert
it into a number of HTML documents. This will then allow you to view the
contents of the guide with the Web browser of your choice.
When run against a guide \fBng2html\fP will generate a number of files
(depending on the size of the guide this could be a lot of files) each
containing a page from the guide. All links are generated by \fBng2html\fP
so you don't need to worry about that.
Note that by default the format of the name of the files, apart from the
menu and about details, is "ng%lx.html" (you can change this in the
source if you so desire) which means that on systems where you are
restricted in the number of characters this restriction will affect the
size of a guide you can process. On systems that use FAT (Dos or OS/2
for example) you will run out of names if the guide is more than 0xFFFFFF
bytes (around 16 megs) in size. This should not be a problem for most
people. If it is, use VFAT or HPFS and a compiler that can handle long
file names instead. :-)
.SS OPTIONS
.TP
\fIguide-path\fP
This is the path and name of the Norton Guide to be converted.
.SS CONFIGURATION FILE
You can customise the way ng2html works by using a configuration file.
The name and location of the configuration file depends on what you
set it to in the source. Look for the line that defines \fBCONFIG_FILE\fP.
Valid options are:
.TP
.B BODY=\fIbody-details\fP
If this option is used in the configuration file then the text after the
'=' is used in any generated HTML document as the <BODY> token. One
obvious use for this would be to allow for images as part of the background.
If you do use this option, ensure that what you provide is valid HTML,
ng2html makes no checks.
.TP
.B FRAMES=\fIyes|no|1|0\fP
If set to "yes" (a simple Y, y or 1 will do, everything else is ignored)
this option tells ng2html to generate frames aware HTML. When used, the
code will create two frames, the left hand side displaying the Norton
Guide menu and the right hand side displaying the contents of the
pages.
.TP
.B FRAMECOLS=\fIcols-spec\fP
If framed HTML code is being generated then this option can be used to
specify the FRAMECOLS for the frames. By default this is set to 30%,70%.
You can change this using this config option.
.SH AUTHOR
Dave Pearson \- [email protected]
.SH COPYRIGHT
NG2HTML NORTON GUIDE TO HTML DOCUMENT CONVERTER.
Copyright (C) 1996,1997 David A Pearson
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the license, or (at your option)
any later version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.
.SH BUGS
The conversion of box drawing characters and other "graphic" charcters that
so many guides rely on could be improved.
Because, depending on the guide, so many small files can be generated,
on some filesystems the resulting HTML can be a waste of diskspace.
.SH SEE ALSO
http://www.acemake.com/hagbard
http://www.hagbard.demon.co.uk