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

From blackwiki
Jump to navigation Jump to search
imported>Fullstop
(return to non-demo #default, remove <span>s, and update code notes)
imported>Fuhghettaboutit
m (Changed protection level of Template:Citation/make link: when I changed this to add template editors, I didn't realize it had cascding protection—so all my change did was make it appear as if it could be edited by them ([Edit=Allow only administrator...)
 
(16 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{#switch:{{#titleparts:{{{1|}}}|2}}
+
{{#if:{{{1|}}}
  |Http:/|Https:/|Ftp:/ = [{{{1}}} {{{2|}}}]
+
  |[{{{1}}} {{{2}}}]
  |<!--if empty-->|None = {{{2|}}}
+
  |{{{2}}}
|#default            = [[:{{{1}}}|{{{2|{{{1}}}}}}]]
+
}}<noinclude><!--
}}<noinclude>
+
  Code notes (here so that people /read/ it)
<!-- Code notes (here so that people /read/ it)  
+
   1. Parameter #2 is always nonempty when called from {{Citation/core}}.
  Switch cases:
+
   2. It's up to {{Citation/core}} to stop italicized "'foo' & 'bar'" from becoming
  1. The switch cases on the first line are for regular url= or chapter-url=
+
     "'''foo' & 'bar'''". Citation/core does this by having a <nowiki></nowiki>
  2. The switch cases on the second line are for empty first param, or for "none" in first param.
+
     at both beginning and end of the call to this template. Since this is only
    Editors can use "none" to stop chapter-url= from defaulting to the value of url=
+
     needed once, it's more efficient to do it in {{Citation/core}} than here.
  3. The #default constructs an internal link since that is what the editor
+
-->{{documentation}}</noinclude>
    seems to have passed in url=
 
  Other notes:
 
   1. Parameter #2 is always non-empty when called from citation/core.
 
   2. Its up to citation/core to stop italicized "'foo' & 'bar'" from becoming  
 
     "'''foo' & 'bar'''". Citation/core does this by having a <nowiki></nowiki>  
 
     at both beginning and end of the call to this template. Since this is only  
 
     needed once, its more efficient to do it in citation/core than here.
 
  3. "None" is safe to use as a magic word. The wp article is not the title of
 
    a book, and will thus not be a url=
 
-->
 
{{documentation}}
 
</noinclude>
 

Latest revision as of 02:17, 13 November 2015

{{{2}}}

Template documentation[view] [edit] [history] [purge]

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".