Publishing a Document for the Web

You can publish Arbortext Editor documents for viewing as a set of HTML documents in a web browser. By default, documents will be published as styled HTML files with features such as a Table of contents, document navigation buttons, searchable index terms, and an interface localized to a chosen language.

You can customize the appearance of your HTML documents by publishing with a custom stylesheet. You can alter the presentation of the HTML files in your browser by creating and choosing a custom frameset when publishing your document. Refer to the information on customizing framesets in the Administrator's Guide for detailed information on creating custom framesets.

• Web browsers interpret graphic width and depth attributes that are specified in pixels. If your document includes graphics, you must specify graphic width and depth attributes in pixels if you want these attributes set in the HTML output.

1. Create the document(s) you wish to compose for the Web. A document can be of any document type, including a DITA map file referencing topics, other published documents (such as PDF files), and other map files.

2. With your document open in Arbortext Editor, choose File > Publish > For Web. The Publish for Web dialog box opens.

3. Specify the location to which you want to publish the document in Output Directory.

If Queue Transaction is selected, Output Directory is not available.

4. Select View HTML if you want the document to display in a Web browser when publishing is complete.

If you select the View HTML option and your document file name includes an &, you will receive a message stating that Arbortext Editor cannot launch the viewer. Select Yes to publish with the viewer disabled, or No to cancel the publishing process.

5. Choose the stylesheet you want to use from the Stylesheet box. Click Browse to locate an existing stylesheet that does not appear in the list.

If you have previously composed 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, type pub_xalan::clear_stylesheets() on the Arbortext Editor command line.

If you are using Arbortext Publishing Engine, the list displays the stylesheets available from the Arbortext Publishing Engine server. The notation (pe) appears in the stylesheet name. Local stylesheets are ignored.

6. Choose the frameset you wish to apply to your document in the Frameset field.

If you are using Arbortext Publishing Engine, the list displays the framesets available from the Arbortext Publishing Engine server. The notation (pe) appears in the frameset name. Local framesets are ignored.

7. Choose the character encoding in which you want to publish your document from the Encoding list.

8. 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.

9. Choose the UI Language for buttons, tool tips, and other user interface components from the list.

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

If you are composing a DITA map, Changes Applied is selected by default. When composing 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 composed 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.

11. Choose whether to convert intelligent graphics to a web-friendly graphic format during composition by checking the Convert Intelligent Graphics. Intelligent graphics are not converted by default.

12. Choose whether to Queue Transaction. If Queue Transaction is checked, the values in Output Directory and View HTML are cleared. You will be prompted for the Output Directory and whether to View HTML when you retrieve the result from your list of Queued Transactions, available from the Tools menu.

If you entered values in Output Directory and View HTML, they will be displayed again if you clear the Queue Transaction check box. Queue Transaction behavior is controlled by a set of Arbortext Publishing Engine.

13. 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.

14. 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.

15. 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.

Arbortext Styler supports three different methods of including CSS information in HTML output. Refer to CSS files in HTML output for more information.