Assemblies: Effectivity attributes on module and structure?
Thomas Schraitle <[email protected]> Sun, 29 Oct 2023 14:32:26 +0100
| Newsgroups | gmane.text.docbook.misc |
|---|---|
| Message-ID | <[email protected]> |
Hi, Since DocBook 5.1, we can write topic oriented documentation with assembli= es. We use it for some time now in our Smart Docs approach at https://github.com/SUSE/doc-modular and it works for us. I'm wondering now about those "effectivity attributes"[1] like os, arch, e= tc. in a <structure> or <module>. For example, consider the following <module>: <module resourceref=3D"..." os=3D"linux"/> If I call the assemble.xsl stylesheet on my assembly file, the "os" attrib= ute is NOT carried over into the result structure. Was this on purpose or is i= t a bug? I assumed, the effectivity attributes on <module> and <structure> can be u= sed to _overwrite_ attributes from the referenced resource. Is my assumption correct? If this is not the case, why allow them at all in the schema? :) We had a similar issue[2] with xml:lang, although this might be a special = case. So how are the effectivity attributes suppose to work in an assembly file = when they are not included in the result? Many thanks! =2D---- Reference [1] https://tdg.docbook.org/tdg/5.2/ref-elements#common.effectivity.attrib= utes [2] GH docbook/xslt10-stylesheets#254 =2D- Gru=C3=9F/Regards Thomas Schraitle