« Modèle:Localized link » : différence entre les versions

De wikarphy
avoid being listed in Special:WantedPages
move doc here to make translatable
Ligne 14 : Ligne 14 :
   |</b>
   |</b>
}}<span style="display:none">[[:{{{1}}}| ]]</span><!-- T63547 --><noinclude>
}}<span style="display:none">[[:{{{1}}}| ]]</span><!-- T63547 --><noinclude>
{{ {{TNTN|documentation}} }}
{{documentation|content=
 
{{tsh|ll|LL}}
{{High-use|35000}}
 
== Purpose ==
 
This helper template can be used to link to [[Special:LanguageStats|translatable pages]] in the user's language. It uses the special page prefix <code>Special:MyLanguage/</code>, which checks if there is a translated version of a page in the user's language, and links to it if there is one, and links to a fallback language where available, or the default wiki language version (English in MediaWiki) if there isn't.
 
It should be used in translated pages, so that they link to the right page even if there is no translated page in that language.
 
== Usage ==
 
{{Localized link/doc}}
 
If "<code>nsp</code>" parameter is not defined, as link text displays the full pagename (including namespace); otherwise — if "<code>nsp</code>" parameter is defined by any value — link text displays the short pagename, without namespace.
 
=== Examples of simple usage ===
 
{{(}}{{!}} class="wikitable"
{{!}}-
! Use
! Becomes
{{!}}-
{{!}} {{Tlx{{!}}ll{{!}}Communication}}
{{!}} {{ll{{!}}Communication}}
{{!}}-
{{!}} {{Tlx{{!}}ll{{!}}Communication{{!}}コミュニケーション}}
{{!}} {{ll{{!}}Communication{{!}}コミュニケーション}}
{{!}}-
{{!}} {{Tlx{{!}}ll{{!}}Project:About}}
{{!}} {{ll{{!}}Project:About}}
{{!}}-
{{!}} {{Tlx{{!}}ll{{!}}Project:About{{!}}nsp{{=}}0}}
{{!}} {{ll{{!}}Project:About{{!}}nsp=0}}
{{!}}{{)}}
 
== Usage in translatable pages ==
 
On pages prepared for translation with the {{ll|Extension:Translate|nsp=0}} extension, this template may be used in three ways.
 
# Should better be substitute this template, and then the wikilink target embedded in a <code><nowiki><tvar|id>...</></nowiki></code>, separately from the translatable displayed text of the link.
#: As example, instead <code><nowiki>{{ll|Communication|About communication}}</nowiki></code>, translation markup in translatable page will be <code><nowiki>[[<tvar|1>Special:MyLanguage/Communication</>|About communication]]</nowiki></code>.
# Alternatively, may be exclude this code from translatable section.
#: As example, for <code>some text <nowiki>{{ll|Communication|About communication}}</nowiki> some text</code>, translation markup in translatable page will be
#: <code>&lt;translate>some text&lt;/translate> <nowiki>{{ll|Communication|&lt;translate>About communication&lt;/translate>}}</nowiki> &lt;translate>some text&lt;/translate></code>.
#: This is useful for bulleted lists of links, e.g. in the "See also:" sections.
# If link text does not have to be different from the name of landing page, will be better to embed all this code into {{tag|tvar|open}}.
#: As example, instead {{Tlx|ll|Communication}}, translation markup in translatable page will be <code><nowiki><tvar|1>{{ll|Communication}}</></nowiki></code>.
 
== See also ==
 
* [[Template:Localized link/messagedoc]] — should be used for message documentation in translatable pages that use this template.
* {{tl|Translatable template}}, alias {{tl|TNT}} or {{tl|tnt}}
* {{tl|Translatable template name}}, alias {{tl|TNTN}} or {{tl|tntn}}
* {{tl|Page language link}}, alias {{tl|pll}}: add a link from a translatable page to another translatable page in the same language
 
}}
[[Category:Internationalization templates]]
</noinclude>
</noinclude>

Version du 5 juin 2021 à 09:34

{{#ifeq:|

 |

}}[[Special:MyLanguage/{{{1}}}|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:|:}}/Page display title/Modèle:Pagelang2

 |{{#if:
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:
   |
   |{{{1}}}
 }}

}}}}]]{{#ifeq:|

 |

}}[[:{{{1}}}| ]]

Documentation du modèle

Modèle:Tsh Modèle:High-use

Purpose

This helper template can be used to link to translatable pages in the user's language. It uses the special page prefix Special:MyLanguage/, which checks if there is a translated version of a page in the user's language, and links to it if there is one, and links to a fallback language where available, or the default wiki language version (English in MediaWiki) if there isn't.

