Template:Ytv-table-top/doc
Documentation
This template provides the header row for tables of YouTube videos that all come from the same channel. This is for the tables with information such as when and where the videos were recorded, Angelina's age at the time, and so forth. For tables of more specific "statistics" like number of views, likes, and dislikes, see {{ytv-stats-table-top}}.
The template outputs HTML-style table code (e.g., <tr><th>…</th></tr>). It should be immediately followed by one of more calls to {{ytv-table-row}}, and then a call to {{ytv-table-bottom}} to complete the table.
The name of this template is based on the phrase "youtube video table top".
Usage
{{ytv-table-top}}{{ytv-table-top|table-style= |header-style= |no-info= |no-notes= |video-col-width-auto= |*-col-width= |*-col-label=}}
The entire table is of class "wikitable sortable". Any further "style" adjustments (like font size) that you want to apply to the whole table can be specified using table-style; its value must be valid CSS style (e.g., font-size:92%). If you have some style you want only the table header row to have, specify it with the parameter header-style.
In the second version above, * stands for any of uploaded, video, length, songs, recorded, age, venue, with, or notes, which correspond to the 9 columns of the table. Any combination of these parameters can be specified, although none of them have to be.
Each *-col-width parameter controls the width of the corresponding column. The value must be a valid CSS width, such as 25%. (This is technically just a "suggestion", since browsers are free to use a different width if that seems preferable.) The "video" column, which will contain video titles and (maybe) thumbnails (as defined in calls to {{ytv-table-row}}) is the only column with a hardcoded default width (25%). To override that and set your own width, use video-col-width, just like any other column. But to override the default and let each user's browser choose the width, set video-col-width-auto to any true value. (Letting the browser select the width is already the default for all the other columns.)
If a *-col-label parameter is used, it overrides the default column label. The defaults can be seen below in the examples. If any of these parameters exist in the template call, they must have visible values, otherwise those column labels will be missing. (In particular, something like |notes-col-label=|… is not saying "I haven't chosen an override value for the notes-column label, so use the default"; it's saying "I want to override the default for the notes-column label and use an empty string instead". This is almost certainly Not What You Wanted.)
If the parameter no-info is set to a true value, then all of the columns strictly between video length and miscellaneous notes will be hidden. (Notice that those are the columns you have to actually watch the video to fill in — thus, the purpose of no-info is to enable work to proceed relatively quickly on completing all the rows of a given table with just the "easier" info, putting off the "harder" info until later).
Examples
{{ytv-table-top}}
⇓
| Uploaded | Video | Len | Songs performed (or description) |
Recorded | Age | Venue/Event | With | Notes |
|---|
{{ytv-table-top|table-style=font-size:90% |vid-col-auto=y |songs-col-width=40%}}
⇓
| Uploaded | Video | Len | Songs performed (or description) |
Recorded | Age | Venue/Event | With | Notes |
|---|
more examples needed…
See also
{{ytv-table-row}}{{ytv-table-bottom}}
