Single Source                 16/4/2004

Thank you for trying Single Source.  We are sure you will find it an easy way to 'single-source' your documentation. This means you only need to maintain a single Word document to create the same publication in three formats: paper, Windows Help, and HTML.

You will find full instructions in two files in the Help sub-directory: SingleSource.hlp which is in Windows Help format, and SingleSource.doc, which you can print out from Microsoft Word.

INSTALLATION

The following software is required to use Single Source:

 Microsoft Word to create documents and run conversion macros. 
 Microsoft Help Workshop to compile Rtf files into Help. If you do not already have this on your system, you can download it from the internet as follows:
  1. Go to the Microsoft web site at www.microsoft.com.
  2. In the Search Microsoft.com box in the top-right corner, enter hcwsetup.exe and click Go.
This should return a list of locations from which you can download and install the workshop.

Single Source Files

Single Source comprises the following files:

 SingleSourceUnreg.dot, which contains the commands needed to process documents.
 Paper.dot, the template for your paper documentation. 
 WindowsHelp.dot, the template for Help RTF files (only used behind-the-scenes).
 SingleSource.doc, the paper documentation for Single Source.
 ExampleGuide.doc, an illustration of the layout you should use for a user's guide to an
  application.
 SingleSource.hlp, the Help documentation for Single Source.
 Standard HPJ, a template Help Project File used to compile Help from RTF files.

Installing the Templates

Copy the three template (.dot) files to your User Templates directory as follows:

1. In Microsoft Word, from the Tools menu, choose Options. This option is only available if you have a document open, so you may need to click the New Blank Document toolbar button first.
2. In the Options dialog, select the File Locations tab.
3. Click the User Templates entry in the list.
4. Click the Modify button.
5. Use Windows Explorer to drag and drop the template files to the Modify Location window.
6. Click OK to close the Modify Location window.

Installing the Application

If you don't want Single Source to be automatically activated each time you start Word, do the following:

1. Open MS Word.
2. From the Tools menu, choose the Templates and Add-Ins option.
   The Templates and Add-Ins dialog is displayed:
3. Click the Add button.
4. Locate and add the SingleSourceUnreg.dot template.
   In the list on the left, an entry for SingleSourceUnreg will be displayed and checked.
5. To activate Single Source in a new Word session, open the Templates and Add-Ins dialog and
   tick the SingleSourceUnreg entry.
   
Alternatively, if you do want it to be automatically activated each time you start Word, copy the SingleSourceUnreg.dot file to the Startup directory for Word.  To find out where this directory is, click Options on the Tool menu, then click the File Locations tab. 

To display the help for Single Source, double-click on the help file as it appears in Windows Explorer or My Computer.

COPYRIGHT NOTICE and DISCLAIMER

Copyright Notice

All contents of the Single Source package are Copyright  2004 Julian Wood, All Rights
Reserved.  Copying and distribution of this product is strictly prohibited.

Disclaimer of Warranty and Liability

Use of Single Source indicates acceptance of the following, in which the Software refers to
Single Source.

No Warranties

The author of the Software expressly disclaims any warranty for the Software. The Software
and any related documentation is provided "as is" without warranty of any kind, either express or implied, including, without limitation, the implied warranties or merchantability, fitness for a particular purpose, or non-infringement. The entire risk arising out of use or
performance of the Software remains with you.

No Liability for Damages

In no event shall the author of the Software be liable for any damages whatsoever arising out
of the use of or inability to use this product, even if the author of the Software has been
advised of the possibility of such damages.
