Created attachment 197368 [details] Current look of the "optional" decoration Look at e.g. https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1drawing_1_1DrawingDocumentDrawView.html#adc47d84dd41ceb0dafa93d47634c2ba4, which is a documentation for DrawingDocumentDrawView Service, at the place where its optional XWindow interface is described. Note that the "optional" decoration is placed at the farthest right of the web page. If your browser is wide enough, it is easily out of one's attention. This is one of a few means used in our documentation pages to define the optionality (the other being the kind of arrows connecting pieces on the graph); and in fact, it is very poorly discoverable to users. An example: [1]. The better placement is needed, e.g. immediately following the declaration, where it would be readily visible and discoverable. There are other decorations possible there, e.g. "property", "readonly", some of which are also present on that page. All of them need to be more discoverable, and their far-right-wing position is not optimal. I hope that this is somehow configurable using CSS or the like? [1] https://ask.libreoffice.org/t/attempt-at-steering-one-program-from-another/113376
https://www.doxygen.nl/manual/customize.html#minor_tweaks_header_css To tweak things like fonts or colors, margins, or other look & feel aspects of the HTML output in detail, you can create a different cascading style sheet. You can also let Doxygen use a custom header and footer for each HTML page it generates, for instance to make the output conform to the style used on the rest of your web site. To do this first run Doxygen as follows: doxygen -w html header.html footer.html customdoxygen.css This will create 3 files: header.html is a HTML fragment which Doxygen normally uses to start a HTML page. Note that the fragment ends with a body tag and that is contains a couple of commands of the form $word. These will be replaced by Doxygen on the fly. footer.html is a HTML fragment which Doxygen normally uses to end a HTML page. Also here special commands can be used. This file contain the link to www.doxygen.org and the body and html end tags. customdoxygen.css is the default cascading style sheet used by Doxygen. It is recommended only to look into this file and overrule some settings you like by putting them in a separate stylesheets and referencing those extra files via HTML_EXTRA_STYLESHEET. You should edit these files and then reference them from the configuration file. HTML_HEADER = header.html HTML_FOOTER = footer.html HTML_EXTRA_STYLESHEET = my_customdoxygen.css
Looks like this could be solved by changing td.mlabels-left to have max-width: 100%; instead of width: 100%;
Ilmari Lauhakangas committed a patch related to this issue. It has been pushed to "master": https://git.libreoffice.org/core/commit/b1fedaf2c150411a50cca5ba23033d3e0c3c42a6 tdf#163746 ODK API docs: place "optional" and "property" decorations It will be available in 26.2.0. The patch should be included in the daily builds available at https://dev-builds.libreoffice.org/daily/ in the next 24-48 hours. More information about daily builds can be found at: https://wiki.documentfoundation.org/Testing_Daily_Builds Affected users are encouraged to test the fix and report feedback.
Ilmari Lauhakangas committed a patch related to this issue. It has been pushed to "libreoffice-25-8": https://git.libreoffice.org/core/commit/b97e9372289c9418febd945951a39703c34be13f tdf#163746 ODK API docs: place "optional" and "property" decorations It will be available in 25.8.0.0.beta2. The patch should be included in the daily builds available at https://dev-builds.libreoffice.org/daily/ in the next 24-48 hours. More information about daily builds can be found at: https://wiki.documentfoundation.org/Testing_Daily_Builds Affected users are encouraged to test the fix and report feedback.