Re: Tabs and <formalgroup> content model

Norm Tovey-Walsh <[email protected]> Mon, 05 Feb 2024 15:48:21 +0000
Newsgroups gmane.text.docbook.misc
Message-ID <[email protected]>
--=-=-=
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable

> Hmn, apart from layout issues and simplification, is there a reason
> why it's not allowed, let's say, add a <figure> and an <example>
> inside a <formalgroup>?

It=E2=80=99s mostly a question of semantics, I think. A formalgroup that
contains four figures is, in some reasonable sense, =E2=80=9Ca kind of figu=
re=E2=80=9D.
But what is a formalgroup that contains an example and a table? Does it
appear in the list of tables? In the list of examples? In both, or in
neither?

> Nevertheless, it would be helpful if we had an example of how this element
> should be used. Or maybe some further explanations on use cases and when =
it
> makes sense. Or when it's not. However, this may not be feasible and perh=
aps
> too specific for a reference.

Yes. I hadn=E2=80=99t noticed that TDG doesn=E2=80=99t have an example for =
it. That=E2=80=99s an
oversight: https://github.com/docbook/defguide/issues/109

> After thinking about it... maybe an alternative could be to have a
> table.

I think I=E2=80=99d just group adjacent elements before I used a table. Usi=
ng a
table feels really=E2=80=A6wrong! But I also think it would be completely
reasonable to invent your own extension for this purpose. Try it out for
a bit and report back what works or doesn=E2=80=99t!

                                        Be seeing you,
                                          norm

=2D-
Norm Tovey-Walsh <[email protected]>
https://norm.tovey-walsh.com/

> The sudden disappointment of hope leaves a scar which the ultimate
> fulfillment of that hope never entirely removes.--Thomas Hardy

--=-=-=
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iHUEARYKAB0WIQSEJUqRvjpp8yLt8uKDEiZHbwv9OwUCZcEGIgAKCRCDEiZHbwv9
O2PwAP9R0XInHErvBW56Sltcmw3SEdb+MWfwValdUnV+d+BaQgEA5TV/I6GcfO7h
2zrNZnREGcyt4A4U81Ei2dnJ/7wbVA4=
=Sr3f
-----END PGP SIGNATURE-----
--=-=-=--