It should be used in translated pages, so that they link to the right page even if there is no translated page in that language.

Usage

Modèle:Localized link/doc

If "nsp" parameter is not defined, as link text displays the full pagename (including namespace); otherwise — if "nsp" parameter is defined by any value — link text displays the short pagename, without namespace.

Examples of simple usage

Modèle:(| class="wikitable" |- ! Use ! Becomes |- | {{Tlx|ll|Communication}} | {{ll|Communication}} |- | {{Tlx|ll|Communication|コミュニケーション}} | {{ll|Communication|コミュニケーション}} |- | {{Tlx|ll|Project:About}} | {{ll|Project:About}} |- | {{Tlx|ll|Project:About|nsp=0}} | {{ll|Project:About|nsp=0}} |Modèle:)

Usage in translatable pages

On pages prepared for translation with the {{#ifeq:Extension:Translate|

 |

}}[[Special:MyLanguage/Extension:Translate|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:|:}}Extension:Translate/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Extension:Translate
   |Extension:Translate
 }}

}}}}]]{{#ifeq:Extension:Translate|

 |

}} extension, this template may be used in three ways.

  1. Should better be substitute this template, and then the wikilink target embedded in a <tvar|id>...</>, separately from the translatable displayed text of the link.
    As example, instead {{ll|Communication|About communication}}, translation markup in translatable page will be [[<tvar|1>Special:MyLanguage/Communication</>|About communication]].
  2. Alternatively, may be exclude this code from translatable section.
    As example, for some text {{ll|Communication|About communication}} some text, translation markup in translatable page will be
    <translate>some text</translate> {{ll|Communication|<translate>About communication</translate>}} <translate>some text</translate>.
    This is useful for bulleted lists of links, e.g. in the "See also:" sections.
  3. If link text does not have to be different from the name of landing page, will be better to embed all this code into Modèle:Tag.
    As example, instead Modèle:Tlx, translation markup in translatable page will be <tvar|1>{{ll|Communication}}</>.

See also

 |

}}[[Special:MyLanguage/Template:Translatable template|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Translatable template/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Translatable template
   |Template:Translatable template
 }}

}}}}]]{{#ifeq:Modèle:Translatable template|

 |

}} }}, alias {{{{#ifeq:Modèle:TNT|

 |

}}[[Special:MyLanguage/Template:TNT|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}TNT/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |TNT
   |Template:TNT
 }}

}}}}]]{{#ifeq:Modèle:TNT|

 |

}} }} or {{{{#ifeq:Modèle:Tnt|

 |

}}[[Special:MyLanguage/Template:tnt|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Tnt/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Tnt
   |Template:tnt
 }}

}}}}]]{{#ifeq:Modèle:Tnt|

 |

}} }}

  • {{{{#ifeq:Modèle:Translatable template name|
 |

}}[[Special:MyLanguage/Template:Translatable template name|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Translatable template name/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Translatable template name
   |Template:Translatable template name
 }}

}}}}]]{{#ifeq:Modèle:Translatable template name|

 |

}} }}, alias {{{{#ifeq:Modèle:TNTN|

 |

}}[[Special:MyLanguage/Template:TNTN|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}TNTN/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |TNTN
   |Template:TNTN
 }}

}}}}]]{{#ifeq:Modèle:TNTN|

 |

}} }} or {{{{#ifeq:Modèle:Tntn|

 |

}}[[Special:MyLanguage/Template:tntn|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Tntn/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Tntn
   |Template:tntn
 }}

}}}}]]{{#ifeq:Modèle:Tntn|

 |

}} }}

  • {{{{#ifeq:Modèle:Page language link|
 |

}}[[Special:MyLanguage/Template:Page language link|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Page language link/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Page language link
   |Template:Page language link
 }}

}}}}]]{{#ifeq:Modèle:Page language link|

 |

}} }}, alias {{{{#ifeq:Modèle:Pll|

 |

}}[[Special:MyLanguage/Template:pll|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Pll/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Pll
   |Template:pll
 }}

}}}}]]{{#ifeq:Modèle:Pll|

 |

}} }}: add a link from a translatable page to another translatable page in the same language

