Documentation Center

Configuring the XML editor to use other S1000D schemas

Contenta S1000D delivers schemas for S1000D Issues such as 1.6, 1.7, 1.8, 1.8.1, 1.9, 2.0, 2.1, 2.2, 2.3, 3.0, 4.0, 4.1, 4.2, and 5.0, and provides mechanisms to configure Arbortext Editor or Oxygen XML Author or to use those schemas. This task explains how you can configure the editor 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 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 the relative file path of the schema to the XML editor. The editor 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. Use one of the following methods to configure the editor to find the newly created catalog file.
    Add the catalog file path to the Catalogs entry under the editor's Preferences "File Locations": In the 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.
    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 Editor_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 XML editor installation that might cause it to be deleted.
    4. Save the catalog file and exit.