Publishing a Document Using XSL

You can publish documents using XSL stylesheets. XSL stylesheets apply structure transformations and formatting to XML documents. If a document contains graphics, their format is not changed in the output. The original graphic file format is kept and referenced in the output.

2. Specify a path and file name for the published output in the Save As box, or accept the default. Click Browse to locate an existing file.

If Queue Transaction is selected, Save As is not available.

3. Choose the stylesheet you wish to use when publishing your document from the Stylesheet list. Click Browse to locate an existing stylesheet that does not appear in the list.

If you have previously published with a stylesheet that includes or imports an XSL stylesheet that has been modified, you must clear the stylesheet from your cache for the changes to take effect. To do this, on the Arbortext Editor command line, enter:

clear_stylesheets()

If you are Using Arbortext Publishing Engine for Publishing Documents, the list displays the stylesheets available from the Arbortext PE server. The notation (pe) precedes the stylesheet name. Local stylesheets are ignored.

4. If you are publishing a DITA document that has an associated DITAVAL file, choose that file in the DITAVAL File list. Click Browse to locate an existing DITAVAL file that does not appear in the list.

5. If your document has change tracking, you can publish the document in any of the change tracking states. By default, the change tracking view from the Edit window is selected, except when publishing from a DITA map.

If you are publishing a DITA map, Changes Applied is selected by default. When publishing from a DITA Map, the Change Tracking view that's selected applies only to the topics referenced from the DITA maps. The DITA map itself, as well as other referenced maps, will always be published with Changes Applied, regardless of the Change Tracking view selected (even if a map has change tracking markup).

◦ Changes with Highlighting — Shows all proposed changes, highlighted with revision marks.

◦ Changes Applied — Shows all proposed changes incorporated into the document, without revision marks.

◦ Original — Shows the original document without proposed changes incorporated into the document.

6. Choose whether to Queue Transaction. If it’s checked, it clears the Save As value. Checking this box means you will be prompted for the Save As file name when you retrieve the result from your list of Queued Transactions, available from the Tools menu.

If you entered a value in Save As, it will be displayed again if you clear the Queue Transaction check box. Queue Transaction behavior is controlled by a set of Arbortext Publishing Engine preferences.

7. Choose whether to enter a Transaction Name. The transaction name will be displayed when you retrieve the result from your list of Queued Transactions, available from the Tools menu.

You can enter transaction names to use by default or for specific output types by entering values in the Queued Transaction Names Dialog Box.

8. If you want to apply profiling to your document, click Set Profiles to access the Set Profiles dialog box. Click OK or Cancel to exit the Set Profiles dialog box. The Set Profiles button is only available if profiles have been configured for the selected document type.

9. If you want to create a publishing rule, click Create Rule to open Create New Publishing Rule, where you can create a new publishing rule or rule set.

10. Click OK to begin publishing. A task bar message indicates publishing progress as well as when publishing is complete.