Difference between revisions of "Template:PubSeries"

From ISFDB
Jump to navigation Jump to search
(cloned from Template:Series)
 
(HTTPS upgrade)
 
Line 1: Line 1:
<span style="{{Linkcolor}}">[http://www.isfdb.org/cgi-bin/pubseries.cgi?{{{altName|{{{altname|{{anchorencode:{{{id|{{{1|{{{name}}}}}}}}}}}}}}}}} {{{name|{{{2|{{{1|{{{id|{{{altName|{{{altname}}}}}}}}}}}}}}}}}}]</span><noinclude>
+
<span style="{{Linkcolor}}">[https://www.isfdb.org/cgi-bin/pubseries.cgi?{{{altName|{{{altname|{{anchorencode:{{{id|{{{1|{{{name}}}}}}}}}}}}}}}}} {{{name|{{{2|{{{1|{{{id|{{{altName|{{{altname}}}}}}}}}}}}}}}}}}]</span><noinclude>
  
 
{{PubSeries/doc}}
 
{{PubSeries/doc}}

Latest revision as of 10:23, 8 September 2022

{{{altname}}}

Purpose

This linking template is used to link to an ISFDB Publication Series Bibliography display page.


Alias

{{PS}} will serve as an alias for {{PubSeries}}, and can be called in the identical way and with identical parameters. -DES Talk 01:13, 20 August 2010 (UTC)

Usage

The most common usage is

{{PubSeries|5|Classic Reprint}}

which will display Classic Reprint and clicking on that link will link to Publication Series Bibliography record 5 which is for the Classic Reprint series.

If the second parameter is omitted as in {{PubSeries|5}} then 5 will be displayed.

While these are convenient to use it's a good practice to always use this template with the id and name parameters.

{{PubSeries|id=5|name=Classic Reprint}}
{{PubSeries|id=5}}

will display as Classic Reprint and 5 respectively.


The "shorthand" or "alias" {{PS}} can be used. For example:

{{PS|5|Classic Reprint}}

which will display Classic Reprint.

{{PS|5}} will display as 5.


Note - As series names can change it is strongly recommended that you always link to an ISFDB series record by its record ID number. However, you can link to a series by name.

{{Series|Classic Reprint}}

will display and link to Classic Reprint. If you are on a series bibliography page and want to know its record ID number then look in the browser's address bar and the number will be at the end of the URL.

If the series name contains special characters such as quotes or parentheses then linking by name can fail. Using {{PubSeries|Classic Reprint (Forgotten Books)}} displays Classic Reprint (Forgotten Books) but clicking on the link will go to a page that displays "Error: Series not found." There is a workaround for this using the altname parameter along with the name parameter. For example, {{PubSeries|altname=Classic_Reprint_(Forgotten Books)|name=Classic Reprint (Forgotten Books)}} displays Books) Classic Reprint (Forgotten Books). Note that when you enter an altname that you must replace any spaces with underscores.

Parameters

There are three optional parameters:

  • id is the record number of a publication series in the ISFDB database.
  • name is the display text used for the link to the series bibliography page. This does not need to be the same as the series name allowing you to write something such as "take a look at this series." In that example {{PubSeries|id=5|name=this}} was used.
  • altname is used when linking by series name and that the name contains special characters. As linking by series name is discouraged the use of altname should be rare. The value for an altname must not contain any spaces. If a series name contains spaces then replace them with underscores (_).

If the Series template is used with unnamed parameters then the first will be interpreted as the id and the second, if present, will be interpreted as the name. It is possible, though unlikely, that future versions of the Series template will change the interpretation of any unnamed parameters. It is recommended that Series always be used with the id, and if desired, the name parameters.

Documentation source

This is documentation for the template PubSeries, transcluded from PubSeries/doc.