Joe Beaudoin Jr. at 00:41, 15 March 2026

2026-03-15T00:41:39Z

← Older revision		Revision as of 00:41, 15 March 2026
Line 54:		Line 54:
	! Filename prefix !! Detected series		! Filename prefix !! Detected series
	\|-		\|-
	\| <code>RDM -</code>, <code>TRS -</code>, <code>BSG - S01…</code> \|\| rdm		\| <code>BSG-TRS -</code>, <code>RDM -</code>, <code>TRS -</code>, <code>BSG - S01…</code> \|\| rdm
	\|-		\|-
	\| <code>CAP -</code>, <code>Caprica -</code> \|\| cap		\| <code>CAP -</code>, <code>Caprica -</code> \|\| cap
	\|-		\|-
	\| <code>B&C -</code>, <code>BNC -</code> \|\| ~~bnc~~		\| <code>B&C -</code>, <code>BAC -</code>, <code>BNC -</code> (legacy) \|\| bac
	\|-		\|-
	\| <code>TOS -</code> \|\| tos		\| <code>TOS -</code> \|\| tos
Line 73:		Line 73:
	\| <code>BSG - 1x05 - Act of Contrition.jpg</code> \|\| Season 1, Episode 5		\| <code>BSG - 1x05 - Act of Contrition.jpg</code> \|\| Season 1, Episode 5
	\|-		\|-
	\| <code>TOS - Saga of a Star World - ~~Apollo~~.jpg</code> \|\| Title hint: "Saga of a Star World ~~- Apollo~~"		\| <code>TOS - Saga of a Star World - Atlantia - 195.jpg</code> \|\| Title hint: "Saga of a Star World" / Timestamp: 00:03:15
	\|}		\|}
	If season/episode numbers cannot be extracted, the template flags the image with a title hint and a maintenance message.		If season/episode numbers cannot be extracted, the template flags the image with a title hint and a maintenance message.
Line 101:		Line 101:
	! Parameter !! Purpose !! Example		! Parameter !! Purpose !! Example
	\|-		\|-
	\| <code>series</code> \|\| Series key. Valid values: <code>rdm</code>, <code>cap</code>, <code>~~bnc~~</code>, <code>tos</code>, <code>1980</code> \|\| <code>series=tos</code>		\| <code>series</code> \|\| Series key. Valid values: <code>rdm</code>, <code>cap</code>, <code>bac</code>, <code>tos</code>, <code>1980</code> \|\| <code>series=tos</code>
	\|-		\|-
	\| <code>type</code> \|\| Source/quality type. Valid values: <code>4k</code>, <code>bluray</code>, <code>hdtv</code>, <code>hddvd</code>, <code>itunes</code>, <code>ntscdvd</code>, <code>ntscb</code>, <code>paldvd</code>, <code>palb</code>, <code>promo</code>, <code>dvd</code>, <code>unknown</code> \|\| <code>type=bluray</code>		\| <code>type</code> \|\| Source/quality type. Valid values: <code>4k</code>, <code>bluray</code>, <code>hdtv</code>, <code>hddvd</code>, <code>itunes</code>, <code>ntscdvd</code>, <code>ntscb</code>, <code>paldvd</code>, <code>palb</code>, <code>promo</code>, <code>dvd</code>, <code>unknown</code> \|\| <code>type=bluray</code>
Line 155:		Line 155:
	* <code>[[Category:Blu-ray screen captures (TRS)]]</code>		* <code>[[Category:Blu-ray screen captures (TRS)]]</code>
	* <code>[[Category:Screen captures by season 4 (TRS)]]</code>		* <code>[[Category:Screen captures by season 4 (TRS)]]</code>
			* <code>[[Category:Screen captures (RDM)]]</code>
			* <code>[[Category:Blu-ray screen captures (RDM)]]</code>
			* <code>[[Category:Screen captures by season 4 (RDM)]]</code>
	* <code>[[Category:Screen captures (Daybreak)]]</code>		* <code>[[Category:Screen captures (Daybreak)]]</code>
	* <code>[[Category:Blu-ray screen captures (Daybreak)]]</code>		* <code>[[Category:Blu-ray screen captures (Daybreak)]]</code>

