Help:Images/zh

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

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

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


 * .jpg 或 .jpeg ：以标准JPEG格式压缩的位图图像（这种有损格式最适合于照片）.
 * .png：“便携式网络图形”格式的位图图像（由W3联盟指定）.
 * .gif ：传统“图形交换格式”中的位图图像.

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


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

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

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

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

如果 "upright" 和等号之间有空格（例如 )），或者如果"upright"值包含非数字字符，则   的值会被忽略.  详情请见.
 * 格式选项：为border和/或frameless，frame，thumb（或者是thumbnail）； 如果填入了多个选项，只有第一个会被使用.
 * 控制呈现的图像应如何格式化并在页面的其余部分嵌入.
 * 调整大小选项：下面列出中的一个
 * {宽度}px——根据给定的最大宽度（以像素为单位）调整图像大小，不限制图像的高度； (在宽度值和“px”之间允许添加一个空格. )
 * x{高度}px——根据给定的最大高度（以像素为单位）调整图像大小，而不限制图像的宽度；
 * {宽度}x{高度}px——调整图像的大小以适应给定宽度和高度（以像素为单位）；
 * upright——根据用户的喜好调整图像尺寸为适合合理的尺寸（适合高度大于宽度的图像）. 选项 会以用户的默认图像宽度显示图片.   会以用户默认图像宽度的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.
 * If there is a space character between  and the equals sign, the link statement will be treated as a caption.
 * Including some HTML character equivalents, like  for , can cause the link statement to be treated as a caption (see T216003).


 * !对于MW 1.24及其以下版本：若您设置了 (为空)，那么没有 会被呈现. （参见 T23454）
 * 其它特定选项：
 * alt={替代文本} —— （MediaWiki 1.14+）定义了若引用的图像无法下载和嵌入时的替代文本（映射到HTML元素 中的 属性），或者是所支持的媒体必须使用使用替代描述文本（例如：使用盲文阅读器或用户浏览器中设置的辅助功能选项）.
 * If there is a space character between  and the equals sign, the alt statement will be treated as a caption.
 * page={数字} —— 呈现指定的页码（当前仅使用于显示 .djvu 或 .pdf 文件）
 * class={html类} —— （MediaWiki 1.20+）定义类（映射到生成的 元素的HTML属性 ）.
 * lang={语言代码}——（MediaWiki 1.22+）对于包含&lt;switch&gt;声明，与“系统语言”属性不同的SVG文件，选择渲染文件时使用的语言. 默认值总是英语，即便在非英语wiki上.

如果参数不符合任何其他的可能性，则将被认为是标题文本. If more than one non-parameter string is present, the final non-parameter string will be used as the caption. 标题文本在thumb 和 frame格式下在图片下方显示，其他格式下会作为提示文本显示. 在thumb 和 frame格式下显示的标题文本可能包含Wiki链接和其他格式. MediaWiki扩展可以添加额外的选项.

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

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

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

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

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


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

水平对齐
注意，当使用 或   格式时，默认是向右水平对齐的.

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

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



为了更清晰地显示对齐结果，文本被添加上划线和下划线，字体大小增加到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) The "middle" vertical alignment position of the image (which is also the default) usually refers to the middle between the x-height and the baseline of the text (on which the vertical middle of the image will be aligned, and on which usually the text may be overstroke), but not to the middle of the line-height of the font-height that refers to the space between the "text-top" and "text-bottom" positions ; the font-height excludes:
 * 2) * the additional line separation spacing normally divided equally into two line-margins (here 0.5em, according to line-height set to 200%) above and below the font-height).
 * 3) * the additional line spacing which may be added by superscripts and subscripts.
 * 4) However, if the image height causes its top or bottom position to go above or below the normal full line-height of text, the middle position will be adjusted after the increasing the top and/or bottom line-margins so that the image can fit and align properly, and all images (including those with smaller heights) will be vertically centered on the adjusted middle position (for computing the effective line-height, the text of each rendered row with the larger font-height will be considered).
 * 5) The "text-top" and "text-bottom" alignment positions also excludes the extra line spacing added by superscripts and subscripts, but not the additional line-spacing defined by the line-height.
 * 6) The "top" and "bottom" alignment positions take into account all these extra line spacings (including superscripts and subscripts, if they are present in a rendered line span). When the image alignment constrains the image to grow above or below the normal line-spacing, and the image is not absolutely positioned, the image will cause the "top" and "bottom" positions to be adjusted (just like superscripts and subscripts), so the effective line-height between rendered lines of text will be higher.
 * 7) The "underline", "overline" and "overstrike" text-decoration positions should be somewhere within these two limits and may depend on the type and height of fonts used (the superscript and subscript styles may be taken into account in some browsers, but usually these styles are ignored and the position of these decorations may not be adjusted); so these decorations normally don't affect the vertical position of images, relatively to the text.

