Difference between revisions of "Template:P/Doc"

From ISFDB
Jump to navigation Jump to search
(where to find tag or rec #)
(pubtag->pubid)
 
(8 intermediate revisions by one other user not shown)
Line 1: Line 1:
------
+
This template is for linking to an ISFDB publication record.
Documentation for '''[[:Template:P]]''' transcluded from '''[[:Template:P/doc]]'''.
 
  
This template is for linking to a publication, It takes as its argument a publication tag or record number. Thus, for example
+
== Usage ==
 +
Call this template with a publication's ID or record number and, optionally, the publication's name or any string to display for the link.
 +
: <code><nowiki>{{P|38228}}</nowiki></code>
 +
gives this link: {{P|38228}}
  
<code><nowiki> {{P|SHPFRMRSD2000}} </nowiki></code>
+
Optionally, you can change the displayed link text.
 +
: <code><nowiki> {{P|38228|Sheepfarmer's Daughter}} </nowiki></code>
 +
gives this link: {{P|38228|Sheepfarmer's Daughter}}
  
gives this link: {{P|SHPFRMRSD2000}}
+
Note that any string can be passed instead of a publication title, for example, <code><nowiki>{{P|38228|this publication}}</nowiki></code> displays as {{P|38228|this publication}}.
  
Optionally, you can change the displayed link text with the name parameter. For example:
+
The template parameters can also be referenced using the names ''id'' and ''name'' respectively with the only requirement being that if the named ''id'' parameter name is used then ''name'' must be used if the second parameter is used. These forms are valid
 +
* <code><nowiki>{{P|id=38228}}</nowiki></code> displays as {{P|id=38228}}.
 +
* <code><nowiki>{{P|id=38228|name=Sheepfarmer's Daughter}}</nowiki></code> displays as {{P|id=38228|name=Sheepfarmer's Daughter}}.
 +
* <code><nowiki>{{P|38228|name=Sheepfarmer's Daughter}}</nowiki></code> displays as {{P|38228|name=Sheepfarmer's Daughter}}.
  
<code><nowiki> {{P|SHPFRMRSD2000|name=Sheepfarmer's Daughter}} </nowiki></code>
+
This form is not allowed as ''name='' must be used when ''id='' is used:
 +
* <code><nowiki>{{P|id=38228|Sheepfarmer's Daughter}}</nowiki></code>
  
gives this link: {{P|SHPFRMRSD2000|name=Sheepfarmer's Daughter}}
+
'''Note''' that while the examples on this page are using publication IDs, using a publication's tag, while deprecated, is still supported. Although very rare, a publication record's tag value can be changed rendering links to that publication invalid while its record number cannot be changed.
  
and
+
------
 
+
Documentation for '''[[:Template:P]]''' is transcluded from '''[[:Template:P/Doc]]'''.
<code><nowiki> {{P|SHPFRMRSD2000|name=SFD}} </nowiki></code>
 
 
 
gives this link: {{P|SHPFRMRSD2000|name=SFD}}
 
 
 
 
 
When a publication record is displayed, either the record numvber or the tag (depending on yow you got there) will be included in the URL (web address0 after "pl.cgi?". When a pub is being edited, the tag will appear in the TAG field, and the record number in the URL.
 

Latest revision as of 00:31, 14 December 2021

This template is for linking to an ISFDB publication record.

Usage

Call this template with a publication's ID or record number and, optionally, the publication's name or any string to display for the link.

{{P|38228}}

gives this link: 38228

Optionally, you can change the displayed link text.

{{P|38228|Sheepfarmer's Daughter}}

gives this link: Sheepfarmer's Daughter

Note that any string can be passed instead of a publication title, for example, {{P|38228|this publication}} displays as this publication.

The template parameters can also be referenced using the names id and name respectively with the only requirement being that if the named id parameter name is used then name must be used if the second parameter is used. These forms are valid

This form is not allowed as name= must be used when id= is used:

  • {{P|id=38228|Sheepfarmer's Daughter}}

Note that while the examples on this page are using publication IDs, using a publication's tag, while deprecated, is still supported. Although very rare, a publication record's tag value can be changed rendering links to that publication invalid while its record number cannot be changed.


Documentation for Template:P is transcluded from Template:P/Doc.