[TYPO3-doc] DocBook: sample reference file

[Thomas Schraitle]

Hi François,

Tuesday 22 February 2011
> [...]
> > (The "int" in the previous sentence is a link in HTML.)
> 
> Hmm, I think we've got a misunderstanding because I'm basing myself on
> what XMLEditor shows me, which is not what *you* "see" because you are
> already projecting yourself in the rendered stuff.

Right! Sorry, if I didn't mention it more clearly.

 
> What you actually mean is that
> 
> <xref linkend="typoscript.datatype.type.int"/>
> 
> will be rendered as "int" (with a link around it) because "int" is the
> value written inside the refname tag. Is that right?

Correct.

 
> I suppose the answer is "yes" after trying out the command-line test you
> indicated. I begin to understand why you say that the pseudo-WYSIWYG
> view in a DocBook editor can be confusing...

Yes, that's true. DocBook doesn't constrain what XML editor you use. As such 
if the XML editor supports a kind of "author" or WYSYWYG view, you are totally 
dependend on how the editor renders the elements.

The only reliable output is the rendering of your preferred output format. 
This is kind of standardized through the DocBook stylesheets.


Cheers,
  Tom