「ヘルプ:Images/ja」を編集中
この編集を取り消せます。
下記の差分を確認して、本当に取り消していいか検証してください。よろしければ変更を保存して取り消しを完了してください。
最新版 | 編集中の文章 | ||
1行目: | 1行目: | ||
− | + | {{PD Help Page}} | |
− | {{ | + | ここではウィキ上での'''画像'''表示のためのマークアップを説明しています。ページで使用するには通常、あなたまたは他の利用者が[[Help:Managing files|画像をアップロード]]する必要があります。 |
− | |||
− | |||
− | + | MediaWiki サーバーに格納されている画像は通常、MediaWiki リンクのターゲットとして名前空間接頭辞 <code>File:</code> を使用してレンダリングされます (以前の名前空間接頭辞 <code>Image:</code> にも別名として対応しています)。 別名の名前空間接頭辞 <code>Media:</code> も元のメディア ファイルのコンテンツを参照するのに有用です (あらゆる MediaWiki ページとは別個で描画またはダウンロードできるようにするため)。 | |
− | |||
== 対応している画像のメディアの種類 == | == 対応している画像のメディアの種類 == | ||
− | |||
既定では以下のファイル形式に対応しています: | 既定では以下のファイル形式に対応しています: | ||
+ | * .jpg or .jpeg : bitmap image compressed in the standard JPEG format (this lossy format is most suitable for photographs). | ||
+ | * .png : bitmap image in the ''[[w:Portable Network Graphics|Portable Network Graphics]]'' format (specified by the ''W3 Consortium''). | ||
+ | * .gif : bitmap image in the legacy ''Graphics Interchange Format''. | ||
− | + | ウィキメディアが使用しているその他の形式、およびその他の場所で広く有効になっている形式 (these may require extra set-up beyond what is enabled by default): | |
− | + | * .svg : scalable image in the ''Scalable Vector Graphics'' format (specified by the ''W3 Consortium''). See {{mediawiki|Manual:Image_Administration#SVG}}. | |
− | + | * .tiff : Tagged image format. Often used for high-resolution archival photographs. Often used with {{mediawiki|Extension:PagedTiffHandler}}. | |
− | + | * .ogg, .oga, .ogv : Ogg multimedia (audio or video). Not an image format, but treated similarly. Often used with {{mediawiki|Extension:OggHandler}} | |
− | + | * .pdf : multipaged documents in the ''Portable Document Format'' (initially specified by ''Adobe''). Often used in conjunction with {{mediawiki|Extension:PdfHandler}} | |
− | + | * .djvu : multipaged bitmap documents in the ''DejaVu'' format (most often, scans of books). See {{mediawiki|Manual:How to use DjVu with MediaWiki}} | |
− | * .svg : scalable image in the ''Scalable Vector Graphics'' format (specified by the ''W3 Consortium''). | ||
− | * .tiff : | ||
− | * .ogg, .oga, .ogv : Ogg multimedia (audio or video). | ||
− | * .pdf : multipaged documents in the ''Portable Document Format'' (initially specified by ''Adobe''). Often used in conjunction with {{ | ||
− | * .djvu : multipaged bitmap documents in the ''DejaVu'' format (most often, scans of books). {{ | ||
*: Only a single page of a .pdf or .djvu file is shown at one time. | *: Only a single page of a .pdf or .djvu file is shown at one time. | ||
− | + | その他のメディアの種類に対応している可能性がありますが、それらはインラインで表示できないかもしれません。 | |
− | == | + | == 1つの画像としてのレンダリング == |
=== 構文 === | === 構文 === | ||
+ | 画像を表示するためのマークアップは以下の通りです: | ||
+ | <nowiki>[[</nowiki>File:''ファイル名.拡張子''|''オプション''|''キャプション'']] | ||
− | + | オプションはまったく指定しなくてもよいし、複数指定することもできます。オプションはパイプ記号(<code>|</code>)で区切ります: | |
− | |||
− | |||
− | |||
− | |||
* ''[[#Format|Format]]'' option: one of '''border''' and/or '''frameless''', '''frame''', '''thumb''' (or '''thumbnail'''); | * ''[[#Format|Format]]'' option: one of '''border''' and/or '''frameless''', '''frame''', '''thumb''' (or '''thumbnail'''); | ||
*: Controls how the rendered image is formatted and embedded in the rest of the page. | *: Controls how the rendered image is formatted and embedded in the rest of the page. | ||
48行目: | 40行目: | ||
* ''[[#Vertical alignment|Vertical alignment]] option'': one of '''baseline''', '''sub''', '''super''', '''top''', '''text-top''', '''middle''', '''bottom''', '''text-bottom'''; | * ''[[#Vertical alignment|Vertical alignment]] option'': one of '''baseline''', '''sub''', '''super''', '''top''', '''text-top''', '''middle''', '''bottom''', '''text-bottom'''; | ||
*: Controls the vertical alignment of a non-floating inline image with the text before or after the image, and in the same block (the default vertical alignment is '''middle'''). | *: Controls the vertical alignment of a non-floating inline image with the text before or after the image, and in the same block (the default vertical alignment is '''middle'''). | ||
− | * ''[[#Altering the default link target| | + | * ''[[#Altering the default link target|Link]] option'': one of |
** '''link='''''{target}'' — Allows to change the target (to an arbitrary page title, or URL) of the generated link, activable on the rendered image surface; e.g. <code><nowiki>[[File:Example.jpg|20px|link=http://www.wikipedia.org]]</nowiki></code> renders as [[File:Example.jpg|20px|link=http://www.wikipedia.org]] (external link), or <code><nowiki>[[File:Example.jpg|20px|link=MediaWiki]]</nowiki></code> renders as [[File:Example.jpg|20px|link=MediaWiki]] (internal link). | ** '''link='''''{target}'' — Allows to change the target (to an arbitrary page title, or URL) of the generated link, activable on the rendered image surface; e.g. <code><nowiki>[[File:Example.jpg|20px|link=http://www.wikipedia.org]]</nowiki></code> renders as [[File:Example.jpg|20px|link=http://www.wikipedia.org]] (external link), or <code><nowiki>[[File:Example.jpg|20px|link=MediaWiki]]</nowiki></code> renders as [[File:Example.jpg|20px|link=MediaWiki]] (internal link). | ||
− | ** '''link=''' (with an empty value) — ({{mediawiki|rev:41727|MediaWiki 1.14 | + | ** '''link=''' (with an empty value) — ({{mediawiki|rev:41727|MediaWiki 1.14 以降}}) Displays an image without any activable link; e.g. <code><nowiki>[[</nowiki>File:Example.jpg|20px|link=]]</code> renders as [[File:Example.jpg|20px|link=]]. |
<!--*** '''!''' Link does '''not''' work with thumb, thumbnail or frame. (This works for external and internal links)--> | <!--*** '''!''' Link does '''not''' work with thumb, thumbnail or frame. (This works for external and internal links)--> | ||
*** '''!''' If you set <code>|link=|</code> (empty), then no <code>title</code> will be rendered. (See [[bugzilla:21454]].) | *** '''!''' If you set <code>|link=|</code> (empty), then no <code>title</code> will be rendered. (See [[bugzilla:21454]].) | ||
− | * | + | * Other specific options: |
− | ** '''alt='''''{alternative text}'' — ({{mediawiki|rev:41837|MediaWiki 1.14 | + | ** '''alt='''''{alternative text}'' — ({{mediawiki|rev:41837|MediaWiki 1.14 以降}}) Defines the alternative text (maps to the HTML attribute <code>alt="..."</code> of the generated <code><img /></code> element) of an image that will be rendered if either the referenced image cannot be downloaded and embedded, or if the support media must use the alternative description text (e.g. when using a Braille reader or with accessibility options set by the user in its browser). |
** '''page='''''{number}'' — Renders the specified page number (currently only applicable when showing a .djvu or .pdf file). | ** '''page='''''{number}'' — Renders the specified page number (currently only applicable when showing a .djvu or .pdf file). | ||
− | ** '''class='''''{html class}'' — (MediaWiki 1.20 | + | ** '''class='''''{html class}'' — (MediaWiki 1.20 以降) Defines classes (maps to the HTML attribute <code>class="..."</code> of the generated <code><img /></code> element). |
− | ** '''lang='''''{language code}'' — (MediaWiki 1.22 | + | ** '''lang='''''{language code}'' — (MediaWiki 1.22 以降) For SVG files containing [http://www.w3.org/TR/SVG/struct.html#SwitchElement <switch>] statements varying on a ''systemLanguage'' attribute, selects what language to render the file in. The default is always English, even on non-English wikis. |
− | If a parameter does not match any of the other possibilities, it is assumed to be the caption text. | + | If a parameter does not match any of the other possibilities, it is assumed to be the caption text. Caption text shows below the image in '''thumb''' and '''frame''' formats, or as tooltip text in any other format. Caption text displayed in the '''thumb''' and '''frame''' formats may contain wiki links and other formatting. MediaWiki extensions can add additional options. |
− | Caption text shows below the image in '''thumb''' and '''frame''' formats, or as tooltip text in any other format. | ||
− | Caption text displayed in the '''thumb''' and '''frame''' formats may contain wiki links and other formatting. | ||
− | MediaWiki | ||
If 'alt' is not specified and a caption is provided, the alternative text will be created automatically from the caption, stripped of formatting. | If 'alt' is not specified and a caption is provided, the alternative text will be created automatically from the caption, stripped of formatting. | ||
− | |||
=== 書式 === | === 書式 === | ||
− | + | 以下は各表示形式の指定結果を示す表です。 | |
− | |||
{|class="wikitable plainlinks" | {|class="wikitable plainlinks" | ||
75行目: | 62行目: | ||
!説明 | !説明 | ||
!入力内容 | !入力内容 | ||
− | ! | + | !表示結果 |
− | {{ | + | {{Help:Images/frame|frame=|ex=表示形式の指定なし|float=no|inline=yes|render caption=no}} |
− | {{ | + | {{Help:Images/frame|frame=border|ex='''border''' results in a very small gray border|float=no|inline=yes|render caption=no}} |
− | {{ | + | {{Help:Images/frame|frame=frameless|ex='''frameless''', like thumbnail, respect user preferences for image width, but without border and no right float|float=no|inline=yes|render caption=no}} |
− | {{ | + | {{Help:Images/frame|frame=frameless|2=border|ex='''frameless''' と '''border'''|float=no|inline=yes|render caption=no}} |
− | {{ | + | {{Help:Images/frame|frame=frame|ex='''frame'''|float=yes|inline=no|render caption=yes}} |
− | {{ | + | {{Help:Images/frame|frame=thumb|ex='''thumb''' or '''thumbnail'''|float=yes|inline=no|render caption=yes}} |
|} | |} | ||
− | When the height of an image in thumbnail is bigger than its width (i.e. in portrait orientation rather than landscape) and you find it too large, you may try the option <code>upright=N</code>, where N is the image's aspect ratio (its width divided by its height, defaulting to 0.75). | + | When the height of an image in thumbnail is bigger than its width (i.e. in portrait orientation rather than landscape) and you find it too large, you may try the option <code>upright=N</code>, where N is the image's aspect ratio (its width divided by its height, defaulting to 0.75). The alternative is to specify the desired maximum height (in pixels) explicitly. |
− | The alternative is to specify the desired maximum height (in pixels) explicitly. | ||
Note that by writing <code>thumb={filename}</code>, you can use a different image for the thumbnail. | Note that by writing <code>thumb={filename}</code>, you can use a different image for the thumbnail. | ||
− | + | === サイズとフレーム === | |
− | === | ||
− | |||
Among different formats, the effect of the size parameter may be different, as shown below. | Among different formats, the effect of the size parameter may be different, as shown below. | ||
− | |||
* For how it appears when its size is not specified, see [[#Format|Format]] section above. | * For how it appears when its size is not specified, see [[#Format|Format]] section above. | ||
* When the format is not specified, or only <code>border</code>ed, the size can be both reduced and enlarged to any specified size. | * When the format is not specified, or only <code>border</code>ed, the size can be both reduced and enlarged to any specified size. | ||
102行目: | 85行目: | ||
{|class="wikitable" | {|class="wikitable" | ||
|- | |- | ||
− | ! | + | ! Format !! Reduced !! Enlarged |
− | {{ | + | {{Help:Images/size|frame=}} |
− | {{ | + | {{Help:Images/size|frame=border}} |
− | {{ | + | {{Help:Images/size|frame=frame}} |
− | {{ | + | {{Help:Images/size|frame=thumb}} |
− | {{ | + | {{Help:Images/size|frame=frameless}} |
|} | |} | ||
− | + | === 水平配置 === | |
− | === | + | <code>frame</code> および <code>thumb</code> を使う時には、デフォルトの配置は <code>right</code> になります。 |
− | |||
− | |||
{|class="wikitable" | {|class="wikitable" | ||
119行目: | 100行目: | ||
!説明 | !説明 | ||
!入力内容 | !入力内容 | ||
− | ! | + | !表示結果 |
− | {{ | + | {{Help:Images/frame|2=100px|frame=|ex='''水平配置指定なし''', or default alignment|inline=yes|float=no}} |
− | {{ | + | {{Help:Images/frame|2=100px|frame=none|ex=specify horizontal alignment as: '''none'''|inline=no|float=no}} |
− | {{ | + | {{Help:Images/frame|2=100px|frame=center|ex=specify horizontal alignment as: '''center'''|inline=no|float=no}} |
− | {{ | + | {{Help:Images/frame|2=100px|frame=left|ex=specify horizontal alignment as: '''left'''|inline=no|float=yes}} |
− | {{ | + | {{Help:Images/frame|2=100px|frame=right|ex=specify horizontal alignment as: '''right'''|inline=no|float=yes}} |
|} | |} | ||
− | + | === 垂直配置 === | |
− | === | + | The vertical alignment options take effect only if the image '''is''' rendered as an inline element and '''is not''' floating. They alter the way the inlined image will be vertically aligned with the text present in the same block before and/or after this image on the same rendered row. |
− | |||
− | The vertical alignment options take effect only if the image '''is''' rendered as an inline element and '''is not''' floating. | ||
− | They alter the way the inlined image will be vertically aligned with the text present in the same block before and/or after this image on the same rendered row. | ||
Note that the rendered line of text where inline images are inserted (and the lines of text rendered after the current one) may be moved down (this will increase the line-height conditionally by additional line spacing, just as it may occur with spans of text with variable font sizes, or with superscripts and subscripts) to allow the image height to be fully displayed with this alignment constraint. | Note that the rendered line of text where inline images are inserted (and the lines of text rendered after the current one) may be moved down (this will increase the line-height conditionally by additional line spacing, just as it may occur with spans of text with variable font sizes, or with superscripts and subscripts) to allow the image height to be fully displayed with this alignment constraint. | ||
− | |||
<div class="mw-collapsible mw-collapsed"><div class="mw-collapsible-toggle toccolours" style="float:none;text-align:center">'''{{Blue|Toggle source code view}}'''</div> | <div class="mw-collapsible mw-collapsed"><div class="mw-collapsible-toggle toccolours" style="float:none;text-align:center">'''{{Blue|Toggle source code view}}'''</div> | ||
<div class="mw-collapsible-content"> | <div class="mw-collapsible-content"> | ||
231行目: | 208行目: | ||
<del>text</del></u></span></p> | <del>text</del></u></span></p> | ||
− | + | Notes: | |
− | |||
# 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: | # 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: | ||
#* 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). | #* 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). | ||
242行目: | 218行目: | ||
=== Stopping the text flow === | === Stopping the text flow === | ||
+ | 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, <nowiki>== My Header ==</nowiki>) 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 '''<nowiki><br clear=all></nowiki>''' (or if you prefer, <nowiki><div style="clear: both"></div></nowiki>) 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 <nowiki><div style="overflow: hidden">…</div></nowiki>, which clears all floats inside the <code>div</code> element.) | ||
− | + | All images rendered as blocks (including non-floating '''center'''ed images, '''left'''- or '''right'''-floating images, as well as '''framed''' or '''thumbnail'''ed 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 '''center'''ed images). | |
− | |||
− | |||
− | |||
− | |||
− | All images rendered as blocks (including non-floating '''center'''ed images, '''left'''- or '''right'''-floating images, as well as '''framed''' or '''thumbnail'''ed 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 '''center'''ed images). | ||
− | |||
− | |||
− | |||
− | The following table shows how to alter the link target (whose default is the image description page) or how to remove it. | + | === 既定のリンク先の変更 === |
− | Changing the link does not alter the format described in the previous sections. | + | The following table shows how to alter the link target (whose default is the image description page) or how to remove it. Changing the link does not alter the format described in the previous sections. |
{|class="wikitable plainlinks" | {|class="wikitable plainlinks" | ||
|- | |- | ||
!説明 | !説明 | ||
− | ! | + | !入力 |
− | ! | + | !結果 |
− | {{ | + | {{Help:Images/frame|2=link=Main Page|ex=internal link}} |
− | {{ | + | {{Help:Images/frame|2=link=http://wikipedia.org/wiki/Test|ex=external link}} |
− | {{ | + | {{Help:Images/frame|2=link=|ex=no link (external or file page)}} |
|} | |} | ||
272行目: | 240行目: | ||
: 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. | : 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. | ||
− | == | + | == 画像ギャラリーのレンダリング == |
=== ギャラリーの構文 === | === ギャラリーの構文 === | ||
− | + | <code><nowiki><gallery></nowiki></code>タグを使って、簡単にサムネイルのギャラリを作成できます。マークアップは次の通りです。 | |
− | |||
− | |||
<pre> | <pre> | ||
<nowiki><gallery></nowiki> | <nowiki><gallery></nowiki> | ||
286行目: | 252行目: | ||
</pre> | </pre> | ||
− | + | 画像ファイルの指定を角括弧で囲まない点に注意してください。 | |
− | Captions are optional, and may contain wiki links or other formatting. | + | Captions are optional, and may contain wiki links or other formatting. Some of the parameters controlling thumb output can also be used here, specifically the ones that modify the file (as opposed to ones that control where in the page the image falls). For example, with multi-paged media like pdfs, you can use code like <code>page=4</code>. |
− | Some of the parameters controlling thumb output can also be used here, specifically the ones that modify the file (as opposed to ones that control where in the page the image falls). | ||
− | For example, with multi-paged media like pdfs, you can use code like <code>page=4</code>. | ||
<code>File:</code> 接頭辞は省略できます。 | <code>File:</code> 接頭辞は省略できます。 | ||
− | + | 例えば | |
− | + | <pre> | |
− | < | + | <nowiki><gallery></nowiki> |
− | <gallery> | + | File:Example.jpg|項目 1 |
− | File:Example.jpg| | + | File:Example.jpg|<nowiki>[[Help:Contents]]</nowiki> へリンク |
− | File:Example.jpg| | ||
File:Example.jpg | File:Example.jpg | ||
File:Example.jpg|alt=An example image. It has flowers | File:Example.jpg|alt=An example image. It has flowers | ||
− | File:Example.jpg|'' | + | File:Example.jpg| <nowiki>''斜体のキャプション''</nowiki> |
− | Example.jpg| | + | File:Example.jpg|"<nowiki>{{PAGENAME}}</nowiki>" のページ |
− | |||
</gallery> | </gallery> | ||
− | </ | + | </pre> |
− | + | は次のようになります。 | |
− | |||
− | |||
<gallery> | <gallery> | ||
− | File:Example.jpg| | + | File:Example.jpg|項目 1 |
− | File:Example.jpg| | + | File:Example.jpg|[[Help:Contents/ja]] へリンク |
File:Example.jpg | File:Example.jpg | ||
File:Example.jpg|alt=An example image. It has flowers | File:Example.jpg|alt=An example image. It has flowers | ||
− | File:Example.jpg|'' | + | File:Example.jpg|''斜体のキャプション'' |
− | Example.jpg| | + | File:Example.jpg| "{{PAGENAME}}" のページ |
− | |||
</gallery> | </gallery> | ||
==== Mode parameter ==== | ==== Mode parameter ==== | ||
− | {{MW 1.22|and after}} | + | {{MW 1.22/ja|and after}} |
Starting in 1.22 we have an experimental <code>mode</code> parameter, taking options as follows: | Starting in 1.22 we have an experimental <code>mode</code> parameter, taking options as follows: | ||
− | |||
* <code>traditional</code> is the original gallery type used by MediaWiki. | * <code>traditional</code> is the original gallery type used by MediaWiki. | ||
* <code>nolines</code> is similar to <code>traditional</code>, but with no border lines. | * <code>nolines</code> is similar to <code>traditional</code>, but with no border lines. | ||
− | * <code>packed</code> causes images to have the same height but different widths, with little space between the images. The rows in this [[ | + | * <code>packed</code> causes images to have the same height but different widths, with little space between the images. The rows in this [[Wikipedia:Responsive web design|responsive]] mode organize themselves according to the width of the screen. |
* <code>packed-overlay</code> shows the caption overlaid on the image, in a semi-transparent white box. | * <code>packed-overlay</code> shows the caption overlaid on the image, in a semi-transparent white box. | ||
* <code>packed-hover</code> is similar to <code>packed-overlay</code>, but with the caption and box only showing up on hover. | * <code>packed-hover</code> is similar to <code>packed-overlay</code>, but with the caption and box only showing up on hover. | ||
− | + | For example: | |
− | + | <pre> | |
− | < | ||
<gallery mode="packed-hover"> | <gallery mode="packed-hover"> | ||
Image:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar) | Image:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar) | ||
349行目: | 306行目: | ||
File:Australian blenny.jpg|''[[commons:Category:Ecsenius|Ecsenius axelrodi]]'' | File:Australian blenny.jpg|''[[commons:Category:Ecsenius|Ecsenius axelrodi]]'' | ||
</gallery> | </gallery> | ||
− | </ | + | </pre> |
Gives (mode: <tt>packed-hover</tt>): | Gives (mode: <tt>packed-hover</tt>): | ||
− | |||
<gallery mode="packed-hover"> | <gallery mode="packed-hover"> | ||
Image:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar) | Image:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar) | ||
370行目: | 326行目: | ||
</gallery> | </gallery> | ||
− | + | Examples of the other modes: | |
<code>mode="traditional"</code> | <code>mode="traditional"</code> | ||
399行目: | 355行目: | ||
Image:Georgia Aquarium - Giant Grouper.jpg|''[[commons:Epinephelus lanceolatus|Epinephelus lanceolatus]]'' (Giant grouper) | Image:Georgia Aquarium - Giant Grouper.jpg|''[[commons:Epinephelus lanceolatus|Epinephelus lanceolatus]]'' (Giant grouper) | ||
</gallery> | </gallery> | ||
− | |||
=== Optional gallery attributes === | === Optional gallery attributes === | ||
− | |||
The gallery tag itself takes several additional parameters, specified as attribute name-value pairs: | The gallery tag itself takes several additional parameters, specified as attribute name-value pairs: | ||
410行目: | 364行目: | ||
* <code>caption="{caption}"</code>: (caption text between double quotes for more than a word) sets a caption centered atop the gallery. | * <code>caption="{caption}"</code>: (caption text between double quotes for more than a word) sets a caption centered atop the gallery. | ||
− | * <code>widths={width}px</code>: sets the widths of the images, default 120px. '' | + | * <code>widths={width}px</code>: sets the widths of the images, default 120px. ''Note the plural, width'''s'''''. |
* <code>heights={heights}px</code>: sets the (max) heights of the images. | * <code>heights={heights}px</code>: sets the (max) heights of the images. | ||
* <code>perrow={integer}</code>: sets the number of images per row. 0 means automatically adjust based on width of screen. | * <code>perrow={integer}</code>: sets the number of images per row. 0 means automatically adjust based on width of screen. | ||
− | * <code>showfilename={anything}</code>: Show the filenames of the images in the individual captions for each image (1.17 | + | * <code>showfilename={anything}</code>: Show the filenames of the images in the individual captions for each image (1.17 以降). |
− | * <code>mode={traditional|nolines|packed|packed-hover|packed-overlay}</code>: See section above (1.22 | + | * <code>mode={traditional|nolines|packed|packed-hover|packed-overlay}</code>: See section above (1.22 以降). |
− | {{note|The widths and heights parameters are taken more as suggestions than strict values for packed (and related) modes. Packed modes will adjust the width of images in order to make each row the same length.}} | + | {{note/ja|The widths and heights parameters are taken more as suggestions than strict values for packed (and related) modes. Packed modes will adjust the width of images in order to make each row the same length.}} |
− | + | Example: | |
− | |||
− | |||
+ | Coding: | ||
<pre> | <pre> | ||
<gallery widths=60px heights=60px perrow=7 caption="sunflowers are groovy"> | <gallery widths=60px heights=60px perrow=7 caption="sunflowers are groovy"> | ||
437行目: | 390行目: | ||
</pre> | </pre> | ||
− | + | Result: | |
− | |||
<gallery widths=60px heights=60px perrow=7 caption="sunflowers are groovy"> | <gallery widths=60px heights=60px perrow=7 caption="sunflowers are groovy"> | ||
File:Example.jpg | File:Example.jpg | ||
452行目: | 404行目: | ||
</gallery> | </gallery> | ||
− | == | + | == リンクの挙動 == |
+ | By default an image links to its file description page. The "link=" option modifies this behavior to link to another page or website, or to turn off the image's linking behavior. Alternatively, you can create a text link to an image's description page or to the image itself. | ||
− | + | === ファイルの説明ページへのリンク === | |
− | + | コロン (<code>:</code>) を <code>{{ns:image}}:</code> の前に追加すると、画像をページ内に埋め込む代わりに、ファイルの説明ページへリンクします。 | |
− | |||
− | + | {| cellpadding=10px | |
− | [[ | + | | |
− | + | [[:{{ns:image}}:{{mediawiki:image_sample}}]] | |
− | [[ | + | | |
− | + | <nowiki>[[</nowiki>:{{ns:image}}:{{mediawiki:image_sample}}]] | |
− | + | |- | |
− | [[ | + | | |
− | + | [[:{{ns:image}}:{{mediawiki:image_sample}}{{!}}Sunflowers]] | |
− | [[ | + | | |
− | + | <nowiki>[[</nowiki>:{{ns:image}}:{{mediawiki:image_sample}}|Sunflowers]] | |
+ | |} | ||
− | + | === Text link to actual image === | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ''' | + | Use '''pseudo-namespace''' “{{ns:media}}” for a text link to the actual image: |
− | + | {| cellpadding=10px width=90% align=center | |
− | + | | | |
− | + | [[{{ns:media}}:{{mediawiki:image_sample}}]] | |
− | < | + | | |
− | + | <nowiki>[[</nowiki>{{ns:media}}:{{mediawiki:image_sample}}]] | |
− | + | |- | |
− | + | | | |
− | < | + | [[{{ns:media}}:{{mediawiki:image_sample}}{{!}}Sunflowers]] |
− | + | | | |
− | + | <nowiki>[[</nowiki>{{ns:media}}:{{mediawiki:image_sample}}|Sunflowers]] | |
− | + | |} | |
− | |||
− | + | (If above gets you instead a text link to the image's file description, not a link to the actual image, perhaps your wiki's namespaces are configured out of compliance with this feature?) | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Display image, link it to another page or website === | === Display image, link it to another page or website === | ||
543行目: | 464行目: | ||
=== Display image, turn off link === | === Display image, turn off link === | ||
− | |||
Use "link=" option with no value assigned to turn link off entirely; the below image is not a link: | Use "link=" option with no value assigned to turn link off entirely; the below image is not a link: | ||
549行目: | 469行目: | ||
[[File:Wiki.png|50px|link=]] | [[File:Wiki.png|50px|link=]] | ||
− | |||
== Requisites == | == Requisites == | ||
+ | Before using images in your page, the system administrator of your wiki must have {{mediawiki|Manual:Configuring file uploads|enabled file uploads}} and a user has to [[Help:Managing files|upload the file]]. System administrators may also set the wiki to accept files from {{mediawiki|Manual:Image Administration#Foreign Repositories|foreign repositories}}, such as the [http://commons.wikimedia.org/wiki/Main_Page Wikimedia Commons]. For server side image resizing it is necessary to have a scaler configured (such as GD2, ImageMagick, etc.). | ||
− | + | == その他のウェブサイトのファイル == | |
− | + | You can link to an external file available online using the same syntax used for linking to an external web page. With these syntaxes, the image will not be rendered, but only the text of the link to this image will be displayed. | |
− | |||
− | |||
− | == | ||
− | |||
− | You can link to an external file available online using the same syntax used for linking to an external web page. | ||
− | With these syntaxes, the image will not be rendered, but only the text of the link to this image will be displayed. | ||
− | |||
<pre>[http://url.for/some/image.png]</pre> | <pre>[http://url.for/some/image.png]</pre> | ||
Or with a different displayed text: | Or with a different displayed text: | ||
− | |||
<pre>[http://url.for/some/image.png link text here]</pre> | <pre>[http://url.for/some/image.png link text here]</pre> | ||
572行目: | 484行目: | ||
which renders as: [http://www.example.com/some/image.png Example '''<del>rich</del>''' ''<ins>link text<ins>'' here.] | which renders as: [http://www.example.com/some/image.png Example '''<del>rich</del>''' ''<ins>link text<ins>'' here.] | ||
− | If it is enabled on your wiki (see {{ | + | If it is enabled on your wiki (see {{mediawiki|Manual:$wgAllowExternalImages}}), you can also embed external images. To do that, simply insert the image's url: |
<pre>http://url.for/some/image.png</pre> | <pre>http://url.for/some/image.png</pre> | ||
Currently, embedded images cannot be resized, but they may be formatted by surrounding MediaWiki markup or HTML/CSS code. | Currently, embedded images cannot be resized, but they may be formatted by surrounding MediaWiki markup or HTML/CSS code. | ||
578行目: | 490行目: | ||
If this wiki option is not enabled, the image will not be embedded but rendered as a textual link to the external site, just like above. | If this wiki option is not enabled, the image will not be embedded but rendered as a textual link to the external site, just like above. | ||
− | + | {{Languages}} | |
− | + | [[Category:Help/ja|{{PAGENAME}}]] | |
− | |||
− | |||
− | |||
− | |||
− | |||
− |