{{#if:Modèle:Tsh

Modèle:High-use

Purpose

This helper template can be used to link to translatable pages in the user's language. It uses the special page prefix Special:MyLanguage/, which checks if there is a translated version of a page in the user's language, and links to it if there is one, and links to a fallback language where available, or the default wiki language version (English in MediaWiki) if there isn't.

It should be used in translated pages, so that they link to the right page even if there is no translated page in that language.

Usage

Modèle:Localized link/doc

If "nsp" parameter is not defined, as link text displays the full pagename (including namespace); otherwise — if "nsp" parameter is defined by any value — link text displays the short pagename, without namespace.

Examples of simple usage

Modèle:(| class="wikitable" |- ! Use ! Becomes |- | {{Tlx|ll|Communication}} | {{ll|Communication}} |- | {{Tlx|ll|Communication|コミュニケーション}} | {{ll|Communication|コミュニケーション}} |- | {{Tlx|ll|Project:About}} | {{ll|Project:About}} |- | {{Tlx|ll|Project:About|nsp=0}} | {{ll|Project:About|nsp=0}} |Modèle:)

Usage in translatable pages

On pages prepared for translation with the {{#ifeq:Extension:Translate|

 |

}}[[Special:MyLanguage/Extension:Translate|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:|:}}Extension:Translate/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Extension:Translate
   |Extension:Translate
 }}

}}}}]]{{#ifeq:Extension:Translate|

 |

}} extension, this template may be used in three ways.

  1. Should better be substitute this template, and then the wikilink target embedded in a <tvar|id>...</>, separately from the translatable displayed text of the link.
    As example, instead {{ll|Communication|About communication}}, translation markup in translatable page will be [[<tvar|1>Special:MyLanguage/Communication</>|About communication]].
  2. Alternatively, may be exclude this code from translatable section.
    As example, for some text {{ll|Communication|About communication}} some text, translation markup in translatable page will be
    <translate>some text</translate> {{ll|Communication|<translate>About communication</translate>}} <translate>some text</translate>.
    This is useful for bulleted lists of links, e.g. in the "See also:" sections.
  3. If link text does not have to be different from the name of landing page, will be better to embed all this code into Modèle:Tag.
    As example, instead Modèle:Tlx, translation markup in translatable page will be <tvar|1>{{ll|Communication}}</>.

See also

 |

}}[[Special:MyLanguage/Template:Translatable template|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Translatable template/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Translatable template
   |Template:Translatable template
 }}

}}}}]]{{#ifeq:Modèle:Translatable template|

 |

}} }}, alias {{{{#ifeq:Modèle:TNT|

 |

}}[[Special:MyLanguage/Template:TNT|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}TNT/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |TNT
   |Template:TNT
 }}

}}}}]]{{#ifeq:Modèle:TNT|

 |

}} }} or {{{{#ifeq:Modèle:Tnt|

 |

}}[[Special:MyLanguage/Template:tnt|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Tnt/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Tnt
   |Template:tnt
 }}

}}}}]]{{#ifeq:Modèle:Tnt|

 |

}} }}

  • {{{{#ifeq:Modèle:Translatable template name|
 |

}}[[Special:MyLanguage/Template:Translatable template name|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Translatable template name/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Translatable template name
   |Template:Translatable template name
 }}

}}}}]]{{#ifeq:Modèle:Translatable template name|

 |

}} }}, alias {{{{#ifeq:Modèle:TNTN|

 |

}}[[Special:MyLanguage/Template:TNTN|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}TNTN/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |TNTN
   |Template:TNTN
 }}

}}}}]]{{#ifeq:Modèle:TNTN|

 |

}} }} or {{{{#ifeq:Modèle:Tntn|

 |

}}[[Special:MyLanguage/Template:tntn|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Tntn/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Tntn
   |Template:tntn
 }}

}}}}]]{{#ifeq:Modèle:Tntn|

 |

}} }}

  • {{{{#ifeq:Modèle:Page language link|
 |

}}[[Special:MyLanguage/Template:Page language link|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Page language link/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Page language link
   |Template:Page language link
 }}

}}}}]]{{#ifeq:Modèle:Page language link|

 |

}} }}, alias {{{{#ifeq:Modèle:Pll|

 |

}}[[Special:MyLanguage/Template:pll|{{#if:|{{{2}}}|{{#ifexist:Translations:{{#if:Modèle|Modèle:}}Pll/Page display title/Modèle:Pagelang2

 |{{#if:0
   |
   |{{ Modèle:TNTN }}
 }}
 |{{#if:0
   |Pll
   |Template:pll
 }}

}}}}]]{{#ifeq:Modèle:Pll|

 |

}} }}: add a link from a translatable page to another translatable page in the same language| [[Category:Template documentation pages{{#translation:}}]] }}