Template talk:Ref
From Wikipedia, the free encyclopedia
| Ref template (talk page) | archives (latest)→ |
|
Contents |
[edit] Documentation
[edit] Alternative referencing style
The Cite.php <ref> and <references/> system is an alternative style of referencing to the templates discussed on this page. For details on this system, please see Wikipedia:Footnotes and Wikipedia:Cite sources.
A third-party tool to translate articles using the templates described on this page into the Cite.php system is available, see Ref converter.
[edit] Usage
For multiple links to one citation in the Reference section, use different id values ("a", "b", etc.), beginning with the first citation. The "id" is used to make multiple backlinks from the note.
[edit] Link in text area
[edit] Simple
{{ref|reference_name}}
{{ref|reference_name|label}}
fuu
fuu
Creates a simple link to a footnote, with reference_name being an invisible unique id.
[edit] Complex
{{ref label|reference_name|label|id}}
fuu[label]
{{ref label}} links to a {{note label}} citation in the References section labeled reference_name and id (reference_nameid). Text is marked with label instead of an automatically generated value. For future needs, reference_name should be the same as related references.
[edit] Harvard
{{ref harvard|reference_name|Harvard reference|id}}
{{ref harv|reference_name|Harvard reference|id}}
fuu (Harvard reference)
fuu(Harvard reference)
{{ref harvard}} and {{ref harv}} link to a {{ref label}} citation in the References section labeled reference_name and id. Text is with Harvard reference (usually an author's name and year of publication) instead of automatically generated number. {{ref_harvard}} formats the reference link as normal text while {{ref_harv}} formats the reference link as superscript.
[edit] Link in References section
[edit] Simple
{{note|reference_name}}
↑ fuu
Creates a simple footnote for the reference with the invisible unique id reference_name.
[edit] Complex
{{note label|reference_name|number|id}}
id fuu
Creates a footnote matching {{ref label}} in the text labeled reference_name and id. For multiple uses of a citation, use {{note_label}} with the corresponding id values ("a", "b", etc.), used in the text. The "id" is used to make backlinks to the text. If the id is specified as "none", then the ^ symbol is rendered for the backlink.
[edit] Examples
Also see examples and explanation in Wikipedia:Footnote3.
The following examples from {{Ref/examples}} are rendered as a template in the following table:
| What to type | What it makes |
|---|---|
|
Linking and footnote templates Tags attached to links in text area:
For two links to the same footnote labeled "example.com", you would:
Tags attached to links in References or Footnote section: "#{{note|reference1}} example of {{note}}" — In References section, citation labeled "reference1". "#{{note_label|example.com|2|none}}"— In References section, citation labeled "example.comnone". Creates backlink to matching {{ref_label}} entry in the text labeled "example.comnone". Now, if you have two links to the same footnote labeled "example.com", you would do: "#{{note_label|example.com|3|a}}{{note_label|example.com|3|b}} example of {{note_label}}" "{{note_label|nextexample.com|4|4}} example of {{note_label}}"
|
In References or Footnote section:
4 example of {{note_label}}
|
[edit] Instructions
In an article, a reference link to supporting material can be made with the {{ref}} template, such as this. (Note the link to the reference's footnote; at present it appears as a small number.)
A significant advantage of using this method is that the reference contains a named link which allows recovery from various edit problems. Otherwise, connections to references can be lost if only numbers are used and editors alter footnote numbers.
- For multiple references to the same work it is suggested that the page number be used to make each reference unique, i.e. {{ref|Jones1954a-25}}.
- For journal articles it is suggested a reference similar to AuthorYear be used, i.e. {{ref|Jones1954a}}.
- Instructions for adding a citations using these templates:
-
- Footnotes use names, not numbers. Please see Wikipedia:Footnote3 for details.
- 1) Assign your footnote a unique name, for example "TheSun_Dec9".
- 2) Add the template {{ref|TheSun_Dec9}} to the body of the article where you want the new footnote.
- 3) Take note of the name of the footnote that immediately proceeds yours in the article body.
- 4) Add #{{Note|TheSun_Dec9}} to the reference list, immediately below the footnote you noted in step 3.
- 5) Multiple sources in the text pointing to the same reference will not work: each source must have uniquely-named notes in the References section.
- Footnotes use names, not numbers. Please see Wikipedia:Footnote3 for details.
- It is important to add the citations in the right order in the Reference (or Notes) list.
- These templates can be used in conjunction with other non-linking templates at Wikipedia:Cite_sources/example_style and Wikipedia:Template_messages/Sources_of_articles/Generic_citations. All citations are listed at Wikipedia:Template_messages/Sources_of_articles as well.
[edit] References (example for Notes)
- (used earlier)
- ↑ This is a footnote with supporting material to the above reference. This footnote is created with the template syntax: {{note|ref_example}}. The {{note}} template presently creates a small symbol ("^") that contains a link back up to the source in the text. Readers thus have links back and forth within the text. The number at the beginning of this line was created with the Wiki notation # placed at the beginning of the line, which only displays a numbered list. The matching number is not necessary, and Wikipedia:Cite sources suggests using the bulleted list notation: *
[edit] See also
- Wikipedia:Footnotes — Discussion about this reference method.
- template:ref — Template for references using this method.
- template:note — Template for footnotes using this method.
[edit] "Template:Ref"
The Tallboy bomb article uses ref notes. The "ref_label" and "note" templates are working as expected but the "ref" template shows "Template:Ref" in the text and if cliked upon takes the reader to this template. Something somewhere is broken and I would appreciate it if someone who knows what they are doing could fix the Ref template. --Philip Baird Shearer 10:57, 17 September 2006 (UTC)
[edit] Please help!
Does this format.. superscripted text in parentheses such as (Author), that links to a note indexed as (Author) .. does it exist in the real world? Can you go to the library and pick up a major journal referenced in this way? If the answer is NO I vote Deprecate and Delete. Just because we can make our own idiosyncratic system of referencing is a far cry for saying that we should. The current chaos in systems for linking cites to refs does a huge disservice to the Wikipedia community. --Ling.Nut 15:29, 24 September 2006 (UTC)
[edit] Optional naming
I'd like to add a second parameter defaulting to nothing for the link name (see example page where this would be useful). This would have no effect on normal usage, as shown below. Are there any objections to this?
meh{{ref|meh|a}} fuu{{ref|fuu|b}} bar{{ref|bar|c}}{{ref|mv}}.
== Notes ==
* {{note|meh|a}} [[meh]]
* {{note|fuu|b}} [[fuu]]
* {{note|bar|c}} [[bar]]
# {{note|mv}} [[Metasyntactic variable]]
// [admin] Pathoschild (talk/map) 00:12, 7 October 2006 (UTC)
- Implemented. // [admin] Pathoschild (talk/map) 06:42, 10 October 2006 (UTC)