停止文本流
On occasion it is desirable to stop text (or other inline non-floating images) from flowing around a floating image. Depending on the web browser's screen resolution and such, text flow on the right side of an image may cause a section header (for instance, == My Header == ) to appear to the right of the image, instead of below it, as a user may expect. The text flow can be stopped by placing   (or if you prefer,  ) before the text that should start below the floating image. (This may also be done without an empty line by wrapping the section with the floating images with …, which clears all floats inside the   element.)

All images rendered as blocks (including non-floating centered images, left- or right-floating images, as well as framed or thumbnailed floating images) are implicitly breaking the surrounding lines of text (terminating the current block of text before the image, and creating a new paragraph for the text after them). They will then stack vertically along their left or right alignment margin (or along the center line between these margins for centered images).

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

警告:
 * The licencing requirements on your wiki may not allow you to remove all links to the description page that displays the required authors attributions, the copyrights statements, the applicable licencing terms, or a more complete description of the rendered image (including its history of modifications).
 * If you change or remove the target link of an image, you will then have to provide somewhere else on your page an explicit link to this description page, or to display the copyright and author statement and a link to the applicable licence, if they are different from the elements applicable to the embedding page itself.
 * Your wiki policy may restrict the use of the alternate link parameter, or may even enforce a prohibition of alternate link parameters for embedded media files (in which case, the link parameter will be ignored), or may only accept them after validation by authorized users or administrators.

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

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


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

例如：

使用（ 选项）：

可选的图库属性
The gallery tag itself takes several additional parameters, specified as attribute name-value pairs:

将包裹至浏览器宽度的图片行
One way that works for a row of images with varying widths is not to use "thumb" or "left" or "none". If "thumb" is not used (and thus no captions) a row of images will wrap to the browser width. If necessary, narrow the browser window to see the images wrap to the next row.





To wrap images of varying widths with captions it is necessary to use div HTML for an unordered list. Along with. For more info and ideas see: Give Floats the Flick in CSS Layouts.

        </li>  </li>  </li>  </li>  </li> </ul> This has aligned the bottom edge of the images. To align the top edges of the images instead, use.

Some wiki farms do not have all gallery options (such as "widths"). Also, sometimes one wants varying widths for images in a row. Outside of a gallery, or the div HTML, it is impossible to have individual captions for images in a row of images that will wrap to the browser width. Try it and see. Nothing else using wikitext works correctly. Images will either overlap stuff on the right, or force a horizontal scroll bar.

Using a left float ("left") for some images, combined with "none" for some of the images, will not work consistently either, especially if there is also a right sidebar of images. Weird things will occur. At narrower browser or screen widths an image out of the row may appear far down the page after the end of the right sidebar of images.

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

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

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

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





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





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





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

File:Wiki.png File:Wiki.png Wiki Wiki

Directly linking to an image
The above examples link to the image's description page. To directly link to an image, the pseudo-namespace  can be used on MediaWiki pages:

[[Media:Wiki.png]]

Direct links from external sites
Another possibility is to use the Special:Redirect/file page (or its alias Special:Filepath). Unlike the above example, you can link to it from external websites as well as from MediaWiki pages.

The parameters  and   can also be added to return a specific size of the image. The image aspect ratio is always preserved.

Obtaining the full URL of an image
To obtain the full path of an image (without going through redirects as shown above), some can be used.

Becomes:



In the event that this is used from a template where the  namespace needs to be removed,   can do so:

Becomes:



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

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



或显示不同的文字：

在此输入链接文本

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

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

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

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

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

参见

 * Wikipedia:Extended image syntax
 * Category:Wikipedia image help
 * Help:图像
 * Wikipedia:Help:Gallery tag