DOCBOOK: oasis xml docbook page needs to be updated?

2002-07-28 Thread Robert P. J. Day


  www.oasis-open.org/docbook/xml

  while that page says that DocBook XML V4.2 is the current version
of DocBook, the most recent link is to DocBook XML V4.2CR3.  perhaps
the addition of a link with the more obvious name of simply V4.2?

rday




DOCBOOK: Uniq values of ID attributes

2002-07-28 Thread Vitaly Ostanin

Hello!

1.
I'm join modular DocBook/XML documents and get errors for already
declared values of ID attributes (each in separated documents).

It's possible to do common attribute id uniq not for all 
document, in some levels only ?

2.
It's possible to add fallback element within xref element ? 
And also for all idref's attributes?

This may be another way to linking between documents, which 
located in one set of documents.

PS On page
http://www.docbook.org/tdg/en/html/ch01.html
exist small text error in first para:
you only need to skim this chapter.
probably must be:
...to skip...

-- 
Regards, Vyt
mailto:  [EMAIL PROTECTED]
JID: [EMAIL PROTECTED]




Re: DOCBOOK: Uniq values of ID attributes

2002-07-28 Thread Dave Pawson

At 05:34 28/07/2002, Vitaly Ostanin wrote:
Hello!

1.
I'm join modular DocBook/XML documents and get errors for already
declared values of ID attributes (each in separated documents).

It's possible to do common attribute id uniq not for all document, in some levels 
only ?


No, the id values must be unique to the whole document you are parsing.


2.
It's possible to add fallback element within xref element ? And also for all 
idref's attributes?

I don't think so, but I'm not sure I understand.
Do you have an example?



This may be another way to linking between documents, which located in one set of 
documents.

PS On page
http://www.docbook.org/tdg/en/html/ch01.html
exist small text error in first para:
you only need to skim this chapter.
probably must be:
...to skip...

grin/ English, to skim is to read very quickly, 
without understanding all of it.

HTH DaveP






Re: DOCBOOK: Uniq values of ID attributes

2002-07-28 Thread Vitaly Ostanin

Dave Pawson wrote:
 At 05:34 28/07/2002, Vitaly Ostanin wrote:
 
Hello!

1.
I'm join modular DocBook/XML documents and get errors for already
declared values of ID attributes (each in separated documents).

It's possible to do common attribute id uniq not for all document, in some levels 
only ?
 
 No, the id values must be unique to the whole document you are parsing.

Then authors of modular documents must to use long name values 
for id's. And this names will depend of document's structure :( Ok.

May be usable adding element for use XPointer or XLink 
functionality ?

2.
It's possible to add fallback element within xref element ? And also for all 
idref's attributes?
 
 I don't think so, but I'm not sure I understand.
 Do you have an example?

Sorry. In XInclude within element xi:include exist element 
xi:fallback for control errors of includes.

In DocBook DTD idref attributes point to id which must exist, 
right? It's possible to add element, which will control situation 
when id not exist in current edition ? id may be visible 
after join of documents.

skipped

-- 
Regards, Vyt
mailto:  [EMAIL PROTECTED]
JID: [EMAIL PROTECTED]




Re: DOCBOOK: Uniq values of ID attributes

2002-07-28 Thread Dave Pawson

At 08:06 28/07/2002, Vitaly Ostanin wrote:

It's possible to do common attribute id uniq not for all document, in some levels 
only ?
No, the id values must be unique to the whole document you are parsing.

Then authors of modular documents must to use long name values for id's. And this 
names will depend of document's structure :( Ok.

Having seen what docbook stuff uses, I steal those ideas.
E.g. a chapter on subject pages,
chapter id='pgs'
   then

  example id='pgs.ex.1'

etc, 

so the names relate to the subject?


May be usable adding element for use XPointer or XLink functionality ?

2.
It's possible to add fallback element within xref element ? And also for all 
idref's attributes?
I don't think so, but I'm not sure I understand.
Do you have an example?

Sorry. In XInclude within element xi:include exist element xi:fallback for 
control errors of includes.

I will wait for someone else to answer that one!
I have tried olink, but not include.




In DocBook DTD idref attributes point to id which must exist, right?

Yes, at parse time.

 It's possible to add element, which will control situation when id not exist in 
current edition ? id may be visible after join of documents.

No. Its an error if the id does not exist at parse time.

Perhaps olink would help.
http://www.sagehill.net/OlinkExtended.html
may give you some help.


regards DaveP.





Re: DOCBOOK: Uniq values of ID attributes

2002-07-28 Thread Bob Stayton

On Sun, Jul 28, 2002 at 07:06:26PM +0400, Vitaly Ostanin wrote:
 Dave Pawson wrote:
  At 05:34 28/07/2002, Vitaly Ostanin wrote:
  
 Hello!
 
 1.
 I'm join modular DocBook/XML documents and get errors for already
 declared values of ID attributes (each in separated documents).
 
 It's possible to do common attribute id uniq not for all document, in some 
levels only ?
  
  No, the id values must be unique to the whole document you are parsing.
 
 Then authors of modular documents must to use long name values 
 for id's. And this names will depend of document's structure :( Ok.
 
 May be usable adding element for use XPointer or XLink 
 functionality ?

The DocBook Technical Committee is just starting the process
of looking at XLinks for the DTD.  At some point this may
be a feature.
 
 2.
 It's possible to add fallback element within xref element ? And also for all 
idref's attributes?
  
  I don't think so, but I'm not sure I understand.
  Do you have an example?
 
 Sorry. In XInclude within element xi:include exist element 
 xi:fallback for control errors of includes.

The xi:fallback element is not yet supported in the only
Xinclude processor I know, which is xsltproc.

But xref is not an xinclude, so I'm not sure how this
applies.  Do you mean you want xref to be able to declare
some fallback text if the generated text is not available?
 
 In DocBook DTD idref attributes point to id which must exist, 
 right? It's possible to add element, which will control situation 
 when id not exist in current edition ? id may be visible 
 after join of documents.

That's true, and you don't find out until you vaildate the
joined document.  I don't know of another tool that can check
across includes or system entities for ID/IDREFs.

-- 

Bob Stayton 400 Encinal Street
Publications Architect  Santa Cruz, CA  95060
Technical Publications  voice: (831) 427-7796
Caldera International, Inc. fax:   (831) 429-1887
email: [EMAIL PROTECTED]