[DOXIASITETOOLS-253] Clarify "border", "width" and "height" for Banner and LinkItem

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 2.0.0-M12
• Component/s: Site model
• Assignee: Michael Osipov
• Reporter: Konrad Windszus
• Created: 06/May/22 09:45
• Updated: 01/Oct/23 19:17
• Resolved: 01/Oct/23 17:52

Description

The elements "border", "width" and "height" in

1. https://maven.apache.org/doxia/doxia-sitetools-archives/doxia-sitetools-1.11.1/doxia-decoration-model/decoration.html#class_bannerLeft
2. https://maven.apache.org/doxia/doxia-sitetools-archives/doxia-sitetools-1.11.1/doxia-decoration-model/decoration.html#class_bannerRight
3. https://maven.apache.org/doxia/doxia-sitetools-archives/doxia-sitetools-1.11.1/doxia-decoration-model/decoration.html#class_item

have a very vague description (same in renamed doxia-site-model https://maven.apache.org/doxia/doxia-sitetools/doxia-site-model/site.html ).

It should be clarified with regards to whether
1. this is the format of the same named CSS properties (https://www.w3.org/TR/CSS2/box.html#border-properties, https://www.w3.org/TR/CSS2/visudet.html#the-width-property and https://www.w3.org/TR/CSS2/visudet.html#the-height-property)
2. or the HTML4 attributes (https://www.w3.org/TR/html401/struct/objects.html#h-13.7.1 and https://www.w3.org/TR/html401/struct/objects.html#h-13.7.3)
3. or another custom format.

Currently the skins use the values as-is for either CSS property or HTML attribute, but although they are named the same, the supported values differ a lot.

This came up in the context of https://github.com/apache/maven-fluido-skin/pull/23#discussion_r866169720.

Issue Links

• is a child of: DOXIASITETOOLS-254 Clarify inconsistencies in Doxia site model
• Is contained by: DOXIASITETOOLS-311 Rework and simplify the site model
• relates to: DOXIASITETOOLS-54 site.xml should also have <title> attribute for all elements that have <alt> attributes
• relates to: MSKINS-169 Image height not effective
• relates to: DOXIASITETOOLS-31 Allow images in the menu items of the site.xml