DTL2SGFT(1) DTL2SGFT(1)
NAME
dtl2sgft - Online Documentation Administration Utility for InfoSearch
SYNOPSIS
dtl2sgft -b bookname -s bookshelfpath
[ -a authorizationstring ] [ -d datadir ]
[ -o outputfile ] [ -p ] [ -q granularityqry ]
[ -r root ] [ -t titletag ] [ -u useshelfname ]
[ -w ] [ -x ]
DESCRIPTION
dtl2sgft is a utility program used to assist in maintaining a full-text
searchable index of online books available to the infosearch(1)
application.
For a specified insight(1) online book, dtl2sgft builds a full-text
indexable word file which is an extraction of the content of the book.
This word file is used in conjunction with the booksAdmin(1) utility to
aid in constructing and maintaining a full-text index. Along with the
word file, a HTML-based version of the book's table of contents is also
produced.
An administrator should never have to run this process by hand. Normally
it will be launched by the booksAdmin(1) utility. If it is run manually,
the only options required when processing insight(1) online books are -b
and -s, as described below.
OPTIONS
Command line options are described below.
-b The -b bookname required option tells dtl2sgft to examine the
specified book. The bookname is the abbreviated short title for
the book. See insight(1) for more details on bookshelves.
-s The -s bookshelfpath required option tells dtl2sgft which specific
bookshelf the bookname is on. See insight(1) for more details on
bookshelves.
For example,
dtl2sgft -b IRISEssentials -s
/usr/share/Insight/library/SGIbookshelves/SGIEndUser
-a The -a authorizationstring option instructs dtl2sgft to use the
designated string as an authorization key for processing books that
have been licensed. This option is not be needed for the online
books from Silicon Graphics.
Page 1
DTL2SGFT(1) DTL2SGFT(1)
-d The -d datadir points to the default data directory. It should not
need to be set. The default is /usr/lib/Insight/data.
-o The -o outputfile option instructs dtl2sgft to append the resultant
word file output to the specified outputfile. The HTML file for the
table of contents will still be created as:
bookshelfpath/books/bookname/bookname.html.
-p The -p option instructs dtl2sgft to purge or remove the word file it
creates (bookshelfpath/books/bookname/bookname.books.wrd). By
default, this file is not removed by dtl2sgft.
-q The -q granularityqry option indicates the level of granularity in
which to break up the book into. This should be specific to the SGML
instance (tag set) used within the book. For example, the default
is: "<INTRODUCTION> OR <PREFACE> OR <CHAPTER> OR <APPENDIX> OR
<GLOSSARY> OR <INDEX> OR <SGIINDEX>". If nothing is found for the
specified granularityqry, there are two fallback attempts. The
first uses "<SECTION1> OR <S1>" and the second utilizes the query
string "<SECTION2> OR <S2>".
-r The -r root option instructs dtl2sgft to write the resultant word
file and HTML file output to the specified root directory. For
example, for the specified root, the resultant set of files are:
root/bookname.books.wrd and root/bookname.html.
-t The -t titletag option indicates the SGML instance tag used to
designate titles within the content. The default is "TITLE".
-u The -u useshelfname option instructs dtl2sgft to use this string as
a bookshelf designation, both in the resultant word and HTML file.
The default is to use the end of the path string specified for
bookshelfpath. If
/usr/share/Insight/library/SGI_bookshelves/SGI_EndUser is specified
for bookshelfpath, the truncated string used to in the word and
HTML file is "SGI_EndUser". The -u useshelfname option overrides
the aforementioned default.
-w The -w option instructs dtl2sgft to only create a HTML-based table
of contents file for web access.
-x The -x option instructs dtl2sgft to output timing specifications.
By default, it runs silently.
FILES
/usr/sbin/dtl2sgft
SEE ALSO
infosearch(1), sgsearch(1)
Page 2
DTL2SGFT(1) DTL2SGFT(1)
Page 3