You can use Book Structure Viewer (BSV) to perform many global
operations on DITA and IBMIDDOC documents. Here's how to do some of them:
- To view the structure of a DITA document,
open its .ditamap or .maplist file. This gives you a tree view of all the
navigable files in the document. To expand or contract a branch of the tree,
click on a + or - symbol. Tip: Use the "Preferences --> Default File Open
type..." menu to specify the default file filter BSV uses when you browse to
open a new document. For example, if you mainly work with DITA files, you can
set the file filter to ".DITAMAP" or ".MAPLIST". If you mainly work with
IBMIDDOC files, you could set it to ".IDD".
To view a .dita file, click on its name in the tree view.
The "Search" menu and toolbar buttons provide all the usual search
operations. You can also go to a specific line number in a file.
- To view the structure of an IBMIDDOC
document, open its .IDD file. This gives you a tree view of the document's
embedded files. To expand or contract a branch of the tree, click on a + or -
symbol.
To view a .DITA, .IDE, .EPS, or .GIF file,
click on its name in the tree view.
Tip: Use the "Preferences -->
Graphics programs..." menu to specify your preferred file viewers for .EPS and
.GIF files.
- To run a fast, interactive, sequential global
search across all the files in your document, use the "Search -->
LFIND..." menu or the "Globe" button. To search using a regular expression,
check the "regular expression" checkbox.
- To run a fast, interactive, sequential global
search-and-replace across all the files in your document, use the "Search
--> LCHANGE..." menu or the "Lightning" button . (Readonly files are never
overwritten.) To use regular expression find and replace strings, check the
"regular expression" checkbox.
- To create and save multiple named configurations
(file paths), use the "Preferences --> Path to book files..." menu or
the "Swiss Army Knife" button . For example, you could create a configuration
named "My First Book" which sets the path to embedded files for My First Book,
and another configuration named "My Second Book", which sets the path to
embedded files for My Second Book. To switch between configurations, click on
the "Swiss Army Knife" button.
- To list all the IDs in your book, or in a
specific file, use the "IDs" menus . You can sort and filter the IDs in various
ways, display information about their contexts, and print or save the listings.
The IDs menu also allows you to check for duplicate IDs.
- To list all the cross-references in your book,
or in a specific file, use the "Xrefs" menus . Full information about each xref
is given -- e.g. the xrefid, the source file in which it occurs, the
element-type of the target (division, table, fig, etc.), the title or caption
of the target, and the target file.
The Xrefs menu also allows you to check for unresolved
cross-references.
- To list all the inter-book links in your book,
or in a specific file, use the "Links" menus . The following information about
each link is given: the link ID, the link text (IBMIDDOC), the source file in
which the link occurs, the element-type of the target (division, table, fig,
etc.), the title or caption of the target (DITA), and the target book.
The Links menu also allows you to check for inter-book links for
which the targets are unresolved (DITA) or undefined (IBMIDDOC).
- To remove all revision bars from your book, or
from a specific file; or to "flatten" all revision attributes to a single
value, use the "Revbars" menus. You can also list the revbar IDs in a book, and
the files in which specific IDs occur, filtering the lists by revbar ID and/or
file-type (ALL, RO, RW). You can selectively remove or flatten revbars.
- To display the trademark markup in your book, use the
"Trademarks" menu. You can also remove all trademark tagging from an entire
document.
- Use the 3 "tick" buttons to run "one-click" checks
for: