765,429
edits
Tardis:Galleries: Difference between revisions
From Tardis Wiki, the free Doctor Who reference
m
upholding T:CLEAN CODE
No edit summary |
m (upholding T:CLEAN CODE) |
||
| Line 4: | Line 4: | ||
For details on how to create galleries, you can read the potted [[#Standard Wikia help file|Wikia help file below]]. Even better is the [[Help:Galleries and slideshows/wikitext|more detailed help file]], which explains the finer points of [[T:MARK|wiki markup]] for galleries. | For details on how to create galleries, you can read the potted [[#Standard Wikia help file|Wikia help file below]]. Even better is the [[Help:Galleries and slideshows/wikitext|more detailed help file]], which explains the finer points of [[T:MARK|wiki markup]] for galleries. | ||
==Points to ponder== | == Points to ponder == | ||
[[#Standard Wikia help file|Wikia's explanation of galleries]] will tell you the ''simplest'' way to make a gallery. But it won't tell you much about how the function behaves in live examples. That's why we're providing some wisdom from actual case studies. | [[#Standard Wikia help file|Wikia's explanation of galleries]] will tell you the ''simplest'' way to make a gallery. But it won't tell you much about how the function behaves in live examples. That's why we're providing some wisdom from actual case studies. | ||
===Put that add button away=== | === Put that add button away === | ||
'''Always hide the add photo button.''' If you don't add any options to your <nowiki><gallery></nowiki> tag, it will automatically show a button that invites users to add a photo the gallery. This is undesirable for several reasons: | '''Always hide the add photo button.''' If you don't add any options to your <nowiki><gallery></nowiki> tag, it will automatically show a button that invites users to add a photo the gallery. This is undesirable for several reasons: | ||
*It makes it easy for vandals or even just new users testing the wiki to ruin your gallery. With a couple of clicks, they can easily insert inappropriate images directly into your gallery. | * It makes it easy for vandals or even just new users testing the wiki to ruin your gallery. With a couple of clicks, they can easily insert inappropriate images directly into your gallery. | ||
*It allows people to upload images without adding a proper [[Tardis:Copyright tags|copyright license]]. The add button completely bypasses the [[MediaWiki:Licenses|Licensing]] drop-down menu presented when you upload a file. | * It allows people to upload images without adding a proper [[Tardis:Copyright tags|copyright license]]. The add button completely bypasses the [[MediaWiki:Licenses|Licensing]] drop-down menu presented when you upload a file. | ||
*It makes the end of a particular gallery obvious. If you remove the button, you can put several galleries together in such a way that the join isn't obvious (so long as you haven't put a border around your galleries). | * It makes the end of a particular gallery obvious. If you remove the button, you can put several galleries together in such a way that the join isn't obvious (so long as you haven't put a border around your galleries). | ||
'''For these reasons, this wiki ''requires'' you to hide the add button by using this markup:''' | '''For these reasons, this wiki ''requires'' you to hide the add button by using this markup:''' | ||
<pre><gallery hideaddbutton="true"></pre> | <pre><gallery hideaddbutton="true"></pre> | ||
===Enough is enough=== | === Enough is enough === | ||
'''Don't go overboard with galleries.''' Theoretically, you can use galleries to display a very large number of images. This poses a problem for users who have slow connections. We're not just talking about those who use dialup. We mean almost '''everyone''' who's viewing on a smartphone, and many who are connected wirelessly. | '''Don't go overboard with galleries.''' Theoretically, you can use galleries to display a very large number of images. This poses a problem for users who have slow connections. We're not just talking about those who use dialup. We mean almost '''everyone''' who's viewing on a smartphone, and many who are connected wirelessly. | ||
| Line 22: | Line 22: | ||
To help with this problem: | To help with this problem: | ||
#Use .jpg files only. Other file types are either unscalable (which is vital to galleries) or far too high-quality for the purpose of galleries. | # Use .jpg files only. Other file types are either unscalable (which is vital to galleries) or far too high-quality for the purpose of galleries. | ||
#Reduce the file-size of your gallery images to around or below 50kb. Certainly, don't go over 100kb with any one image. You can reduce your filesize most easily in Photoshop by '''saving for web''' (as opposed to normally saving), and dialing down the quality to around 20. '''Make the filesize of every image as small as you possibly can.''' | # Reduce the file-size of your gallery images to around or below 50kb. Certainly, don't go over 100kb with any one image. You can reduce your filesize most easily in Photoshop by '''saving for web''' (as opposed to normally saving), and dialing down the quality to around 20. '''Make the filesize of every image as small as you possibly can.''' | ||
#Find a way to limit the total number of images in a single gallery structure. Do you really need all 200+ images of, say, ''[[Doctor Who Adventures]]'' covers on a single page? Or can you create a page for each publication year? | # Find a way to limit the total number of images in a single gallery structure. Do you really need all 200+ images of, say, ''[[Doctor Who Adventures]]'' covers on a single page? Or can you create a page for each publication year? | ||
===Watch your dimensions=== | === Watch your dimensions === | ||
'''Keep the dimensions of your images as equal as possible.''' The gallery function basically creates a series of thumbnails. But it's not like this kind of thumbnail:<pre>[[file:Pic.jpg|thumb]]</pre>No, the gallery thumbnail creates ''relative'' thumbnails. It considers '''all''' the images in the gallery and resizes them ''relative to each other'', trying to put them into the specified width. (If you don't specify a width, it defaults to 200px.) | '''Keep the dimensions of your images as equal as possible.''' The gallery function basically creates a series of thumbnails. But it's not like this kind of thumbnail:<pre>[[file:Pic.jpg|thumb]]</pre>No, the gallery thumbnail creates ''relative'' thumbnails. It considers '''all''' the images in the gallery and resizes them ''relative to each other'', trying to put them into the specified width. (If you don't specify a width, it defaults to 200px.) | ||
| Line 32: | Line 32: | ||
<div id=inline-box-rt> | <div id=inline-box-rt> | ||
;dimensions : the ratio of width to height | ;dimensions : the ratio of width to height | ||
''A image that is 800X400 has the same dimensions as one that is 400X200 — <br>but '''not''' one that's 137X877''. | ''A image that is 800X400 has the same dimensions as one that is 400X200 — <br />but '''not''' one that's 137X877''. | ||
</div> | </div> | ||
Technically, there's always '''some''' level of distortion in a gallery, if the pics don't have the exact same dimension. But it is considerably less obvious if the files are all of the same dimensions. | Technically, there's always '''some''' level of distortion in a gallery, if the pics don't have the exact same dimension. But it is considerably less obvious if the files are all of the same dimensions. | ||
| Line 39: | Line 39: | ||
To help with this problem: | To help with this problem: | ||
#Try to use images that are all of the same dimensions. If you're displaying a series of magazine covers, for instance, it's a good idea to crop all of them to precisely the same dimensions. That way, they'll all be perfectly scaled down. | # Try to use images that are all of the same dimensions. If you're displaying a series of magazine covers, for instance, it's a good idea to crop all of them to precisely the same dimensions. That way, they'll all be perfectly scaled down. | ||
#If you ''must'' use a mixture of widescreen, 4:3, and extremely skinny images, don't put them all into the same gallery structure. Find a way to break up the galleries on the same page, so that the gallery command is not having to work so hard. | # If you ''must'' use a mixture of widescreen, 4:3, and extremely skinny images, don't put them all into the same gallery structure. Find a way to break up the galleries on the same page, so that the gallery command is not having to work so hard. | ||
==Rules of use== | == Rules of use == | ||
{{sc|T:GAL RULES}} | {{sc|T:GAL RULES}} | ||
There are a few absolute '''rules''' which should be observed when using galleries. | There are a few absolute '''rules''' which should be observed when using galleries. Failure to observe these rules could lead to a [[Tardis:Blocking policy|suspension of your editing rights]]: | ||
#'''Never''' use a gallery for a single image. | # '''Never''' use a gallery for a single image. Single images should be placed on pages using the syntax:<pre>[[file:PicName.extension]]</pre>as described at [[Help:Files]]. There is simply no advantage to using the gallery structure for a single image; the [[T:MARK|wikitext]] for file display is invariably superior for the task. | ||
#'''Always''' hide the add button. '''All''' galleries must begin with a command that looks like this:<pre><gallery hideaddbutton="true"></pre> | # '''Always''' hide the add button. '''All''' galleries must begin with a command that looks like this:<pre><gallery hideaddbutton="true"></pre> | ||
#'''Never''' use galleries on in-universe pages. | # '''Never''' use galleries on in-universe pages. | ||
#'''Use caution''' with galleries on story pages. | # '''Use caution''' with galleries on story pages. Generally, they should be used only when displaying a '''series''' of '''alternate covers'''. There is no other reasonable usage for galleries on story pages. No story page should have a gallery of images from that story. | ||
==Standard Wikia help file== | == Standard Wikia help file == | ||
[[ | [[Category:Help]] | ||
