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

Daniel Bruessler danielb at typo3.org
Fri Apr 29 09:02:20 CEST 2011


Hello Sebastian and Francois,

>> The IDs should take the language into account, otherwise there will be
>> duplicate IDs within the complete file structure, right?
> I would say no, they should *not* take language into account, and also
> not the version.
> - If they would take the *version* into account, we would need to update
> *all* links when creating a new version.
> - furthermore, it would be impossible to display a selector like "this
> information is available for 4.2, 4.3, 4.4, trunk", as we need the same
> IDs for getting this information.
> - If they would take *language* into account, we'd need to update *all*
> links when creating a new language.
> - furthermore, it would be impossible to display a selector like "this
> information is available in english, german, ...", as we need the same
> IDs for getting this information.

+1

In the wiki I have made it like this when I wanted to switch between language versions. We can expect from a spanish/italian/french/german/.. manuals that they use english xml:ids. In the wiki this
works very good and I veeeery seldom have to change a page name into an english one because the people understand why it's needed so. I just defined that "english is the language for page names".

> -> another reason for olinks, and against global xrefs ;-) (at least IMHO)

I still don't know what it's better ;-)

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