Understanding multi-level libraries
Multi-level libraries allow documentation organizations to organize their content libraries in layers so that they match the product architecture.
Multi-level libraries are useful in deployments whose libraries contain a very large number of topics. To help manage library items, a library is split into smaller libraries that are organized hierarchically.
Libraries are organized hierarchically in layers, where each layer is associated with a level ID. The level ID indicates at which architecture layer the library is set.
The top-most layer is the level 1 layer. In the sample library structure above, there are two layers: The top layer, Error messages, is at level 1, while the Windows and Linux libraries are at level 2. Lower-level libraries are called child libraries, upper-level libraries are called parent libraries, while libraries that are at the same level are called sibling libraries.
A library inherits content from its child libraries. For example, products that reference the Error messages library will be able to access all the content in the Windows and Linux libraries. However, a library cannot access objects from its parent or sibling libraries; in the example above, products who reference the Windows library only cannot access content that is in the Error messages or Linux library.
Note: Please contact your IXIASOFT DITA specialist before implementing multi-level
libraries in your deployment, as they increase complexity. Multi-level
libraries must be planned carefully. |
More detailed example: IXIA CCMS Web
The following diagram shows a more detailed implementation of multi-level libraries, using CCMS Web as an example.
The DRM product that references a library is always considered to be layer 0. In this example, the Web product references the Web library, which is at the Product Library layer. The Web library uses the Glassfish and Tomcat libraries, which are at the Third-Party Library layer. Each of these libraries uses the Windows and Linux libraries, which are at the Operating System Library layer.
Layer level | Name | Examples |
---|---|---|
3 | Product Library | TEXTML Server |
6 | Third Party Library | Tomcat, Glassfish, Java, oXygen |
9 | Operating System Library | Windows, Linux, Mac OS |
There is no maximum number of levels. However, try to keep the number of levels to a manageable number to reduce the complexity. |