1.1. "Document Set" menu

You may need to enable this submenu by checking "Enable the 'File|Document Set' Submenu" in OptionsPreferences, General|Features section.

Open Document Set

Select a file specifying a document set. Displays standard file chooser dialog box or advanced URL chooser dialog box depending on the state of the "Use the URL Chooser" checkbox.

After the specification file is selected, XXE displays the "Document Set" tool in order to let the user interact with this document set.

If the selected file is a DITA map then the members of the document set are the topics referenced in this map.

If the selected file is a master DocBook document (for example a modular book including a number of chapters, each chapter being found in its own XML file) then the members of the document set are the DocBook documents included in this master document.

In all other cases, the content of the selected file is not analyzed by XXE. Instead, the selected file specifies a directory and a filename extension. For example, selecting file file:/home/john/site/buy.html specifies the "file:/home/john/site/*.html" glob pattern[7]. In this example, the members of the document set are all the files found in directory file:/home/john/site/ having an "html" extension.

A glob pattern is the simplest possible specification for a document set. It is generally useful when editing the XHTML pages composing a web site. See also ".uri_list" files, another simple way to specify document sets for a simple generalisation of such glob patterns.

Tip

Shift-clicking on the "Open Document Set" menu item forces XXE to open the simplest possible document set, that is, the document set specified by a glob pattern. For example, if the selected document set is file:/home/john/docs/doc.xml, a master DocBook book, Shift+click will open the simpler document set specified by "file:/home/john/docs/*.xml".

Below the above menu item, a menu item is added for the last nine document sets which have been opened in XXE. Selecting such menu item:

Tip

Shift-click on a menu item to open the glob pattern corresponding to selected document set. For example, if the selected document set is file:/home/john/docs/doc.xml, a master DocBook book, Shift-click will open the simpler document set specified by "file:/home/john/docs/*.xml".



[7] It's called a glob pattern because UNIX-style wildcards which are used here. UNIX-style wildcards are more powerful than their MS-DOS/Windows counterparts. For example, when MS-DOS/Windows limits you to specifying "*.html", you can specify the "*.*htm*" glob pattern to match the files having htm, html, shtml or xhtml extensions.