Difference between revisions of "Category:Citable Source Templates"

From The Dreadnought Project
Jump to: navigation, search
m (Purpose)
 
(6 intermediate revisions by the same user not shown)
Line 4: Line 4:
  
 
==Purpose==
 
==Purpose==
Editing the site requires a lot of pointless syntax.  We have around 200-500 sources we use continually, and we spend too much time typing characters for human readers when we should be typing only enough characters to get the Wiki to understand the source being used so that '''it''', in turn, can generate the verbose strings for the users to readTemplates matching this new standard provide this information, of course, and should replace the old ones categorized under [[:Category:Bibliography Templates|Bibliography Templates]] which did nothing at all to help in drafting footnotes.
+
Editing the site often requires a lot of boilerplate syntax.  We have around 200-500 sources we use continually, and making flexible templates helps us refer to them in a footnote, reducing error and saving timeThe templates in this category show the basic model we use.
 
+
You can see how beneficial the result is on authoring by examining [[Revenge Class Battleship (1914)]] and seeing how the footnotes are authored.  They are now very typeable, and editors really can forget about copying and pasting the long blurbs.
+
  
 
==Naming Standards==
 
==Naming Standards==
Line 20: Line 18:
 
**Torpedo as Torp
 
**Torpedo as Torp
 
**Technical History as TH
 
**Technical History as TH
* don't use Roman numerals; use Arabic, e.g., NavOps4 rather than NavOpsIV
 
 
* books by the naval service should not mention an author
 
* books by the naval service should not mention an author
 
* books should have last name of the first author, if the author seems vital to remembering the work
 
* books should have last name of the first author, if the author seems vital to remembering the work
* if the book is in a series, however; drop the author name:  e.g., NavOps4 rather than NewboltNOIV
+
* if the book is in a prominent series, however; drop the author name:  e.g., NavOpsIV rather than NewboltNOIV
* include a year as a suffix when the work was part of a regular or occasional series, e.g., SightM1916
+
* include a year as a suffix when the work was part of a regular or occasional series, e.g., ARTS1916,  if there is a Volume number or such, have that come after the year, e.g., ManGun1920III
  
 
==Using the Templates in a Wiki Article==
 
==Using the Templates in a Wiki Article==
Line 31: Line 28:
 
<blockquote>
 
<blockquote>
 
<nowiki>
 
<nowiki>
Crumpets are best for breakfast.{{CitTest|p. 5}}
+
Crumpets are best for breakfast.{{CrumpetH|p. 5}}
 
</nowiki>
 
</nowiki>
 
</blockquote>
 
</blockquote>
Line 40: Line 37:
 
<nowiki>==Bibliography==</nowiki>
 
<nowiki>==Bibliography==</nowiki>
 
<br>
 
<br>
<nowiki>* {{CitTest}}</nowiki>
+
<nowiki>* {{CrumpetH}}</nowiki>
 
</blockquote>
 
</blockquote>
  
Line 47: Line 44:
  
 
<blockquote>
 
<blockquote>
<nowiki>{{Cit|Complete bibliography reference here, no final dot|Abbreviated reference here, no final dot|{{{1|}}}}}<noinclude>{{CitCat}}</noinclude></nowiki>
+
<nowiki>{{Cit|Complete source reference|Abbreviated reference|{{{1|}}}}}<noinclude>{{CatCit}}</noinclude></nowiki>
 
</blockquote>
 
</blockquote>
  
Line 54: Line 51:
 
* a pipe character: |
 
* a pipe character: |
 
* the abbreviated footnote mention of the same work (final period omitted)
 
* the abbreviated footnote mention of the same work (final period omitted)
* the following mess: <nowiki>|{{{1|}}}<noinclude>{{CitCat}}</noinclude></nowiki></nowiki>
+
* the following mess: <nowiki>|{{{1|}}}<noinclude>{{CatCit}}</noinclude></nowiki></nowiki>
  
 
==Gotchas==
 
==Gotchas==
There should be NO line breaks anywhere, or the including article may have ugly whitespace and stray bullets and periods.
+
* There should be NO line breaks anywhere, or the including article may have ugly whitespace and stray bullets and periods.
 +
* Any equal signs (such as in a URL) must be replaced by <nowiki>{{Eq}}</nowiki>
 +
* Let me know if you see other anomalies {{TONE}}
  
Any URLs in the long form reference may require you to wrap "troublesome characters" (I am exploring which) in some manner to avoid confusing the templates.  For instance, at the moment, links to documents at the National Archives website are failing, and I have removed a few.  I hope to come up with a solution so these may be restored, if they are truly useful.
+
[[Category:Editing Aids]]

Latest revision as of 15:21, 11 January 2014

A Citable Source Template, is one with a short name optimized for placing a footnote in an article body, with the page/folio/plate number supplied as the single parameter.

When it is used with NO parameters, a more verbose reference to the encompassing book/work or source is supplied, suitable for use in a page's Bibliography section.

Purpose

Editing the site often requires a lot of boilerplate syntax. We have around 200-500 sources we use continually, and making flexible templates helps us refer to them in a footnote, reducing error and saving time. The templates in this category show the basic model we use.

Naming Standards

These have to be sufficiently long to specify the work being referred to, but must be short enough to be unique (of course) and easy to type. Editors should err on making them short rather than pretty, especially those that will be used frequently (e.g., ARTS1914 is good for "Annual Report of the Torpedo School, 1914", as it is used hundreds of times and is part of a series).

To this end, I suggest:

  • no standard prefix (i.e., no Bib or Cit, though we maybe we should consider SR for Service Records, when we "go there")
  • I have been abbreviating
    • Manual as M
    • Handbook as H
    • Drill Book as DB
    • Gunnery as Gun
    • Torpedo as Torp
    • Technical History as TH
  • books by the naval service should not mention an author
  • books should have last name of the first author, if the author seems vital to remembering the work
  • if the book is in a prominent series, however; drop the author name: e.g., NavOpsIV rather than NewboltNOIV
  • include a year as a suffix when the work was part of a regular or occasional series, e.g., ARTS1916, if there is a Volume number or such, have that come after the year, e.g., ManGun1920III

Using the Templates in a Wiki Article

As a citation, a single parameter is used to specify the page number (or similar details particular to this citation, but not to the source itself).

Crumpets are best for breakfast.{{CrumpetH|p. 5}}

When listing this source in a Bibliography section, however, no parameter is used. The template spits out the long format reference.

==Bibliography==
* {{CrumpetH}}

Creating a Citable Source Template

How does one write such a template? The basic form is:

{{Cit|Complete source reference|Abbreviated reference|{{{1|}}}}}<noinclude>{{CatCit}}</noinclude>

Note that it calls another template called Cit, and hands it three parameters:

  • the bibliographic (long format) description of the source (final period omitted).
  • a pipe character: |
  • the abbreviated footnote mention of the same work (final period omitted)
  • the following mess: |{{{1|}}}<noinclude>{{CatCit}}</noinclude></nowiki>

Gotchas

  • There should be NO line breaks anywhere, or the including article may have ugly whitespace and stray bullets and periods.
  • Any equal signs (such as in a URL) must be replaced by {{Eq}}
  • Let me know if you see other anomalies — TONY LOVELL, Editor.

Pages in category "Citable Source Templates"

The following 200 pages are in this category, out of 892 total.

(previous 200) (next 200)

A

A cont.

B

C

C cont.

D

E

F

G

H

(previous 200) (next 200)