Home Forums DITA and XMetaL Discussion adding an non existing element to xmetal Reply To: adding an non existing element to xmetal

Derek Read

Reply to: adding an non existing element to xmetal

If you wish to modify your DITA DTDs then the only proper way to do that is through specialization. The only supported way to make changes to the DITA DTDs is to specialize them (you should not make direct changes to the standard DITA DTDs).

Once you have created a valid specialized DITA DTD follow the instructions on setting up XMetaL Author Enterprise to use it in the Help. The topic is listed in the Help's Contents tab under Working with DITA > DITA Specializations.

Based on the questions you have asked on the forum I think you may wish to consult directly with someone familiar with specializing DITA before you proceed (you may also wish to brush up on XML in general as well as DITA specifically). Note that if you do plan to specialize DITA for use with XMetaL Author Enterprise you must specialize the DITA DTDs. XMetaL Author (as an editor for all types of XML content) fully supports XSDs but the customization provided for authoring DITA is designed to work only with the DITA DTDs and so specialization must be done on the DTDs.

To answer your last question (“so my doubt is we have to modify the schema in each and every case?”):
You should not be modifying the standard DITA DTDs at all. When you create a specialized DITA DTD you are creating a new DTD. It will reference large portions of the DITA DTDs (essentially including them in itself) and then make additions to it for your new elements.

I really question what you are doing…
I think you should seriously consider that you may have some wrong ideas about what you want to do and how to use Teamcenter together with XMetaL. Please consult with the support people for Teamcenter as there is no need to modify DITA in any way in order to support images (from the XMetaL Author Enterprise side). DITA has an element and XMetaL Author Enterprise is configured to render images referenced by that element.

If necessary, the Teamcenter support people should be able to help you configure and use their integration properly so that you can reference images located in the CMS. I believe their CMS integration with XMetaL Author Enterprise does not use our “XMetaL Connector” layer and so they may have special instructions for you that specifically tell you not to use the Insert > Image dialog in XMetaL when inserting images and there may be other standard features they do not support. For most CMS integrations (those that use our XMetaL Connector layer) when you select Insert > Image that dialog allows you to browse for images directly in the CMS (it is designed to know you have a CMS integration installed and not to browse the local file system). Once an image is selected all of the proper XML markup is automatically created in that case, including any translation from CMS references to local references as well as checking the image out and downloading it to your local file system's CMS temp folder so that XMetaL can render it. However, because of the special way the Teamcenter integration works you must follow their instructions exactly and ignore portions of our user interface that their integration does not support.