Enabling and Disabling Multiple Folder Insertion in a DITA Map
When you are editing a DITA Map or BookMap, Arbortext Editor enables you to drag and drop a file system folder hierarchy from either the Resource Manager browser or Windows Explorer into a DITA map and to maintain the structure of the folder hierarchy in the references added to the map. If you do not want users to be able to insert a folder hierarchy into a DITA map, you can use the .dcf file to disable this capability. You can also use the .dcf file to control the DITA map element to which the folders are converted. When you disable this feature, folders can still be dragged and dropped into a DITA map. In this case, the documents in the folder are entered into the DITA map as references and any sub-folders are ignored.
To disable multiple folder insertion in a DITA map:
1. Open Arbortext Architect.
2. Choose > .
3. Locate the directory in which the document type whose .dcf file you want to modify is saved, and click Select.
4. Once the document type is loaded, choose > . If the document type has a .dcf file, it displays in the Arbortext ArchitectDCF Editor window. If there is no .dcf file associated with this document type, Arbortext Architect automatically creates one.
5. Locate the Options element in the DCF Editor. If the file doesn't include an Options element, add one.
|
|
Open the Document Type Viewer ( > ) to view the element hierarchy for the .dcf file. This will help you determine the valid location for the Options element.
|
6. Inside of the Options element, locate the DitaOptions element. If the file doesn't include a DitaOptions element, add one.
7. Click next to the DitaOptions element to open the Modify Attributes dialog box.
|
|
You must have the Force Required Attributes EntryEdit preference selected for this dialog box to open automatically. |
8. Enter off in the dragAndDropElementList field to disable multiple folder insertion in a DITA map for this document type. You can also delete the attribute to disable multiple folder insertion.
To enable multiple folder insertion in a DITA map, enter either one or more DITA map elements (separated by commas) to which the folders in the hierarchy should be converted. Files inside of the folders are generally entered into the map as topic references (topicref). The default dragAndDropElementList setting for the DITA document types distributed with Arbortext Editor is topichead.
Note that the actual element inserted into a map depends on several factors including the valid elements at the insertion point, the current selection in the Resource ManagerTopic tab's Insert option (if the Resource Manager is open), and the list of elements in the dragAndDropElementList setting. The dragAndDropElementList setting is used, if possible.
9. Click OK.
10. Choose > to save the changes you have made to the .dcf file.
