Domain specialization

Follow this workflow for domain specialization:

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

  2. Create a .ent file with the entities for the specialized domain. For more information, see Modify DTDs for domain specialization.

  3. Integrate the .mod and .ent files with the existing DITA DTDs in ditabase.dtd. For more information, see Modify DTDs for domain 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.
  4. Copy the .mod and .ent files at $StructDir\xml\DITA_1.2\app\base\dtd.

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

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

  7. 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.
  8. 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....
  9. 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.

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

  11. Select StructureTools > Edit Application Definitions.

  12. Select StructureTools > Read Application Definitions.

Start authoring.


September 29, 2022

Legal Notices | Online Privacy Policy