[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [docbook-apps] How to use a catalog for an entity declaration file?
Hi Radu,
It's all working now. Thank you. I really appreciate it. And thanks, Dave
and Bernhard, for your suggestions as well.
Best regards,
Bob
Bob McIlvride Communications Manager
Cogent Real-Time Systems Inc., a Skkynet company
T 1 905 702 7851 ext 103
cogent.ca
-----Original Message-----
From: Radu Coravu <radu_coravu@sync.ro>
Sent: Thursday, March 14, 2019 2:40 AM
To: Bob McIlvride <bob.mcilvride@skkynet.com>;
docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] How to use a catalog for an entity declaration
file?
Hi Bob,
If you look in the build file
"OXYGEN_INSTALL_DIR\frameworks\docbook\xsl\com.oxygenxml.webhelp.classic\bui
ld_docbook.xml"
it defines an xml catalog:
> <xmlcatalog id="docbook_catalog">
> <catalogpath>
> <pathelement location="${basedir}/../../catalog.xml"/>
> </catalogpath>
> </xmlcatalog>
so you can add an extra <pathelement> there pointing to your XML catalog.
Or the alternative is to open the main DocBook XML catalog file:
> OXYGEN_INSTALL_DIR\frameworks\docbook\catalog.xml
and add in it at the end an extra <nextCatalog> entry pointing to your XML
catalog.
Of course, by using this second approach you would not need anymore to refer
to your XML catalog explicitly in the Oxygen Preferences->"XML Catalogs"
page because Oxygen already takes the main DocBook XML catalog into account.
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
On 3/13/2019 4:39 PM, Bob McIlvride wrote:
> Hi Radu,
>
> I was testing with our modified version of Oxygen's DocBook WebHelp
> transformation scenario, which uses an ANT build file. How would I go
> about providing a reference to the xmlcatalog in the <xslt> task for that?
>
> By the way, I just now tried processing the document using an XSLT
> transformation scenario, and that works fine. Thank you for that tip.
> All I need now is a little guidance for the ANT transformation.
>
> Best regards,
>
> Bob
>
>
> Bob McIlvride Communications Manager
> Cogent Real-Time Systems Inc., a Skkynet company T 1 905 702 7851 ext
> 103 cogent.ca
>
> -----Original Message-----
> From: Radu Coravu <radu_coravu@sync.ro>
> Sent: Wednesday, March 13, 2019 2:18 AM
> To: docbook-apps@lists.oasis-open.org
> Subject: Re: [docbook-apps] How to use a catalog for an entity
> declaration file?
>
> Hi Bob,
>
> How exactly do you process the XML file? Applying an XSLT using an XML
> + XSLT transformation scenario should use automatically the XML
> catalog set up in Oxygen.
> Are you using an ANT build file? If so did you provide in the <xslt>
> task a reference to the xmlcatalog?
>
> https://ant.apache.org/manual/Tasks/style.html
>
> Regards,
> Radu
>
> Radu Coravu
> <oXygen/> XML Editor
> http://www.oxygenxml.com
>
> On 3/12/2019 6:45 PM, Bob McIlvride wrote:
>> Hi Radu,
>>
>> Thank you for the tips. Using "systemSuffix and systemIDSuffix
>> allows me to validate the document. That's a great help. However,
>> when I go to process the document in Oxygen, I get this error:
>>
>> [xslt] : Fatal Error! Failure reading
>> file:/C:/Activity/Cogent/Docs/DocsOx/Source/TestBook1/test3-book.xml
> Cause:
>> java.io.FileNotFoundException:
>> C:\Activity\Cogent\Docs\DocsOx\Source\TestBook1\commonentityID (The
>> system cannot find the file specified)
>>
>> I followed your suggestion to move the TestCatalg.xml file into the
>> same directory as the commonentities.ent file. Now the source files
>> look like
>> this:
>>
>> TestCatalog.xml:
>>
>> <!DOCTYPE catalog
>> PUBLIC "-//OASIS//DTD XML Catalogs V1.1//EN"
>>
>> "http://www.oasis-open.org/committees/entity/release/1.1/catalog.dtd";
>> > <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
>> <systemSuffix systemIdSuffix="commonentityID"
>> uri="commonentities.ent"/>
>> </catalog>
>>
>> test3-book.xml:
>>
>> <!DOCTYPE book [
>> <!ENTITY % commonentities SYSTEM "commonentityID" > %commonentities;
>> ]> <book xmlns="http://docbook.org/ns/docbook"; version="5.0"
>> xmlns:xi="http://www.w3.org/2001/XInclude";
>> xmlns:xlink="http://www.w3.org/1999/xlink"; xml:id="test3-book">
>> <info>
>> <title>Test Book 3</title>
>> </info>
>> <chapter xml:id="test3-introduction">
>> <info>
>> <title>Introduction - A Simple Book</title>
>> </info>
>> <para>Test entity: ©</para>
>> </chapter>
>> </book>
>>
>> Those both validate in Oxygen, but it gives that "cannot find the file"
>> error when processing the document. I have tried modifying the
>> Preferences for the XML Catalog in different ways, but nothing seems
>> to affect the problem. The current settings can be seen in the
>> attached
> image:
>> CatalogSnip.png.
>>
>> I'm sure I'm doing something wrong, but can't figure out what. Can
>> you see what the problem might be?
>>
>> Best regards,
>>
>> Bob
>>
>>
>> Bob McIlvride Communications Manager
>> Cogent Real-Time Systems Inc., a Skkynet company T 1 905 702 7851
>> ext
>> 103 cogent.ca
>>
>> -----Original Message-----
>> From: Radu Coravu <radu_coravu@sync.ro>
>> Sent: Tuesday, March 12, 2019 1:44 AM
>> To: docbook-apps@lists.oasis-open.org
>> Subject: Re: [docbook-apps] How to use a catalog for an entity
>> declaration file?
>>
>> Hi Bob,
>>
>> Here are 3 possibilities:
>>
>> 1) An entity reference like this:
>>
>>> <!ENTITY % commonentities SYSTEM "commonentityID" >
>>
>> would be resolved by a catalog entry like this:
>>
>>> <systemSuffix systemIdSuffix="commonentityID"
>>> uri="file:///C:/Activity/Cogent/Docs/DocsOx/Source/Common/commonenti
>>> t
>>> i
>>> es.ent"/>
>>
>> 2) An entity reference like this:
>>
>>> <!ENTITY % commonentities SYSTEM "../Common/commonentities.ent" >
>>
>> would be resolved by a catalog reference like this:
>>
>>> <systemSuffix systemIdSuffix="Common/commonentities.ent"
>>> uri="file:///C:/Activity/Cogent/Docs/DocsOx/Source/Common/commonenti
>>> t
>>> i
>>> es.ent"/>
>>
>> 3) An entity reference like this:
>>
>>> <!ENTITY % commonentities SYSTEM
>>> "http://someHost/Common/commonentityID"; >
>>
>> would be resolved by a catalog entry like this:
>>
>>> <system systemId="http://someHost/Common/commonentityID";
>>> uri="file:///C:/Activity/Cogent/Docs/DocsOx/Source/Common/commonenti
>>> t
>>> i
>>> es.ent"/>
>>
>> Also in practice no absolute file references should be in the
catalog.xml.
>> So the catalog.xml would be placed as close as possible to the DTDs,
>> for example in the "DocsOx/Source/Common" folder, meaning that the
>> @uri attribute value would be something like this:
>>
>>> <system systemId="....." uri="commonentities.ent"/>
>>
>>
>> Regards,
>> Radu
>>
>> Radu Coravu
>> <oXygen/> XML Editor
>> http://www.oxygenxml.com
>>
>> On 3/11/2019 10:33 PM, Bob McIlvride wrote:
>>> Dear friends,
>>>
>>>
>>>
>>> I am trying to implement this guidance from Chapter 23. Modular
>>> DocBook files of Bob Stayton's DocBook XSL: The Complete Guide - 4th
>> Edition:
>>>
>>>
>>>
>>> "If all of your modules and document files have the same entity
>>> declaration and reference, then they will all share the same set of
>>> entities. You can use an XML catalog to map the filename to a
>>> specific pathname on a system so it can be in a central location."
>>>
>>> http://www.sagehill.net/docbookxsl/ModularEntities.html#entities.in.
>>> d
>>> t
>>> d
>>>
>>>
>>>
>>> My problem is that I don't know the correct syntax for the system
>>> entity declaration. For example, this doesn't work:
>>>
>>>
>>>
>>> <!DOCTYPE book [
>>>
>>> <!ENTITY % commonentities SYSTEM "commonentityID" >
>>>
>>> %commonentities;
>>>
>>> ]>
>>>
>>> ...
>>>
>>>
>>>
>>> My catalog looks like this:
>>>
>>>
>>>
>>> <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
>>>
>>> <system systemId="commonentityID"
>>> uri="file:///C:/Activity/Cogent/Docs/DocsOx/Source/Common/commonenti
>>> t
>>> i
>>> es.ent"/>
>>>
>>> </catalog>
>>>
>>>
>>>
>>> The catalog validates in Oxygen.
>>>
>>>
>>>
>>> Without attempting to use the catalog, this is what we normally use:
>>>
>>>
>>>
>>> <!DOCTYPE book [
>>>
>>> <!ENTITY % commonentities SYSTEM "../Common/commonentities.ent" >
>>>
>>> %commonentities;
>>>
>>> ]>
>>>
>>> ...
>>>
>>>
>>>
>>> This also validates and produces correct output. How can we get
>>> this working using a catalog? Any suggestions would be most helpful.
>>>
>>>
>>>
>>> Best regards,
>>>
>>>
>>>
>>> Bob
>>>
>>>
>>>
>>>
>>>
>>> COGENT <http://cogent.ca/>
>>>
>>>
>>>
>>> *Bob McIlvride ** Communications Manager*
>>>
>>> Cogent Real-Time Systems Inc., a Skkynet company
>>>
>>> T 1 905 702 7851 ext 103
>>>
>>> cogent.ca <http://cogent.ca/>
>>>
>>>
>>>
>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
>> For additional commands, e-mail:
>> docbook-apps-help@lists.oasis-open.org
>>
>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
>> For additional commands, e-mail:
>> docbook-apps-help@lists.oasis-open.org
>>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail:
> docbook-apps-help@lists.oasis-open.org
>
>
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]