Documentation Center

Configuring Arbortext Editor to use other S1000D schemas

SDL Contenta S1000D delivers schemas for major S1000D Issues such as 2.2, 2.3, 3.0, 4.0, 4.1, and 4.2 and provides mechanisms to configure Arbortext Editor to use those schemas. This task explains how you can configure Arbortext to use other S1000D schemas, for example, schemas for minor S1000D Issues such as 3.0.1 or 4.0.1.

About this task

If the schemas that you require are not delivered with SDL Contenta S1000D in the Contenta_home/S1000D_samples/schemas directory, the following procedure explains one way to add them to your environment.

Procedure

  1. Download the desired S1000D schemas from the s1000d.org web site to a safe location on the client.
    For example, download the 3.0.1 schemas to the following directory: C:/S1000D/schemas/3.0.1
  2. Create a catalog file in the schema revision's parent folder, in this example, 3.0.1.
    The contents of the catalog file must include one identifying record for each schema. The record specifies to Arbortext the relative file path of the schema. Arbortext matches the value of the xsi:noNamespaceSchemaLocation attribute in the root element of the document being edited to the identifier in quotes immediately after "URI". Then it uses the corresponding relative path to locate the schema and parse the document.
    Sample record: URI "http://www.s1000d.org/S1000D_3-0-1/xml_schema_flat/crew.xsd" "./xml_schema_flat/crew.xsd"
  3. Configure Arbortext so that it can find the new catalog file you just created. There are several ways to do this. Steps 4 and 5 describe two options. Choose only one option, i.e., perform either step 4 or step 5 but not both.
  4. Add the path to your catalog file to the Catalogs entry under Arbortext Preferences "File Locations": In Arbortext Editor do the following:
    1. Select Tools > Preferences.
    2. In the Preferences dialog, click File Locations.
    3. Click in the Catalogs field and go to the end of the field.
    4. If there is not a semicolon (;) add one.
    5. Enter the path to the directory that contains the catalog file you just created, which in this example is: C:\S1000D\schemas\3.0.1
    6. Click OK.
  5. Alternatively, create or modify a secondary catalog file in order to reference the primary catalog file that you created in step 2:
    1. Navigate to the Arbortext_home/custom/doctypes directory.
    2. Create a file named catalog if this file does not already exist. Open the catalog file for editing.
    3. Add one record to this catalog file to specify the location of the primary catalog file.

      For example: CATALOG "C:/S1000D/schemas/3.0.1/catalog"

      Using this two-file approach protects the primary catalog file from changes to your Arbortext installation that might cause it to be deleted.
    4. Save the catalog file and exit.