Difference between revisions of "Template:Citation/make link/doc"

From blackwiki
Jump to navigation Jump to search
imported>Fullstop
m (m title)
imported>Trappist the monk
m (ce;)
 
(25 intermediate revisions by 23 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
 +
{{high-risk|4000}}
  
This template (<code><nowiki>{{Citation/make_link}}</nowiki></code>) is a "subroutine" of <code>{{tl|Citation/core}}</code>. It is used for conditionally making links for the <code>chapter=</code> and <code>title=</code> fields in a citation.  
+
This template is a "subroutine" of {{tl|Citation/core}} used for conditionally making links for the <code>chapter=</code> and <code>title=</code> fields in a citation.  
  
It is invoked as  
+
It is invoked as:
: <tt><nowiki>{{citation/link </nowiki> </tt>
+
: <kbd><nowiki>{{Citation/make link </nowiki> </kbd>
::  | <tt>1</tt> = ''<value of ''<tt>IncludedWorkURL=</tt>'' or ''<tt>URL=</tt>'' or ''<tt>PMC=</tt>'' parameters>''  
+
::  | <kbd>1</kbd> = ''<value of ''<kbd>IncludedWorkURL=</kbd>'' or ''<kbd>URL=</kbd>'' or ''<kbd>PMC=</kbd>'' parameters>''  
::  | <tt>2</tt> = ''<value of ''<tt>IncludedWorkTitle=</tt>'' or ''<tt>Title=</tt>'' parameters>''
+
::  | <kbd>2</kbd> = ''<value of ''<kbd>IncludedWorkTitle=</kbd>'' or ''<kbd>Title=</kbd>'' parameters>''
: <tt><nowiki>}}</nowiki></tt>
+
: <kbd><nowiki>}}</nowiki></kbd>
  
Depending on the value of the first parameter, it then returns one of the following:
+
It uses the following algorithm:
: 1. if parameter #1 is empty or "none", it returns the second parameter as plain text
+
# If the first parameter is empty, it returns the second parameter as plain text.
: 2. if parameter #1 is an external url, it returns an external link-ified form of parameter #2
+
# If the first parameter is a URL, it returns the second parameter wrapped inside an external link to the first.
: 3. default: treats parameter #1 as the name of an existing article, and so returns an internal link form of parameter #2
 
  
This "subroutine" is not suitable for general use. It makes certain assumptions that are probably only valid as used by <nowiki>{{citation/core}}</nowiki>.
+
This "subroutine" is designed for {{tl|Citation/core}} and makes assumptions that may not be valid elsewhere.
  
 +
Examples:
 +
* "<code><nowiki>{{Citation/make link||BBC News front page}}</nowiki></code>" produces "{{Citation/make link||BBC News front page}}".
 +
* "<code><nowiki>{{Citation/make link|http://news.bbc.co.uk/|BBC News front page}}</nowiki></code>" produces "{{Citation/make link|http://news.bbc.co.uk/|BBC News front page}}".
  
 
<includeonly>
 
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
+
 
 
</includeonly>
 
</includeonly>

Latest revision as of 17:21, 21 November 2019

This template is a "subroutine" of {{Citation/core}} used for conditionally making links for the chapter= and title= fields in a citation.

It is invoked as:

{{Citation/make link
| 1 = <value of IncludedWorkURL= or URL= or PMC= parameters>
| 2 = <value of IncludedWorkTitle= or Title= parameters>
}}

It uses the following algorithm:

  1. If the first parameter is empty, it returns the second parameter as plain text.
  2. If the first parameter is a URL, it returns the second parameter wrapped inside an external link to the first.

This "subroutine" is designed for {{Citation/core}} and makes assumptions that may not be valid elsewhere.

Examples:

  • "{{Citation/make link||BBC News front page}}" produces "BBC News front page".
  • "{{Citation/make link|http://news.bbc.co.uk/|BBC News front page}}" produces "BBC News front page".