Respec template van Logius vereist figcaption in catalogus.

[wilkoquak]

Momenteel ben ik bezig met een catalogus te maken met Imvertor in de nieuwe Respec omgeving van Logius. (https://github.com/Logius-standaarden/ReSpec-template). Hiermee heb ik een dataspec gemaakt en als ik dan naar de list of figures kijk zie ik geen captions voor de figures die door Imvertor worden gemaakt (Zie: https://geonovum.github.io/dso-cim-template/#tof ). Zou bij het genereren van de catalogus een <figcaption> kunnen worden toegevoegd?

[ArjanLoeffen]

Wat je vraagt is feitelijk, als ik het goed begrijp, dat we een <figure> introduceren waar nu <img> is opgenomen:

https://www.w3schools.com/tags/tag_figcaption.asp

Dus waar het nu de vorm heeft:

<div class="imageinfo overview">
  <img src="" usemap="" alt="Diagram Overzicht van alle constructies in dit model voor bakstenen en hun producenten. " />
  <map name="">
     <area>...
     ....

wordt dit:

<div class="imageinfo overview">
  <figure>
    <img src="" usemap="" alt="Diagram Overzicht van alle constructies in dit model voor bakstenen en hun producenten. " />
    <figcaption>Diagram Overzicht van alle constructies in dit model voor bakstenen en hun producenten. </figcaption>
 </figure>
<map name="">
     <area>...
     ....

Ik weet niet hoe dit uitwerkt in het figures-overzicht van Respec, wanneer de complete caption daar wordt opgenomen.

Die caption wordt nu binnen EA geplaatst in de omschrijving (notes) van een diagram:

Graag je reactie.

[wilkoquak]

Ik zie het probleem. Helaas is de name die je aan het diagram geeft al in gebruik voor de titel van de paragraaf waarin het plaatje komt. Zou je die niet kunnen her-gebruiken? En dan zonder de '-overzicht' postfix. Het is een beetje dubbelop, maar het zou voor de list-of-figures wel het gewenste resultaat opleveren.

[Gtrouborst]

Langere bijschriften zijn op zich geen probleem: https://geonovum.github.io/MIM-Werkomgeving/#tof. De naam van het diagram zonder suffix - overzicht of - detail klinkt prima.

[ArjanLoeffen]

Het lijkt erop dat bij <figure> de figuur binnen de kolombreedte wordt gedwongen zonder de vertikale hoogte te herstellen. Dat moet dan in CSS kan worden aangepast.

Voorbeeld:

terwijl dit op de oude manier was:

[ArjanLoeffen]

In de owner parameters is de parameter diagram-encoding opgenomen; deze is niet verplicht.
Wanneer 'figure', dan wordt een <figure> element met caption ingevoegd.
De naam van de figure is de title zonder "- overzicht".

[ArjanLoeffen]

Beschikbaar op 15 aug.

[Gtrouborst]

Als ik dit test bij bestuurlijke gebieden gaat het nog niet helemaal goed, maar misschien komt het doordat ik de parameter nog niet correct heb opgenomen.

Geef ik de owner parameters aan in de properties file? Op deze manier: diagram-encodig = figure?

[ArjanLoeffen]

Nee dat is onderdeel van de owner. Dus geldt voor heel Geonovum. Ik kan die instellen zoals jullie willen.

…

-- Arjan vanaf mobiel Op di 15 aug. 2023 17:27 schreef Gtrouborst ***@***.***>:

Als ik dit test bij bestuurlijke gebieden gaat het nog niet helemaal goed, maar misschien komt het doordat ik de parameter nog niet correct heb opgenomen. Geef ik de owner parameters aan in de *properties file*? Op deze manier: diagram-encodig = figure? — Reply to this email directly, view it on GitHub <#326 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ADB34OPBBSEPBHQLA7FHRN3XVOIN5ANCNFSM6AAAAAAV4MM3PQ> . You are receiving this because you were assigned.Message ID: ***@***.***>

[Gtrouborst]

@wilkoquak en ik hebben hier vandaag nog even naar gekeken. Nu wordt <figcaption> samengesteld uit Diagram Name én Diagram Notes. Maar dat is teveel van het goede. De Diagram Notes gebruiken we graag voor een geschreven toelichting op een diagram. De teksten die we daar opnemen kunnen langer zijn dan prettig is als bijschrift voor een figuur. We zien die teksten wél graag terug in de documentatie, maar liever niet in de <figcaption>.

Voorstel

Graag zien wij het als volgt:

• Alleen Diagram Name in <figcaption>, zonder - detail of - overzicht
• De tekst in <figcaption> niet vetgedrukt maken (anders wijkt het af van de rest van het document)
• De tekst uit de Diagram Notes als losse tekst onder de figuur, dus na de closing tag </figure>) en met behoud van opmaak zoals die in EA is meegegeven.

[ArjanLoeffen]

Uitgevoerd.

[ArjanLoeffen]

17 aug beschikbaar.

[Gtrouborst]

Fijn, dankjewel Arjan!

[wilkoquak]

Er gebeuren nog wat onverwachte dingen... [let op de spaties]. Als de naam van een UML diagram op '-overzicht' eindig wordt dez wel geplaatst in de catalogus, maar de tekst onder het plaatje wordt niet geprint. Als de naam van een UML diagram eindigt op '- overzicht' gaat het plaatje ook naar de catalogus maar wordt de tekst wel geprint. Voor mij is het altijd de bedoeling dat de tekst geprint wordt. Verder zou het mooier zijn om in de figcaption de postfix (-overzicht, -detail, en alle varianten niet mee te nemen.

[PalmJanssen]

Voor de volledigheid. Als de naam eindigt op - detail wordt het diagram wel geplaatst maar wordt de tekst van het notes veld niet geprint. Dit was natuurlijk 'vroeger' wel zo, ook met de nightlyBuild.

[ArjanLoeffen]

Hersteld. Graag testen! De aanpassing geldt voor respec waarin figure elementen worden ingevoegd. Dat is op dit moment alleen het geval voor Geonovum, namelijk dmv de parameter:

<parameter name="diagram-encoding">figure</parameter>

onderdeel van /input/Geonovum/cfg/owners/Geonovum.xml

[ArjanLoeffen]

Beschikbaar in Nightly-build.10

[wilkoquak]

Dank! Ik zie dat (-overzicht) nog wel in de caption terechtkoment en (- overzicht) niet (een spatie verschil). Dat is nog niet helemaal logisch, zie in het screenshot hieronder het verschil tussen de table-of-contents en de list-of-figure maar dit issue ga ik sluiten.

[wilkoquak]

sorry vergeten te sluiten