Joe Beaudoin Jr.: Created page with " ==Overview== '''Template:Screencap''' is a unified, self-detecting image tag for BattlestarWiki Media. It replaces the fragmented family of hand-maintained sub-templates ({{Master screencap}}, {{RDM NTSC DVD screencap}}, {{TOS BR screencap}}, etc.) with a single template backed by Module:Screencap. The template: * '''Auto-detects''' series, season/episode (from SxxExx or NxNN..."

2026-03-08T17:32:46Z

Created page with "  ==Overview== '''Template:Screencap''' is a unified, self-detecting image tag for BattlestarWiki Media. It replaces the fragmented family of hand-maintained sub-templates ({{Master screencap}}, {{RDM NTSC DVD screencap}}, {{TOS BR screencap}}, etc.) with a single template backed by Module:Screencap. The template: * '''Auto-detects''' series, season/episode (from SxxExx or NxNN..."

New page

==Overview==
'''Template:Screencap''' is a unified, self-detecting image tag for BattlestarWiki Media. It replaces the fragmented family of hand-maintained sub-templates ({{Master screencap}}, {{RDM NTSC DVD screencap}}, {{TOS BR screencap}}, etc.) with a single template backed by [[Module:Screencap]].

The template:
* '''Auto-detects''' series, season/episode (from SxxExx or NxNN patterns), and quality tier from the file's '''pixel dimensions'''
* '''Renders''' a formatted infobox with the correct source badge, episode info, copyright notice, and timestamp
* '''Applies''' the correct maintenance and browse categories automatically
* Accepts '''named override parameters''' to correct or supplement any auto-detected value

==Quick Usage==
The simplest case — paste this on a file description page and the template does the rest:

<pre>
{{Screencap}}
</pre>

With manual overrides only where needed:

<pre>
{{Screencap
| episode = 33
| timestamp = 00:14:22
}}
</pre>

Full explicit form (mirrors the old Master screencap interface):

<pre>
{{Screencap
| series = rdm
| episode = The Hand of God
| cepisode = The Hand of God (RDM)
| season = 1
| type = bluray
| timestamp = 00:32:11
| scaled = yes
| cropped =
| aspect = yes
| de = Die Hand Gottes
| es =
| fr = La Main de Dieu
| tr =
| zh =
}}
</pre>

==Auto-Detection Logic==

===Series (from filename prefix)===
{| class="wikitable"
! Filename prefix !! Detected series
|-
| <code>RDM -</code>, <code>TRS -</code>, <code>BSG - S01…</code> || rdm
|-
| <code>CAP -</code>, <code>Caprica -</code> || cap
|-
| <code>B&C -</code>, <code>BNC -</code> || bnc
|-
| <code>TOS -</code> || tos
|-
| <code>1980 -</code>, <code>G1980 -</code> || 1980
|}

===Season & Episode (from filename)===
{| class="wikitable"
! Filename pattern !! Extracted info
|-
| <code>RDM - S04E20 - Daybreak.jpg</code> || Season 4, Episode 20
|-
| <code>BSG - 1x05 - Act of Contrition.jpg</code> || Season 1, Episode 5
|-
| <code>TOS - Saga of a Star World - Apollo.jpg</code> || Title hint: "Saga of a Star World - Apollo"
|}
If season/episode numbers cannot be extracted, the template flags the image with a title hint and a maintenance message.

===Quality / Source Type (from pixel dimensions)===
{| class="wikitable"
! Longest pixel dimension !! Auto-detected type !! Label
|-
| ≥ 3840 px || <code>4k</code> || 4K UHD
|-
| ≥ 1920 px || <code>bluray</code> || Blu-ray / 1080p stream
|-
| ≥ 1280 px || <code>hdtv</code> || HDTV 720p broadcast
|-
| ≥ 853 px || <code>ntscdvd</code> || NTSC DVD (anamorphic)
|-
| ≥ 720 px || <code>paldvd</code> || PAL DVD
|-
| < 720 px || <code>dvd</code> || DVD (generic / low res)
|}
Portrait-orientation images (promo photos) use the longer axis so a 1080×1535 portrait correctly reads as Blu-ray/stream quality.

==Parameters==

===Auto-detected (override only if wrong)===
{| class="wikitable"
! Parameter !! Purpose !! Example
|-
| <code>series</code> || Series key. Valid values: <code>rdm</code>, <code>cap</code>, <code>bnc</code>, <code>tos</code>, <code>1980</code> || <code>series=tos</code>
|-
| <code>type</code> || Source/quality type. Valid values: <code>4k</code>, <code>bluray</code>, <code>hdtv</code>, <code>hddvd</code>, <code>itunes</code>, <code>ntscdvd</code>, <code>ntscb</code>, <code>paldvd</code>, <code>palb</code>, <code>promo</code>, <code>dvd</code>, <code>unknown</code> || <code>type=bluray</code>
|-
| <code>season</code> || Season number || <code>season=2</code>
|}

===Identification (provide if not in filename)===
{| class="wikitable"
! Parameter !! Purpose !! Example
|-
| <code>episode</code> || English Wiki article name of episode (used for links and categories) || <code>episode=Exodus, Part II</code>
|-
| <code>cepisode</code> || Disambiguation display name if article has "(RDM)" etc. suffix || <code>cepisode=Exodus, Part II (RDM)</code>
|-
| <code>timestamp</code> || ISO 8601 time index HH:MM:SS || <code>timestamp=00:42:07</code>
|}

===Image attributes===
{| class="wikitable"
! Parameter !! Purpose
|-
| <code>scaled=yes</code> || Image has been scaled down from source dimensions
|-
| <code>cropped=yes</code> || Image has been cropped
|-
| <code>aspect=yes</code> || Aspect ratio confirmed correct
|}

===Multilingual episode links===
Provide the episode article name on each language wiki. The <code>c</code>-prefixed variants hold disambiguation suffixes where needed.

{| class="wikitable"
! Parameter !! Wiki
|-
| <code>de</code> / <code>cde</code> || German wiki (de.battlestarwiki.org)
|-
| <code>es</code> / <code>ces</code> || Spanish wiki
|-
| <code>fr</code> / <code>cfr</code> || French wiki (fr.battlestarwiki.ddns.net)
|-
| <code>tr</code> / <code>ctr</code> || Turkish wiki
|-
| <code>zh</code> / <code>czh</code> || Chinese wiki
|}

==Auto-Applied Categories==
The module automatically applies categories based on detected/overridden values. No manual <code>[[Category:...]]</code> tags are needed on the file page.

Examples of categories applied for a Blu-ray RDM Season 4 image of "Daybreak":
* <code>[[Category:Screen captures]]</code>
* <code>[[Category:Screen captures (TRS)]]</code>
* <code>[[Category:Blu-ray screen captures (TRS)]]</code>
* <code>[[Category:Screen captures by season 4 (TRS)]]</code>
* <code>[[Category:Screen captures (Daybreak)]]</code>
* <code>[[Category:Blu-ray screen captures (Daybreak)]]</code>

DVD/broadcast images also receive:
* <code>[[Category:Screen captures requiring upgrade]]</code>

Images where the source cannot be determined receive:
* <code>[[Category:Screen captures requiring source identification]]</code>

==Migration from Old Templates==
The old templates are ''not'' immediately broken — they can remain as thin wrappers that call <code>{{Screencap}}</code> with the appropriate <code>type=</code> and <code>series=</code> pre-filled. For example, <code>{{TOS BR screencap}}</code> can be refactored to:

<pre>
{{Screencap | series=tos | type=bluray | episode={{{episode|}}} | season={{{season|}}} | timestamp={{{timestamp|}}} | scaled={{{scaled|}}} | cropped={{{cropped|}}} | de={{{de|}}} | es={{{es|}}} | fr={{{fr|}}} | tr={{{tr|}}} | zh={{{zh|}}} }}
</pre>

This lets existing file pages continue to work unchanged while benefiting from the new auto-detection and unified infobox.

==Installation==
# Copy [[Module:Screencap]] to <code>Module:Screencap</code> on media.battlestarwiki.org
# Copy [[Template:Screencap]] wikitext to <code>Template:Screencap</code>
# Copy this documentation to <code>Template:Screencap/doc</code>
# (Optional) Update legacy sub-templates to wrap <code>{{Screencap}}</code> as shown above
# Test on a file page with known values; compare infobox output and categories against expected

<includeonly>[[Category:Image tags]]</includeonly>
<noinclude>[[Category:Template documentation]]</noinclude>

Template:Screencap/doc - Revision history

Joe Beaudoin Jr. at 00:41, 15 March 2026