Joomla! Documentation™

Het linken van vertaalde pagina's aan elkaar is een belangrijk onderdeel van de pagina-navigatie voor onze gebruikers. Het is een snelle manier om een gebruiker naar een andere pagina met meer informatie over relevante onderwerpen te verwijzen. Het vertalen van deze links moet op een bepaalde manier worden gedaan om te zorgen dat de gebruiker de link in de gewenste taal kan bekijken. Iemand zal bij het browsen door onze documentatie het liefst in de eigen taal willen blijven wanneer dat mogelijk is. Een link naar een Engelstalige pagina bieden zal werken, maar de gebruiker moet dan weer op de link van de eigen taal klikken om het daarin te kunnen bekijken.

Inleiding

Het vertalen van paginalinks moet op een bepaalde manier gedaan worden om de lezer naar een andere pagina in dezelfde taal te verwijzen. Engelse schrijvers kunnen ook helpen door dit formaat te volgen. Het maakt het gemakkelijker voor de vertalers wanneer zij pagina's vertalen en de juiste link voor localisatie al gebruikt wordt.

In a normal links [[Component]] a user is taken to the Component page when they click the link. If there is a translated version of the page, for example, French, the French page would be located at [[Component/fr]].

So what if the page for Component/fr has not been created yet? The user would see a 'red-link' (page doesn't exist) compared to a blue link (the page exists). Perhaps the page Component will be translated, but it has not been translated yet. This is why Special:MyLanguage/ should always be used as a prefix to the linked page.

[[Component]] should be written as [[S:MyLanguage/Component|Component]]
 or
[[Component]] should be written as [[Special:MyLanguage/Component|Component]]

How "Special:MyLanguage" Works in Links

What does Special:MyLanguage/ do? It does a few things when processing a clicked link on a page before sending the user to the page. Using the page Component as an example:-

• The user has asked for this link, Special:MyLanguage/Component
• Get the user's language (or what language is the page current being viewed in?).
• Got it! The user is viewing the page in French, fr is the language code.
• Let's see if the link clicked to Component exists in French. Add /fr to it.
  • Yes, Component/fr is a valid page! Send the user to the page's French version;
  • No, the page Component/fr doesn't exist. Send the user to the default source language version;
• Show the user the page.

Applications of Use

Translators

A setting in documentation has made it easier with an short alias to "Special:" in links. You may use "S:" instead of "Special:" in a link, [[S:MyLanguage/....

Regular page links

[[Component]] should be written as [[S:MyLanguage/Component|<{translate this only}>]]
 or
[[Component]] should be written as [[Special:MyLanguage/Component|<{translate this only}>]]

Namespaced page links

[[JDOC:Translating Links]] should be written as [[S:MyLanguage/JDOC:Translating Links|<{translate this only}>]]
 or
[[JDOC:Translating Links]] should be written as [[Special:MyLanguage/JDOC:Translating Links|<{translate this only}>]]

Category page links:

[[:Category:Glossary_definitions]] should be written as [[S:MyLanguage/:Category:Glossary_definitions|<{translate this only}>]]
 or
[[:Category:Glossary_definitions]] should be written as [[Special:MyLanguage/:Category:Glossary_definitions|<{translate this only}>]]

English Page Writers and Editors

All the above in the Translators section applies to English version page writers and copy editors. You can help with translations by creating page links in English version pages using Special:MyLanguage/ or S:MyLanguage/ too! A page doesn't need to be marked for translation or even in the process of being translated. As pages are added to the translation queue, translators will have an easier time translating the links on a page.