Help:Images/zh

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

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

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



支持的媒体类型
下面的文件格式默认被支持：


 * 或  - 以标准JPEG格式压缩的位图图像（这种有损格式最适合于照片）.
 * - “便携式网络图形”格式的位图图像（由W3联盟指定）.
 * - 传统“图形交换格式”中的位图图像.
 * - WebP 支持有损和无损压缩格式，并且最大能压缩45%的大小.

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


 * - 可扩展的图像“可缩放矢量图形”格式（由W3联盟指定）. 参见手册:图片管理#SVG.
 * - 标签图像格式. 常用于高分辨率档案照片.  通常与一同使用.
 * ,,   - Ogg多媒体（音频或视频）.  不是一个图像格式，但对待方式类似.  通常与一同使用.
 * - 多页文档的便携文档格式（最初由Adobe指定）. 通常与配合使用.
 * - DejaVu格式的多页面位图文档（通常是书本的扫描）. 参见
 * 一次只显示 或 文件的单个页面.

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



语法
显示图像的完整语法是：

options可以不存在或者为以下内容，通过管道符号（|）分隔：


 * 格式选项：border和frameless、frame（或framed）、thumb（或者是thumbnail）中的一个； Note: border can be used in combination with frameless but will be ignored if used with one of the other options.
 * 控制呈现的图像应如何格式化并在页面的其余部分嵌入.
 * 调整大小选项：下面列出中的一个
 * {宽度}px——根据给定的最大宽度（以像素为单位）调整图像大小，不限制图像的高度. (只支持整数像素值.  可以在宽度值和“px”之间添加一个空格. )
 * x{高度}px——根据给定的最大高度（以像素为单位）调整图像大小，而不限制图像的宽度. 只支持整数像素值.  可以在寬度值和“px”之间添加一个空格.
 * {宽度}x{高度}px——调整图像的大小以适应给定宽度和高度（以像素为单位）. 只支持整数像素值.  可以在宽度值和“px”之间添加一个空格.
 * upright — 根据用户的偏好（对于未登录用户则是默认的thumbnail尺寸）调整图像尺寸为适合合理的尺寸. 该选项适合那些高度大于宽度的图片.  需要 thumb 或 frameless 选项.  选项 会以用户的默认图像宽度显示图片.   会以用户默认图像宽度的2倍显示图片.
 * 图像总是会保持它原有的长宽比例.
 * 不可放缩的文件格式的图片可以被缩小，但不能被放大；例如，位图图像不能被放大.
 * 选项并不一定需要一个等号，也就是说， 和 效果相同.
 * 如果没有填入任何值或等号（例如, ），默认视作   （但   的效果相当于  ）.
 * 默认最大尺寸取决于“格式”和内部图像尺寸（根据其媒体类型）.
 * 水平对齐选项：为left，right， center，none中的一个. 如果填入了多个选项，只有第一个会被使用.
 * 在文本内控制图片的水平对齐（及行内/块状或浮动样式）（没有默认值）.
 * 垂直对齐选项：为baseline、sub、super、top、text-top、middle、bottom、text-bottom中的一个；
 * 在文本内控制非浮动行内图片的图片前后，以及同一块内的垂直对齐（默认的垂直对齐值为middle）.
 * 链接选项：以下之一
 * link={目标} —— 允许您更改生成的链接的目标（为任意页面标题或URL），可以从图像链接到；例如： 呈现为Example.jpg（外部链接），或者是 呈现为Example.jpg（内部链接）.
 * link= (为空值) —— （MediaWiki 1.14+）显示图片且不显示链接；例如： 呈现为Example.jpg.
 * 如果 和等于号之间有空格，则该语句会被视为普通的图片说明.
 * 包含某些HTML字符等价，例如 替代 ，可能导致整个语句被视为图片说明（参见T306216）.


 * !对于MW 1.24及其以下版本：若您设置了 （为空），则不显示 . （参见T23454. ）
 * 其它特定选项：
 * alt={替代文本} —— （MediaWiki 1.14+）定义了若引用的图像无法下载和嵌入时的替代文本（映射到HTML元素中的 属性），或者是所支持的媒体必须使用使用替代描述文本（例如：使用盲文阅读器或用户浏览器中设置的辅助功能选项）.
 * 如果 和等于号之间有空格，则替代文字语句会被视为普通的图片说明.
 * page={数字} —— 呈现指定的页码（当前仅使用于显示 .djvu 或 .pdf 文件）
 * thumbtime={number} — Renders a thumbnail from the video at the specified timestamp in seconds or MM:SS or HH:MM:SS format (only applicable when showing a video file).
 * start={number} — When video playback is started it will start at the specified timestamp in seconds or MM:SS or HH:MM:SS format (only applicable when showing a video file).
 * muted — When media playback is started, audio will be muted.
 * loop — Media will loop continuously. (only applies to audio and video)
 * class={html类} —— （MediaWiki 1.20+）定义类（映射到生成的元素的HTML属性 ）.
 * lang={语言代码}——（MediaWiki 1.22+）对于包含&lt;switch&gt;声明，与“系统语言”属性不同的SVG文件，选择渲染文件时使用的语言. 默认值总是英语，即便在非英语wiki上.

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

