模板:Internal link helper/doc
 | 这是 {{Internal link helper}} 模板的说明文件页面。 本文件并不是为直接浏览而撰写。若是其中使用了跨维基计划连结，某些连结可能会显示损毁。请勿将这些连结替换为硬编码的页面名称或网址。 |
 | 此Template被引用于220,000+个页面。 为了避免造成大规模的影响，所有对此Template的编辑应先于沙盒、测试样例或您的沙盒上测试。 测试后无误的版本可以一次性地加入此Template中，但是修改前请务必于讨论页发起讨论。 模板引用数量会自动更新。 |
 | 使用Lua语言编写： |
{{Internal link helper}}系列（内部连结助手，简称“ilh”或“Link系列”）模板，实际常用{{link-en}}等快捷方式子模板，为内文跨语言链接模板。对于中文维基未建立条目的词汇，该模板可在生成内部连接的基础上，展示外语版条目连结以供参考。
对于尚未创建中文版条目，桌面版网页预设以为绿色连结（#00af89）加鼠标悬浮提示框取代红色连结，行动版网页则在红色连结后括弧加注跨语言连结。注册用户可在偏好设定#小工具中选取其它效果。
当该中文条目建立后，模板和普通蓝色连结显示效果相同，同时条目归类于Category:有蓝链却未移除内部链接助手模板的页面，一段时间后机器人会自动摘除模板。如果中文版实际存在对应条目，而编辑者填写了其它名称，则目前会有机器人会自动建立重定向。
用法
[编辑]{{Internal link helper}}不能直接用于条目，编者必须调用其各语文子模板（如{{Internal link helper/en}}）。实践中编者常使用{{link-xx}}快捷方式使用模板，其中xx表示语言代码，如希望展示英文维基百科连结，可使用{{link-en}}，可用语文代码参见下文#子模板章节。
语法
[编辑]代码中的en可换为实际需要的语文代码，如ja、ru。
{{link-en|<中文维基百科页面名>|<外文维基百科对应页面名>|<连结实际显示文字>}}
| 参数 | 必填？ | 说明 |
|---|---|---|
1
|
是 | 中文维基百科页面名，相当于内部连结语法[[XXX|YYY]]中的XXX。
|
2
|
建议 | 外文维基百科对应页面名，相当于[[:en:ZZZ]]中的ZZZ。若中文版和外文版命名一致，此参数可省略。
|
3, d
|
否 | 连结实际显示文字，相当于内部连结语法[[XXX|YYY]]中的YYY。和页面名相同时可省略。
|
示例
[编辑]| 代码 | 效果 |
|---|---|
{{link-en|小精灵小姐|Ms. Pac-Man}}
|
小精灵小姐 |
{{link-en|电子世界争霸战 (游戏)|Tron (video game)|电子世界争霸战}}
|
电子世界争霸战 |
{{link-ru|Old-Games.RU}}
|
Old-Games.RU |
{{link-ja|上月景正||上月}}
|
上月 |
子模板
[编辑]现有子模板
[编辑]创建子模板
[编辑]因子模板尚未创建，部分语言代码无法使用，编者可按下述方法创建子模板：
- 首先，确认需要对应到的语言维基百科的语言代码
- 创建
Template:Internal link helper/语言代码——- 贴上以下代码：
<includeonly>{{Internal link helper | lang = 语言名称 | lang-code = 语言代码 | 1 = {{{1|}}} | 2 = {{{2|}}} | d = {{{d|{{{3|}}}}}} }}</includeonly><noinclude>{{Documentation|Template:Internal link helper/doc}}</noinclude>
- 将
语言名称文字替换为该语言的名称（如英语、德语），并将语言代码替换为对应的代码（如en、de等）
- 贴上以下代码：
- 将
Template:语言代码-link和Template:Link-语言代码两个页面重定向到Template:Internal link helper/语言代码 - 到Template:Internal link helper/doc#现有子模板登记新创建的模板
显示效果
[编辑]模板提供了多种显示效果，注册用户可以在参数设置的小工具栏目中，选择希望的表示方式，请不要同时选择一种以上的效果。开启功能后，在目标页面或条目未出现下面效果的，请按Wikipedia:绕过缓存进行操作。
| 跨语言连结小工具 | 说明 | 效果 |
|---|---|---|
| （不启用跨语言连结小工具） | 显示红色连结，括弧附注语文标签及跨语言连结。亦为行动版视图效果。 | 电子世界争霸战（英语：Tron (video game)） |
| 只显示红链 | 仅显示红色连结。读者无法获取外文信息。 | 电子世界争霸战 |
| 在Tooltip中显示原文链接 | 显示红色连结；鼠标浮于连结时，弹窗提示跨语言连结。 | 
|
| 显示红链和未链接原文 | 显示红色连结，括弧附注外文页面标题（无跨语言连结）。 | 电子世界争霸战（Tron (video game)） |
| 直接指向原文 | 直接指向外文维基。不便于编者创建中文条目。 | 电子世界争霸战 |
| 指向原文和语言名后缀 | 直接指向外文维基，并注明此为外文连结。不便于编者创建中文条目。 | 电子世界争霸战（英文） |
| 鼠标点击时显示Tooltip | 将红色连接改为绿色（#008800）显示；鼠标点击连结时，弹窗提示红色连结及跨语言连结。模板早期版本效果。（未正常工作？） | |
| 光标悬浮时显示Tooltip | 将红色连结改为绿色（#00af89）显示；鼠标浮于连结时，弹窗提示跨语言连结。桌面版预设效果。 |
|
| 光标悬浮时显示Tooltip（对于已存在页面的情况下高亮表示） | 同上，但对于已建立页面，蓝色连结会以亮蓝色（#21a9ff）显示。有利于编者核查Category:有蓝链却未移除内部链接助手模板的页面。 |
|
用户亦可透过个人CSS页自订显示效果。例如：取消所有跨语言连结小工具，并将如下代码粘贴到个人CSS页，可使用小字括弧附注跨语言连结，同时隐去语文标签。
.ilh-comment { font-size: smaller; }
.ilh-lang, .ilh-colon { display: none; }
历史
[编辑]
中文维基百科早期由于缺乏规范，内文跨语言连结的标注方式不一，如直接连结（[[:en:Example|示例]]）、括号附注（[[示例]]（[[:en:Example|Example]]））等。{{Internal link helper}}模板2008年建立时，意图通过网页即时提示（tip）方式，美观地展示对应外语页面链接，避免大量出现原文后附注括号的情况。但当时除非主动启用小工具，否则无法看到模板附加效果，故该模板未获广泛使用。
后来，社群广泛讨论了内文跨语言链接用法，提出了多种跨语言链接表示方式。在2012年跨语言链接的处理方式的投票中，社群指出应使用该模板表示内文跨语言连结，并将各类表示方式整合到模板，由用户自行选择偏好。
模板资料
[编辑]跨语言链接模板
| 参数 | 描述 | 类型 | 状态 | |
|---|---|---|---|---|
| 1 | 1 | 本地条目名
| 页面名称 | 必需 |
| 2 | 2 | 外语条目名
| 页面名称 | 推荐 |
| 3 | 3 d | 显示文字，不存在时显示参数1
| 字符串 | 可选 |
相关条目
[编辑]{{Translink}}（{{Tsl}}） － 另一个跨语言链接模板，调用本模板但调换了参数顺序{{Interlanguage link}}（{{ill}}） － 另一个跨语言链接模板用法- WP:MOSIW