模板:Portal

此模板被引用于约735,000个页面，占全部页面的9%。
为了避免造成大规模的影响，所有对此模板的编辑应先于沙盒、测试样例或您的沙盒上测试。
测试后无误的版本可以一次性地加入此模板中，但是修改前请务必于讨论页发起讨论。

模板引用数量会自动更新。

此模板使用Lua语言：

Module:Portal

用法

基本

{{Portal |Portal 1 |Portal 2 |Portal 3 |... }}

所有参数

{{Portal
 | Portal 1
 | Portal 2
 | Portal 3
 | ... 
 | left = <!-- yes -->
 | margin = <!-- CSS margin -->
 | break = <!-- yes -->
 | boxsize = <!-- custom box width in pixels -->
 | image1 = <!-- image override for Portal 1 -->
}}

兼容模式

中文维基百科旧portal模板的参数格式与Lua版本的多参数模式不尽相同。为保证兼容性，Lua模板中也增加了对这两种形式的支持。

name image

如果没有指定位置参数，则尝试将：

{{Portal|name=Portal 1|image=Image 1.png <!-- 可选 -->}}

解读为：

{{Portal|1=Portal 1|image1=Image 1.png <!-- 可选 -->}}

这一步骤并不会让模板运算变得十分复杂，因此基本无需修正到新格式。

2号位作图像

如果参数数量为2，且第二项按照文件名理解时扩展名长度为3或4，则尝试将：

{{Portal|Portal 1|Image 1.xyz}}

解读为：

{{Portal|1=Portal 1|image1=Image 1.xyz}}

为减少误报，模块会在扩展名不是常用图片格式（png、jpg、svg）时检查文件是否存在。检查步骤为“昂贵操作”，对服务器负担较重，因此请检查文档底部的追踪分类进行清理。

位置

在条目里面，本模板通常放置在条目底端的“参见”章节。

举例

Code	Result
{{Portal\|科学}}	科学主题
{{Portal\|1=科学\|2=弹维基\|image2=New-Bouncywikilogo.gif\|3=默认图片}}	科学主题弹维基主题默认图片主题

TemplateData

以下是该模板的模板数据，适用于可视化编辑器等工具。

Portal模板数据

A template to create a list of portals

模板参数[编辑模板数据]
参数		描述	类型	状态
Portal (1)	`1`	Inserts the portal image and text. Further portals can be added to the template by increasing the number	字符串	必需
Portal (2)	`2`	Insert the portal image and text	字符串	可选
Portal (3)	`3`	Insert the portal image and text	字符串	可选
Side	`left`	If set to yes, the portal appears on the left side of the page instead of the right. 默认值 no	字符串	可选
Margin size	`margin`	Alters the margin size. Any valid CSS margin is accepted	数字	可选
Line break	`break`	If set to yes, a line break is inserted after the portal name and before the word portal	字符串	可选
Box size	`boxsize`	This sets a custom box width in pixels.	数字	可选

图片

自动配图模块（取代Template:Portal/Images，请检查图像数据是否迁移完毕）：

Module:Portal/images/letter，以字母开头
Module:Portal/images/chinese，以汉字开头
Module:Portal/images/other，以其他字符开头
Module:Portal/images/aliases，文字别名，可用于地区词及英文转换

参见

{{Portals}}，该模板提供现有主题的一个列表。
{{Portal bar}}，该模板可一次性添加数个主题链接，并横向显示。
{{Portal-inline}}，该模板可添加一个不带边框的主题链接。
排错分类：
- Category:使用2号参数传递Portal模板图像的页面（1,829）
- Category:Portal模版没有使用参数（0）

重定向

{{主题}}
{{主题首页}}
{{入口}}
{{门户}}
{{指南}}

上述文档嵌入自Template:Portal/doc。
编者可以在本模板的沙盒和测试样例页面进行实验。
请在/doc子页面中添加分类。本模板的子页面。