Template:Article thumbnail: Difference between revisions

Content deleted Content added
No edit summary
Tag: Reverted
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 1:
<templatestyles src="Article thumbnail/styles.css" />
<div class="article-thumb article-thumb--align-{{{align|center}}}">
<div class="article-thumb__imgwrap">
[[File:{{{image|work-in-progress-book.jpg}}}|{{{heightwidth|150180}}}px|link={{{page|{{BASEPAGENAME}}}}}|alt={{{alt|Thumbnail for {{{page|{{BASEPAGENAME}}}}}}}}]]
</div>
<div class="article-thumb__contentthumb__caption">
<div class="article-thumb__title">[[{{{page|{{BASEPAGENAME}}}}}]]</div>
{{#if:{{{subtitle|}}}|<div class="article-thumb__subtitlethumb__text">{{{subtitlecaption|}}}</div>}}
</div>
{{#if:{{{description|}}}|<div class="article-thumb__description">{{{description}}}</div>}}
</div>
</div><noinclude>
== What this does ==
Displays a small, consistent '''article thumbnail''' card: an image that links to a page, with a caption under it.
This version performs '''no existence checks''' (no <code>#ifexist</code>) to avoid expensive parser calls. Styling is provided via TemplateStyles (''Article thumbnail/styles.css''). Images are centered and scaled to fit the fixed thumbnail area.
 
== Parameters ==
* <code>image</code> – Optional. File name of the image '''without''' the <code>File:</code> prefix (e.g., <code>Atomic Habits cover.jpg</code>).
* <code>page</code> – Target page link.
If omitted, it defaults to <code>work-in-progress-book.jpg</code>. '''No existence check is performed'''—if the specified file does not exist, MediaWiki will render it as a missing image link/icon as per your wiki configuration.
* <code>pagecaption</code> – Optional.Text Target page forunder the image link and(color caption. Defaults to <code>{{BASEPAGENAME}}</code>#202122).
* <code>widthalign</code> – Optional. Width passedSet to the<code>left</code>, file thumbnail ('''numeric only<code>right</code>, noor units''')<code>center</code>. Defaults to <code>180center</code>.
* <code>width</code> – Image width (numeric).
Note: The card itself is fixed at 150&nbsp;px wide by CSS; the image is scaled to fit inside the 150×180 area.
* <code>alt</code> – Optional. Alt text for accessibility. Defaults to <code>Thumbnail for {page}</code>.
 
== ExamplesExample (Left Aligned) ==
Basic (links to the current page):
<pre>
{{Article thumbnail
| image = Atomic Habits cover.jpg
| page = Atomic Habits
| caption = James Clear (2018)
| align = left
}}
</pre>
 
Link to a specific page:
<pre>
{{Article thumbnail
| image = Atomic Habits cover.jpg
| page = Atomic Habits
}}
</pre>
 
Custom image width (number only):
<pre>
{{Article thumbnail
| image = Atomic Habits cover.jpg
| width = 200
}}
</pre>
 
Custom alt text:
<pre>
{{Article thumbnail
| image = Atomic Habits cover.jpg
| alt = Atomic Habits by James Clear, book cover
}}
</pre>
 
Two thumbnails side by side (inline cards):
<pre>
{{Article thumbnail
| image = Atomic Habits cover.jpg
| page = Atomic Habits
}}
{{Article thumbnail
| image = How to Win Friends.jpg
| page = How to Win Friends and Influence People
}}
</pre>
 
== Notes ==
* Provide the exact file name, including extension, but do not include the <code>File:</code> prefix in <code>|image=</code>.
* This template intentionally avoids expensive parser functions. There is '''no automatic fallback''' if the file is missing; pass a known placeholder (e.g., <code>work-in-progress-book.jpg</code>) from the caller if you want a guaranteed image.
* The CSS fixes the card width (150&nbsp;px) and image area height (180&nbsp;px). The image is centered and constrained with <code>max-width:100%</code> and <code>max-height:100%</code>.
* For grid layouts, place multiple template calls on the same line or separated by spaces; each card is <code>display:inline-block</code> and will wrap as needed.
</noinclude>