[TYPO3-doc] DocBook: XML IDs // Linking between documents

Daniel Bruessler danielb at typo3.org
Fri Apr 29 09:18:31 CEST 2011


Hello Thomas and Sebastian,

>> <xref linkend="typo3v4.core.typoscript.function.stdWrap" />
>>
>> and also link is easy to use
>> <link linkend="flow3.installingphp53">installation instructions for PHP 5.3</link>
> Well this example would more be:
> <link
> linkend="http://documentation.typo3.org/typo3v4/core/tsref/current/en/function.html#stdWrap">...</link>
> for example; so it's not exactly what I'd call "easy to use" -- but see
> my issues with it in the other mail :)

right, that would be bad. But not so important as it's just the decision between xlink and olink.

>> but olink doesn't look so simple IMHO (taken from http://www.sagehill.net/docbookxsl/Olinking.html)
>> <olink targetdoc="MailAdminGuide" targetptr="user_accounts">user accounts</olink>
> Taking the above example:
> <olink targetdoc="typo3v4.core.tsref" targetptr="function.stdWrap" />
> 
> The only thing you need to know more as user is the *name of the manual*
> and the *name of the reference inside the manual* :-)

yes, that's much better. Looks good.

Can we do a request to the DocBook standard / Norman Walsh  ;-)

This would be much simpler:
<olink doc="typo3v4.core.tsref" target="function.stdWrap" />

(but I know we have to stick to the 5.0 as it is)

Greets!
Daniel

== DocTeam ==
Want to help? Just see what topics you're interested in and join us!
http://typo3.org/teams/documentation-team/
http://forge.typo3.org/projects/show/team-docteam
http://forge.typo3.org/projects/typo3v4-documentation


More information about the TYPO3-project-documentation mailing list