Help:Gallery format
| Gallery format | |
|---|---|
| displays query results as dynamic galleries with output which is the same as when using MediaWiki's built-in gallery tag. | |
| Scenario | |
| Scenario: | Gallery |
| Further Information | |
| Provided by: | Semantic Result Formats |
| Added: | 1.5.0 |
| Removed: | still supported |
| Requirements: | none |
| Format name: | gallery |
| Enabled by default:info.pngIndicates whether the result format is enabled by default upon installation of the respective extension. | yes |
| Authors: | Rowan Rodrik van der Molen, Jeroen De Dauw, MWJames |
| Categories: | misc |
| Table of Contents | |
The result format gallery, part of the Semantic Result Formats extension, displays query results as dynamic galleries with output which is the same as when using MediaWiki's built-in <gallery> tag.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| galleryformat | Text | empty | Gallery format |
| perrow | Whole number | empty | The amount of images per row |
| widths | Whole number | empty | The width of the images |
| heights | Whole number | empty | The height of the images |
| autocaptions | Yes/no | yes | Use file name as caption when none is provided |
| fileextensions | Yes/no | no | When using the filename as caption, also display the file extension |
| captionproperty | Text | empty | The name of a semantic property present on the queried pages to be used as caption |
| imageproperty | Text | empty | Name of a semantic property on the queried pages that points to images to use. When set, the queried pages themselves will not be displayed as images |
Query
You can create a gallery either by querying image pages, or by querying image names which are a property of other pages.
Querying image pages
To generate a simple gallery of all images whose image pages have been categorized as "Photographs", you could use the following syntax:
{{#ask: [[Category:Photographs]] | format=gallery}}
Simulated result:
If you query a property for the image pages, it'll be used as the caption. The value of the property "Has description", as declared on the image pages, will become the caption in this example:
{{#ask: [[Category:Photographs]] | ?Has description | format=gallery}}
Simulated result:
Caption 1
Caption 2
Caption 3
Caption 4
If you want your gallery to have a caption of its own, use the "intro" parameter:
{{#ask: [[Category:Photographs]] | ?Has description | format=gallery | intro=This is a gallery caption}}
Simulated result:
- This is a gallery caption
Caption 1
Caption 2
Caption 3
Caption 4
Now adjust the widths of the images to 60px:
{{#ask: [[Category:Photographs]] | ?Has description | format=gallery | intro=This is a gallery caption | widths=60px}}
Simulated result:
- This is a gallery caption
Caption 1
Caption 2
Caption 3
Caption 4
Querying image names as properties
The gallery format can also display images named by properties on your pages. You must add the property to be queried to your pages using the "Has" syntax, including "File:", as shown in this example:
[[Has image::File:Example.jpg]]
Your query must have two parts: a query for the existence of the property, using a "?", and a query for the name of the property, using "imageproperty". You may optionally specify a property containing a caption: "captionproperty".
This example will return a gallery of images named by the "Has image" property, specified on pages in the category "Events":
{{
#ask: [[Category:Events]]
| ?Has image
| format=gallery
| imageproperty=Has image
}}
This example will show images from the current page with their captions:
{{
#ask: [[{{PAGENAME}}]]
| ?Has image
| ?Has caption
| format=gallery
| imageproperty=Has image
| captionproperty=Has caption
}}
Gallery with text links
London: The Tower Bridge opening
Munich: Dom zu Unserer Lieben Frau
San Diego: Skyline from the beaches of Coronado
Rome: Colosseum
The above embedded text and link information is stored using a #subobject (text property) to represent the captionproperty.
Example with text links
{{#ask:[[Meta data link::+]]
| ?Meta data link
| format=gallery
| imageproperty=Has cover
| captionproperty=Meta data link
| link=none
| limit=4
}}
Gallery as carousel
The r111953 patch introduces a new parameter called galleryformat which if sets to 'carousel', galleries are displayed using the jcarousel plug-in. Further information can be found on github.
Example with carousel
{{#ask:[[Meta data link::+]]
| ?Meta data link
| format=gallery
| imageproperty=Has cover
| captionproperty=Meta data link
| link=none
| perrow=4
| galleryformat=carousel
| limit=10
}}
Other examples
|
|
