Networking Guide
Chapter 20, Making documents available to the network

Using a homepage to serve documents to a local network

Using a homepage to serve documents to a local network

To serve documents to a local network (assuming you have already created them) you must: 

  1. Create a homepage.

  2. 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:

  1. Log in as root.

  2. 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.

  3. Change directories to /var/scohttpd/conf.

  4. Open srm.conf.

  5. 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
    

  6. 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
    

  7. Save the file and exit.

  8. Open access.conf.

  9. Find the following line:
       <Directory /usr/lib/scohelp>
    

  10. 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>
    

  11. Save the file and exit.

  12. Change directories to /usr/lib/X11/app-defaults.

  13. 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).

  14. Save the file and exit.

  15. Start and stop the help server (scohttp) by issuing the commands:

    scohttp stop
    scohttp start

  16. To test your configuration, issue the command:

    scohelp

    SCOhelp should start with your new homepage displayed in the SCOhelp window.

See also: