Revision as of 19:16, 23 August 2025

Documentation

This template creates a link to a comic for inline citations. It supports citing a single issue, a range of issues, or multiple different comics at once.

Single Issue Citation

This is the basic usage for citing a single comic book issue.

{{comics|starbuck|1}} will produce: (Comics: Battlestar Galactica: Starbuck #1)
{{comics|origins|5}} will produce: (Comics: Battlestar Galactica: Origins #5)

You can also link to just the main series page by omitting the issue number:

{{comics|vol3}} will produce: (Comics: Battlestar Galactica (Volume 3))

Issue Range Citation

To cite a range of issues from the same comic series, use three unnamed parameters in the format (Comics: series #start_issue — end_issue). This format does not link the comic title.

{{comics|starbuck|1|4}} will produce: (Comics: Battlestar Galactica: Starbuck #1 — 4)

Multiple Comic Citation

To cite issues from different comic series in one reference, use numbered parameters like comic1, issue1, comic2, issue2, etc. You can cite up to 5 different comics this way.

{{comics|comic1=starbuck|issue1=1|comic2=origins|issue2=5}} will produce: (Comics: Battlestar Galactica: Starbuck #1, Battlestar Galactica: Origins #5)

Other Parameters

nolink=y: Prints the comic title without linking. Note: This currently only works for single issue citations using the first and second unnamed parameters.
nocat=y: Prevents the template from adding a category to the page.

@@ Line 1: / Line 1: @@
 <includeonly>{{#if:{{{nolink|}}}|
 {{#if:{{{2|}}}|{{void}}|{{comics/switch|{{{1}}}|{{{2}}}}}}}
-{{#if:{{{template|}}}|{{comics/switch|{{{1}}}|{{{2}}}}}{{#ifeq:{{{1}}}|marvel|{{void}}|&nbsp;{{{2|}}}}}{{!}}''{{comics/switch|{{{1}}}|{{{2}}}}}{{#ifeq:{{{1}}}|marvel|{{void}}|&nbsp;#{{{2|}}}''}}|{{#if:{{{2|}}}|{{#if:{{{short|}}}|<nowiki>#</nowiki>{{{2|}}}|{{comics/switch|{{{1}}}|{{{2}}}}}{{#ifeq:{{{1}}}|marvel|{{void}}|&nbsp;{{{2|}}}}}}}}}}}|<sup>([[List of comics|Comics]]: {{#if:{{{3|}}}|{{void}}|''}}[[{{comics/switch|{{{1}}}|{{{2}}}}}{{#if:{{{2|}}}|&nbsp;{{#if:{{{short|}}}|{{{2|}}}{{!}}#{{{2|}}}|{{#ifeq:{{{1}}}|marvel|{{void}}|{{{2|}}}}}{{!}}{{{3|{{comics/switch|{{{1}}}|{{{2}}}}}{{#ifeq:{{{1}}}|marvel|{{void}}|&nbsp;#{{{2|}}}}}}}}}}|{{#if:{{{3|}}}|{{!}}{{{3}}}|{{void}}}}}}]]{{#if:{{{3|}}}|{{void}}|''}})</sup>}}
+{{#if:{{{template|}}}|{{comics/switch|{{{1}}}|{{{2}}}}}{{#ifeq:{{{1}}}|marvel|{{void}}|&nbsp;{{{2|}}}}}{{!}}''{{comics/switch|{{{1}}}|{{{2}}}}}{{#ifeq:{{{1}}}|marvel|{{void}}|&nbsp;#{{{2|}}}''}}|{{#if:{{{2|}}}|{{#if:{{{short|}}}|<nowiki>#</nowiki>{{{2|}}}|{{comics/switch|{{{1}}}|{{{2}}}}}{{#ifeq:{{{1}}}|marvel|{{void}}|&nbsp;{{{2|}}}}}}}}}}}|([[List of comics|Comics]]: {{#if:{{{comic1|}}}
+  |{{#if:{{{comic1|}}}|{{#if:{{{issue1|}}}|''[[{{comics/switch|{{{comic1}}}}}&nbsp;{{{issue1}}}|{{comics/switch|{{{comic1}}}}}&nbsp;#{{{issue1}}}]]''|''[[{{comics/switch|{{{comic1}}}}}]]''}}}}{{#if:{{{comic2|}}}|, {{#if:{{{issue2|}}}|''[[{{comics/switch|{{{comic2}}}}}&nbsp;{{{issue2}}}|{{comics/switch|{{{comic2}}}}}&nbsp;#{{{issue2}}}]]''|''[[{{comics/switch|{{{comic2}}}}}]]''}}}}{{#if:{{{comic3|}}}|, {{#if:{{{issue3|}}}|''[[{{comics/switch|{{{comic3}}}}}&nbsp;{{{issue3}}}|{{comics/switch|{{{comic3}}}}}&nbsp;#{{{issue3}}}]]''|''[[{{comics/switch|{{{comic3}}}}}]]''}}}}{{#if:{{{comic4|}}}|, {{#if:{{{issue4|}}}|''[[{{comics/switch|{{{comic4}}}}}&nbsp;{{{issue4}}}|{{comics/switch|{{{comic4}}}}}&nbsp;#{{{issue4}}}]]''|''[[{{comics/switch|{{{comic4}}}}}]]''}}}}{{#if:{{{comic5|}}}|, {{#if:{{{issue5|}}}|''[[{{comics/switch|{{{comic5}}}}}&nbsp;{{{issue5}}}|{{comics/switch|{{{comic5}}}}}&nbsp;#{{{issue5}}}]]''|''[[{{comics/switch|{{{comic5}}}}}]]''}}}}
+  |{{#if:{{{3|}}}
+    |''{{comics/switch|{{{1}}}}}'' #{{{2}}} &mdash; {{{3}}}
+    |{{#if:{{{1|}}}|{{#if:{{{2|}}}|''[[{{comics/switch|{{{1}}}}}&nbsp;{{{2}}}|{{comics/switch|{{{1}}}}}&nbsp;#{{{2}}}]]''|''[[{{comics/switch|{{{1}}}}}]]''}}}}
+   }}
+}})}}
 {{#if:{{{nocat|}}}|{{void}}|[[Category:{{#ifeq:{{{1}}}|marvel|{{comics/switch|{{{1}}}|{{{2}}}}}|{{comics/switch|{{{1}}}}}}}]]}}</includeonly><noinclude>
 = Documentation =
-This template creates a link to a comic for inline citations, for instance:
+This template creates a link to a comic for inline citations. It supports citing a single issue, a range of issues, or multiple different comics at once.
-* <code><nowiki>{{comics|1880|1}}</nowiki></code> creates {{comics|1880|1}}
+== Single Issue Citation ==
-* <code><nowiki>{{comics|bsgvsbsg|1}}</nowiki></code> creates {{comics|bsgvsbsg|1}}
+This is the basic usage for citing a single comic book issue.
-* <code><nowiki>{{comics|cw|1}}</nowiki></code> creates {{comics|cw|1}}
+* <code><nowiki>{{comics|starbuck|1}}</nowiki></code> will produce: ([[List of comics|Comics]]: ''[[Battlestar Galactica: Starbuck 1|Battlestar Galactica: Starbuck #1]]'')
-* <code><nowiki>{{comics|origins|1}}</nowiki></code> creates {{comics|origins|1}}
+* <code><nowiki>{{comics|origins|5}}</nowiki></code> will produce: ([[List of comics|Comics]]: ''[[Battlestar Galactica: Origins 5|Battlestar Galactica: Origins #5]]'')
-* <code><nowiki>{{comics|starbuck|1}}</nowiki></code> creates {{comics|starbuck|1}}
-* <code><nowiki>{{comics|vol3|1}}</nowiki></code> creates {{comics|vol3|1}}
-This template can also be used to shorten a link down to the issue number itself, when citing multiple comics within the same series, e.g.:
+You can also link to just the main series page by omitting the issue number:
+* <code><nowiki>{{comics|vol3}}</nowiki></code> will produce: ([[List of comics|Comics]]: ''[[Battlestar Galactica (Volume 3)]]'')
-* <code><nowiki>{{comics|starbuck|1|short=y}}</nowiki></code> creates {{comics|starbuck|1|short=y}}
+== Issue Range Citation ==
+To cite a range of issues from the same comic series, use three unnamed parameters in the format <code>{{comics|series|start_issue|end_issue}}</code>. This format does not link the comic title.
+* <code><nowiki>{{comics|starbuck|1|4}}</nowiki></code> will produce: ([[List of comics|Comics]]: ''Battlestar Galactica: Starbuck'' #1 &mdash; 4)
-It can also print out the comic title ''without'' being linked, and also strips italics (they can be added on around the template call, of course):
+== Multiple Comic Citation ==
+To cite issues from different comic series in one reference, use numbered parameters like <code>comic1</code>, <code>issue1</code>, <code>comic2</code>, <code>issue2</code>, etc. You can cite up to 5 different comics this way.
+* <code><nowiki>{{comics|comic1=starbuck|issue1=1|comic2=origins|issue2=5}}</nowiki></code> will produce: ([[List of comics|Comics]]: ''[[Battlestar Galactica: Starbuck 1|Battlestar Galactica: Starbuck #1]]'', ''[[Battlestar Galactica: Origins 5|Battlestar Galactica: Origins #5]]'')
-* <code><nowiki>{{comics|starbuck|1|nolink=y}}</nowiki></code> creates {{comics|starbuck|1|nolink=y}}
+=== Other Parameters ===
-* <code><nowiki>''{{comics|starbuck|1|nolink=y}}''</nowiki></code> creates ''{{comics|starbuck|1|nolink=y}}''
+* '''nolink=y''': Prints the comic title without linking. Note: This currently only works for single issue citations using the first and second unnamed parameters.
-* <code><nowiki>{{comics|starbuck|1|nolink=y|template=y}}</nowiki></code> creates {{comics|starbuck|1|nolink=y|template=y}}<ref>Piping is deliberate so as to be integrated into templates that already have linking abilities built in.</ref>
+* '''nocat=y''': Prevents the template from adding a category to the page.
-* <code><nowiki>{{comics|starbuck|1|short=y|nolink=y}}</nowiki></code> creates {{comics|starbuck|1|short=y|nolink=y}}<ref>Not that this is really necessary, anyway...</ref>
+</noinclude>
-It can also be used to link to the proper comic issue, but with custom text to be hyperlinked.
-* <code><nowiki>{{comics|vol3|1|In the Beginning}}</nowiki></code> creates {{comics|vol3|1|In the Beginning}}
-The parameters switch for this template may be [[/switch|found here]].
-=== Marvel Comics ===
-For Marvel comics, the usage will print out slightly differently, and titles must be called out by their ''issue'' number.
-e.g. ''[[Collision Course!]]'' (issue 13) would be called thusly:
-<code><nowiki>{{comics|marvel|13}}</nowiki></code>
-And thus would print:
-{{comics|marvel|13}}
-It is ''important'' that the "marvel" call be entirely lowercase.
-Parameters switch for the Marvel list may be [[/marvel|found here]].
-== References ==
-{{reflist}}
-[[Category:Battlestar Wiki link templates|Comics]]</noinclude>