To serve documents to a local network (assuming you have
already created them) you must:
Create a homepage.
Configure scohttpd to serve your homepage to the local network.
Home pages are special
HTML
documents that SCOhelp displays at startup (if help is started from
the desktop icon or from a UNIX command line).
Home pages provide hyperlinks to any document that you
want to make available to your network.
To create a homepage,
use a text editor (for example, emacs or vi)
to create your own HTML document
(see
,Chapter 3, ``Writing HTML documents'' in Using Help)
or customize the sample
homepage in Using Help
found in /usr/lib/scohelp/XHelp/sample.html.
After you have created your homepage, configure the help server
(scohttp) to use it.
To configure the help server, complete the following steps:
Log in as root.
Move your homepage to your document root
(the directory you want to make available
to the network).
By default, the document root is /usr/lib/scohelp.
If you want to use the default directory, move your new homepage
to /usr/lib/scohelp and skip to step 12. If you want
to change the default directory, complete steps 3 through 11.
WARNING:
If you want access to the SCO Documentation Library,
do not change the document root. To use your own
homepage while retaining access to the help library,
move your homepage to /usr/lib/scohelp and
skip to step 12.
Change directories to /var/scohttpd/conf.
Open srm.conf.
Find the line defining DocumentRoot. This
is the directory out of which you serve your
help documents.
The line resembles the following:
DocumentRoot /usr/lib/scohelp
Change this directory to the new name. For example, if you
want to serve documents from the directory /usr/local/documents,
you would add the following line:
DocumentRoot /usr/local/documents
Save the file and exit.
Open access.conf.
Find the following line:
<Directory /usr/lib/scohelp>
Replace this directory pathname with the one used
by DocumentRoot in srm.conf.
In the above example, this line would be the following:
<Directory /usr/local/documents>
Save the file and exit.
Change directories to /usr/lib/X11/app-defaults.
Open ScoHelp and search for the following line:
*homeDocument: http://localhost/dochome
Change *homeDocument to reflect your new homepage.
For example, if your new homepage file is called
myhome.html, the line would look like this.
*homeDocument: http://localhost/myhome.html
NOTE:
If you change the homeDocument resource and still want access
to the Help library (/usr/lib/scohelp/dochome.html)
on your homepage,
make sure you create a hyperlink to dochome.html
on your new homepage (there are also links to the library
on the Navigate menu and the toolbar).
Save the file and exit.
Start and stop the help server (scohttp)
by issuing the commands:
scohttp stop scohttp start
To test your configuration, issue
the command:
scohelp
SCOhelp should start with your new
homepage displayed in the SCOhelp window.
See also:
scohelp(XC)
Chapter 3, ``Writing HTML documents'' in Using Help