OASIS Darwin Information Typing Architecture (DITA) TC

  • 1.  Re: [dita] Implications of type= attribute for xref element

    Posted 01-03-2007 16:05
    Michael Priestley wrote:
    
    > It seems reasonable though to say that when the type is unspecified it 
    > should be determined by inspecting the target if possible, and only 
    > default to topic if the target cannot be inspected for some reason.
    
    If we say "topic" is the default for xrefs to non-DITA-based content 
    (i.e., format="pdf" or format="html" or whatever) then that implies that 
    xref is only intended to create references to topics or topic components 
    and not, for example, links to non-topic-ish content (for example, a 
    link to an arbitrary Web site).
    
    I think this is fine but we need to be clear that this is the case and 
    ensure that there is a different linking construct for handling 
    references to non-topic-ish stuff. However, I don't see anything like 
    that in the language reference (I'm looking at the spec dated 2005-05-09).
    
    That is, normally I would expect to have something like "link" or 
    "weblink" or "urlref" or something that is intended to point to things 
    outside the scope of my documentation set and that therefore are not 
    really candidates for cross referencing, where I would expect, for 
    example, to be able to generate the target's title or label and page 
    number (for paginated output).
    
    But if xref is intended to be a more general linking element, where only 
    one use is what I would think of as a normal xref, then I think that 
    type="topic" would not be appropriate, since normally the stuff you 
    *can't* resolve would not be topics (because normally you'd be able to 
    resolve references to topics [because you have to at least know the 
    topic's ID in order to author the link in the first place, which means 
    you probably have direct access to the topic or to some sort of database 
    of information about the topic, for example, a table of topic titles and 
    topic IDs, which is as good as resolving to the topic itself for the 
    purpose of processing xrefs]).
    
    So I'm coming to the conclusion that the semantics of xref need to be 
    clarified and, if that clarification includes broadening their use to be 
    more of a generic linking element, then I think that an implied value of 
    "topic" should be changed to "unknown" or be based on the format= value 
    (i.e., if format="dita" then topic is a reasonable default, if it is 
    "ditamap" then "map" is a reasonable default, if format is any other 
    value, then "unknown" is a more reasonable default).
    
    Cheers,
    
    Eliot
    -- 
    W. Eliot Kimber
    Professional Services
    Innodata Isogen
    9390 Research Blvd, #410
    Austin, TX 78759
    (214) 954-5198
    
    ekimber@innodata-isogen.com
    www.innodata-isogen.com
    
    


  • 2.  RE: [dita] Implications of type= attribute for xref element

    Posted 01-04-2007 17:24
     
    
    >