<oXygen/> comes with DocBook DTDs, XML catalog, XSL stylesheets and document templates so that one can start creating DocBook documents right away. The articles from our site are written using DocBook and their sources are available for download. You can use them as samples to start with! DocBook documents can be converted to HTML, PDF or PostScript and supports intelligent XML editing, validation, content completion.
<oXygen/> offers support for DocBook conditional text processing: profiling attributes can be easily managed to filter content in the published output. You can toggle between different profile sets to see directly in the Author what will be included in the output.
Conditional text is a way to mark blocks of text meant to appear in some renditions of the document, but not in others. For instance you can mark a section of a document to be included in the manual designated for the 'expert' users, other for the 'novice' users manual while unmarked sections are included in any rendition.
You can use conditional text when you develop documentation for:
With <oXygen/> DocBook Editor you can define values for the DocBook profiling attributes. The profiling configuration can be shared between content authors through the project file. There is no need for coding or editing configuration files.
<oXygen/> allows you to aggregate a set of profiling conditions (attributes and their values) as Profiling Condition Sets. Using a Profiling Condition Set you can preview in the Author editing mode the text sections that will go into the published output.
The excluded text is grayed-out. The profiling attributes visibility was turned on for clarity.
To mark text for inclusion or exclusion, you can modify the profiling attributes of the parent element, using the contextual action "Edit Profiling Attributes":
Change Tracking is a way to keep a history of the changes made to a document. When change tracking is enabled, the inserted and deleted content is highlighted in the document allowing you to easily identify the affected regions. Also, tracked changes can be rendered in callouts (balloons) displayed at the side of the document, with connecting lines pointing to the changed content.
<oXygen/> supports changes from multiple authors, rendering each author changes with different colors.
For each change <oXygen/> stores the author and the date when that change was performed. The name of the author who is currently making changes and the colors can be customized from the Track Changes preferences page. It is possible to add comments to the changes.
In the screenshot you can see how various insert/delete changes made by various authors are displayed (the option to display changes as balloons is on).
You can review the changes made by you or other authors and then accept or reject them using the Track Changes toolbar buttons or by using the change management dialog.
When you annotate your XML documents, the comments are displayed in the Author view as side callouts (balloons) showing also additional information like the author and the comment time.
The comment support is not limited to a document type (DocBook or DITA for instance). You can use it on any document that is opened in the Author editing mode. The comment data is stored in the XML document as processing instructions, so it will not interfere with your XML tool chain.
You can access the comments actions from the application toolbar:
Styled content can be inserted by copying content from Office applications (Microsoft Word and Microsoft Excel, OpenOffice.org Writer and OpenOffice.org Calc) and Web browsers (Mozilla Firefox, Microsoft Internet Explorer) and pasting it in the DocBook editor. The styles and general layout of the copied content like: sections with headings, tables, list items, bold and italic text, hyperlinks, etc. are preserved by the paste operation as equivalent DocBook XML elements.
You can select multiple text ranges (discontinuous selection) or multiple elements in the Author page and cut/copy/paste them.
<oXygen/> is able to recognize the DocBook documents based either on the root element name or namespace. When you switch to the Author mode, the editor loads both the set of CSS files and the available actions that were associated in the DocBook configuration.
The action set include operations for emphasising text, creating lists, tables, sections and paragraphs.
More than this, you can create your own operations for inserting or deleting XML document fragments.
You can create CALS or HTML tables, join or split cells, add or remove rows easily. <oXygen/> will create all the column specifications for you.
A CALS table example. The caret is positioned between two cells.
<oXygen/> can manage table width and column width specifications from the source document both in fixed and proportional dimensions. The tables and columns widths can be visually adjusted by dragging with the mouse their edges.
A HTML table example. The column widths are adjusted.
By allowing to select entire rows and columns <oXygen/> you can easily copy or move table data using copy/paste and drag and drop operations.
There are available templates for creating DocBook documents with MathML support. The MathML equations included in DocBook documents are rendered in the PDF and XHTML output of the DocBook transformations.
See below an equation edited in the <oXygen/> built-in MathML editor. Features include:
The MathFlow editor (one of Structure Editor, Style Editor, Simple Editor) is presented when you have a licensed installation of the MathFlow SDK on your computer and configured in oXygen. The Structure Editor targets professional XML workflow users. Such users need fine control over visual presentation, as well as its underlying MathML structure. It is the best choice for demanding publishing workflow applications. The Style Editor is tailored to the needs of content authors, while the Simple Editor is designed for applications where end-users can enter mathematical equations without prior training, and only the meaning of the math matters.
An equation edited with the MathFlow Structure Editor:
You can edit the DocBook files using the text/source editing mode of <oXygen/> XML Editor. The "as you type" validation and the powerful content completion are always on your side.
You can control what elements are displayed in the Outline view by typing element names into a filter box. For example, entering the element name "figure" when editing a DocBook article results in getting immediately a short summary of all the figures from your document.
The next image shows the filtered outliner as a tree. There are presented only the elements that are parents or children of the selected elements. The selected elements are boldfaced.
A new module file was added in the DocBook DTD distribution adding XInclude support to the DocBook DTD. There are also document templates (New from templates action) that allows easy creation of a DocBook document with XInclude support. An XInclude sample is provided.
<oXygen/> adds by default a root catalog that refers the built-in catalogs for DocBook documents. These are located in the frameworks/docbook subdirectory of the installation directory.
Before transforming the current edited XML document in <oXygen/> one must define a transformation scenario to apply to that document. A scenario is a set of values for various parameters defining a transformation.
<oXygen/> has two predefined scenarios for DocBook, one using the XSLs for FO-PDF output and the other using the stylesheets for HTML. These scenarios can be reused for any DocBook document. If the predefined settings are not exactly what you need you can easily change them.
The Apache FOP is bundled inside <oXygen/> and it does not require any special configuration. Thus you can convert DocBook to PDF just by selecting a scenario and pressing a button.
Each <oXygen/> XML Editor release bundles the latest DocBook schemas and XSL stylesheets. At this time, both DocBook 4 and DocBook5 are included.