Structural specialization

Follow this workflow for structural specialization:

1. Create a .mod file with definitions of specialized elements. For more information, see Modify DTDs for structural specialization.

2. Integrate the .mod file with the existing DITA DTDs. For more information, see Modify DTDs for structural specialization.

   Note:

   To make your specialized elements types work with the existing <topic> hierarchies, add your specialization to ditabase.dtd. Alternatively, you can create a separate DTD. For <map> specialization, modify and use map.dtd or bookmap.dtd

3. Copy the mod file at $StructDir\xml\DITA_1.2\app\base\dtd.

4. In FrameMaker®, click DITA > DITA Specialization.... The DITA specialization dialog box appears.

   DITA Specialization dialog box
   

   

   
   

5. Specify the path of the source files and a public ID:

   Field	Value
   Read/Write rules	$StructDir\xml\DITA_1.2\app\technicalContent\rules\<topic.rules.txt>
   EDD	$StructDir\xml\DITA_1.2\app\technicalContent\edd\<topic.edd.fm>
   Template	$StructDir\xml\DITA_1.2\app\technicalContent\template\<topic.template.fm>
   Public ID	A public ID for the generated files. Note: If you do not enter a Public ID, the XML files created from these specialized files are not portable to other systems. The XML files contain the absolute path of the DTD that is not available on other systems.
   Specialized DTD	$StructDir\xml\DITA_1.2\app\technicalContent\dtd\<ditabase.dtd> (or the base dtd file you have integrated the .mod file with)

6. Specify the output destination folder and filenames:

   Field	Value
   Destination Folder	Path of the folder containing the output files for specialization
   Read\Write Rules	Name of the read\write rules file
   EDD	Name of the EDD file
   Template	Name of the FrameMaker template

   Note: Enter file names with the appropriate filename extensions. Adobe® FrameMaker® creates the output files with the filenames and extensions you specify. Entering incorrect file extensions leads to file association issues.

7. Select Create New Structured Application when files are created check box and click OK.

   Note: The ditafm.ini file specifies the default DITA version as 1.2 (DitaVersion=1.2). If you want to map your specialization DITA application to DITA 1.1, change DITA version after selecting DITA > DITA options... and restart FrameMaker.

8. You are prompted to select a structured application. Select an existing structured application from which you want to derive the Doctypes and Entity Locations (Public IDs) and click Continue. The Structured Application Designer dialog box appears.

9. Edit the structured application name and, if necessary, other application settings and click Save. Your structured application is now created.

10. Select StructureTools > Edit Application Definitions.

11. Select StructureTools > Read Application Definitions.

Start authoring.