How to convert an Aleppo help project to a CS help project

1. Invoke the converter specifying an Aleppo project file: alp2csh AleppoProjectFile.alp

1. Open the generated XML project file AleppoProjectFile.alp.xml—it is located in the same directory as the old Aleppo project file.

2. Enter the help file's UID between the <helpfileUID> tags in the CS Help project file. This field is missing because there is no UID associated with an Aleppo project file.

An XML project file AleppoHelp.alp.xml generated from an Aleppo project file is shown below:

<?xml version="1.0"?>
<!DOCTYPE cshproj PUBLIC "/EPOC32/tools/cshlpcmp/dtd/CSHproj.dtd" "SYSTEM">
<?xml:stylesheet href="/EPOC32/tools/cshlpcmp/xsl/CSHproj.xsl" title="CS-Help project" type="text/xsl"?>
<cshproj>
  <helpfileUID><!--Insert UID here--></helpfileUID>
  <directories>
    <input>\aleppo\projdir\</input>
    <output>\aleppo\projdir\releases\</output>
    <graphics>\aleppo\projdir\</graphics>
    <working>\aleppo\projdir\temp\</working>
  </directories>
  <files>
    <source>
      <file>AleppoHelp</file>
    </source>
    <destination>AleppoHelp.hlp</destination>
    <customization>\aleppo\projdir\uk.alc</customization>
  </files>
</cshproj>

1. Replace the old Aleppo word template with the cshelp.dot template. Alternatively, simply cut the entire Aleppo rtf file and past it into a file generated using the new template.

2. Select Style Check from the EPOC menu to remove any Aleppo styles which are no longer supported. The hypertext anchor style does not exist in CS Help and needs to be removed.

3. Add a UID for the help file (Category UID) style.

How to configure a rtf source file

The generated XML customisation file uk.alc.xml does not need any extra configuration.

The order file is not converted—it is not possible to specify topic order in CS Help.