Entity selection and shared files
Posted: Fri Oct 24, 2014 4:45 pm
Hello
I'm using Oxygen 16.1 and DocBook 5 to generate our technical documentation.
I'm desperatley trying to find a way to use entities in shared files.
Let me explain. Imagine bookprod1 and bookprod2 organized as follows:
bookprod1:
============================
bookprod2:
=============================
===============================
Imagine also the following entity files declaring the "ent1" entity
[*]c:\doc\prod1\release_and_product-specific_entities.ent where ent1=prod1ent1
[*]c:\doc\prod2\release_and_product-specific_entities.ent where ent1=prod2ent1
Note that :
[*]c:\doc\common\common.xml is used in both books
[*]the "ent1" entity is inserted in c:\doc\common\common.xml. As a consequence, I expect that it returns a distinct value depending on which book is processed.
My issue is that the "ent1" entity that is returned in c:\doc\common\common.xml is always the same. I understand that it may select the first entity file that resolves "ent1".
I thought that setting up Catalogs would allow me to redirect the entity file selection depending on which book is generated, but it has no effect. As a matter of fact, I set two catalog files, one in c:\doc\prod1\ and the other one in c:\doc\prod2\. Each file defined a rewritePrefix rule that redirected to the appropriate entity file. Anyway, this has no effect since Oxygen seems to select the first catalog that solves the issue.
Do you have any idea ? Is there any way to use entities in a "common file" and return a different value for an entity depending on the book that is processed ? Regarding catalogs, is there a way to specify that Book A uses rules from Catalog A and Book B relies on Catalog B ?
Thanks a lot for your help.
George
I'm using Oxygen 16.1 and DocBook 5 to generate our technical documentation.
I'm desperatley trying to find a way to use entities in shared files.
Let me explain. Imagine bookprod1 and bookprod2 organized as follows:
bookprod1:
============================
Code: Select all
<book> c:\doc\prod1\bookprod1
|_<xi:include.....c:\doc\prod1\chapter1.xml />
|_<xi:include.....c:\doc\prod1\chapter2.xml />
|_<xi:include.....c:\doc\common\common.xml />
</book>
=============================
Code: Select all
<book> c:\doc\prod2\bookprod2
|_<xi:include.....c:\doc\prod2\chapter1.xml />
|_<xi:include.....c:\doc\prod2\chapter2.xml />
|_<xi:include.....c:\doc\common\common.xml />
</book>
Imagine also the following entity files declaring the "ent1" entity
[*]c:\doc\prod1\release_and_product-specific_entities.ent where ent1=prod1ent1
[*]c:\doc\prod2\release_and_product-specific_entities.ent where ent1=prod2ent1
Note that :
[*]c:\doc\common\common.xml is used in both books
[*]the "ent1" entity is inserted in c:\doc\common\common.xml. As a consequence, I expect that it returns a distinct value depending on which book is processed.
My issue is that the "ent1" entity that is returned in c:\doc\common\common.xml is always the same. I understand that it may select the first entity file that resolves "ent1".
I thought that setting up Catalogs would allow me to redirect the entity file selection depending on which book is generated, but it has no effect. As a matter of fact, I set two catalog files, one in c:\doc\prod1\ and the other one in c:\doc\prod2\. Each file defined a rewritePrefix rule that redirected to the appropriate entity file. Anyway, this has no effect since Oxygen seems to select the first catalog that solves the issue.
Do you have any idea ? Is there any way to use entities in a "common file" and return a different value for an entity depending on the book that is processed ? Regarding catalogs, is there a way to specify that Book A uses rules from Catalog A and Book B relies on Catalog B ?
Thanks a lot for your help.
George