Difference between revisions of "Template:P/Doc"

From ISFDB
Jump to navigation Jump to search
(It turns out tag SHPFRMRSD2000 used in all the examples was not valid...)
(Rename tag parameter to id and add note about using record numbers)
Line 2: Line 2:
  
 
== Usage ==
 
== Usage ==
Call this template with a publication's tag or record number and, optionally, the publication's name or any string to display for the link.
+
Call this template with a publication's tag or record number and, optionally, the publication's name or any string to display for the link.
: <code><nowiki> {{P|BKTG11707}} </nowiki></code>
+
: <code><nowiki>{{P|BKTG11707}}</nowiki></code>
 
gives this link: {{P|BKTG11707}}
 
gives this link: {{P|BKTG11707}}
  
Line 12: Line 12:
 
Note that any string can be passed instead of a publication title, for example, <code><nowiki>{{P|BKTG11707|this publication}}</nowiki></code> displays as {{P|BKTG11707|this publication}}.
 
Note that any string can be passed instead of a publication title, for example, <code><nowiki>{{P|BKTG11707|this publication}}</nowiki></code> displays as {{P|BKTG11707|this publication}}.
  
The template parameters can also be referenced using the names ''tag'' and ''name'' respectively with the only requirement being that if the named ''tag'' parameter name is used then ''name'' must be used if the second parameter is used. These forms are valid
+
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|tag=BKTG11707}}</nowiki></code> displays as {{P|tag=BKTG11707}}.
+
* <code><nowiki>{{P|id=BKTG11707}}</nowiki></code> displays as {{P|id=BKTG11707}}.
* <code><nowiki>{{P|tag=BKTG11707|name=Sheepfarmer's Daughter}}</nowiki></code> displays as {{P|tag=BKTG11707|name=Sheepfarmer's Daughter}}.
+
* <code><nowiki>{{P|id=BKTG11707|name=Sheepfarmer's Daughter}}</nowiki></code> displays as {{P|id=BKTG11707|name=Sheepfarmer's Daughter}}.
 
* <code><nowiki>{{P|BKTG11707|name=Sheepfarmer's Daughter}}</nowiki></code> displays as {{P|BKTG11707|name=Sheepfarmer's Daughter}}.
 
* <code><nowiki>{{P|BKTG11707|name=Sheepfarmer's Daughter}}</nowiki></code> displays as {{P|BKTG11707|name=Sheepfarmer's Daughter}}.
  
This form is not allowed as ''name='' must be used when ''tag='' is used:
+
This form is not allowed as ''name='' must be used when ''id='' is used:
* <code><nowiki>{{P|tag=BKTG11707|Sheepfarmer's Daughter}}</nowiki></code>
+
* <code><nowiki>{{P|id=BKTG11707|Sheepfarmer's Daughter}}</nowiki></code>
 +
 
 +
'''Note''' that while the examples on this page are using publication tags using a publication's ID or record number value is preferred as they are more stable. A publication record's tag value can be changed rendering links to that publication invalid while its record number can't be changed.
  
 
------
 
------
 
Documentation for '''[[:Template:P]]''' is transcluded from '''[[:Template:P/Doc]]'''.
 
Documentation for '''[[:Template:P]]''' is transcluded from '''[[:Template:P/Doc]]'''.

Revision as of 02:35, 27 October 2008

This template is for linking to an ISFDB publication record.

Usage

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

{{P|BKTG11707}}

gives this link: BKTG11707

Optionally, you can change the displayed link text.

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

gives this link: Sheepfarmer's Daughter

Note that any string can be passed instead of a publication title, for example, {{P|BKTG11707|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=BKTG11707|Sheepfarmer's Daughter}}

Note that while the examples on this page are using publication tags using a publication's ID or record number value is preferred as they are more stable. A publication record's tag value can be changed rendering links to that publication invalid while its record number can't be changed.


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