MediaWiki

Help:图片

This page is a translated version of the page Help:Images and the translation is 100% complete.
Languages:
PD 注意：當您編輯本頁面時，即同意以CC0協議授權您的貢獻。您可以在公有領域帮助页面找到更多信息。 PD

这个页面解释了在编辑wiki时的图片语法。 在页面中，您或其它用户通常在使用它之前必须先上传一张图片。

图片被存储在MediaWiki服务器上通常通过使用File:命名空间前缀（但传统的Image:命名空间前缀仍然作为同义词而受到支持）作为MediaWiki链接的目标。 Media:命名空间前缀也可以作为替代用于链接用于引用原始媒体文件内容（在任何MediaWiki页面之外单独呈现或下载）。

必要条件

在页面使用图像之前，您Wiki的系统管理员必须开启文件上传且用户须要上传文件。 系统管理员可能也将Wiki设置为可使用外部存储库，例如：维基共享资源。 对于在服务器端的图像大小调整，则需要配置一个图形库（例如：GD2，ImageMagick等）。

支持的媒体类型

下面的文件格式默认被支持：

  • .jpg 或 .jpeg – 以标准JPEG格式压缩的位图图像（这种有损格式最适合于照片）。
  • .png – “便携式网络图形”格式的位图图像（由「全球資訊網協會」指定）。
  • .gif – 传统“图形交换格式”中的位图图像。
  • .webp – WebP 支持有损和无损压缩格式，并且最大能压缩45%的大小。

其他在维基媒体上和其他地方通常使用的格式（这超出安装时默认启用的类型，可能需要额外的步骤）：

其他媒体类型可能受支持，但可能无法以内联方式显示它们。

渲染单个图片

语法

显示图像的完整语法是： 

[[File:文件名.副檔名|可选项|标题]]

