The DAPS tool helps you author and publish documentation written in DocBook XML. This extension makes it easier to run selected DAPS commands from the VSCode editor.
This extension requires that you...
See our issue tracker at openSUSE/vscode-daps/issues.
The following sections illustrate how to use the
Making it quicker with options
If you work on a project and use the same DC file, target format, or root ID
over and over, you can specify this information in the
Formatting an XML document
To format the currently opened active XML document, right-click its tab and
TIP: Use the predefined
To format any XML document from the Explorer view, right-click its name in
Explorer and select
Validating an XML document
You can validate a document specified by its DC file. Right-click the DC file in
the Explorer view and select
Or, you can specify the DC file manually from a drop-down list. Verify that the
Explorer shows a documentation project, then press
Building PDF and HTML versions with a DC file
To build a document specified by its DC file, right-click the DC file in the
Explorer view and select
If you prefer typing to mouse movements, you can run the build command from the
Command Palette. Press
TIP: After the build is finished, you can directly open the resulting document or copy its path to a clipboard.
Building PDF and HTML versions by root ID
Besides building a whole book, you can build only a part of it, for example, a
chapter or a topic. To achieve this, you need to specify a top-level element
root ID. Press
IMPORTANT: Populating the list of root IDs can take a few seconds.
Alternatively, you can select the root ID with the mouse in your active editor
and right-click the selection. Then select
Building PDF and HTML versions of an XML file
To build the currently active XML document, right-click its editor tab and
To build any XML file, right-click its name in the explorer view and select
To preview a DocBook XML file, right-click its editor tab ans select
You can view a document structure treeview inside the Explorer pane. Navigate to a related section by clicking its title in the structure.
With the DocBook assembly XML (