Generic GUI component element
Anders Svensson <anders.svensson <at> paligo.se>
2016-02-04 13:50:50 GMT
I'm wondering what would be the recommended best practice for a GUI component element in DocBook?
I know there are a number of different elements for GUI components, like guilabel, guiicon, guibutton, etc. The problem is, it's too specific. In most cases I see there is a wish to mark up GUI components to tag them semantically, but usually just one generic GUI component element rather than specifying exactly what kind of GUI component.
But I'm having trouble finding such an element, and I suspect there just isn't one. In the use cases I'm referring to it will be considered too laborious to have to specify exactly if it is a button or an icon, etc.
So what would be the recommended practice for marking up any kind of GUI element, whether a button, icon or whatever? The best I can think of is if you still don't need the specific variants is to select "guilabel" as the most generically named one, and probably the one there is the least use for even if you were to use it in its specific meaning.
Is that a good idea or does anyone have any other suggestions? (Apart from something like a phrase with role="guicomponent" or the like, which I know would always be a generic option)
Anders Svensson | Paligo AB | anders.svensson <at> paligo.se
Sankt Eriksgatan 117 | 113 43 Stockholm | Phone: +46 70 815 99 02