可选项可以为空或者包含一个以上的以下小写单词，通过管道符号（|）分隔：

  • 格式选项：border和frameless、frame（或framed）、thumb（或者是thumbnail）中的一个；   注意： border 可以與 frameless 結合使用，但如果與其他選項一起使用，則會被忽略。
    控制呈现的图像应如何格式化并在页面的其余部分嵌入。
  • 调整大小选项：下面列出中的一个
    • {宽度}px——根据给定的最大宽度（以像素为单位）调整图像大小，不限制图像的高度。 (只支持整数像素值。 在宽度值和“px”之间添加一个空格是可以的。)
    • x{height}px –調整圖片大小以符合指定的最大高度（以像素為單位），而不限制其寬度。 只支持整数像素值。 在寬度值和“px”之间添加一个空格是可以的。
    • {宽度}x{高度}px–調整圖片大小以符合指定的宽度和高度（以像素為單位） 只支持整数的像素值。 在宽度值和“px”之间添加一个空格是可以的。
    • upright – 調整圖片大小為使用者縮圖大小偏好設定的倍數 (請參閱 $wgThumbLimits )--或預設縮圖的大小(對於已登出的使用者或未變更偏好設定的已登入使用者)--以符合合理的尺寸。 该选项通常對於那些高度大于宽度的图片很有用。 需要 thumb 或 frameless 选项。 选项|upright=1.0|会以用户的默认图像宽度显示图片。 |upright=2.0|会以用户默认图像宽度的2倍显示图片。
    图像总是会保持它原有的长宽比例。
    不可放缩的文件格式的图片可以被缩小，但不能被放大；例如，位图图像不能被放大。
    upright选项并不一定需要一个等号，也就是说，|upright 2.0|和|upright=2.0|效果相同。
    如果没有填入任何值或等号（例如, |upright|），默认视作 |upright=0.75| （但 |upright=| 的效果相当于 |upright=1.0|）。
    默认最大尺寸取决于“格式”和内部图像尺寸（根据其媒体类型）。
  • 水平对齐选项：为left，right， center，none中的一个。 如果填入了多个选项，只有第一个会被使用。
    在文本内控制图片的水平对齐（及行内/块状或浮动样式）（没有默认值）。
  • 垂直对齐选项：为baseline、sub、super、top、text-top、middle、bottom、text-bottom中的一个；
    在文本内控制非浮动行内图片的图片前后，以及同一块内的垂直对齐（默认的垂直对齐值为middle）。
  • 链接选项：以下之一
    • link={target}–允许您更改生成的链接的目标（为任意页面标题或URL），可以从图像链接到；例如：[[File:Example.jpg|20px|link=http://www.wikipedia.org]]呈现为 （外部链接），或者是[[File:Example.jpg|20px|link=MediaWiki]]呈现为 （内部链接）。
    • link= (为空值) –（MediaWiki 1.14+）显示图片且不显示链接；例如：[[File:Example.jpg|20px|link=]]呈现为 。
    如果link和等于号之间有空格，则该语句会被视为普通的图片说明。
    包含某些HTML字符等价，例如%22替代"，可能导致整个语句被视为图片说明（参见phabricator:T306216）。
    !对于MW 1.24及其以下版本：若您设置了|link=|（为空），则不显示title。（参见phabricator:T23454。）
  • 其它特定选项：
    • alt={替代文本} —— （MediaWiki 1.14+）定义了若引用的图像无法下载和嵌入时的替代文本（映射到HTML元素‎<img />中的alt="..."属性），或者是所支持的媒体必须使用使用替代描述文本（例如：使用盲文阅读器或用户浏览器中设置的辅助功能选项）。
    如果alt和等于号之间有空格，则替代文字语句会被视为普通的图片说明。
    • page={number} – 呈现指定的页码（当前仅使用于显示 .djvu 或 .pdf 文件）
    • thumbtime={number} – 以指定的时间戳（以秒为单位）或MM:SS或HH:MM:SS格式（仅适用于显示视频文件）从视频中呈现缩略图。
    • start={number} – 开始播放视频时，它将以指定的时间戳（以秒为单位）或MM:SS或HH:MM:SS格式开始播放（仅适用于显示视频文件时）。
    • muted – 媒体开始播放时，音频将被静音。
    • loop – 媒体将持续循环播放。（仅适用于音频和视频）
    • lossy={false} – (PagedTiffHandler ) 用于使用PNG而不是JPG缩略图进行Tiff图像
    • class={html class} – (MediaWiki 1.20+) 定义类（映射到围绕‎<img />元素生成的‎<span>...‎</span>元素的HTML属性class="..."）。
      MediaWiki 1.40起的默认行为，MediaWiki 1.36起可选。[1] 以前，该类直接应用于‎<img />元素。[2]
    • lang={language code} – (MediaWiki 1.22+) 对于包含<switch>声明，与“系统语言”属性不同的SVG文件，选择渲染文件时使用的语言。 預設為頁面語言（在大多數專案中預設為計劃的預設語言）。

如果参数不符合任何其他的可能性，则将被认为是标题文本。 如果有多个非参数字符串，则图片说明中只会使用最后的非参数字符串。 标题文本在thumb 和 frame格式下在图片下方显示，其他格式下会作为提示文本显示。 在thumb 和 frame格式下显示的标题文本可能包含Wiki链接和其他格式。 MediaWiki扩展可以添加额外的选项。

若没有指定“alt”且提供了标题，替代文字将自动创建为去除格式的标题。“thumb”和“frame”模式中标题已对屏幕阅读器可见因此不会自动创建替代文字。

縮圖尺寸

檔案縮圖是以離散的尺寸儲存的。如果頁面指定的縮圖尺寸不在標準尺寸(20, 40, 60, 120, 250, 330, 500, 960)之列，那麼 MediaWiki 將會選擇最接近的較大縮圖尺寸，但會告訴瀏覽器將縮小到所要求的尺寸。在這種情況下，視覺上沒有任何變化，但使用者可能會載入稍大一點的圖片。如果在頁面中使用哪種縮圖尺寸並不重要，請選擇其中一種標準尺寸，以避免額外的瀏覽器內縮放步驟。

格式

下表显示了所有可用格式的效果。

描述 您输入的 您输出的
未指定格式
显示为浮动式: 否
显示为嵌入式: 是
生成的文件说明: 否 
... 文本 文本 文本
[[File:example.jpg|标题]]
文本 文本 文本 ...
... 文本 文本 文本

  文本 文本 文本 ...

border 将呈现一个非常小的灰色边框
显示为浮动式: 否
显示为嵌入式: 是
生成的文件说明: 否 
... 文本 文本 文本
[[File:example.jpg|border|标题]]
文本 文本 文本 ...
... 文本 文本 文本

  文本 文本 文本 ...

frameless，与thumbnail相似，尊重用户对于图像宽度的偏好，但没有边框且不向右浮动。
显示为浮动式: 否
显示为嵌入式: 是
生成的文件说明: 否 
... 文本 文本 文本
[[File:example.jpg|frameless|标题]]
文本 文本 文本 ...
... 文本 文本 文本

  文本 文本 文本 ...

frameless 和 border
显示为浮动式: 否
显示为嵌入式: 是
生成的文件说明: 否 
... 文本 文本 文本
[[File:example.jpg|frameless|border|标题]]
文本 文本 文本 ...
... 文本 文本 文本

  文本 文本 文本 ...

frame
显示为浮动式: 是
显示为嵌入式: 否
生成的文件说明: 是 
... 文本 文本 文本
[[File:example.jpg|frame|标题]]
文本 文本 文本 ...
... 文本 文本 文本
 
标题

文本 文本 文本 ...

thumb 或 thumbnail
显示为浮动式: 是
显示为嵌入式: 否
生成的文件说明: 是 
... 文本 文本 文本
[[File:example.jpg|thumb|标题]]
文本 文本 文本 ...
... 文本 文本 文本
 
标题

文本 文本 文本 ...

当缩略图中图像的高度大于其宽度（即纵向而不是横向）时，如果图像的高度太大，可以尝试使用upright=N，其中N是图像的纵横比（宽度除以其高度，默认为0.75）。 另一种方法是明确指定所需的最大高度（以像素为单位）。

注意，通过添加thumb={filename}，您可以为缩略图使用不同的图像。

大小和框架

在不同的格式中，大小参数的效果可能不同，如下所示。

  • 关于在未指定大小时的显示方式，请参阅上面的格式章节。
  • 当格式没有指定或者只有border，图像的尺寸可以缩小或放大到所有指定的尺寸。
  • 在下面的例子中，图像的原始尺寸为400×267像素。
  • 带有frame时，图像将始终忽略指定的大小。原始图像的尺寸超过用户偏好中定义的最大尺寸时，则将会被缩小，页面信息将会显示一个Linter错误。
  • 带有thumb或frameless时，图像被可以减小，但不能放大超出图像的原始大小。
格式 缩小 放大
(not specified) 
[[File:example.jpg|50px]]

  

[[File:example.jpg|500px]]

 


border 
[[File:example.jpg|border|50px]]

  

[[File:example.jpg|border|500px]]

 


frame 
[[File:example.jpg|frame|50px]]
 
 
[[File:example.jpg|frame|500px]]
 


thumb 
[[File:example.jpg|thumb|50px]]
 
 
[[File:example.jpg|thumb|500px]]
 


frameless 
[[File:example.jpg|frameless|50px]]

  

[[File:example.jpg|frameless|500px]]

 

水平对齐

注意，当使用frame 或 thumb[nail] 格式时，对于从左向右书写的语言，图片是水平向右对齐的；对于从右向左书写的语言，图片水平向左对齐。

描述 您输入的 您得到的
未指定水平对齐，或是默认对齐
显示为浮动式: 否
显示为嵌入式: 是 
... 文本 文本 文本
[[File:example.jpg|100px|标题]]
文本 文本 文本 ...
... 文本 文本 文本

  文本 文本 文本 ...

指定水平对齐为：none
显示为浮动式: 否
显示为嵌入式: 否 
... 文本 文本 文本
[[File:example.jpg|none|100px|标题]]
文本 文本 文本 ...
... 文本 文本 文本
 
标题

文本 文本 文本 ...

指定水平对齐为：center（居中）
显示为浮动式: 否
显示为嵌入式: 否 
... 文本 文本 文本
[[File:example.jpg|center|100px|标题]]
文本 文本 文本 ...
... 文本 文本 文本
 
标题

文本 文本 文本 ...

指定水平对齐为：left（向左）
显示为浮动式: 是
显示为嵌入式: 否 
... 文本 文本 文本
[[File:example.jpg|left|100px|标题]]
文本 文本 文本 ...
... 文本 文本 文本
 
标题

文本 文本 文本 ...

指定水平对齐为：right（向右）
显示为浮动式: 是
显示为嵌入式: 否 
... 文本 文本 文本
[[File:example.jpg|right|100px|标题]]
文本 文本 文本 ...
... 文本 文本 文本
 
标题

文本 文本 文本 ...

垂直对齐

垂直对齐选项仅在图像呈现为内联元素且不浮动时才能生效。 它们改变了内嵌图像在同一渲染行上的图像之前和/或之后与同一块中存在的文本垂直对齐的方式。

注意，插入内嵌图像显示的文本行（以及后面显示的文本行）可能会向下移动（这将通过增加行间距来增加行高度，就像使用span标签设置字体大小参数的文本或者是带有上标或下标），以根据这个对齐约束来完全显示图像的高度。

切换源代码视图
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''top:''' [[File:Example.jpg|20px|top]] [[File:Example.jpg|40px|top]] [[File:Example.jpg|100px|top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-top:''' [[File:Example.jpg|20px|text-top]] [[File:Example.jpg|40px|text-top]] [[File:Example.jpg|100px|text-top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sup>super:</sup> [[File:Example.jpg|20px|super]] [[File:Example.jpg|40px|super]] [[File:Example.jpg|100px|super]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''baseline:''' [[File:Example.jpg|20px|baseline]] [[File:Example.jpg|40px|baseline]] [[File:Example.jpg|100px|baseline]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sub>'''sub:'''</sub> [[File:Example.jpg|20px|sub]] [[File:Example.jpg|40px|sub]] [[File:Example.jpg|100px|sub]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''default:''' [[File:Example.jpg|20px]][[File:Example.jpg|40px]] [[File:Example.jpg|100px]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''middle:''' [[File:Example.jpg|20px|middle]] [[File:Example.jpg|40px|middle]] [[File:Example.jpg|100px|middle]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-bottom:''' [[File:Example.jpg|20px|text-bottom]] [[File:Example.jpg|40px|text-bottom]] [[File:Example.jpg|100px|text-bottom]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]]
<del>text</del></u></span></p>

为了更清晰地显示对齐结果，文本被添加上划线和下划线，字体大小增加到200％，并且用细边框勾勒段落块；另外不同大小的图像是成一条线的：

text top:       text

text text-top:       text

text super:       text

text baseline:       text

text sub:       text

text default:       text

text middle:       text

text text-bottom:       text

text bottom:       text

备注：

  1. 图片位置的“居中”垂直对齐（即默认值）通常是指位于x高度和文本基线中央（图像的垂直中心会对齐到x高度，文本书写与文本基线上），但并不是对齐到字体高度的行高的中央（即“文本顶部”和“文本底部”位置之间的空格）；字体高度不包括：
    • 额外的行距（line separation spacing）通常被均分为字体高度上方和下方的两个行边距（line-margins），这里是0.5em，根据设置为200%的行高。
    • 可能被上下标添加的额外行距。
  2. 然而，如果图像高度导致顶部或底部位置超过正常完整文本行高之上或之下，则中央位置会在增加顶部/底部行间距后进行调整，这样图片可以适当地适应和对齐，且所有图片（包括高度较小的）将垂直居中于文本调整中间位置（为了计算有效行高，会考虑每行字体高度较大的文本）。
  3. “文本顶部”和“文本底部”对齐位置也不包括由上下标添加的额外行距，但没有由行高定义的额外的行距。
  4. “顶部”与“底部”对齐位置会考虑所有的额外的行距（包括上下标，如果渲染的行范围中存在）。 当图像对齐将图像限制在正常行距之上或之下增长，且图像不是绝对定位时，图像将导致调整“顶部”和“底部”位置（就像上标和下标一样），因此文本的渲染行之间的有效行高会更高。
  5. “下划线”“上划线”“删除线”这些文本装饰（text-decoration），一般是在这两个限制之内的，“可能会”取决于使用的字体的类型和高度（部分浏览器会考虑上下标，但通常这些样式会被忽略，文本装饰的位置也不会调整）；所以这些文本装饰通常不会影响图像相对文本的垂直位置。

停止文本流

有时需要阻止文本（或其他内联非浮动图像）在浮动图像周围流动。 根据web浏览器的屏幕分辨率或者类似的，图像右侧的文本流可能导致段落标题（例如，== 我的标题 ==）出现在图像的右侧，而不是像用户想看到的那样出现在图像下方。 可以通过在需要在浮动图像之下开始的文本之前放置<div style="clear: both"></div>来阻止文本流。 （也可以通过将带有浮动图片的段落包装在<div style="overflow: hidden">…</div>中来做到这样而无需添加新行，这会清除div元素内的所有浮动。）

所有渲染为块的图像（包括非浮动的中央图像、左浮或右浮的图像，以及有框架或缩略图的浮动图像）都会不明显地打断周围文本行（中止图片前文本的当前块，为其后的文本创建新的段落）。 然后，这些图像就会沿着左侧或右侧对齐边距（或者沿着居中对齐图像的这些边距之间的中心行）垂直堆叠。

修改默认链接目标

下表显示了如何更改链接目标（默认为图像说明页面 ）或如何移除它。 更改链接不会改变前面部分中描述的格式。

描述 您输入的 您输出的
内部链接 
... 文本 文本 文本
[[File:example.jpg|link=Main Page|标题]]
文本 文本 文本 ...
... 文本 文本 文本

  文本 文本 文本 ...

外部链接 
... 文本 文本 文本
[[File:example.jpg|link=http://wikipedia.org/wiki/Test|标题]]
文本 文本 文本 ...
... 文本 文本 文本

  文本 文本 文本 ...

无链接（外部链接或文件页面） 
... 文本 文本 文本
[[File:example.jpg|link=|标题]]
文本 文本 文本 ...
... 文本 文本 文本

  文本 文本 文本 ...

警告:
您的wiki上的许可要求可能会禁止您移除所有指向描述页的链接，因为那上面显示了必需的作者署名、著作权声明、应用的许可证、或者对图片更详细的描述（包括该文件的更改历史）。
如果您更改或者移除了一个图片的链接，您之后需要在该页面其他位置提供一个单独的链接指向描述页，或者在图片许可信息与页面不一致的情况下列出著作权和作者的信息并提供指向应用的许可证的链接。
您的wiki政策可能会限制链接参数的使用，甚至直接阻止嵌入式媒体文件的链接参数（此情况下链接参数会被忽略），或者只能在认证用户或管理员许可后才能使用。


渲染一系列图片的图库

图库语法

使用‎<gallery>标签制作缩略图图库很容易。 语法为： 

<gallery>
File:file_name.ext|caption|alt=alt language
File:file_name.ext|caption|alt=alt language
{...}
</gallery>

注意，在gallery标签中图片代码没有使用中括号括起来。

标题是可选的，其可以包含Wiki链接或其他格式。

图库不允許使用小寫的“center”、“left”、“right”作為图库图片的標題，因為会导致偽陽性Linter报错。 参见T275074以获取更多信息。

控制图片显示的一些参数也可以在这里使用，特别是那些修改文件的参数（与控制图像在页面中的位置不同）。 例如：带有多个页面的PDF文档，您可以使用像page=4这样的代码，对于视频则可以使用thumbtime=10。

File:前缀可以被省略。 不过，包含前缀有助于快速在wikitext中定位图片声明语句（比如说清理页面版式的时候）

如果圖片連結到外部網站，標題必須在連結參數「之前」，否則標題將無法顯示。

例如： 

<gallery>
File:Example.jpg|項目1
File:Example.jpg|連結至 [[Help:Contents]]
File:Example.jpg
File:Example.jpg|alt=範例圖片。它有花朵
File:Example.jpg|''斜體標題''
File:Example.jpg|link=https://example.com|此文字不會顯示，因為外部連結在先
File:Example.jpg|連結至外部網站|link=https://example.com
File:Example.jpg|link=w:Main_Page|内部链接
Example.jpg|on page "{{PAGENAME}}"
File:Using Firefox.pdf|page=72
</gallery>

会被格式化为：

mode参数

MediaWiki版本：
≥ 1.22

自1.22版本开始，我们有了一个实验性的mode参数，采取如下选项：

  • traditional是MediaWiki使用的最初的图库类型。
  • nolines与traditional相似，但不包含边框。
  • packed使图像拥有相同的高度但是宽度不同，图像之间的空隙很小。 这个响应模式中的行根据屏幕的宽度自行组织。
  • packed-overlay用一个半透明的白框将标题覆盖显示在图像上。
  • packed-hover与packed-overlay相似，但图片标题和白框只在悬停时显示。
  • slideshow用幻灯片形式展现图像。

例如： 

<gallery mode="packed-hover">
File:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar)
File:Salmonlarvakils.jpg|''[[commons:Salmo salar|Salmo salar]]'' (Salmon Larva)
File:Georgia Aquarium - Giant Grouper.jpg|''[[commons:Epinephelus lanceolatus|Epinephelus lanceolatus]]'' (Giant grouper)
File:Pterois volitans Manado-e.jpg|''[[commons:Pterois volitans|Pterois volitans]]'' (Red Lionfish)
File:Macropodus opercularis - front (aka).jpg|''[[commons:Macropodus opercularis|Macropodus opercularis]]'' (Paradise fish)
File:Canthigaster valentini 1.jpg|''[[commons:Canthigaster valentini|Canthigaster valentini]]'' (Valentinni's sharpnose puffer)
File:Flughahn.jpg|[[File:POTY ribbon 2007.svg|25px]] ''[[commons:Dactylopterus volitans|Dactylopterus volitans]]'' (Flying gurnard)
File:Fishmarket 01.jpg|''[[commons:Semicossyphus pulcher|Semicossyphus pulcher]]'' (California Sheephead)
File:Pseudorasbora parva(edited version).jpg|''[[commons:Category:Pseudorasbora parva|Pseudorasbora parva]]'' (Topmouth gudgeon)
File:MC Rotfeuerfisch.jpg|''[[commons:Category:Pterois antennata|Pterois antennata]]'' (Antennata Lionfish)
File:Cleaning station konan.jpg|''[[commons:Novaculichthys taeniourus|Novaculichthys taeniourus]]''
File:Synchiropus splendidus 2 Luc Viatour.jpg|''[[commons:Synchiropus splendidus|Synchiropus splendidus]]'' (Mandarin fish)
File:Psetta maxima Luc Viatour.jpg|''[[commons:Psetta maxima|Psetta maxima]]'' (Turbot)
File:Australian blenny.jpg|''[[commons:Category:Ecsenius|Ecsenius axelrodi]]''
</gallery>

使用（packed-hover选项）：

使用其他选项的例子：

mode="traditional"

mode="nolines"

mode="packed"

mode="packed-overlay"

mode="packed-hover"

MediaWiki版本：
≥ 1.28

mode="slideshow"

可选的图库属性

gallery标签本身也有一些额外的参数，通过名称-值对进行声明： 

<gallery {parameters}>
{images}
</gallery>
  • caption="{caption}": （多个词汇需要包含在双引号之间）在图库顶部居中位置显示说明。只能使用纯文本，格式代码、模板等不会工作。
  • widths={width}px: 设置图片的（最大）宽度。默认值是120像素。 （当模式设置为以下选项之一时无效：packed, packed-overlay, packed-hover, slideshow） 注意复数：widths.
  • heights={heights}px: 设置图片的（最大）高度。默认值是120像素。 （当模式设置为slideshow时无效。）
  • perrow={integer}：设置一行内图片的数量。 （当模式设置为以下选项之一时无效：packed, packed-overlay, packed-hover, slideshow） 預設值為 perrow=0，會根據螢幕寬度自動調整每行的影像數量。
  • showfilename={anything}：在单独的图片标注中显示每个文件的文件名称（1.17+）。
  • mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow}：见上文。（1.22+；对于"slideshow"则是1.28+）
  • showthumbnails: 仅供 "slideshow" 模式，在幻灯片底部显示带有图像缩略图的条带（1.29+）。
  • <ul>标签上允许的任何html属性（例如id、title、class）
在打包（及相關）模式中，widths 參數沒有任何作用；相反，heights 參數會決定影像的最小高度。 打包模式會調整影像的寬度，以確保每一行的長度相等，除非某一行包含的影像太少，無法在不過度放大影像的情況下達到此目的。
示例 1

语法： 

<gallery widths=300 heights=200>
File:Example.jpg|Lorem ipsum
File:Example.jpg|Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
</gallery>

结果：

  •  
    Lorem ipsum
  •  
    Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
示例 2

语法： 

<gallery widths=60 heights=60 perrow=7 caption="向日葵很时髦">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>

结果：

将包裹至浏览器宽度的图片行

对于一行宽度不同的图片，一种有效的方法就是不使用“thumb”、“left”、或“none”。 如果不使用“thumb”（因此也不会有文件说明），这一行图片就会换行到浏览器的宽度。 需要的话，您可以缩小浏览器的宽度，查看下面一行的图片换行到浏览器的宽度。 

[[File:Example.jpg|220px]]
[[File:Example.jpg|100px]]
[[File:Example.jpg|150px]]
[[File:Example.jpg|250px]]
[[File:Example.jpg|200px]]
[[File:Example.jpg|50px]]
[[File:Example.jpg|220px]]
[[File:Example.jpg|175px]]

               

要将带有文件说明而宽度不同的图片就需要给一个无序列表使用div标签，并加上代码style="display: inline-block;"。更多信息和想法请参阅Give Floats the Flick in CSS Layouts。 

<div><ul> 
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>
  •  
    Caption 1
  •  
    Caption 2
  •  
    Caption 3
  •  
    Caption 4
  •  
    Caption 5
  •  
    Caption 6
  •  
    Caption 7
  •  
    Caption 8

要将图片顶部对齐，请添加vertical-align参数。 

<div><ul> 
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>
  •  
    Caption 1
  •  
    Caption 2
  •  
    Caption 3
  •  
    Caption 4
  •  
    Caption 5
  •  
    Caption 6
  •  
    Caption 7
  •  
    Caption 8

有些wiki农场不包含所有图库的选项（比如“widths”）。 同样的，有些时候人们希望在同一行里对不同图片调整宽度。 在图库或div元素之外，不可能为一行内每个图片添加文件说明，同时让它们换行到浏览器宽度。 您可以试一下。除了wikitext之外没有别的东西会正常工作。这些图片要么向右溢出，要么会强制出现一个水平滚动条。

为一些图片指定左侧浮动（"left"），同时为另一些图片使用"none"也不会正常工作，尤其是右侧有一个图片边栏。 这会导致一些奇怪的问题。 在较窄的浏览器或屏幕宽度下，行外的一张图片会出现在页面极下方，也就是右侧图片边栏的后面。

链接行为

默认情况下图片是链接到他的描述页面的。 “link=”选项可以修改这个行为将图片链接的另一个页面或网站，或是关闭图片的链接行为。

另外，您可以创建一个文本链接到文件描述页面或文件本身。 参见Help:链接到文件 。

显示图片，链接至另一页面或网站

使用“link=”选项链接图像到另一个页面或网站：

点击下方的图像将会引导您到MediaWiki页面： 

[[File:MediaWiki-2020-logo.svg|50px|link=MediaWiki]]

 

点击下方的图像将会带您到example.com： 

[[File:MediaWiki-2020-logo.svg|50px|link=http://example.com]]

 

显示关闭链接的图像

使用“link=”选项而不对齐赋值来完全关闭链接；下方是不带链接的图像： 

[[File:MediaWiki-2020-logo.svg|50px|link=]]

 

链接到图像

添加:作为前缀到您要创建的链接前： 

[[:File:MediaWiki-2020-logo.svg]]

File:MediaWiki-2020-logo.svg 

[[:File:MediaWiki-2020-logo.svg|Wiki]]

Wiki

直接链接到图像

上面的示例会链接到图片的描述页面。 要直接链接到图片本身，您可以在Mediawiki页面上使用Media:命名空间： 

[[Media:MediaWiki-2020-logo.svg]]

Media:MediaWiki-2020-logo.svg

来自外部网站的直链

另一种可能就是使用特殊页面Special:Redirect/file（简写为Special:Filepath）。 不像前面的例子，您可以在Mediawiki页面或外部网站链接到图片上。 

[[Special:Redirect/file/Wikipedia.png]]

您也可以添加参数height和width来得到一个特定尺寸的图片。 图片的纵横比始终会保持不变。 

https://www.mediawiki.org/w/index.php?title=Special:Redirect/file/Wikipedia.png&width=100&height=100

获取图片的完整链接

要获取图片的完整链接（而不使用前文的重定向），您可以使用一些魔术字 。 

{{filepath:MediaWiki-2020-logo.svg}}

会变为：

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg

鉴于这个是用在一个模板格式之中，并且需要移除File命名空间，您也可以使用{{PAGENAME}}： 

{{filepath:{{PAGENAME:File:MediaWiki-2020-logo.svg}}}}

会变成：

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg

在其他网站的图片

您可以使用链接到外部网页的相同方式链接到可在线获取的外部文件。 带有这些句法，图像将不会被渲染，但是只有链接到这个图像的文本才会被显示。 

[http://url.for/some/image.png]

或显示不同的文字： 

[http://url.for/some/image.png 在此输入链接文本]

额外的MediaWiki标记或HTML/CSS格式（对于内联元素）允许在显示文本中使用（除破坏周围链接的嵌入式链接外）： 

[http://www.example.com/some/image.png 这里是'''<del>富</del>'''''<ins>文本链接</ins>''示例。]

会渲染为： 这里是富文本链接示例。

若这在您的Wiki上启用了（参见手册:$wgAllowExternalImages ），您可以嵌入外部图像。要这样做，只需插入图片网址： 

http://url.for/some/image.png

目前，嵌入式图像无法调整大小，但可以通过MediaWiki标记或HTML/CSS代码进行格式化。

如果此Wiki未启用该选项，则图像将不会被嵌入，而会以与上述相同的方式呈现为外部网站的文本链接。

也可以使用 即时共享资源 或其他共用檔案儲存庫 ，從其他 wiki 載入檔案，這些檔案會被視為本機影像。

参见

  1. ↑ Manual:$wgParserEnableLegacyMediaDOM
  2. ↑ |class=媒体选项现在应用于包装器
Retrieved from "https://www.mediawiki.org/w/index.php?title=Help:Images/zh&oldid=7615302"