Page 1 of 1

Author mode - show inline XInclude content inline

Posted: Tue Sep 22, 2009 4:24 pm
by honyk
Hello,

it would be nice to have some automatical mechanism for detection of external content and if it was inline, it would be displayed also inline. There could be also additional option for hidding title of referenced file and leave there only chain icon to be everything more compact.

Jan

Re: Author mode - show inline XInclude content inline

Posted: Wed Sep 23, 2009 12:00 pm
by sorin_ristache
Hello,

What do you mean external content that is inline? Please give an example. I call external content the content that is included from an external file using an include mechanism (DTD external entities, XInclude, etc) and I call inline content the content that is contained in that file (the content that does not come from an external file by an include mechanism).


Regards,
Sorin

Re: Author mode - show inline XInclude content inline

Posted: Wed Sep 23, 2009 12:21 pm
by honyk
Ok, here is example:

Code: Select all

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"
[ <!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
%xinclude;
]>
<para>Testing <xi:include href="phrase.xml"/>.</para>
External file phrase.xml:

Code: Select all

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE phrase PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<phrase>phrase</phrase>
Current result:
Image
Proposal:
Image

HTH, Jan

Re: Author mode - show inline XInclude content inline

Posted: Wed Sep 23, 2009 2:23 pm
by sorin_ristache
Thank you for the example but I think the difference of rendering between external content (using the chain icon and the file title) and inline content is important for larger files for avoiding confusion between the two types of content. In smaller files it may not be important but in large files I think the author wants to know by a quick look at some visual indicators if the content is external or internal. Does the master document seem more complicated to edit or to read if the name of the included fragments is displayed next to the chain icon?


Regards,
Sorin