Πρότυπο:Japanese episode list/sublist/τεκμηρίωση

Από Γνωσιακή Βάση Υπηρεσιών και Διαδικασιών του Δημοσίου Τομέα
Μετάβαση σε: πλοήγηση, αναζήτηση
40px Αυτό το πρότυπο περιλαμβάνει περίπλοκες μεθόδους σύνταξης προτύπων.
Ενθαρύνεστε να μελετήσετε την κατασκευή του και τις parser functions πριν επεξεργαστείτε το πρότυπο. Αν η επεξεργασία σας προκαλέσει μη αναμενόμενα προβλήματα, παρακαλούμε αναιρέστε την γρήγορα, καθώς το πρότυπο μπορεί να εμφανίζεται σε ένα μεγάλο αριθμό από σελίδες.
Να θυμάστε ότι μπορείτε να κάνετε πειράματα, και θα πρέπει να δοκιμάζετε όλες τις βελτιώσεις, είτε στο γενικό Αμμοδοχείο προτύπων είτε στον προσωπικό σας χώρο χρήστη πριν αλλάξετε εδώ οτιδήποτε.
Lists that only want to list titles and air dates, etc, without including summaries can remove |ShortSummary=, which will remove the colored line separator and any cell coloring.

Parameters

EpisodeNumber EpisodeNumber=01 would allow the link [[List of episodes#ep01]].
EpisodeNumber2 (optional) A second episode number column. Useful for when a series aired in a different order, or only included certain episodes, etc (for instance, season 1 of Sailor Moon had several episodes cut when it aired in English).
EnglishTitle The official English title of the episode. If there is no official title (e.g. the series has not been licensed in English, or no official English title has been published), the provided title should be a literal English translation of the Japanese title. EnglishTitle is displayed above RomajiTitle with "bolding and quotes".
RomajiTitle The transliterated (romaji) Japanese episode title. The title is automatically displayed with "bolding and quotes".
KanjiTitle The kanji episode title (for example, "漂流? 冒険の島"). This displays in parenthesis after RomajiTitle.

Note that some browsers may not properly display kanji, or some computers may not have proper fonts installed, resulting in square boxes or question marks displaying instead of the actual kanji characters - see Help:Multilingual support (East Asian) for more information and links to CJK fonts.

RTitle (optional) An unformatted parameter normally used to add a secondary English title, for instance if the same episode had more than one official English release under multiple names (e.g. the first 144 episodes of One Piece). It can also be used to insert a reference immediately after EnglishTitle.

Note that this outputs immediately after EnglishTitle (there's not even a space between them), so if it's being used to provide a second official English title, a space must be hard-coded in the parameter with   or  .

Aux1 (optional) A custom-use parameter whose meaning is specified by the table header.
DirectedBy (optional) The individual who directed the episode, or the animation director. This should be used only when a series was directed by multiple people, with a different person directing each episode, for instance Samurai Harem: Asu no Yoichi. It should not be used if just a small handful of the total number of episodes was directed by someone other than the main director.
WrittenBy (optional) The individual who wrote the episode (screenplay). This should only be used when a series was written by multiple people, with a different person writing each episode, for instance Buso Renkin. It should not be used if just a small handful of the total number of episodes was written by someone other than the main writer.
Aux2 and Aux3 (optional) Custom-use parameters whose meanings are specified by the table header.
OriginalAirDate The date the episode first aired on TV in Japan. For original net animations, this should be the date the episode was first streamed online, and for original video animations, can be used for the date the episode was first released on VHS, DVD, Blu-ray Disc, etc. Use {{Start date}}.
FirstEngAirDate (optional) The date the English-dubbed/subtitled episode was first aired on television or streamed online (release dates of fandubs or fansubs should not be listed here, and will be removed on site). It is assumed that this refers to a traditional dubbed television broadcast; if the episode is subbed, streamed online, or both, a note should be placed in the lead.

If a series is licensed in English, but a given episode has no official English airdate, an mdash (—) should be used. The field should not contain TBA/TBD/TBR (to be announced/determined/revealed) etc, and it should not be left blank.

ProdCode (optional) ProdCode=01 would allow the link [[List of episodes#pc01]].
Aux4 (optional) A custom-use parameter whose meaning is specified by the table header.
ShortSummary (optional) A succinct summary of the episode. Episode summaries cannot be copied from websites, program guides, or other sources; these will be removed as copyright violations. Spoilers should not be avoided in summaries unless an episode has not been aired or released yet, in which case it is generally preferable to completely omit the summary until the episode airs.

If ShortSummary is defined but empty, an empty "placeholder" cell will be displayed. This is useful if a custom LineColor is being used, but no one has written a summary for a given episode.

LineColor<code> (optional) The color of the line separating episode entries, in hex triplets. The number sign (#) is inserted automatically, so <code>#009900, for example, would be input as |LineColor=009900 (or the shorthand |LineColor=090). LineColor defaults to #CCF, and custom LineColor values are ignored if ShortSummary is undefined.
TopColor (optional) The color of the main row of information (EpisodeNumber, xTitle, xAirDate, etc). If ShortSummary is defined, this defaults to #F2F2F2; otherwise, it defaults to the table default.
Notes
  • † - Any field (except LineColor and TopColor) will display an empty cell if it is defined but empty.
  • ‡ - At least one of EnglishTitle, RomajiTitle, or KanjiTitle must be defined.
</dl>

This shows how the template appears with all parameters defined (|LineColor= and |TopColor= are not shown, since they don't output text):

Πρότυπο:Japanese episode list

Using the template

Optional parameters such as Aux1 and RTitle should only be listed if they are used in the table. This helps avoid confusion when a parameter is filled out on only some entries. If a parameter is not filled out, it will result in an empty table cell being displayed.

An additional episode entry can be added to a List of episodes by copying the following code (be sure to prune unused parameters):

{{Japanese episode list
| EpisodeNumber   = 
| EpisodeNumber2  = 
| EnglishTitle    = 
| RomajiTitle     = 
| KanjiTitle      = 
| RTitle          = 
| Aux1            = 
| DirectedBy      = 
| WrittenBy       = 
| Aux2            = 
| Aux3            = 
| OriginalAirDate = 
| FirstEngAirDate = 
| ProdCode        = 
| Aux4            = 
| ShortSummary    = 
| LineColor       = 
}}

Note that this only inserts a section of a wikitable which must be opened and closed:

{|class="wikitable plainrowheaders" style="width:98%; margin:auto; background:#FFF; table-layout:fixed;"
|-
! style="width:3em;"  | No.
! Title
! style="width:12em;" | Original air date
|-
{{Japanese episode list
| Episode 1 stuff
}}
{{Japanese episode list
| Episode 2 stuff
}}
...
{{Japanese episode list
| Episode n stuff
}}
|}

Alternatively, you may wish to bring attention to the closing wikitable tag, so it doesn't accidentally get deleted or moved to the wrong spot:

<!--Wikitable footer. Place this after the last episode entry-->|}<!--End wikitable footer-->

Example

This entry (episode 1 of The Melancholy of Haruhi Suzumiya; note that the episode list actually uses the variant template {{S-Japanese episode list}}):

{{Japanese episode list
| EpisodeNumber   = 01
| RomajiTitle     = Asahina Mikuru no Bōken Episode 00
| KanjiTitle      = 朝比奈ミクルの冒険 Episode00
| EnglishTitle    = The Adventures of Mikuru Asahina Episode 00
| OriginalAirDate = {{Start date|2006|04|02}}
| ShortSummary    = The SOS Brigade previews their movie of questionable quality. In the movie, [[Mikuru Asahina]] stars as a time-travelling waitress from the future who must engage in fights with [[Yuki Nagato]], who is playing as an alien-magician. Mikuru has sworn to protect a young man, played by [[Itsuki Koizumi]], but a love-triangle ensues with both Mikuru and Yuki vying for Itsuki's affections. [[Kyon]] is the narrator of the movie, while [[Haruhi Suzumiya (character)|Haruhi Suzumiya]] is the director.
}}

Would appear as follows (shown without a table header):

Πρότυπο:Japanese episode list

Sublists

Occasionally, when dealing with a very long series, you may wish to break the list up into separate sublists. When doing so, the list should be broken at season breaks. These can be hard to determine for anime series; a good source for them is Japanese or English season box sets if any have been released; otherwise, other good indicators include opening and closing theme song changes or, failing all else, just breaking the list up into chunks of approximately 26 episodes.

Sublists should be named as "List of X episodes (season y)", and transcluded onto the main list to prevent ending up with two lists of duplicate information. For sublist pages, you should use {{Japanese episode list/sublist|List of X episodes}} for each episode, where "List of X episodes" is the name of the main episode list. So, for instance, if you're working on List of D.Gray-man episodes, you would split it into List of D.Gray-man episodes (season 1) and List of D.Gray-man episodes (season 2), and each episode on the sublist would use {{Japanese episode list/sublist|List of D.Gray-man episodes}}. When transcluded onto the main list, this template strips out any summaries and alternates the background row color between light and dark gray, depending on the value of {{{EpisodeNumber}}}, but any custom {{{LineColor}}} coloring is left intact. For episodes breaking this alternation, use {{Japanese episode list/sublist|List of ''X'' episodes|NeutralTopColor}} instead.

For the purpose of transclusion, each sublist should make use of <onlyinclude/> tags, with the opening tag just after the "Episode list" or "List of episodes" header, and the closing tag at the very end of the episode list. This prevents the lead, external links, references, templates, categories, interwiki links, and all other unnecessary information from being transcluded onto the main list.

When transcluding onto the main list, you should make use of {{main}}. For example, referring to D.Gray-man again, the main list would have the following code under the "Episode list" header:

===Season 1===
{{main|List of D.Gray-man episodes (season 1)}}
{{:List of D.Gray-man episodes (season 1)}}

===Season 2===
{{main|List of D.Gray-man episodes (season 2)}}
{{:List of D.Gray-man episodes (season 2)}}

Note the colon (:) at the beginning of the transclusions (for example, {{:List of ...); this is necessary when transcluding non-templates to prevent a redlink from appearing. If you tried to transclude List of D.Gray-man episodes (season 1) without using the colon, you would get {{Template:List of D.Gray-man episodes (season 1)}}: a redlink to a nonexistent template.

Tips

It may be helpful to include a hidden message that will appear when someone edits the article, placed above the table headers and under the article section, such as:

==Episodes==
<!-- For help with this template see http://en.wikipedia.org/wiki/Template_talk:Japanese_episode_list -->

This message won't be visible when normally viewing the article. A message such as this notes where one can get help for the template.

Microformat

The HTML mark-up produced by this template includes an hCalendar microformat that makes event details readily parsable by computer programs. This aids tasks such as the cataloguing of articles and maintenance of databases. For more information about the use of microformats on Wikipedia, please visit the Microformat WikiProject.
Classes used

The HTML classes this microformat uses include:

  • attendee
  • contact
  • description
  • dtend
  • dtstart
  • location
  • organiser
  • summary
  • url
  • vevent
Please do not rename or remove these classes
nor collapse nested elements which use them.

Episode list templates

Sub-pages