Re: Allow <info> as root element?
David Cramer <[email protected]> Tue, 29 Nov 2022 18:47:52 -0600
| Newsgroups | gmane.text.docbook.misc |
|---|---|
| Message-ID | <[email protected]> |
I make most or all elements start elements in my DocBook variants because wh= y not? What if you want to xi:include a <phrase> or a <note> multiple times (= and find entities to be kludgy and gross)? Put it in a file and xi:include t= hat file as needed. No need for an id or id fixup. =20 I also consider making a variant good practice. Nobody needs all of DocBook a= nd changes like adding start elements have little effect on interoperability= .=20 Regards, David Typed wtih thmubs=20 > On Nov 29, 2022, at 5:51 PM, Richard Hamilton <[email protected]> wrot= e: >=20 > =EF=BB=BFI=E2=80=99ve run into the same thing. I have a separate file for o= ur book info, so that I can move the copyright page to the back of the book f= or ebooks. >=20 > I am lazy, however, and just ignore the errors when I=E2=80=99m editing th= e info page:-). I essentially do what Norm mentioned; that is, only pay atte= ntion to validation when the block is included in a book. >=20 > The other thing you could do, if you=E2=80=99re using xinclude, is to put t= he info block into a valid root element, so you can validate it, then use xi= nclude to include just the info element when you build a deliverable. >=20 > I=E2=80=99m not sure how doable that is with assemblies. >=20 > Dick Hamilton > ------- > XML Press > XML for Technical Communicators > http://xmlpress.net > [email protected] >=20 >=20 >=20 >> On Nov 29, 2022, at 14:03, Thomas Schraitle <[email protected]> wrote: >>=20 >> Hi, >>=20 >> On 28.11.22 11:10, Norm Tovey-Walsh wrote: >>>> currently, DocBook v5.2 (and previous versions) allows several elements= as root >>>> element. However, it is currently not possible to use info "alone". Any= reasons >>>> why? >>>=20 >>> I can see how reusing metadata might make sense in some environments. I >>> won=E2=80=99t speak for anyone else on the TC, but I tend to think of it= as >>> being attached to something. It provides metadata for an element, and so= >>> it=E2=80=99s not immediately obvious what it means sitting on its own. >>>=20 >>> It isn=E2=80=99t that I thought there was any reason to forbid it so muc= h as it >>> never occurred to me that it would be useful. >>=20 >> I know, this use case may be not very common. Still I think, if you use >> assemblies and share content it might become more helpful, especially whe= n you >> want (or need to) validate on its own. >>=20 >>=20 >>>> Imagine you would like to share some common meta information among seve= ral >>>> articles: >>>=20 >>> There=E2=80=99s obviously nothing that prevents you from doing this. You= can >>> XInclude this metadata file into several articles and then validate >>> them. >>>=20 >>> It would be a very simple Relax-NG customization to allow info in the >>> =E2=80=9Cstart=E2=80=9D pattern then it could be validated independently= . >>=20 >> That's true, but that wouldn't be DocBook anymore. ;) Thus validating wou= ldn't >> work. >>=20 >>=20 >> -- >> Gru=C3=9F/Regards >> Thomas Schraitle >>=20 >>=20 >> --------------------------------------------------------------------- >> To unsubscribe, e-mail: [email protected] >> For additional commands, e-mail: [email protected] >>=20 >=20 >=20 > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] >=20