Difference between revisions of "Template:Fanart/Doc"
From questden
m (Suppress junk ToC) |
(Added advice on creating a gallery) |
||
(6 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | <noinclude>{{ | + | <noinclude>{{Doc}}</noinclude> |
− | This template inlines posts from fanart threads nicely with links to the post | + | This template inlines posts from fanart threads nicely with links to the post (click the [[Image:LinkToBoard.gif]] icon). |
− | |||
− | |||
− | |||
− | |||
− | + | A post ID number is the only required input. | |
− | = | + | |
+ | ==Optional Parameters== | ||
;board:Specify the board on which to find the post, e.g. <code>|board=quest</code>. The default is ''questdis''. | ;board:Specify the board on which to find the post, e.g. <code>|board=quest</code>. The default is ''questdis''. | ||
;caption:Put a caption below the image. Captions can contain limited markup, but shouldn't be too long. | ;caption:Put a caption below the image. Captions can contain limited markup, but shouldn't be too long. | ||
+ | ;by:Attribute the image's artist. Will be linked automatically. | ||
+ | ;mouseover:Specifies mouseover text for the thumbnail. | ||
+ | |||
+ | ==Examples== | ||
+ | {| class="wikitable" style="margin: auto; background-color:#FFFFFF; width:95%; text-align:center" cellpadding="2" | ||
+ | ! Description | ||
+ | ! Code | ||
+ | ! Output | ||
+ | |- | ||
+ | |Short and simple.<br>Just the provide the post ID number. | ||
+ | | | ||
+ | <nowiki>{{fanart|111411}}</nowiki> | ||
+ | | | ||
+ | {{fanart|111411}} | ||
+ | |- | ||
+ | |Credit the artist, if you know who they are.<br>It's okay to leave it blank if you don't know and the artist didn't leave their name. | ||
+ | | | ||
+ | <nowiki>{{fanart|110849|by=LimeBreaker}}</nowiki> | ||
+ | | | ||
+ | {{fanart|110849|by=LimeBreaker}} | ||
+ | |- | ||
+ | |Captions can be informative or silly.<br>You can put links inside of captions. | ||
+ | | | ||
+ | <nowiki>{{fanart|120758|caption=[[Polo Quest|Polo]] in a pile}}</nowiki> | ||
+ | | | ||
+ | {{fanart|120758|caption=[[Polo Quest|Polo]] in a pile}} | ||
+ | |- | ||
+ | |Long captions may extend past the edge of the thumbnail, which doesn't look great. | ||
+ | | | ||
+ | <nowiki>{{fanart|122701|caption=Here's some Moon Elf from Audit}}</nowiki> | ||
+ | | | ||
+ | {{fanart|122701|caption=Here's some Moon Elf from Audit}} | ||
+ | |- | ||
+ | |You can make long captions look better by using <code><nowiki><br></nowiki></code> to manually break up lines. The '''show preview''' button helps a lot with this. | ||
+ | | | ||
+ | <nowiki>{{fanart|122701|caption=Here's some<br>Moon Elf<br>from Audit}}</nowiki> | ||
+ | | | ||
+ | {{fanart|122701|caption=Here's some<br>Moon Elf<br>from Audit}} | ||
+ | |- | ||
+ | |You can also hide text that will appear when people move their cursor over the thumbnail. (May not work in all browsers, or on mobile). | ||
+ | | | ||
+ | <nowiki>{{fanart|122612|mouseover=surprise!}}</nowiki> | ||
+ | | | ||
+ | {{fanart|122612|mouseover=surprise!}} | ||
+ | |- | ||
+ | |If you want to link an image that's not on the /questdis/ board, you need to specify the board name. | ||
+ | | | ||
+ | <nowiki>{{fanart|board=draw|39396}}</nowiki> | ||
+ | | | ||
+ | {{fanart|board=draw|39396}} | ||
+ | |} | ||
+ | |||
+ | ==Creating a Gallery== | ||
+ | The fanart template's most common use is creating galleries in [[:Category:Quests|quest]] articles. | ||
+ | |||
+ | *The gallery will usually be the last heading in a quest article, above the [[Template:Authorbox|authorbox]] (if any) and '''category tags'''. | ||
+ | **Authorboxes are optional- they aren't generally created until a quest author has at least 2 or 3 quests. | ||
+ | *Divide the gallery between '''official''' art, drawn by the quest author, and '''fanart''', drawn by others. | ||
+ | **If a quest has no official art or no fanart, you can omit that heading. | ||
+ | **If a quest has no official art ''and'' no fanart, you can omit the gallery all together! | ||
+ | *Try to avoid including official art from the quest threads in the gallery. The gallery is meant to collect art from other locations a reader might miss. [https://tgchan.org/kusaba/draw/ Draw threads], [[Fanart Thread]]s, [[:Category:Holidays|Holiday threads]], etc. | ||
+ | *Use '''by''' to credit fanart creators whenever possible. | ||
+ | *It's not necessary to use '''by''' for official art unless the quest has more than one author. The quest author is already credited in the [[Template:Infobox|infobox]]. | ||
+ | *Art in galleries is usually arranged '''chronologically'''. | ||
+ | *If an image contains characters from multiple quests, use a '''caption''' to link the other quest articles. | ||
+ | **Or if characters are dressed up as each other, etc. | ||
+ | *If a quest has art that is not safe for work, use [[Template:NSFWsubpage]] to create a separate nsfw gallery. | ||
+ | **If all the art is safe for work, you can omit this template. | ||
+ | *A NSFW Gallery should use [[Template:NSFWreturn]] to link back to the quest page and include [[:Category:NSFW Galleries]]. | ||
+ | |||
+ | ===Quest Article Gallery=== | ||
+ | <nowiki> | ||
+ | ==Gallery== | ||
+ | {{NSFWsubpage}} | ||
+ | ===Official=== | ||
+ | {{fanart}} | ||
+ | {{fanart}} | ||
+ | |||
+ | |||
+ | ===Fanart=== | ||
+ | {{fanart}} | ||
+ | {{fanart}} | ||
+ | |||
+ | {{Quest author's name}} | ||
+ | |||
+ | [[Category:????]]</nowiki> | ||
+ | ===NSFW Gallery=== | ||
+ | <nowiki> | ||
+ | {{NSFWreturn}} | ||
+ | |||
+ | ==Gallery== | ||
+ | ===Official=== | ||
+ | {{fanart}} | ||
+ | {{fanart}} | ||
+ | |||
+ | |||
+ | ===Fanart=== | ||
+ | {{fanart}} | ||
+ | {{fanart}} | ||
+ | |||
+ | {{Quest author's name}} | ||
+ | |||
+ | [[Category:NSFW Galleries]]</nowiki> | ||
− | = | + | ==See also== |
− | + | *[[Template:questart]] A renamed version of the fanart template. Maybe someone once intended to differentiate these templates, but currently using one or the other is just a formatting convention. | |
− | + | *[[Template:Flash]] The fanart template, but for flash. | |
− | + | *[[Template:Fanfile]] The fanart template, but for mp4s. | |
− | + | *[[Template:Fanaudio]] The fanart template, but for audio files. | |
− | + | *[[Template:Fakeart]] The fanart template, but it lets you pick a different thumbnail for fakeouts. | |
− | + | *[[Template:Comic]] Provides a text link to an image posted on the board, instead of providing a thumbnail. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | = Maintenance notes = | + | ==Maintenance notes== |
* It depends on the set of redirects that let you look up kusaba resources by post number: | * It depends on the set of redirects that let you look up kusaba resources by post number: | ||
**<code>…kusaba/thumb-for/'''board'''/'''post'''</code> → <code>…kusaba/'''board'''/thumb/'''thumbnail-filename'''</code> | **<code>…kusaba/thumb-for/'''board'''/'''post'''</code> → <code>…kusaba/'''board'''/thumb/'''thumbnail-filename'''</code> | ||
Line 35: | Line 126: | ||
**And because MediaWiki is kind of dumb, a hack that lets it ignore a <code>.png</code> extension on these and let the browser sort out the details with <code>Content-Type</code>. | **And because MediaWiki is kind of dumb, a hack that lets it ignore a <code>.png</code> extension on these and let the browser sort out the details with <code>Content-Type</code>. | ||
* It makes assumptions about the maximum size of thumbnail images, namely that they'll never exceed 250px width. | * It makes assumptions about the maximum size of thumbnail images, namely that they'll never exceed 250px width. | ||
− | * It doesn't play nice with | + | * It doesn't play nice with gallery tags (<code><nowiki><gallery></gallery></nowiki></code>) because Mediawiki syntax doesn't allow for external images in them. |
Latest revision as of 00:39, 24 July 2018
This is a template documentation page. It is transcluded into place. |
This template inlines posts from fanart threads nicely with links to the post (click the icon).
A post ID number is the only required input.
Contents
Optional Parameters
- board
- Specify the board on which to find the post, e.g.
|board=quest
. The default is questdis. - caption
- Put a caption below the image. Captions can contain limited markup, but shouldn't be too long.
- by
- Attribute the image's artist. Will be linked automatically.
- mouseover
- Specifies mouseover text for the thumbnail.
Examples
Description | Code | Output | ||||
---|---|---|---|---|---|---|
Short and simple. Just the provide the post ID number. |
{{fanart|111411}} |
| ||||
Credit the artist, if you know who they are. It's okay to leave it blank if you don't know and the artist didn't leave their name. |
{{fanart|110849|by=LimeBreaker}} |
| ||||
Captions can be informative or silly. You can put links inside of captions. |
{{fanart|120758|caption=[[Polo Quest|Polo]] in a pile}} |
| ||||
Long captions may extend past the edge of the thumbnail, which doesn't look great. |
{{fanart|122701|caption=Here's some Moon Elf from Audit}} |
| ||||
You can make long captions look better by using <br> to manually break up lines. The show preview button helps a lot with this.
|
{{fanart|122701|caption=Here's some<br>Moon Elf<br>from Audit}} |
| ||||
You can also hide text that will appear when people move their cursor over the thumbnail. (May not work in all browsers, or on mobile). |
{{fanart|122612|mouseover=surprise!}} |
| ||||
If you want to link an image that's not on the /questdis/ board, you need to specify the board name. |
{{fanart|board=draw|39396}} |
|
Creating a Gallery
The fanart template's most common use is creating galleries in quest articles.
- The gallery will usually be the last heading in a quest article, above the authorbox (if any) and category tags.
- Authorboxes are optional- they aren't generally created until a quest author has at least 2 or 3 quests.
- Divide the gallery between official art, drawn by the quest author, and fanart, drawn by others.
- If a quest has no official art or no fanart, you can omit that heading.
- If a quest has no official art and no fanart, you can omit the gallery all together!
- Try to avoid including official art from the quest threads in the gallery. The gallery is meant to collect art from other locations a reader might miss. Draw threads, Fanart Threads, Holiday threads, etc.
- Use by to credit fanart creators whenever possible.
- It's not necessary to use by for official art unless the quest has more than one author. The quest author is already credited in the infobox.
- Art in galleries is usually arranged chronologically.
- If an image contains characters from multiple quests, use a caption to link the other quest articles.
- Or if characters are dressed up as each other, etc.
- If a quest has art that is not safe for work, use Template:NSFWsubpage to create a separate nsfw gallery.
- If all the art is safe for work, you can omit this template.
- A NSFW Gallery should use Template:NSFWreturn to link back to the quest page and include Category:NSFW Galleries.
Quest Article Gallery
==Gallery== {{NSFWsubpage}} ===Official=== {{fanart}} {{fanart}} ===Fanart=== {{fanart}} {{fanart}} {{Quest author's name}} [[Category:????]]
NSFW Gallery
{{NSFWreturn}} ==Gallery== ===Official=== {{fanart}} {{fanart}} ===Fanart=== {{fanart}} {{fanart}} {{Quest author's name}} [[Category:NSFW Galleries]]
See also
- Template:questart A renamed version of the fanart template. Maybe someone once intended to differentiate these templates, but currently using one or the other is just a formatting convention.
- Template:Flash The fanart template, but for flash.
- Template:Fanfile The fanart template, but for mp4s.
- Template:Fanaudio The fanart template, but for audio files.
- Template:Fakeart The fanart template, but it lets you pick a different thumbnail for fakeouts.
- Template:Comic Provides a text link to an image posted on the board, instead of providing a thumbnail.
Maintenance notes
- It depends on the set of redirects that let you look up kusaba resources by post number:
…kusaba/thumb-for/board/post
→…kusaba/board/thumb/thumbnail-filename
…kusaba/image-for/board/post
→…kusaba/board/src/fullsize-image-filename
…kusaba/thread-for/board/post
→…kusaba/board/res/thread.html#post
- And because MediaWiki is kind of dumb, a hack that lets it ignore a
.png
extension on these and let the browser sort out the details withContent-Type
.
- It makes assumptions about the maximum size of thumbnail images, namely that they'll never exceed 250px width.
- It doesn't play nice with gallery tags (
<gallery></gallery>
) because Mediawiki syntax doesn't allow for external images in them.