User:Peaceray/Converting Havard citations to shortened footnotes (sfn)
Framing the problem
edit- The urgency
- As per WP:PARREF, there is
a consensus that inline parenthetical referencing should be deprecated
on English Wikipedia.
- What is parenthetical referencing & what's the simplest way to replace it?
- What is parenthetical referencing (AKA Harvard referencing)?
- Parenthetical referencing used to be a valid citation style, (see examples at WP:HARVARD), again, now deprecated.
- The simplest replacement is shortened footnotes: Help:Shortened footnotes
Why use shortened footnotes?
edit- They are advantageous when individual sets of footnotes reference different pages from the same source.
- The full citations are then placed in alphabetic or alphanumeric order, rather than in order of citation use. This eases locating the citation when viewing the section by itself.
- In cases where an article has an inconsistent citation style, WP:CITEVAR recommends seeking consensus and
imposing one style on an article with inconsistent citation styles (e.g., some of the citations in footnotes and others as parenthetical references): an improvement because it makes the citations easier to understand and edit;
combining duplicate citations (see Duplicate citations).
Before and after examples
edit- Actuary, an easy conversion, because it was primarily changing from one template to another
- Shizi (book), a more complicated conversion, because it required creating both full citations and shortened footnote templates
- Kahlil Gibran exemplifies conversion to shortened footnotes as part of WP:CITEVAR
Step by step: how to do it
editRecommended: install User:Ucucha/HarvErrors.js
editThis will warn you of any errors such as full citations that are not used by shortened footnotes, or sfns that do not have a full citation to which to link.
- Documentation: User:Ucucha/HarvErrors
- JavaScript: User:Ucucha/HarvErrors.js
- To install the script, add:
-
importScript('User:Ucucha/HarvErrors.js');
- to Special:MyPage/common.js.
Pick an article
edit- Go to User:Peaceray/Conversions from Use Harvard referencing
- If you do this, please apply a
strikethroughby using the <s></s> tags when done.
- If you do this, please apply a
- Alternately, go to Category:Use Harvard referencing and drill down into a month.
- State your intention on the article talk page
- For example, see Talk:Shizi (book)#Converting to shortened footnotes
To obtain a full citation and a sfn
editItems to note:
|
- Pick a citation in your target article that needs conversion
- If you have a URL, DOI, ISBN, PMID, PMCID, or OCLC #, go to Citer
- If you only have a title for a book, a journal, or article, go to WorldCat.org to get an OCLC # or an ISBN, then go to Citer at https://citer.toolforge.org/. (Also see [Github citer page https://github.com/5j9/citer] for concise description)
- Citer examples — Note that some need to be manually adjusted
- URL: Citation for www.newyorker.com/magazine/2008/01/07/prophet-motive
- Wayback Machine at web.archive.org: Khalil Gibran, archived from collectiondevelopment.library.cornell.edu
- ISBN: 9780861402793
- DOI: 10.31826/9781463240387
- OCLC: 62023693
- OCLC, rendering as web page rather than book: 589037866
- If the citation link goes to a Google books item, then follow the
About this link-->Get this book in print-->Find in a library
pulldown/links. This will take you to WorldCat to get an OCLC # or an ISBN, then go to Citer. - At Citer, pick the appropriate ID type from the drop down list at the upper left, enter the ID value (URL, DOI, ISBN, OCLC #, etc.) that you have. Submit.
- Copy the Shortened footnote and citation to a text editor.
- Adjust the citation as needed. For instance, if the URL or DOI is to an article, and the generated citation omits the author(s) or date(year), alter the citation and the {{sfn}} template accordingly, including any
|ref=
values. If the citation has one or more author last names, it will generate a ref value containing the each of the first four author names plus the year of publication. - Citer will typically render a single author as {{sfn |last_name |year |p=}} format whereas it will render two authors will generate a {{sfn |last1_name |last2_name |year |p=}} format. Please keep this in mind if you are manually altering the generated values.
- Or hand craft it yourself!
Placing the citation and a sfn
edit- Ensure that there are the appropriate sections. I prefer ==References== and ==Sources==. See MOS:NOTES.
- Either place the full citation first by editing the Sources section (easier), or by placing the full citation and sfns simultaneously by editing the full article code (harder). Always preview! If you have User:Ucucha/HarvErrors.js installed, it will warn you of any errors.
- If are placing the shortened footnote(s) after placing the full citation, do it now.
End steps
editAfter you have completed the conversion, there are follow through steps.
- Add the {{Use shortened footnotes}} template using the
{{Use shortened footnotes|date=December 2020}}
syntax near the top of the article. - Consider adding {{done}} ( Done) and any comments to your comments on the talk page.
- Notify a template editor to (or if you have template editor privileges) add {{Shortened footnote editnotice}} using the
{{Shortened footnote editnotice|expiry=indefinite}}
syntax. You can find an example at Template:Editnotices/Page/Kahlil Gibran.