若“alt”没有被指定且提供了标题，替代文字将从标题自动创建建而不进行格式化，除了自从字母已经由屏幕阅读者可读以来，在“thumb”或“frame”模式中的格式.

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

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

注意，通过添加 ，您可以为缩略图使用不同的图像.



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


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



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



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

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



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



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

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



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

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

<span id="Rendering_a_gallery_of_images">

渲染一系列图片的图库
<span id="Gallery_syntax">

图库语法
使用标签制作缩略图图库很容易. 语法为：

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

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

控制图片显示的一些参数也可以在这里使用，特别是那些修改文件的参数（与控制图像在页面中的位置不同）. 例如：带有多个页面的PDF文档，您可以使用像$code这样的代码.

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

例如：

会被格式化为：

<span id="mode_parameter">

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


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

例如：

使用（ 选项）：

<span id="Optional_gallery_attributes">

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


 * : （多个词汇需要包含在双引号之间）在图库顶部居中位置显示说明. 只能使用纯文本，格式代码、模板等不会工作.
 * : 设置图片的（最大）宽度. 默认值是120像素. （当模式设置为以下选项之一时无效：packed, packed-overlay, packed-hover, slideshow） 注意复数：widths.
 * : 设置图片的（最大）高度. 默认值是120像素. （当模式设置为slideshow时无效. ）
 * ：设置一行内图片的数量. （当模式设置为以下选项之一时无效：packed, packed-overlay, packed-hover, slideshow） 0 表示根据屏幕宽度自动调整数量.
 * ：在单独的图片标注中显示每个文件的文件名称（1.17+）.
 * ：见上文. （1.22+；对于"slideshow"则是1.28+）
 * : 仅供 "slideshow" 模式，在幻灯片底部显示带有图像缩略图的条带（1.29+）.


 * 示例 1

语法：

结果：

<span id="Row_of_images_that_will_wrap_to_browser_width">

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





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

<ul> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> </ul>

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

<ul> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> </ul>

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

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

<span id="Link_behavior">

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

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

<span id="Display_image,_link_it_to_another_page_or_website">

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

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





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





<span id="Display_image,_turn_off_link">

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





<span id="Link_to_an_image">

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

File:MediaWiki-2020-logo.svg File:MediaWiki-2020-logo.svg Wiki Wiki

<span id="Directly_linking_to_an_image">

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

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

<span id="Direct_links_from_external_sites">

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

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

<span id="Obtaining_the_full_URL_of_an_image">

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

会变为：



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

会变成：



<span id="Files_at_other_websites">

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



或显示不同的文字：

在此输入链接文本

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

[http://www.example.com/some/image.png 这里是 富  文本链接 示例. ]

会渲染为： [http://www.example.com/some/image.png 这里是 富  文本链接 示例. ]

若这在您的Wiki上启用了（参见），您可以嵌入外部图像. 要这样做，只需插入图片网址： http://url.for/some/image.png 目前，嵌入式图像无法调整大小，但可以通过MediaWiki标记或HTML/CSS代码进行格式化.

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

<span id="See_also">

参见

 * Wikipedia:Extended image syntax
 * Category:Wikipedia image help
 * Help:图像
 * w:Help:Gallery tag
 * T113101 - 响应问题
 * Extension:PageImages#Can I exclude certain page images?
 * Extension:PageImages#Can I exclude certain page images?