Re: [docbook] Help needed to use ENTITY in docbook5 (convert from docbook4)

[Bob Stayton <bobs@sagehill.net>]

Thank you, Jirka, for clearing this up.  I actually covered this topic of text entities with XIncludes in my book, where I recommended using a central entity definition file that is referenced by all modular files in their DOCTYPES to ensure the same set of entities are available everywhere, and can be updated in a central location:

http://www.sagehill.net/docbookxsl/ModularEntities.html

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

On 5/28/2018 3:08 AM, Jirka Kosek wrote:

On 25.5.2018 9:23, victory wrote:

I think this is caused by this change:
https://github.com/docbook/docbook.org/issues/17

Please note that there were not made change. The problem is that with
DocBook 4 people usually used external entities to break document into
several smaller files. If this approach is used entities defined in the
main file are inherited to files included via entity mechanism.

For DocBook 5 XInclude is usually used for modularity. With XInclude
situation is different. Each xincluded file is parsed separately and
does not inherit entity declarations from the main file. So with
XInclude entity declarations has to be repeated at the beginning of each
file.

But in fact this is not directly related to differences between DocBook
4 and 5. You can use XInclude with DocBook 4 or external entities with
DocBook 5.

But using entities for accented characters in 2018 seems really wrong.
Appropriate Unicode characters should be used directly in the files.

				Jirka