Help talk:Citation Style 1/Archive 6
Cite original title or second title for the continuation of a newspaper storySometimes a story from one page of a newspaper (e.g. on page 1 "Easter Bunny Goes Berzerk") is continued on another page under a different title (e.g. on page 2, "Children run in terror; Chocolate eggs spilled everywhere - continued from p. 1"). If the material I want to use is on page 2, do I still cite only the original title? Should I use
Rendering problem with right-to-left language and trans-titleTrappist the monk and others who might know the details of the Lua code: please see the following thread at VPT: Wikipedia:Village pump (technical)/Archive 137#Citations with title parameter in rtl language.2C beginning with numbers: Display issue and workaround – Jonesey95 (talk) 16:32, 18 August 2014 (UTC)
Where is the deprecated parameter in this article?Where is the deprecated citation parameter in Michael Sells? I have done a null edit and a purge, and it shows the deprecated parameter category, but I do not see any error messages or deprecated parameters. The category appears to have been added with this recent edit. The article also sorts at the very top of the error category, before the articles that start with numbers, for some reason. I don't know if that is relevant. I am also seeing this same situation with Urban College of Boston, Wiktor Eckhaus, and University of Natal. – Jonesey95 (talk) 03:05, 14 September 2014 (UTC)
Deprecated parameter test removed from —Trappist the monk (talk) 22:43, 14 September 2014 (UTC) Missing space in cite conference*{{cite conference | authors=Abe, M. et al. | date=2008 | title=Ground-based observational campaign for asteroid 162173 1999 JU3 | journal=[[Lunar and Planetary Science]] | volume=39 |pages=1594 | conference=37th COSPAR Scientific Assembly | url=http://www.lpi.usra.edu/meetings/lpsc2008/pdf/1594.pdf }} Yields the following output.
Notice the part that says "37th COSPAR Scientific AssemblyLunar and Planetary Science", which should instead be "37th COSPAR Scientific Assembly. Lunar and Planetary Science". Headbomb {talk / contribs / physics / books} 16:31, 15 September 2014 (UTC) Well ..., *{{cite conference | authors=Abe, M. et al. | date=2008 | title=Ground-based observational campaign for asteroid 162173 1999 JU3 | publisher=[[Lunar and Planetary Institute]] | volume=39 |page=1594 | conference=39th Lunar and Planetary Science Conference | url=http://www.lpi.usra.edu/meetings/lpsc2008/pdf/1594.pdf }}
Or, I think a better solution is to use
As an aside, I think that —Trappist the monk (talk) 19:07, 15 September 2014 (UTC)
Publication within a publicationThe Sun Magazine used to appear every Sunday in The Baltimore Sun. (It now appears to be part of it six times each year: [1].) If I am using Template:Cite news for an article published in The Sun Magazine, do I indicate that for
Update to the live CS1 module week of 2014-08-24After the end of this week I propose to update:
This update changes the things: in Module:Citation/CS1:
in Module:Citation/CS1/Configuration:
in Module:Citation/CS1/Whitelist:
in Module:Citation/CS1/Date validation:
—Trappist the monk (talk) 13:59, 17 August 2014 (UTC)
Additionally, the current Module:Citation/CS1/Configuration/sandbox is rendering
Done. In the process I discovered that the documentation for the old style arxiv identifiers does not mention versioning as the new style identifiers do. So, I wrote the original test so that versioning was only allowed in the new style. Turns out that old style identifiers may have versioning. I've fixed both the sandbox and the live versions of the module to correct this error. —Trappist the monk (talk) 11:55, 24 August 2014 (UTC) Documentation neededWe need documentation sections on Help:CS1 errors for the new arXiv and first name / last name errors. Does anyone have a sandboxed version of those new sections yet? If not, I'll start drafting them in commented sections on the page. The styling change for the error message means that we will need to re-style the error messages on the Help page as well. Is there a clever way to do this for the whole page, or do we need to edit each instance of
Your edits look fine to me. I might tweak the wording a bit after it goes live and I can see it in context, but I do not expect to make major changes. I don't think we need separate categories. In both cases, I do think that a missing editor should report "missing
Is that difficult or easy to modify? – Jonesey95 (talk) 15:39, 20 August 2014 (UTC)
OL parameter not being processed optimallyI have noticed a problem with the CS1 citations' processing of the (little-used) This OL is broken: Marjorie L. Burns (1980). How to Read a Short Story (Scholastic language skills). Scholastic Book Services. ISBN 978-0-590-30611-9. OCLC 8000874. OL 10699186M. This OL works: Marjorie L. Burns (1980). How to Read a Short Story (Scholastic language skills). Scholastic Book Services. ISBN 978-0-590-30611-9. OCLC 8000874. OL 10699186M. The OLID listed on the resulting page is "OL10699186M", so we should expect editors to put in such values. We should also expect them to leave off the leading "OL", since doing so has presumably resulted in working links for some period of time. I was unable to find a spec for the Open Library Identifier (OLID); someone else may have better luck finding it. It appears that we might want to ignore the presence of a leading "OL" in the
An ISO 639-1 language name testSometime ago somewhere there was a discussion about ISO 639-1 that led me to do a brief experiment with So, I've tweaked Module:Citation/CS1/sandbox to use If the tweaked code works, and if
I have been through the list and found a handful of code translations that do not match. Can anyone find others?
These codes produced results different from the current table of definitions in Module:Citation/CS1/Configuration. Each is accompanied by a link to SIL International (SIL) along with a list of language names. Presumably, where two or more language names are listed, the first listed should be preferred? Right? SIL is, according to the Library of Congress web site, is the keeper of ISO 639 (here is a table of ISO 639 codes at the Library of Congress).
With the exception of codes no and to, In the mean time I will adjust the existing table so that if it takes a while before code no is fixed at least CS1 will be doing correct code to language name translation for codes dv, ht, and kj. —Trappist the monk (talk) 23:06, 1 September 2014 (UTC)
I have tweaked Module:Citation/CS1/sandbox to provide a workaround for the code With this tweak, I think we can remove the translation table from Module:Citation/CS1/Configuration. —Trappist the monk (talk) 16:59, 10 September 2014 (UTC) If this is intended to appear in the citation, this would be way more helpful if the output was "(language: Langname)" instead of "(in Langname)", an ambiguous construction that relies entirely upon the reader's recognition of Langname as the name of a language. That is unworkable because of the large number of obscure languages on the planet, and the fact that some of them are not distinguished from geonyms or ethnonyms. — SMcCandlish ☺ ☏ ¢ ≽ʌⱷ҅ᴥⱷʌ≼ 14:49, 6 September 2014 (UTC)
I've been wondering if the categorization that Module:Citation/CS1 applies to pages with citations that assign ISO639-1 codes to
Here, So my question is: Are we correctly categorizing these pages? If yes, then we're done; if no, how should these pages be categorized? —Trappist the monk (talk) 14:45, 10 September 2014 (UTC)
Based on my conversation with Editor Danmichaelo, I have taken the decision that Module:Citation/CS1 will return the string '(in Norwegian)' when editors use I have removed the translation table from Module:Citation/CS1/Configuration/sandbox so language codes now get the language names from Mediawiki. Still unanswered is the categorization question. Category:Articles with non-English-language external links appears to have been intended for just that: external links. Right now, the module is indiscriminate. Whenever a citation with —Trappist the monk (talk) 11:34, 15 September 2014 (UTC)
The other half is now implemented in Module:Citation/CS1/sandbox. The code will now categorize pages with CS1 citations containing —Trappist the monk (talk) 16:05, 29 September 2014 (UTC)
Should Template:Cite report be listed on this Help page?I recently came across an invalid LCCN in a
The documentation for {{cite report}} is so bad and the title formatting is so non-standard that this template should not be considered part of CS1. I consider the template unfit for any use at all and if I come across a featured article that uses it, I will change it. If the change is reverted I will challenge the FA status of the article. Jc3s5h (talk) 12:54, 5 September 2014 (UTC)
Untitled workI notice that CS1 does not support untitled works. Chicago would use a descriptive phrase where the title would normally go, and the phrase would not be in italics nor would it be enclosed with quotes. So if someone needs to cite an untitled work, what would they do, other than rewrite all the citations in the article to use a style other than CS1? Jc3s5h (talk) 13:26, 5 September 2014 (UTC)
archivedate considered harmful(in the tradition of Goto considered harmful) The existence of Help:CS1_errors#.7Carchiveurl.3D_requires_.7Carchivedate.3D makes little sense to me. 99%[1] of archiveurl fields on en contain the archive date within the URL, so the archivedate field is redundant, and where the archivedate field conflicts with the archive date within the URL, it's always the former that is wrong. I therefore proclaim archivedate considered harmful, and propose it be deprecated. --{{U|Elvey}} (t•c) 08:09, 17 September 2014 (UTC) References
FYI—The other day I ran across several archive.org URLs that had bogus values in the date part; e.g., "15" in the location where the month is supposed to be. The URLs were functional, but IIRC they redirected to "valid" URLs. There is no way of knowing how widespread the problem is, but you can't rely on those values 100% of the time. ‑‑Mandruss (talk) 13:08, 27 September 2014 (UTC)
Wikimarkup and COinS metadataOne very common corrupter of the COinS metadata is wikimarkup when it is used to add bold and / or italic styling to
In Module:Citation/CS1/sandbox, I have created a function
The above examples use Have I missed anything obvious? With this fix, the work discussed at Module talk:Citation/CS1/Archive 11#non-italic titles may no longer be necessary. —Trappist the monk (talk) 12:46, 18 September 2014 (UTC)
Accessibility and COinSThere may be an accessibility issue with the COinS metadata that is appended to citations emitted by the CategoriesI have created some new categories. Category:CS1, Category:CS1 errors, and Category:CS1 maintenance. I have added Category:CS1 errors to all of the current error categories listed at Category:Articles with incorrect citation syntax with the exception of Category:Pages with DOI errors and Category:Pages with OL errors. Because these two categories are also populated by non-CS1 templates, I have modified Module:Citation/CS1/sandbox so that errors that previously categorized pages into these two categories will use two new categories Category:CS1 errors: DOI and Category:CS1 errors: OL when the module is next updated. First use for Category:CS1 maintenance is likely to be to categorize citations that use I plan to add a properties category which will get as its first subcategory something like Category:CS1 foreign language citations which will then list all pages that have CS1 citations that use —Trappist the monk (talk) 11:59, 25 September 2014 (UTC)
Updating the live module?moved from Help talk:Citation Style 1/Archive 6#Categories I support updating the live module. Has the missing editor/author condition been re-implemented in this round of updates? Also, do we feel that there is consensus on enabling any of the hidden error messages? (See discussion above.) If this comment is forking the discussion, feel free to move it to a new section or subsection about updating the module. – Jonesey95 (talk) 03:40, 27 September 2014 (UTC)
Date when no date suppliedThis webpage does not list a date, but does state the copyright, "© 2009-2014 Concordia Theological Seminary", at the bottom. Should I leave
Date for ArXivI'd like to be able to add a separate date for the ArXiv link specified with
Date templateJust curious - why doesn't the {{date}} template generate a CS1 error, even though the template's documentation says not to use it within citation tempates? For example:
Thanks! GoingBatty (talk) 15:29, 5 October 2014 (UTC)
Author aliasI have a work by someone with an English name and a Chinese name. What to do? What I did was put his English name as author, and his alias as others= alias.... Anyone got a better idea? John of Cromer (talk) mytime= Mon 17:37, wikitime= 09:37, 6 October 2014 (UTC) Deprecated parameters?Asked at Wikipedia:Help desk#Module:Citation/CS1. Module:Citation/CS1/Configuration has a number of parameters commented with "remove after 1 October 2014". I am guessing that the use would be updated, the documentation updated and the parameters removed. -- Gadget850 talk 10:46, 12 October 2014 (UTC)
Date rangeHi, I just noticed a broken cite journal date in an article. The publication was "date = January-March 1969" but the system doesn't like this, so I changed it to "date = January 1969". But how should a date range be specified? Thanks, Esowteric+Talk 14:30, 13 October 2014 (UTC)
Similar template with cite web with date format in YYYY-MM-DDHello, I am looking for a template similar with {{cite web}}, that is capable to accept the date in the YYYY-MM-DD format and then to transform it into the desired output. Imagine for example a template named {{cite web US}}, where, when I specify the date like "date= 2014-01-07", it will show it like "January 7, 2014" (or "January 7th, 2014"). And another template named {{cite web UK}}, where, when I specify the date like "date= 2014-01-07", it will show it like "7 January 2014" (or "7th of January 2014"). And then, each Wikipedia will translate that template into their own language. So when you create a reference (manually or automatically), you only have to specify the data in the universally YYYY-MM-DD format, so you don't have to bother to understand how that language outputs the date. For example, at Spanish Wikipedia, "date= 2014-01-07", will output "7 de enero de 2014". Therefore, the same reference can be translated and adapted everywhere (in any other Wikipedia), and then when you use it, you don't need to know how each language outputs the date. To be more specific, the following reference:
will output it like:
on Spanish Wikipedia, it ({{cite web YMD}}) will output it like:
Is there such a template, or can anyone create such template? Thanks — Ark25 (talk) 10:45, 14 October 2014 (UTC)
Sorry, I don't need anything like unifying an entire article. I just need the template to output the date as I say. I tried it other way, using the {{date}}, it works, but it doesn't work with subst: This one works:
And this one doesn't work:
— Ark25 (talk) 22:34, 14 October 2014 (UTC)
Two months in the date parameter
I want to use a {{harvnb}} with a year parameter of 1828. See here, the date in the publication is given as "February & June MDCCCXXVIII" which before the introduction of CS1 could be dealt with as in a {{cite book}} with the parameters set to the following values "month=February & June |year=1828" or as "year=1828 |date=February, June 1828" How to deal with it now as CS1 barfs on "date=February, June 1928" (Help:CS1 errors#bad date). Of course one can use "date=February–June 1828" or even "date=June 1828", but that is a distortion of date in the source. -- PBS (talk) 19:12, 14 October 2014 (UTC)
Date with "onwards"There are a number of web sites which give their preferred citation in the form "YEAR onwards" (e.g. the Angiosperm Phylogeny Website – see [3]) or "YEAR+" (e.g. the Euro+Med database – as one example see [4])). I recall pointing this out when the date processing in the cite/citation templates was updated. Yet dates of this form produce errors. Peter coxhead (talk) 16:11, 15 October 2014 (UTC)
Cite Journal/magazineIs there any particular reason why {{Cite journal}} displays page numbers in a format unlike the rest of the cite x series of templates? Why is p. or pp. missing here? Resolute 17:27, 15 October 2014 (UTC)
{{Cite journal}} states that the p. or pp. is displayed (i.e., added) unless
Here is the complete documentation section:
As noted, if and only if work or one of its aliases is defined, then the formatting changes are applied. If you use {{cite journal}} and don't define work then the formatting is not applied. -- Gadget850 talk 21:50, 15 October 2014 (UTC)
Multiple publishers in cite bookDoes anyone know how to go about adding more than one publisher to a book citation? I've got a scenario where a source has two publishers in the same country who jointly published the book - but I don't know how to put the second publisher into the cite template. Thanks! Miyagawa (talk) 16:54, 16 October 2014 (UTC)
Time to show date error messages?Currently, errors categorized in Category:CS1 errors: dates are hidden, pending fixing of as many as reasonably possible by a bot. The hiding decision was a result of this RFC. BattyBot task 25 has been processing Category:CS1 errors: dates periodically for about eight months now. When BattyBot is not running, date errors are added to the category at a rate of hundreds per week, maybe more. The category population was about 100,000 when BattyBot started running; it is about 60,000 now, and would be tens of thousands higher than 100,000 if not for the bot's work. I have been working with GoingBatty, the bot's operator, to add more patterns to the list of bot-fixable errors. You can see the latest round of proposed fixes on GoingBatty's talk page, and there are many previous rounds of this exercise in that page's archives. I believe that we have reached a point of diminishing returns with the bot, and that the bot has "run to sufficient completion" (quoting the RFC closure decision). I believe that the date error messages should be exposed by default to editors when the live version of the citation module is next updated. Thoughts? – Jonesey95 (talk) 02:30, 26 August 2014 (UTC)
Is there a decision here? If not, what about some of the other hidden error messages?
or, dare I even suggest it:
—Trappist the monk (talk) 12:50, 15 September 2014 (UTC)
OK, so what are we supposed to do with a date like 370 BC, then? That isn't an error, but one is reported. Chiswick Chap (talk) 19:48, 19 October 2014 (UTC)
Cite4Wiki Phoenix releasedCite4Wiki Phoenix is a Firefox extension intended to make it easier to generate citations for a page which you are currently viewing. It has a number of features which are configurable in order to generate citations formatted as desired for the article which you are working on. The point of view is that the tool should do a good job at generating values for parameters, but ultimately the user is in control of what actually goes in the citation.
A couple of example citations:
This follow-on to Cite4Wiki is a work in progress. This release should be considered to be an alpha or beta level release. I have been using Cite4Wiki Phoenix to make citations for some time now and found it to be quite useful. It would be helpful to have input from others on any and all aspects of the tool. This includes anything (e.g. bug reports, desired/missing features, GUI changes, page scraping issues, lack of CS1 compliance, etc.). You can add it to Firefox from Mozilla Add-ons. — Makyen (talk) 23:56, 19 October 2014 (UTC) Duplicate template parametersOn the October 23 update, templates with duplicate parameters will be tracked by a category defined in MediaWiki:duplicate-args-category.[6][7] -- Gadget850 talk 14:00, 20 October 2014 (UTC)
How is spring 1969 a date error if a publication dates an issue that way?I seem to be seeing dates indicated as "spring 1969" or "fall 1993" or "Nov./Dec. 1983" on the original publications showing an error when the date= field of the cite template inserts that value. That seems silly; we ought to be able to declare the exact date of a dated publication that is issued quarterly or bimonthly, for careful bibliographic work. You can find examples by page-searching for "(help)" in my user bibliography for updating articles. This brand-new error message isn't helpful to editors. -- WeijiBaikeBianji (talk, how I edit) 17:03, 21 October 2014 (UTC)
@WeijiBaikeBianji: our MOS does actually specify which date formats can be used for citation dates in an article. Under MOS:DATEUNIFY, it says:
and:
In other words, if a Wikipedia article is citing a newspaper article dated today in the APA style, "2014, October 23" would be the appropriate date format. However, if that same Wikipedia article is using CS1 in its references, then it needs to follow the "Acceptable date formats" table, and the templates used for CS1 style are enforcing those formats. @Wiki CRUK John and Peter coxhead: CS1 has its own style guide, which is Help:Citation Style 1. If editors want to use APA instead of CS1, and WP:CITESTYLE and MOS:DATEUNIFY both allow that option, then they need to consult the current edition of the Publication Manual of the American Psychological Association. However, the CS1 templates are their own style, so editors should not mix and match thinking it's acceptable. Imzadi 1979 → 15:17, 23 October 2014 (UTC)
Removing deprecated parametersI have removed parameters I am currently running an AWB script that looks for these parameters and am replacing what ones I find – there aren't many. —Trappist the monk (talk) 16:34, 25 October 2014 (UTC)
Chapters in edited collections not working rightHello, I have noticed that the chapters in edited collections are not working correctly. For example, the following template:
is producing the following displayed text:
The correct display (which used to be the case till recently) is:
It looks like there was an update to the template recently, which is breaking things. Specifically, the authors of the chapter and the editors of the collection are being combined. The chapter title and the book title are being combined. This is very confusing! Kautilya3 (talk) 14:57, 27 October 2014 (UTC)
cite journal and quarterly publicationsI took a quick search through the archives but I don't see mention of this. Some of the historical journals that I reference for railroad history are issued quarterly and their issue dates read like "First quarter YYYY" through "Fourth quarter YYYY". When I put that information into the date parameter, the page gets added to CS1 errors: dates even though this specification is valid according to WP:SEASON. Typing "the first quarter of YYYY" instead of "first quarter YYYY" seems nonsensical for a citation, so I've used the shorter of the two versions. So what I guess I'm asking is this: how should I be entering journal issue dates when the journal is issued quarterly and specifies the quarter number in its official issue date rather than the month name? Thanks! Slambo (Speak) 16:33, 13 October 2014 (UTC)
Or we could add "First Quarter XXXX", "1st Quarter XXXX", "Q1 XXXX", etc to the error checking as allowed options and make a note that just as we capitalize season names when used as dates of publication, we have a set of allowed formats for these quarterly publications. I'm neutral on capitalization on the word quarter. but I would recommend the Q1 type format as an option to go along with abbreviated month names in other dates. Imzadi 1979 → 01:23, 29 October 2014 (UTC)
Quarterly journal date formatI have a copy of the Second Quarter 1973 issue of Automobile Quarterly that I have used as a reference in articles on Triumph, Messerschmitt, and ALCO automobiles in general, and on the Alfa Romeo 8C 2900 and first generation of the Pontiac Grand Am in particular, as the magazine has articles on these cars. However, the date given for the magazine is "Second Quarter 1973", and this triggers an error response in the "date" entry in Template:Cite journal. Is there a solution to this, other than just giving a year and a volume and issue number instead of the date as stated in the magazine? Sincerely, SamBlob (talk) 14:22, 28 October 2014 (UTC)
ASINAt
Using We should add this to the documentation for Here are a couple of (not very good) example citations. The first uses
The second uses
The documentation for —Trappist the monk (talk) 21:01, 21 September 2014 (UTC)
Now that Category:CS1 maint: ASIN uses ISBN exists, I've written an AWB script that removes I've noticed that the value assigned to some
Anyone ever seen a functioning —Trappist the monk (talk) 23:08, 29 October 2014 (UTC)
Cite DVD notesI propose to update {{Cite DVD notes}} (366 transclusions) to {{Cite AV media notes}} (7666 transclusions). Thoughts? -- Gadget850 talk 11:48, 31 October 2014 (UTC)
Nowrap for accessdateI was just thinking a bit about this yesterday and then overnight, a ping from Editor GoingBatty caused me to do this experiment. In Module:Citation/CS1/sandbox I have added
I have seen ISBNs that wrapped inappropriately so those and perhaps other identifiers are candidates for nowrap. Is there anything else that should be prevented from wrapping in inappropriate places? —Trappist the monk (talk) 11:30, 18 October 2014 (UTC)
CS1 has a bunch of date-holding parameters: I have created a function Here are the other date formats:
Question 2: If the answer to Question 1 is affirmative, then where should browsers be allowed to break the other dates? It seems that for #1 and #2, the rule is the same as for date formats DD Mmmm YYYY and Mmmm DD, YYYY but what about the others? —Trappist the monk (talk) 14:50, 1 November 2014 (UTC)
Error messages across the entire projectPlease stop playing around with {{cite web}} immediately. For the first time in years, almost all preformatted dates and accessdates are suddenly "rejected" by this template with a nasty error message. Please put it back where it was. These are not "errors". Thanks, Poeticbent talk 18:09, 13 October 2014 (UTC)
— Preceding unsigned comment added by Poeticbent (talk • contribs) 18:53, 13 October 2014 (UTC) See the linked help page, which references MOS:BADDATEFORMAT
-- Gadget850 talk 19:03, 13 October 2014 (UTC)
Lua module and css presentationPretty much invisible to users, but I have changed Module:Citation/CS1/sandbox and Module:Citation/CS1/Configuration/sandbox so that This change required minor changes to
—Trappist the monk (talk) 17:03, 1 November 2014 (UTC)
.quoted-title:before {font-style: normal; content: '\22';}
.quoted-title{font-style: normal;}
.quoted-title:after {font-style: normal; content: '\22';}
Small capsIs writing the editor's name in large and small caps on purpose, or is something broken? I've never seen a citation anywhere, inside or outside Wikipedia, that used large and small caps. Jc3s5h (talk) 20:50, 1 November 2014 (UTC)
Why Are Publishers and Editors Wasting Time Formatting Citations?This blog post may be if interest. It's not Wikipedia specific, but a lot of what it says is applicable. Andy Mabbett (Pigsonthewing); Talk to Andy; Andy's edits 12:55, 6 November 2014 (UTC)
Citing multiple contributions to a workSuppose I need to cite a number of contributions to a single work. One way of doing this, widely accepted in style manuals, is to cite the contribution followed by "in" followed by a "short hand" for the work (itself possibly placed in a Bibliography section). Thus:
This used to work nicely using the cite/citation templates, but now throws a missing title error:
How is this supposed to be coded now, apart from repeating the full citation every time? Peter coxhead (talk) 08:19, 3 November 2014 (UTC)
Jc3s5h (talk) 13:53, 3 November 2014 (UTC) Struck 14:53 UT. References
Perhaps we need an alternative to {{harvnb}} designed to work within the CS1 framework better. For example, it could handle shortening these references to contributions in a larger work. Right now, CS1 encloses the date or year in parentheses after the author to separate it, and As for whether or not this is in use, I've used
If I understand my own thinking, one might place ===References=== References
=== Bibliography ===
—Trappist the monk (talk) 19:25, 4 November 2014 (UTC)
There is now —Trappist the monk (talk) 16:01, 6 November 2014 (UTC)
Ok. I didn't want to take credit for an idea that wasn't mine so I, correctly I think, credited you with the idea that got me to But I'm confused. Here are the three elements of the Rogers citation from Michigan State Trunkline Highway System:
The full citation remains as it is. Here are the other two parts reworked to use
This is a placeholder sentence that uses all four of the references above just as you see them there: Dillman handcrafted,[1] Dillman harvc,[2] Belknap handcrafted,[3] and Belknap harvc.[4] ===References=== References
===Bibliography===
The handcrafted and —Trappist the monk (talk) 01:06, 7 November 2014 (UTC)
Sorry, but this regrettable. Heretofore there has been a clear and universal distinction across all styles of citation between "full" citations (that include all bibliographic detail useful for identifying and finding a source in the world at large), and "short" citations (which need only enough information to identify a full citation within a source). This entirely novel "mid-length" citation form (besides being entirely unnecessary) goes well beyond what is useful in a short cite, but falls short of what is needful in a full citation. Adding it to the already confusing panoply of WP citation options will mainly blur the distinction and use of short and full citations, further confusing editors in their use. ~ J. Johnson (JJ) (talk) 23:07, 6 November 2014 (UTC)
Translated title error fails to display red error messageI came across an article with the following citation, which caused the article to be categorized in Category:Pages with citations using translated terms without the original but did not display a red error message.
Any ideas about why the error message did not display? I expect that the problem is related to the code changes that just went into effect, since the category has been empty for a long time and the article had not been edited recently. – Jonesey95 (talk) 02:05, 12 October 2014 (UTC)
One way of dealing with this is to ignore
—Trappist the monk (talk) 00:09, 10 November 2014 (UTC)
Alternative titleIs there an option to add an alternative title to the citation? Example in case:
is commonly known as The red book (as the article Nomenclature of Inorganic Chemistry lead says). IMO, it would be helpful to have that added as the 'popular' (in the science domain) & recognizable name. (btw, isn't it a pity we cannot link to both the article and the website). -DePiep (talk) 09:24, 12 November 2014 (UTC)
Migrating cite newsgroup to Module:Citation/CS1/sandbox (cont'd)In May 2014 I began the process of migrating
I have implemented a new parameter
These two examples are
To prepare for the next upgrade to the live CS1 module, I propose to:
—Trappist the monk (talk) 13:17, 11 November 2014 (UTC)
I have updated the live template from —Trappist the monk (talk) 13:49, 13 November 2014 (UTC) Strange interaction between {{Cite encyclopedia}} and |
Wikitext | {{cite encyclopedia
|
---|---|
Live | "御室相承記". Nihon Kokugo Daijiten (in Japanese) (online ed.). Shogakukan. Retrieved 2011-05-16. {{cite encyclopedia}} : Unknown parameter |trans_title= ignored (|trans-title= suggested) (help)
|
Sandbox | "御室相承記". Nihon Kokugo Daijiten (in Japanese) (online ed.). Shogakukan. Retrieved 2011-05-16. {{cite encyclopedia}} : Unknown parameter |trans_title= ignored (|trans-title= suggested) (help)
|
into this:
Wikitext | {{cite encyclopedia
|
---|---|
Live | 御室相承記. Nihon Kokugo Daijiten (in Japanese) (online ed.). Shogakukan. Retrieved 2011-05-16. {{cite encyclopedia}} : Unknown parameter |trans_title= ignored (|trans-title= suggested) (help)
|
Sandbox | 御室相承記. Nihon Kokugo Daijiten (in Japanese) (online ed.). Shogakukan. Retrieved 2011-05-16. {{cite encyclopedia}} : Unknown parameter |trans_title= ignored (|trans-title= suggested) (help)
|
Somehow, the script-title parameter caused the title of the encyclopedia to move to the beginning of the citation and to be linked to the URL, along with the article title, in one long string. That doesn't seem right.
Also, the sandbox version of the original citation links the URL to the encyclopedia, not to the article title, which also doesn't seem like it is what we want. It will break all of the examples on the {{Cite encyclopedia}} documentation, for starters. – Jonesey95 (talk) 03:49, 14 November 2014 (UTC)
- History in archives.
- I've fixed the url-linking-encyclopedia issue.
- Because of how we remap parameters for
{{cite encyclopedia}}
,|script-title=
breaks the citation because it doesn't have a matching|script-chapter=
yet. Because|script-title=
replaced|title=
, what is happening in the second example is:|encyclopedia=
is mapped to metaparameterTitle
Title
(ex-encyclopedia) is marked-up and then concatenated with|script-title=
and|trans-title=
''[[Nihon Kokugo Daijiten]]'' <bdi lang="ja">御室相承記</bdi> [''Omuro sōjōki'']
- the whole is then wrapped in external link markup and the wikilink in title error message added
[http://... ''[[Nihon Kokugo Daijiten]]'' <bdi lang="ja">御室相承記</bdi> [''Omuro sōjōki'']]
- I don't see a solution to this until we do either of a couple of things:
- rethink how we handle
{{cite encyclopedia}}
- implement
|script-chapter=
- rethink how we handle
- The second is likely the path of least resistance, though we probably ignore the first at our peril.
- In the mean time, I will modify Monkbot task 6 so that it ignores
{{cite encyclopedia}}
.
Date bug fix;
In the sandbox, have closed a small hole through which |date=2nd
could wriggle:
Wikitext | {{cite book
|
---|---|
Live | Title. 2nd. {{cite book}} : Check date values in: |date= (help)
|
Sandbox | Title. 2nd. {{cite book}} : Check date values in: |date= (help)
|
—Trappist the monk (talk) 19:13, 14 November 2014 (UTC)
Chapter and its associated parameters
I've been wondering about how CS1 handles |chapter=
and its associated parameters. There are some sixty possible combinations of |chapter=
, |chapterlink=
, |chapterurl=
, |trans-chapter=
, |title=
, and |url=
. These last two are included in this list because they can change how |chapter=
is rendered.
Some of the things that I've noticed are:
- Like
|chapterurl=
,|chapterlink=
should be applied to|trans-chapter=
even in the absence of|chapter=
{{cite book |chapterlink=Abraham Lincoln |trans-chapter=Trans Chapter}}
{{cite book |title=Title |chapterlink=Abraham Lincoln |trans-chapter=Trans Chapter}}
{{cite book |title=Title |chapterlink=Abraham Lincoln |trans-chapter=Trans Chapter |url=//example.com}}
{{cite book |chapterlink=Abraham Lincoln |trans-chapter=Trans Chapter |url=//example.com}}
- [Trans Chapter]. //example.com.
{{cite book}}
: Missing or empty|title=
(help); Unknown parameter|chapterlink=
ignored (help)
- [Trans Chapter]. //example.com.
|chapterurl=
and|chapterlink=
are mutually exclusive; currently|chapterlink=
has priority; is this correct? The template is citing a source so shouldn't a link to the source take precedence over a Wikipedia article about the source?{{cite book |chapter=Chapter |chapterlink=Abraham Lincoln |chapterurl=//example.org}}
{{cite book |title=Title |chapter=Chapter |chapterlink=Abraham Lincoln |chapterurl=//example.org }}
{{cite book |title=Title |chapter=Chapter |chapterlink=Abraham Lincoln |chapterurl=//example.org |url=//example.com}}
{{cite book |chapter=Chapter |chapterlink=Abraham Lincoln |chapterurl=//example.org |url=//example.com}}
- When a citation contains either or both of
|chapter=
and|trans-chapter=
, these parameters are linked by|url=
regardless of the presence of|title=
. Is this correct? Shouldn't|url=
be limited to|title=
just as|chapterurl=
is limited to|chapter=
and/or|trans-chapter=
?{{cite book |title=Title |chapter=Chapter |url=//example.com}}
- "Chapter". Title.
{{cite book |title=Title |trans-chapter=Trans Chapter |url=//example.com}}
{{cite book |chapter=Chapter |url=//example.com}}
- "Chapter". //example.com.
{{cite book}}
: Missing or empty|title=
(help)
- "Chapter". //example.com.
{{cite book |trans-chapter=Trans Chapter |url=//example.com}}
- [Trans Chapter]. //example.com.
{{cite book}}
: Missing or empty|title=
(help)
- [Trans Chapter]. //example.com.
—Trappist the monk (talk) 11:49, 17 October 2014 (UTC)
- I do not see item 1 as an error. Once the missing
|chapter=
is added, the citation will display correctly. I don't think we should bend over backwards to render citations that are missing key parameters.
- Item 2 is a new one to me. What is the purpose of
|chapterlink=
? It does not appear to be documented in any of the CS1 templates. As a reader, I expect a linked chapter title to point me to the source so that I can verify that the referenced information is in the source.|chapterlink=
seems unlikely to do that. I would lean toward eliminating it. Do we know how often that parameter is used?
- I think I brought up item 3 sometime in the past. Because
|chapterurl=
exists,|url=
should always go with|title=
. Given the complexity of CS1's handling of titles, chapters, entries, journal names, and similar parameters, I expect that fixing this without breaking anything will require very careful programming and testing. – Jonesey95 (talk) 00:37, 18 October 2014 (UTC)
- The point of #1 is to note that
|chapterlink=
doesn't act the same way that|chapterurl=
does. Simplified, with|chapter=
present: |chapterlink=
should link both|chapter=
and|trans-chapter=
like|chapterurl=
does in this version:
- The point of #1 is to note that
- When
|chapter=
is missing,|chapterurl=
still links|trans-chapter=
similar to #3.|chapterlink=
should do the same I think.
- When
- What is the purpose of
|chapterlink=
? I don't know; perhaps it is the|chapter=
equivalent of|titlelink=
. I don't recall ever having seen it in the wild so maybe it can/should get deprecated and removed.
- What is the purpose of
- By the time we get to the point of deciding to link
|chapter=
with|url=
all of the various aliases have been reduced to the metavariableChapter
. I don't think that it is as complex as you are making it out to be. Of course I say this fully recognizing that I have of late missed the obvious.
- By the time we get to the point of deciding to link
- A CirrusSearch using insource: syntax did not find any use of the search term
chapterlink
in any of the ways I could think of to format it. I was able to find four instances of the termchapter-link
andchapter link
none of which were|chapterlink=
or an alias. I propose to deprecate this parameter because it is unused.
- A CirrusSearch using insource: syntax did not find any use of the search term
- —Trappist the monk (talk) 22:29, 22 October 2014 (UTC)
- Support. It will be difficult to detect instances of this parameter's deprecation amid the population of deprecated parameter errors, unless we could persuade one of the local bots or an AWB user to search through the category's articles. I suppose deprecating the parameter is the logical first step, in any event. – Jonesey95 (talk) 03:37, 23 October 2014 (UTC)
- —Trappist the monk (talk) 22:29, 22 October 2014 (UTC)
Returning to this topic after some thought. In Module:Citation/CS1/sandbox is a new function format_chapter_title()
. It's purpose is to assemble the values provided by |chapter=
, |trans-chapter=
, and |chapter-url=
into a single metaparameter Chapter
. Unlike the current live module's chapter handling, this new function does not support |chapterlink=
and will not link a chapter title with |url=
.
Wikitext | {{cite book
|
---|---|
Live | Title. |
Sandbox | Title. |
Wikitext | {{cite book
|
---|---|
Live | Title. {{cite book}} : External link in (help); Unknown parameter |contributionurl= ignored (|contribution-url= suggested) (help)
|
Sandbox | Title. {{cite book}} : External link in (help); Unknown parameter |contributionurl= ignored (|contribution-url= suggested) (help)
|
Wikitext | {{cite book
|
---|---|
Live | [Translation]. Title. {{cite book}} : |trans-chapter= requires |chapter= or |script-chapter= (help)
|
Sandbox | [Translation]. Title. {{cite book}} : |trans-chapter= requires |chapter= or |script-chapter= (help)
|
Wikitext | {{cite book
|
---|---|
Live | [Translation]. Title. {{cite book}} : |trans-chapter= requires |chapter= or |script-chapter= (help); External link in (help); Unknown parameter |chapterurl= ignored (|chapter-url= suggested) (help)
|
Sandbox | [Translation]. Title. {{cite book}} : |trans-chapter= requires |chapter= or |script-chapter= (help); External link in (help); Unknown parameter |chapterurl= ignored (|chapter-url= suggested) (help)
|
Wikitext | {{cite book
|
---|---|
Live | "Chapter". Title. |
Sandbox | "Chapter". Title. |
Wikitext | {{cite book
|
---|---|
Live | "Chapter". Title. {{cite book}} : External link in (help); Unknown parameter |chapterurl= ignored (|chapter-url= suggested) (help)
|
Sandbox | "Chapter". Title. {{cite book}} : External link in (help); Unknown parameter |chapterurl= ignored (|chapter-url= suggested) (help)
|
Wikitext | {{cite book
|
---|---|
Live | "Chapter" [Translation]. Title. |
Sandbox | "Chapter" [Translation]. Title. |
Wikitext | {{cite book
|
---|---|
Live | "Chapter" [Translation]. Title. {{cite book}} : External link in (help); Unknown parameter |chapterurl= ignored (|chapter-url= suggested) (help)
|
Sandbox | "Chapter" [Translation]. Title. {{cite book}} : External link in (help); Unknown parameter |chapterurl= ignored (|chapter-url= suggested) (help)
|
Wikitext | {{cite book
|
---|---|
Live | "Chapter". Title (pdf). |
Sandbox | "Chapter". Title (pdf). |
|url= does not link |chapter=
|
I have also been wondering if we shouldn't create |chapter-format=
so that, when appropriate, the file type annotation is applied in the correct place as it clearly is not in this example:
Wikitext | {{cite book
|
---|---|
Live | "Chapter" (PDF). Title (pdf). |
Sandbox | "Chapter" (PDF). Title (pdf). |
—Trappist the monk (talk) 17:05, 9 November 2014 (UTC)
- I have added
|chapter-format=
so that citations like this work properly: - When
|chapter-format=
is set but|chapter-url=
is empty or missing: - The way the error message is rendered differs from the way the format-missing-url error is rendered:
- I think I prefer the way the chapter format error is rendered. The two should be the same. Opinions?
- —Trappist the monk (talk) 16:38, 12 November 2014 (UTC)
- It would be great if the red error message could appear after the closing parenthesis in the "format without url" error. – Jonesey95 (talk) 01:38, 13 November 2014 (UTC)
Ok, like this:
Wikitext | {{cite book
|
---|---|
Live | Title. {{cite book}} : |format= requires |url= (help)
|
Sandbox | Title. {{cite book}} : |format= requires |url= (help)
|
—Trappist the monk (talk) 15:19, 13 November 2014 (UTC)
- That looks better. Thanks. – Jonesey95 (talk) 15:52, 13 November 2014 (UTC)
- And what about
|archive-url=
? I have tweaked the archive-url code so that when|chapter-url=
and|archive-url=
are present but|url=
is missing or empty, then|archive-url=
swaps with|chapter-url=
. This is for legacy reasons because we haven't got (yet) a|chapter-archive-url=
parameter:{{cite book/new |title=Title |chapter=Chapter |chapter-url=//example.com |archive-url=//example.net |archive-date=2014-11-16}}
- →"Chapter". Title. Archived from the original on 2014-11-16.
- but when all three are present then
|archive-url=
exchanges with|url=
:{{cite book/new |title=Title |chapter=Chapter |chapter-url=//example.com |archive-url=//example.net |url=//example.org |archive-date=2014-11-16}}
- →"Chapter". Title. Archived from the original on 2014-11-16.
- At some point I think that we should consider creating
|chapter-archive-url=
and|chapter-archive-date=
so that the suite for chapter is complete.
- And what about
Date and year disagreement: should it generate a redundant parameter error?
Should a citation with a |date=
and |year=
that disagree generate some sort of error? Perhaps a redundant parameter error?
Wikitext | {{cite web
|
---|---|
Live | Author (24 Dec 1986). "Title". {{cite web}} : |author= has generic name (help); Check date values in: |year= / |date= mismatch (help); Invalid |ref=harv (help)
|
Sandbox | Author (24 Dec 1986). "Title". {{cite web}} : |author= has generic name (help); Check date values in: |year= / |date= mismatch (help); Invalid |ref=harv (help)
|
I believe that |year=
is no longer needed for Harvard-style references to work, so a filled-in |date=
and |year=
seem redundant to me, even if they do agree. What am I missing? – Jonesey95 (talk) 04:23, 14 November 2014 (UTC)
- No. If both
|date=
and|year=
exist, then the anchor is formed from|year=
. This allows for multiple sources where the author and year are the same. For example, if John Smith wrote three articles in 2014, then|year=
would respectively be 2014a, 2014b and 2014c. See Template:Sfn#More than one work in a year. -- Gadget850 talk 07:19, 14 November 2014 (UTC)
- No. If both
- I think that we should think about this. For those CS1 templates still using
{{citation/core}}
, having both|date=
and|year=
is still a requirement. This is because you can't use a year disambiguator in|date=
for those citations. The parser function ignores the disambiguator:{{#time:Y|12 January 2013a}}
→ 2013
- But, for those that use Module:Citation/CS1, this requirement went away when we introduced date validation. It is still supported. If both are present, the module will use the value from
|year=
for theCITEREF
anchor id.
- I don't think that having both
|year=
and|date=
is necessarily an error, even when the values don't match. It wouldn't be too difficult to add a maintenance category, Category:CS1 maint: Date and year or some such that would allow us to build a script or bot (depending on the magnitude of the 'problem') to fix those citations that use both.
- I do think that this should be done because
{{sfn}}
and the{{harv}}
family of templates render their output dates with the disambiguator. When CS1 citations that use the module have both|date=
and|year=
where|year=
is disambiguated, the rendered citation does not include the disambiguator. I think CS1 should always display disambiguators so that it is consistent with the short-form links.
- I did not know that. Need to check the documentation. -- Gadget850 talk 14:59, 14 November 2014 (UTC)
- Fitting action to words, I have tweaked Module:Citation/CS1/sandbox to add Category:CS1 maint: Date and year when a citation uses both
|date=
and|year=
.
- Fitting action to words, I have tweaked Module:Citation/CS1/sandbox to add Category:CS1 maint: Date and year when a citation uses both
Period appears at start of Cite Hansard
{{Cite Hansard}} (which is based on {{cite journal}}) is now showing a period at the start of the line for some instances, see its documentation page for examples. I'm sure it never used to be there, but I don't know when it changed - Evad37 [talk] 01:40, 16 November 2014 (UTC)
- I think the period is because of how
|last1=
is passed, but I need to check that.
- Another issue is that the date is being processed as the title and is being linked to the url:
{{cite hansard |jurisdiction=Commonwealth of Australia |house=House of Representatives |url=http://www.example.org |date=April 1, 1994 |column=1234 |speaker=Paul Keating |position=Prime Minister}}
- Paul Keating, Prime Minister (April 1, 1994). http://www.example.org. Parliamentary Debates (Hansard). Commonwealth of Australia: House of Representatives. col. 1234.
{{cite book}}
:|chapter-url=
missing title (help)
- Paul Keating, Prime Minister (April 1, 1994). http://www.example.org. Parliamentary Debates (Hansard). Commonwealth of Australia: House of Representatives. col. 1234.
- But that is in the template markup:
| title = {{{title|{{{date|}}}{{#if:{{{part|}}}|, part {{{part|}}}}}}}}
- I have no idea why. -- Gadget850 talk 01:59, 16 November 2014 (UTC)
- The first problem is in {{cite journal}} and occurs when you have
|others=
without an author:
- The first problem is in {{cite journal}} and occurs when you have
{{cite journal |others=Others |work=Work}}
- Work. Others.
{{cite journal}}
: Missing or empty|title=
(help)CS1 maint: others (link)
- Work. Others.
I think using cite journal is part of the problem. Based on citation guides for various styles from the University of Canberra [9][10][11][12][13], plus the last version of the template before it was migrated over to cite journal [14], it seems to me the CS1-style format should be something like
- Jurisdiction. Parliamentary Debates (Hansard). House. Date. At (Speaker, Position).
where At would be either the page(s) or column(s) reference, preceded by part (if applicable). (The usual optional extras like |url=
, |format=
, and |archiveurl=
would also be needed.) I don't think this is possible with any of the existing CS1 templates, at least not without misusing the parameters. - Evad37 [talk] 03:48, 16 November 2014 (UTC)
- We should discuss this on the {{Cite Hansard}} talk page. I think we need to hash out the elements of this type of citation. -- Gadget850 talk 05:26, 16 November 2014 (UTC)
- Discussion started at Template talk:Cite Hansard#Citation_format - Evad37 [talk] 06:55, 16 November 2014 (UTC)
- We should discuss this on the {{Cite Hansard}} talk page. I think we need to hash out the elements of this type of citation. -- Gadget850 talk 05:26, 16 November 2014 (UTC)
Part of this conversation should perhaps remain here. Semantically, |others=
implies that there are 'others': editors, authors, etc. CS1 citations that use |others=
without 'others' are malformed, are they not? Should we not be flagging this condition as an error?
Module:Citation/CS1 assumes that 'something' will precede the |others=
value in the rendered citation. This is why the dot-space appear in the Hansard citations. It is not strictly a {{cite journal}}
issue.
—Trappist the monk (talk) 13:51, 16 November 2014 (UTC)
What about a work title?
[Edit: I mean in {{cite web}}
. Didn’t realize the talk page redirects here.] If a webpage is a piece of a larger work, and that larger work does not define the website, does this template allow citing it?
Let’s say the website Example.com has a whole section titled The Fooiest Bars. We need to cite “Foobar #37: The Baz Biz.” How do we do that here? Do we just ignore the fact that it’s part of The Fooiest Bars? Or do we cite that title and ignore the individual entry’s title? —174.141.182.82 (talk) 16:35, 18 November 2014 (UTC)
- Just so I can wrap my little brain around what it is that you're asking, can you give me real life example, please?
- —Trappist the monk (talk) 17:22, 18 November 2014 (UTC)
- Here’s one. The site is IGN, and I’d say the title is “Rick Grimes - #26 Top Comic Book Heroes”, and the work title is “IGN’s Top 100 Comic Book Heroes”. —174.141.182.82 (talk) 18:58, 18 November 2014 (UTC)
- Perhaps like this:
{{cite web |department=[http://www.ign.com/top/comic-book-heroes IGN's Top 100 Comic Book Heroes] |website=[[IGN]] |title=#26 – Rick Grimes |url=http://www.ign.com/top/comic-book-heroes/26 |accessdate=2014-11-18}}
- →"#26 – Rick Grimes". IGN's Top 100 Comic Book Heroes. IGN. Retrieved 2014-11-18.
{{cite web}}
: External link in
(help)|department=
- —Trappist the monk (talk) 19:23, 18 November 2014 (UTC)
- Perhaps like this:
- I would treat this the same way that we treat subtitles.
|title=The Fooiest Bars: Foobar #37: The Baz Biz
. There are plenty of {{cite web}} templates in articles with titles like this. Web sites often use the pipe (vertical bar) character, which you need to substitute with {{!}} or the equivalent HTML entity in|title=
. – Jonesey95 (talk) 17:56, 18 November 2014 (UTC) - I concur with Jonesey95. And you don't have to use the same typographic style, you can replice a pipe or middot with a colon. -- Gadget850 talk 18:44, 18 November 2014 (UTC)
- I would treat this the same way that we treat subtitles.
Citation formatting RfC
Please see Talk:Aspromonte goat#RFC on citation formatting for an RfC about the scope of WP:CITEVAR and whether it can be used to prevent changes to underlying technical coding of reference citations, including correct XML, and changing problematic ref IDs. — SMcCandlish ☺ ☏ ¢ ≽ʌⱷ҅ᴥⱷʌ≼ 19:48, 21 November 2014 (UTC)
Additional archive URLs
I have been adding an additional archive URL to citations, to preserve references if an archive link goes dead (had this happen with an Internet Archive url, luckily it was a live website pre-emptively archived). The format I've been using is something like <ref>{{cite xxx|...}} {{webcite|...}}.</ref>
, which ends up as something like "Archived from the original on 29 August 2014. Retrieved 13 October 2014. Archived 23 October 2014 at WebCite." I'm wondering if there is, or could be, a better way to do this? - Evad37 [talk] 02:20, 22 November 2014 (UTC)
Circa
RE: "Supports c. only with a single year value (no ranges or day/month combinations)," it would be helpful if this could be adjusted. There are legitimate times when "c. 1999-2000", for example, is the most accurate thing one can say. --Tenebrae (talk) 22:37, 22 November 2014 (UTC)
- Real life example of where it's important to use such a date? Where neither c. 1999 or c. 2000 are suitable?
The quotation marks are part of the bibliographic entry for the work, not of the title of or link to the work
- This talk contrib applies to {{cite web}}, and (i presume) many other templates within the scope of this talk page.
The topic may well have previously been talked to completion somewhere in the consolidated talk archive, for all i know.
I was forced, by a violation of our nested-quotation-marks guideline, to notice that the quotations marks around some suitable works are
- supplied by the templates and
- inside the "click to display linked-content" zone of the external link.
That is, the link to the text of "The Night Before Christmas" underlines, and converts from black to blue, not just the four words and the blanks separating them, but also the quotation marks around those.
Now, it's not necessarily the case that anyone's semantic analysis has any bearing at all on what our style should be for the relationship between web pages and the links to them. But for me, that's the best guide, so here's my opinion:
- The name of the poem consists of four words separated by spaces, and does not include any punctuation. The quotation marks we place around that name, in a variety of situations, are not part of its name, but rather clarifying marks placed adjacent to the name in those situations, to for instance help distinguish short formats (e.g. essay, or typical-length "poem", or article, or track within an optical-disk sound recording, or speech within a play) from long ones (e.g. book, magazine, optical-disk embodying multiple sound recordings, or play). When a title appears on a physical realization of the work -- on the cover of a book, above the poem, on the CD, and AFAIK at the top of the Web page that presents or, often, comments on
onthe work (except where titles like- Review of "The Night Before Christmas"
- are chosen) -- neither quotes nor italics are used. And orally, very little if any distinction is made, that would correspond to quotes or italics.
(For names of works that deserve italics, of course, the format-cue is inseparable from the letters, and there's no choice to be made in the relationship between the format-cue and the spatial boundary of the click-to-display-linked-content zone.)
My suggestion is that that zone should extend only as far as the title itself does, and exclude the quotation marks, which are about the relationship between the title and the context (prose reference, bibliographic entry, etc.) within which the name is being used. It's a fine distinction, but IMO not an expensive one to shift to, and one that remedies a slight undercutting of semantic clarity.
--Jerzy•t 09:23 & 09:41, 23 November 2014 (UTC)
- The quote marks do differ, depending on whether it is a wikilink or a URL:
Markup | Renders as |
---|---|
{{cite journal |title=The Night Before Christmas |url=https://en.wikipedia.org/wiki/A_Visit_from_St._Nicholas}} |
"The Night Before Christmas". |
{{cite journal |title=[[The Night Before Christmas]]}} |
"The Night Before Christmas". |
- We are somewhat bound by the limitations imposed by Mediawiki. The wiki markup that Module:Citation/CS1 generates looks like this:
[https://en.wikipedia.org/wiki/A_Visit_from_St._Nicholas "The Night Before Christmas"]
- which gives this:
- If we move the enclosing quote marks like this:
"[https://en.wikipedia.org/wiki/A_Visit_from_St._Nicholas The Night Before Christmas]"
- we get this:
- As you can see, the external link icon gets in the way. I don't know of a simple way to avoid that. I think that it is important to keep the icon. We could do this:
"[https://en.wikipedia.org/wiki/A_Visit_from_St._Nicholas The Night Before Christmas"]
- we get this:
- which is halfway to what you want.
- We are somewhat bound by the limitations imposed by Mediawiki. The wiki markup that Module:Citation/CS1 generates looks like this:
Check date values in date
It might have been months ago, or perhaps even a couple of years ago, when cite web and related templates started displaying date format errors like this:
- Check date values in: date
But I am just now getting around to questioning why this check is necessary.
- Could someone point to a talk page somewhere where the case was made for introducing that error message? I know about WP:DATESNO but there must be something more than that.
I imagine there's some benefit to it, so I have a follow-on question. Why does this
- {{cite news|url=http://en.wikipedia.org/wiki/Wikipedia:Wikipedia_Signpost/Archives/2014-11-12| title= Wikipedia Signpost| publisher= Wikimedia Foundation|date= September 03, 2014 | agency= Associated Press |accessdate= 2014-11-23}}
product an error:
- "Wikipedia Signpost". Wikimedia Foundation. Associated Press. September 03, 2014. Retrieved 2014-11-23.
{{cite news}}
: Check date values in:|date=
(help)
Surely Postel's robustness principle applies:
- "implementations should follow a general principle of robustness: be conservative in what you do, be liberal in what you accept"
There is no obvious reason that the leading zero in "September 03" should be treated as an error.
72.244.200.236 (talk) 20:30, 23 November 2014 (UTC)
- Since you read WP:DATESNO then you know that we don't use leading zeroes in this date format. Our style guidelines are based on current major published guidelines, which allows a leading zero here? -- Gadget850 talk 20:49, 23 November 2014 (UTC)
- Postel's principle does not apply because he was writing about input to a computer program, which need not be aesthetically pleasing or readily comprehended by people. Although values of template parameters are used by computer programs, they also are read by editors, so should conform to norms for human-readable text. Jc3s5h (talk) 21:01, 23 November 2014 (UTC)
- Perhaps it started here. To answer that, we implemented date validation in Module:Citation/CS1 and later in Module:Citation/CS1/Date validation. The beginning of that discussion is here. Rather than invent a CS1-specific standard for date formats, we adopted WP:DATESNO and try to adhere to it because that is a standard that the community have agreed amongst themselves. At present, WP:DATESNO allows leading zero dates only in year initial numeric format. If you believe that leading zeros should be acceptable in other date formats, the proper venue for that discussion is WT:MOSDATE.
- Thanks to all for the replies. Trappist points to places I can read more about why we are where we are. It sounds like the consensus is its better to prioritize style over an unambiguously-formatted date. When I am filling in the parameters of cite web/cite news I am cutting the date from a web page and pasting into the article. Marking such a date as an error makes adding ref details a bit more tedious than it needs to be. In a bizarre way, rejecting dates on style guidelines can encourage editors to not bother cut/pasting _any_ date at all. By following Postel's principle both editors and readers would benefit. 72.244.200.236 (talk) 21:33, 23 November 2014 (UTC)
- P.S. Maybe the ideal solution is to allow editors to supply ref dates in any unambiguous format they want, but rendering the article for readers based on settings specified by templates like {{Use dmy dates}} and WP:SKIN 72.244.200.236 (talk) 21:54, 23 November 2014 (UTC)
- Thanks to all for the replies. Trappist points to places I can read more about why we are where we are. It sounds like the consensus is its better to prioritize style over an unambiguously-formatted date. When I am filling in the parameters of cite web/cite news I am cutting the date from a web page and pasting into the article. Marking such a date as an error makes adding ref details a bit more tedious than it needs to be. In a bizarre way, rejecting dates on style guidelines can encourage editors to not bother cut/pasting _any_ date at all. By following Postel's principle both editors and readers would benefit. 72.244.200.236 (talk) 21:33, 23 November 2014 (UTC)
- Lets consider two other guidelines:
- MOS:DATEUNIFY: "Publication dates in an article's citations should all use the same format."
- WP:CITEVAR: "Editors should not attempt to change an article's established citation style merely on the grounds of personal preference, to make it match other articles, or without first seeking consensus for the change."
- Thus, when you add a new reference you need to follow the established style and use it for all the publication dates. You also need to consider other style issues such as sentence case v. title case for titles.
- The issue of automatic date formatting has a long history of discussion that resulted in the existing methods being removed as useless. There is currently no way to read {{Use dmy dates}} and apply it on the fly. {{Use dmy dates}} is for bots and follow on editors. -- Gadget850 talk 22:04, 23 November 2014 (UTC)
- Lets consider two other guidelines:
Updated Articles
For updated articles, for the date, do you put the date it was published or the date that the latest update happened? — Preceding unsigned comment added by Copulative (talk • contribs) 04:21, 26 November 2014 UTC
- Put the date of the version of the article that you are citing in the
|date=
parameter in the citation. If you want to show that the article was originally published on an earlier date, you can use|origyear=
. – Jonesey95 (talk) 04:26, 26 November 2014 (UTC)
- Is there a way to put the original full date instead of just the year? — Preceding unsigned comment added by 166.137.242.122 (talk • contribs) 09:46, 26 November 2014 (UTC)
- Yes. Put the original full date in
|origyear=
. It allows free-form text. See Template:Cite_web#Date for an explanation. – Jonesey95 (talk) 17:50, 26 November 2014 (UTC)
- Yes. Put the original full date in
- Is there a way to put the original full date instead of just the year? — Preceding unsigned comment added by 166.137.242.122 (talk • contribs) 09:46, 26 November 2014 (UTC)
Time to retire Category:Pages using citations with old-style implicit et al.?
Category:Pages using citations with old-style implicit et al. is down to about 160 articles, from well over 10,000 last year. I believe that once the remaining articles are fixed, there is no further need for this error category or for the error message that goes along with it.
The category, as I understand it, was intended as a maintenance category to hold citations that had ambiguous uses of exactly nine authors. Once the category is empty, all future citations with exactly nine authors should display all nine of the authors unless editors use |display-authors=
.
Can the citation module sandbox be modified before the next code sync to reflect these changes? I will clear out the remaining 160 articles before the sync happens. – Jonesey95 (talk) 02:18, 16 November 2014 (UTC)
- Perhaps convert to a maintenance category instead? If we do that, the module can fill it with pages that have citations using
|display-authors=
where the value is the same as the number of|author=
parameters. A bot or script can then troll that category and delete extraneous|display-authors=
.
- I disagree "et al" is useful and should be placed in the coauthors parameter. -- PBS (talk) 15:31, 16 November 2014 (UTC)
- A new maint category would be fine with me. It could look for citations where the value of
|display-authors=
is greater than or equal to the number of displayed authors. A citation with nine authors and|display-authors=29
should be placed in the maint category along with an identical citation with|display-authors=9
.
- A new maint category would be fine with me. It could look for citations where the value of
- I disagree "et al" is useful and should be placed in the coauthors parameter. -- PBS (talk) 15:31, 16 November 2014 (UTC)
- PBS, can you please explain what you mean, preferably with example citations? I can't make sense of your comment as written. – Jonesey95 (talk) 16:03, 16 November 2014 (UTC)
- If coauthors is used then the Harvard templates link to the long citation,[1]
{{sfn|Smith|2001|p=2}}
they do not ifdisplay_author
is used.[2][3]{{sfn|Beta|2002|p=3}}{{sfn|Beta|Gamma|Delta|2002|p=4}}
Addingdisplay_author
to the {{harv}} templates is one solution but every change like this makes it more and more complicated and more of a hurdle for beginners (even for beginners with a programming background which will be a minority) to use the citation templates. As you will know if you lurk around WT:CITE there is a lot of resistance to using citation templates and making the interface more complicated does not help encourage their take up. As you will see there is a "et al" default for the harv of 4 last names no matter how many are in the list.[4]{{sfn|Gamma |Delta |Epsilon |Zeta |2003 |p=5}}
it would seem sensible to me to defaultdisplay_author
to four so that the short and long citations defaulted to the same number.
- If coauthors is used then the Harvard templates link to the long citation,[1]
- PBS, can you please explain what you mean, preferably with example citations? I can't make sense of your comment as written. – Jonesey95 (talk) 16:03, 16 November 2014 (UTC)
- ^ Alpha 2001, p. 2.
- ^ Beta 2002, p. 3.
- ^ Beta, Gamma & Delta 2002, p. 4.
- ^ Gamma et al. 2003, p. 5.
{{reflist}}
* Alpha, Fred (2001), A title{{citation}}
: Unknown parameter|coauthors=
ignored (|author=
suggested) (help) * Beta, Fred; et al. (2002), B title * Gamma, Fred; Delta; Epsilon; Zeta; Eta (2003), C title *{{citation |first=Fred |last=Smith |year=2001 |coauthors=et al |title=A title}}
*{{citation |first=Fred |last=Beta |last2=Gamma |last3=Delta |last5=Eta |display-authors=1 |year=2002 |title=B title}}
*{{citation |first=Fred |last1=Gamma |last2=Delta |last3=Epsilon |last4=Zeta |last5=Eta |year=2003 |title=C title}}
- Just for clarity, the harv link to
{{citation |first=Fred |last=Beta |last2=Gamma |last3=Delta |display-authors=1 |year=2002 |title=B title}}
is not broken because|display-authors=1
. It is broken because{{sfn|Beta|2002|p=3}}
is incomplete. Figuring out how to better do harv referencing is a topic for another discussion. This discussion is about what to do with the error category and message.
- Just for clarity, the harv link to
- @Jonesey95, you're right: categorize when number of authors is less than or equal to
|display-authors=<value>
.
- @Jonesey95, you're right: categorize when number of authors is less than or equal to
Wikitext | {{cite book
|
---|---|
Live | Author1; Author2; Author3; Author4; Author5; Author6; Author7; Author8; Author9. Title. {{cite book}} : |author1= has generic name (help)CS1 maint: numeric names: authors list (link)
|
Sandbox | Author1; Author2; Author3; Author4; Author5; Author6; Author7; Author8; Author9. Title. {{cite book}} : |author1= has generic name (help)CS1 maint: numeric names: authors list (link)
|
Wikitext | {{cite book
|
---|---|
Live | Author1; Author2; Author3; Author4; Author5; Author6; Author7; Author8; et al. Title. {{cite book}} : |author1= has generic name (help)CS1 maint: numeric names: authors list (link)
|
Sandbox | Author1; Author2; Author3; Author4; Author5; Author6; Author7; Author8; et al. Title. {{cite book}} : |author1= has generic name (help)CS1 maint: numeric names: authors list (link)
|
Wikitext | {{cite book
|
---|---|
Live | Author1; Author2; Author3; Author4; Author5; Author6; Author7; Author8; Author9. Title. {{cite book}} : |author1= has generic name (help); Invalid |display-authors=9 (help)CS1 maint: numeric names: authors list (link)
|
Sandbox | Author1; Author2; Author3; Author4; Author5; Author6; Author7; Author8; Author9. Title. {{cite book}} : |author1= has generic name (help); Invalid |display-authors=9 (help)CS1 maint: numeric names: authors list (link)
|
Wikitext | {{cite book
|
---|---|
Live | Author1; Author2; Author3; Author4; Author5; Author6; Author7; Author8; Author9. Title. {{cite book}} : |author1= has generic name (help); Invalid |display-authors=10 (help)CS1 maint: numeric names: authors list (link)
|
Sandbox | Author1; Author2; Author3; Author4; Author5; Author6; Author7; Author8; Author9. Title. {{cite book}} : |author1= has generic name (help); Invalid |display-authors=10 (help)CS1 maint: numeric names: authors list (link)
|
No more error messages. Categorize in Category:CS1 maint: display-authors.
—Trappist the monk (talk) 19:37, 16 November 2014 (UTC)
- As of my time stamp, Category:Pages using citations with old-style implicit et al. is empty except for a few archived pages that do not need to be modified. The category is ready to go away after the module updates are applied this weekend. A million thanks to Citation Bot for doing the lion's share of work in cleaning up this category. It always has a few little bugs, but it does vast amounts of tedious work that improves the encyclopedia. – Jonesey95 (talk) 05:42, 27 November 2014 (UTC)
Insering wikilinks from works
Many academic journals have WP articles about them. Can we enforce some minimal wiki-linking to them (as per Help:Citation_Style_1#Work_and_publisher): "If the work is notable and has an article in Wikipedia, it should be wiki-linked at first appearance in citations in the article." If desirable, could it be automated, with a bot? Thanks. Fgnievinski (talk) 19:24, 28 November 2014 (UTC)
- What is Insering?
- Whether to link or not to link the value in
|journal=
is a decision left entirely to the editors of the article where the citation template is used. CS1 does not require editors to link any parameters to articles within Wikipedia.
- Agreed; it absolutely should not be automated. (I'd like to see where the consensus was developed for wiki-linking journal titles in citations. "It should be wiki-linked at first appearance in citations" doesn't make sense; another reference using the same journal may later be added earlier in the article or existing references using the same journal may later be re-ordered.) Peter coxhead (talk) 20:18, 28 November 2014 (UTC)
- @Fgnievinski: what you are describing is how I link things now. However, as Peter coxhead notes, additional editing can reorder the footnotes, shuffling a new citation to be the first one that should have the link. (By the same token, additional editing can shuffle the text in the body of the article, changing what prose should have the wikilink.) That's why I don't worry about it until its an article that's substantially complete content-wise. Rather than have a bot handle the task, a user script that could shift the links for authors, works, and publishers to their first footnote appearance would be nice. There's a similar script that highlights duplicate wikilinks in body text. Imzadi 1979 → 21:39, 29 November 2014 (UTC)
- Agreed; it absolutely should not be automated. (I'd like to see where the consensus was developed for wiki-linking journal titles in citations. "It should be wiki-linked at first appearance in citations" doesn't make sense; another reference using the same journal may later be added earlier in the article or existing references using the same journal may later be re-ordered.) Peter coxhead (talk) 20:18, 28 November 2014 (UTC)
"format= requires url=" error checking needs adjustment
After the latest changes to the targeting of the |url=
parameter, it looks like the error-checking for the "format= requires url=" error may need some adjustment. Here's an example from Template:Citation/doc:
Wikitext | {{citation
|
---|---|
Live | Sullivan, D.B. (2001), "Time and frequency measurement at NIST: The first 100 years" (PDF), 2001 IEEE Int'l Frequency Control Symp., National Institute of Standards and Technology {{citation}} : |format= requires |url= (help)
|
Sandbox | Sullivan, D.B. (2001), "Time and frequency measurement at NIST: The first 100 years" (PDF), 2001 IEEE Int'l Frequency Control Symp., National Institute of Standards and Technology {{citation}} : |format= requires |url= (help)
|
Whatever the "access-date= without url=" is doing seems to be working fine though. This is the above citation with |access-date=
added.
Wikitext | {{citation
|
---|---|
Live | Sullivan, D.B. (2001), "Time and frequency measurement at NIST: The first 100 years" (PDF), 2001 IEEE Int'l Frequency Control Symp., National Institute of Standards and Technology, retrieved 4 November 2014 {{citation}} : |format= requires |url= (help)
|
Sandbox | Sullivan, D.B. (2001), "Time and frequency measurement at NIST: The first 100 years" (PDF), 2001 IEEE Int'l Frequency Control Symp., National Institute of Standards and Technology, retrieved 4 November 2014 {{citation}} : |format= requires |url= (help)
|
I hope it's an easy fix. – Jonesey95 (talk) 19:02, 29 November 2014 (UTC)
- It's not broken. There is no
|url=
so the error message is correct. Changing the citation to use|chapter-format=PDF
removes the error message and places the annotation in the correct place:- Sullivan, D.B. (2001), "Time and frequency measurement at NIST: The first 100 years" (PDF), 2001 IEEE Int'l Frequency Control Symp., National Institute of Standards and Technology, retrieved 4 November 2014
- What is not quite right is the error message help text which needs a bit of a massage and we need to document
|chapter-format=
.
- Also all the aliases of "chapter" need to work with "...-format". In the specific example from Template:Citation/doc it would be very odd to have to use
|chapter-format=
with|contribution=
, but|contribution-format=
doesn't work:- Sullivan, D.B. (2001), "Time and frequency measurement at NIST: The first 100 years" (PDF), 2001 IEEE Int'l Frequency Control Symp., National Institute of Standards and Technology, retrieved 4 November 2014
- I commented out
|format=PDF
from the Template:Citation/doc example for the present until|contribution-format=PDF
can be used. Peter coxhead (talk) 20:22, 29 November 2014 (UTC)- @Trappist the monk: I see that you removed my commenting out and put in
|chapter-format=PDF
– that is so, so ugly with|contribution=
and|contribution-url=
! Peter coxhead (talk) 20:54, 29 November 2014 (UTC)
- @Trappist the monk: I see that you removed my commenting out and put in
- Also all the aliases of "chapter" need to work with "...-format". In the specific example from Template:Citation/doc it would be very odd to have to use
New ASIN-checking code marks 10-digit ISBN ending in X as an error
The new ASIN-checking code appears to mark a 10-digit ASIN ending in "X" as an error instead of marking it as an ISBN. I have adjusted the sandbox code to allow ASINs to have 10-digit ISBNs ending in X.
Wikitext | {{cite book
|
---|---|
Live | Author. Title. ASIN 630580916X. {{cite book}} : |author= has generic name (help); Unknown parameter |sandbox= ignored (help)
|
Sandbox | Author. Title. ASIN 630580916X. {{cite book}} : |author= has generic name (help); Unknown parameter |sandbox= ignored (help)
|
ASINs like this that are valid 10-digit ISBNs will be added to Category:CS1 maint: ASIN uses ISBN. Feel free to correct or improve upon my change to the sandbox if I did something wrong. – Jonesey95 (talk) 18:02, 30 November 2014 (UTC)
- @Jonesey95: Should there be a visible error, to make it easier for editors to know which reference needs to be fixed? Thanks! GoingBatty (talk) 18:16, 30 November 2014 (UTC)
- We have had complaints about the red error messages, especially when they highlight a condition that may or may not be an actual error. In this case, the ASIN/ISBN is fully functional, but it should be cleaned up to point to a neutral source instead of Amazon. I imagine that a bot or human running a script could take care of it pretty easily. That is the idea behind the maintenance categories.
- I understand people's concerns about filling our pages with red error messages, especially for issues that are very minor. I am fully supportive of the error messages for actual errors like the ones that are currently displayed. – Jonesey95 (talk) 18:23, 30 November 2014 (UTC)
- I have an AWB script that I periodically use to sweep Category:CS1 maint: ASIN uses ISBN which converts
|asin=
to|isbn=
. - —Trappist the monk (talk) 18:33, 30 November 2014 (UTC)
- I'm pretty sure that I warned against marking X as an error... ah yes, right here at 07:05, 25 September 2014. --Redrose64 (talk) 19:07, 30 November 2014 (UTC)
- I have an AWB script that I periodically use to sweep Category:CS1 maint: ASIN uses ISBN which converts
Update to the live CS1 module weekend of 11–12 October 2014
Over the 11–12 October 2014 weekend I propose to update:
- Module:Citation/CS1 to match Module:Citation/CS1/sandbox (diff)
- Module:Citation/CS1/Configuration to match Module:Citation/CS1/Configuration/sandbox (diff)
- Module:Citation/CS1/Whitelist to match Module:Citation/CS1/Whitelist/sandbox (diff)
- Module:Citation/CS1/Date validation to match Module:Citation/CS1/Date validation/sandbox (diff)
This update changes these things:
in Module:Citation/CS1:
- Bug fix in
get_coins_pages()
; (discussion) - Bug fix in
extractnames()
; (discussion) - Change
lccn()
to require lower case alpha characters; (discussion) - Change
openlibrary()
to emit error message when OL identifier contains leading alpha characters; (discussion) - Change
|language=
support (discussion):- get ISO639-1 language name from Wikimedia;
- Add support for right-to-left languages using new parameter
|script-title=
; (discussion) and (discussion) - Categorize pages when
|language=language name
;
- Change
listpeople()
so that we don't link to the current page through|authorlinkn=
or|editorlinkn=
; (discussion) - Add code to strip wikimarkup (italics and bold) from titles and chapters when adding those to COinS metadata; (discussion)
- Add Australia, Brazil, Mexico to list of countries supported by
|asn-tld=
; (discussion) - Undo peculiar title and chapter format swap when
|work=
or any of its aliases set; (discussion) - Categories:
- Add support for maintenance categories; discussion
- Change
amazon()
to add maintenance category when|asin=
value is an isbn; discussion - Add support for properties categories; (discussion)
in Module:Citation/CS1/Configuration:
- Updated JFM and ZBL prefixes; (discussion)
- deleted ISO639-1 table; (discussion)
- Changed error categories for doi and ol errors (discussion)
- Make date errors visible; (discussion)
in Module:Citation/CS1/Whitelist:
- add new parameter
|script-title=
(discussion) and (discussion)
in Module:Citation/CS1/Date validation:
- Add support for valid date formats Summer yyyy–yy and Summer yyyy–yyyy; (discussion)
There is enough here that there is a deal of documentaion to be done. I think that I'll begin that and not bother to hide it prior to the live update – it's just easier that way.
—Trappist the monk (talk) 16:18, 30 September 2014 (UTC)
- I think this update will also re-enable the missing author/editor errors. And wasn't there something about creating an error when
|chapter=
exists when there is no|title=
or|work=
? (See "I have removed the tests for" above.) – Jonesey95 (talk) 16:52, 30 September 2014 (UTC)
- Missing author/editor is the
extractnames()
bug (#2);|chapter=
is Undo peculiar title ... (#9).
- Missing author/editor is the
Done.
—Trappist the monk (talk) 14:20, 11 October 2014 (UTC)
script-title
Could the value of |script-title=
not be underlined? Kanguole 17:51, 30 September 2014 (UTC)
- Agree. The proper name mark is a Chinese convention that would not apply to other writing systems such as Hebrew or Arabic. -- Gadget850 talk 18:12, 30 September 2014 (UTC)
- and an obsolete Chinese convention at that. But these are conventions for Chinese running text, which isn't the situation here. Kanguole 20:26, 30 September 2014 (UTC)
- Looks like that was removed.
- and an obsolete Chinese convention at that. But these are conventions for Chinese running text, which isn't the situation here. Kanguole 20:26, 30 September 2014 (UTC)
{{cite book/new |title=ABC |script-title=ar:العربية}}
- ABC العربية.
Documentation:
script-title: Title in the original writing system where it is not appropriate to italicize (e.g. Arabic, Chinese, Hebrew, Japanese). Displays after title in upright font and is isolated from the surrounding text-direction settings so that right-to-left scripts render properly. The language may be set by prefixing the value with the ISO 639-1 two-character language code followed by a colon. Unrecognized codes are ignored and will display in the rendered citation. Example: |script-title=ar:العربية
.
-- Gadget850 talk 18:05, 1 October 2014 (UTC)
- I'd suggest using Chinese or Japanese as the example language, as those are the two for which CMOS recommends also including the original form. Kanguole 20:50, 1 October 2014 (UTC)
- Sample? -- Gadget850 talk 12:56, 2 October 2014 (UTC)
- Wang, Li (1985). Hànyǔ Yǔyīn Shǐ 汉语语音史 [History of Chinese Phonetics] (in Chinese). Beijing: China Social Sciences Press. ISBN 978-7-100-05390-7.
{{cite book}}
: Invalid|script-title=
: missing prefix (help) - Morohashi, Tetsuji (1984–1986). Dai Kan-Wa Jiten 大漢和辞典 [Comprehensive Chinese–Japanese Dictionary]. Tokyo: Taishukan.
{{cite book}}
: Invalid|script-title=
: missing prefix (help)
- Wang, Li (1985). Hànyǔ Yǔyīn Shǐ 汉语语音史 [History of Chinese Phonetics] (in Chinese). Beijing: China Social Sciences Press. ISBN 978-7-100-05390-7.
- Kanguole 00:45, 19 October 2014 (UTC)
- Sample? -- Gadget850 talk 12:56, 2 October 2014 (UTC)
- Arabic is a good example because it is both non-Latin and rtl, and because support for rtl is a substantial reason for the existence of
|script-title=
.
- Arabic is a good example because it is both non-Latin and rtl, and because support for rtl is a substantial reason for the existence of
- Arabic is an unfortunate example, because it's one of the languages that CMOS recommends be transliterated, whereas Chinese and Japanese are the languages where it recommends using the original form in addition to romanization. Kanguole 00:45, 19 October 2014 (UTC)
Error checking
Unrecognized codes are not ignored:
{{cite book/new |title=ABC |script-title=zz:العربية}}
More than two characters or other than alpha characters do show the language code. -- Gadget850 talk 14:25, 2 October 2014 (UTC)
- Thanks for that. Fixed.
Related discussions
See Template talk:Lang#Rtl-lang in citation titles. -- Gadget850 talk 12:49, 3 October 2014 (UTC)
Titles of journal articles
Titles of journal articles used to be in roman, wrapped in double quotes, as in {{cite journal}}
:
- {{cite journal | author = Author | year = 2000 | title = Article title | journal = Journal | ref = none }}
- Author (2000). "Article title". Journal.
{{cite journal}}
:|author=
has generic name (help)
but now in {{citation}}
they're in italics:
- {{citation | author = Author | year = 2000 | title = Article title | journal = Journal | ref = none }}
- Author (2000), "Article title", Journal
{{citation}}
:|author=
has generic name (help)
However {{cite journal}}
still does it the old way. Kanguole 00:56, 19 October 2014 (UTC)
- It does seem to have changed, yes. This might be the same issue as Template talk:Citation#Formatting of journal article_title. --Redrose64 (talk) 08:39, 19 October 2014 (UTC)
- Oversight on my part when I undid the peculiar title formatting. Fixed in the sandbox so that now if the using
{{citation}}
with one of the|work=
aliases then|title=
is upright and quoted. - —Trappist the monk (talk) 10:07, 19 October 2014 (UTC)
- Oversight on my part when I undid the peculiar title formatting. Fixed in the sandbox so that now if the using
- @Trappist the monk:
{{citation}}
is still wrong:- {{citation |last1=Jones |first1=P. |date=2014 |title=Some interesting paper |journal=Journal of Interesting Papers }} → Jones, P. (2014), "Some interesting paper", Journal of Interesting Papers
- whereas it did produce and should produce: Jones, P. (2014), "Some interesting paper", Journal of Interesting Papers. Peter coxhead (talk) 11:40, 2 November 2014 (UTC)
- @Trappist the monk:
- As I wrote before, it is fixed in the sandbox:
- Jones, P. (2014), "Some interesting paper", Journal of Interesting Papers
- The live module will get the fix at the next update.
- As I wrote before, it is fixed in the sandbox:
New error in cite conference: "chapter= ignored"
I'm seeing a lot of "chapter= ignored" errors (and non-formatting of the conference paper title) in {{cite conference}} templates with a conference paper title in |title=
and the title of the overall conference proceedings in |booktitle=
. There are five of these in isolation lemma, for instance. An example:
Wikitext | {{cite conference
|
---|---|
Live | Arvind, V.; Mukhopadhyay, Partha (2008). "Derandomizing the Isolation Lemma and Lower Bounds for Circuit Size". Proceedings of the 11th international workshop, APPROX 2008, and 12th international workshop, RANDOM 2008 on Approximation, Randomization and Combinatorial Optimization: Algorithms and Techniques. Boston, MA, USA: Springer-Verlag. pp. 276–289. ISBN 978-3-540-85362-6. Retrieved 2010-05-10. {{cite conference}} : Invalid |ref=harv (help); Unknown parameter |booktitle= ignored (|book-title= suggested) (help)
|
Sandbox | Arvind, V.; Mukhopadhyay, Partha (2008). "Derandomizing the Isolation Lemma and Lower Bounds for Circuit Size". Proceedings of the 11th international workshop, APPROX 2008, and 12th international workshop, RANDOM 2008 on Approximation, Randomization and Combinatorial Optimization: Algorithms and Techniques. Boston, MA, USA: Springer-Verlag. pp. 276–289. ISBN 978-3-540-85362-6. Retrieved 2010-05-10. {{cite conference}} : Invalid |ref=harv (help); Unknown parameter |booktitle= ignored (|book-title= suggested) (help)
|
Is this a new bug? And if so can we please get it fixed? —David Eppstein (talk) 20:56, 30 November 2014 (UTC)
- It's a new error message, not necessarily a new bug.
{{cite conference}}
is problematic. Its name suggests that a 'conference' is being cited (what does that mean, exactly?) when it appears that most often, the editor is citing the published proceedings of that conference. A conference and its proceedings are, I think two difference beasts. I think that{{cite conference}}
should only be used on those rare occasions when an editor has actually attended the conference, but then, such use is questionable because of verification issues. For these reasons I have suggested elsewhere, though not formally, that{{cite conference}}
should be abandoned.
- It appears that all of the citations at isolation lemma that display the chapter-ignored error message are actually citing the proceedings of a conference, not the conference itself. Because this example citation appears to be citing the proceedings of the conference, it (and the others at isolation lemma) might be rewritten to use
{{cite book}}
{{cite encyclopedia}}
:{{cite encyclopedia |last1=Arvind |first1=V. |last2=Mukhopadhyay |first2=Partha |chapter=Derandomizing the Isolation Lemma and Lower Bounds for Circuit Size |title=Proceedings of the 11th international workshop, APPROX 2008, and 12th international workshop, RANDOM 2008 on Approximation, Randomization and Combinatorial Optimization: Algorithms and Techniques |date=2008 |url=http://portal.acm.org/citation.cfm?id=1429791.1429816 |location=Berlin |publisher=Springer-Verlag |isbn=978-3-540-85362-6 |doi=10.1007/978-3-540-85363-3_23 |pages=276–289 |ref=harv}}
- Arvind, V.; Mukhopadhyay, Partha (2008). "Derandomizing the Isolation Lemma and Lower Bounds for Circuit Size". Proceedings of the 11th international workshop, APPROX 2008, and 12th international workshop, RANDOM 2008 on Approximation, Randomization and Combinatorial Optimization: Algorithms and Techniques. Berlin: Springer-Verlag. pp. 276–289. doi:10.1007/978-3-540-85363-3_23. ISBN 978-3-540-85362-6.
{{cite encyclopedia}}
: Invalid|ref=harv
(help)
Yes, those citations might be coded better. Nevertheless, the comparison I included in my previous post clearly shows that it used to work ("Old") and now doesn't ("Live"). I have no idea how many of these there are out there but I suspect it's not a small number. Additionally, the "Examples" section of the cite conference documentation is exactly this, a paper in a proceedings, although for some reason that one doesn't seem to be broken — I think because they use |conference=
instead of |title=
. And the {{cite book}} explicitly says not to use cite book for edited collections (which most conference proceedings including this are). Can't we just get this to work? —David Eppstein (talk) 22:27, 30 November 2014 (UTC)
- PS Two of the five problematic citations on isolation lemma really were miscoded, by Citation bot when it filled out some {{cite doi}} templates. It used {{cite journal}} for a conference paper, with
|title=
being the conference title and|chapter=
being the paper title. I'm not going to try to argue that the bad rendering on these ones is a bug in the templates. But this sort of mess is one reason I personally prefer {{citation}}: if you don't have to figure out whether it's a conference or a book or a journal (and there are conference proceedings published as special issues of journals — how are they supposed to be coded) then there are fewer mistakes you can be making. —David Eppstein (talk) 22:41, 30 November 2014 (UTC)
- I'm not sure why
{{cite book}}
says: For edited collections, use {{cite encyclopedia}}. So, I changed my example above to use{{cite encyclopedia}}
. I also changed it to use|chapter-url=
so that the cite links the paper's title rather than the proceedings title. Should have done that when I did the{{cite book}}
version.
- I'm not sure why
- I believe that the the answer to
Can't we just get this to work?
is to abandon{{cite conference}}
as we know it today. We could do this by redirecting to{{cite encyclopedia}}
, deprecating the unique{{cite conference}}
parameter combination of|booktitle=
and|title=
in favor of|title=
and|chapter=
.|location=
has a peculiar meaning in{{cite conference}}
where it identifies the place where the conference convened. That is problematic because it ends up in the citation's COinS metadata as the place of publication For this example, Boston, the location of the conference is identified as the place of publication when in reality, that place is Berlin.
- I believe that the the answer to
- The process would seem to be:
- redirect
{{cite conference}}
to{{cite encyclopedia}}
- here is your example citation unchanged except to use
{{cite encyclopedia}}
:- Arvind, V.; Mukhopadhyay, Partha (2008). Derandomizing the Isolation Lemma and Lower Bounds for Circuit Size. Boston, MA, USA: Springer-Verlag. pp. 276–289. ISBN 978-3-540-85362-6. Retrieved 2010-05-10.
{{cite encyclopedia}}
: Invalid|ref=harv
(help); Unknown parameter|booktitle=
ignored (help)
- Arvind, V.; Mukhopadhyay, Partha (2008). Derandomizing the Isolation Lemma and Lower Bounds for Circuit Size. Boston, MA, USA: Springer-Verlag. pp. 276–289. ISBN 978-3-540-85362-6. Retrieved 2010-05-10.
- here is your example citation unchanged except to use
- write an AWB script that would:
- change
|title=
to|chapter=
- change
|trans-title=
to|trans-chapter=
- change
|url=
to|chapter-url=
- change
|booktitle=
to|title=
- hide the content of
|location=
in<!-- -->
markup or perhaps move the content into|type=
- clarify the documentation to indicate that
{{cite conference}}
is to be used to cite conference proceedings and to correct examples and parameter documentation
- change
- in Module:Citation/CS1 deprecate
|booktitle=
- redirect
- Have I missed anything? Probably. What?
- The process would seem to be:
- I also noticed the large jump in the number of "chapter ignored" errors, so a couple of days ago I saved a screen capture of the error counts on Category:CS1 errors. Among the categories with at least 500 pages containing errors, there are a couple of anomalies that have seen real big increases in error counts in the past 48 hours.
- Category:Pages with citations having wikilinks embedded in URL titles - 1,295 pages, up 68.0%
- Category:CS1 errors: Chapter ignored - 5,728 pages, up 66.4%
- Category:Pages using citations with format and no URL - 2,987 pages, up 5.18%
- Category:Pages with citations having bare URLs - 16,114 pages, up 2.45%
- Category:Pages using web citations with no URL - 10,615 pages, up 0.29%
- Category:Pages using citations with old-style implicit et al. in editors - 1,232 pages, up 0.24%
- Category:Pages using citations with accessdate and no URL - 47,550 pages, up 0.02%
- Category:Pages with citations lacking titles - 12,103 pages, up 0.02%
- Category:Pages containing cite templates with deprecated parameters - 25,744 pages, down 0.01%
- Category:CS1 errors: dates - 50,449 pages, down 0.18%
- Category:CS1 errors: missing author or editor - 12,327 pages, down 0.73%
- There's clearly something going on with recent changes to the way errors are flagged on pages in the top two categories on this list. It appears that {{cite conference}} is one culprit, but I don't know what is causing all the recent "wikilinks embedded in URL" errors. - Stamptrader (talk) 07:23, 3 December 2014 (UTC)
- We've been discussing that one over on Template talk:Citation. It's caused when you have
|contribution=
,|url=
,|title=
, and a wikilink in the title. The|url=
parameter used to attach to the lowest-level named subdivision (the|contribution=
, in this case). In the latest version, it always attaches to the title, and any other parameter that wants a url has its own separate url-parameter such as|contribution-url=
. So, in a large number of cases that had a|contribution=
or|chapter=
with a|url=
(papers in conference proceedings and chapters in edited volumes) the url is now linked in the wrong place. If that wrong place is a title that happens to also have a wikilink, you get this error. Think how many other references there must be out there that also now have misplaced urls but aren't made visible by wikilinks in the title.
- We've been discussing that one over on Template talk:Citation. It's caused when you have
- I also noticed the large jump in the number of "chapter ignored" errors, so a couple of days ago I saved a screen capture of the error counts on Category:CS1 errors. Among the categories with at least 500 pages containing errors, there are a couple of anomalies that have seen real big increases in error counts in the past 48 hours.
- By the way, I remember discussing exactly this issue when we were in the process of switching from the core template to the Lua module (or maybe even earlier when we first started using core? I'm not sure), and the consensus then being that attaching to the lowest level named subdivision was the correct thing to do, because it was the most common case. If there was a subsequent discussion that changed that consensus before this change to the software was made, I don't know where it happened. —David Eppstein (talk) 08:20, 3 December 2014 (UTC)
Documentation confusion
I am confused by the matching of |trans-title=
/|trans-chapter=
, |title=
/|chapter=
, and |url=
/|chapter-url=
in Template:Citation_Style_documentation/conference_title. Can someone please look at it to see if it makes sense? It looks all mixed up to me. It would be nice for it to make sense between now and the time when we eventually get rid of this template, if ever. – Jonesey95 (talk) 06:55, 2 December 2014 (UTC)
- As it exists now,
|booktitle=
is only supposed to be used in{{cite conference}}
though, there isn't anything in the module to prevent its use in any other template. If|booktitle=
is set then the module does these substitutions:- chapter gets its value from title
- chapter-link gets its value from title-link
- trans-chapter gets its value from trans-title
- title gets its value from booktitle
- title-link and trans-title are set to empty strings
- This remapping reflects how parameters were remapped in the
{{citation/core}}
version and shows why the placement and use of|trans-chapter=
(with|title=
) and|trans-title=
(with|booktitle=
) is so odd.
- Alles klar?
To my mind the recommendation to use {{cite encyclopedia}} for citations to papers in conference proceedings is wrongheaded and bizarre. They are not encyclopedia articles. They do not even resemble encyclopedia articles. The whole point of the {{cite}} series of templates, in contrast to the one-size-fits-all {{citation}} (which I prefer) is to have the template name tell you what kind of citation it is. The fact that {{cite conference}} has a |booktitle=
parameter (in contrast to other cite templates) should make it obvious that the intent of the template was to support citations to books produced from conferences (i.e. proceedings) and contradicts what is claimed above that this was only ever supposed to be for citations to talks (a very unusual use case, much less common than proceedings). And, when editors saw this template available and used it in the past to produce citations to conference proceedings papers, these citations came out correctly formatted. Now they are broken.
This is part of a change in the way these templates have been managed that I have seen over the past few months and that I strongly object to. It used to be that they were extremely stable, with any incompatible change subject to much debate, and they had a philosophy of being able to handle any citation, with accuracy of the metadata being an important criterion as well but one that was clearly secondary to stability and flexibility. Now, Trappist has taken a hard line that certain templates and certain parameters can only be used in the proper way, that anything that doesn't fit that narrow view is erroneous, and that the templates should fail to render such usages, has changed the templates in multiple ways to fit that point of view, and responds to all complaints with assertions about how he thinks the templates should be used properly rather than with any flexibility. The result has been that thousands of Wikipedia articles have damaged citations, many of them difficult to track down and repair, and that software that depended on the past behavior of these templates is also broken. Another symptom of this was the recent breakage of journal formatting in the citation template. Yet another problematic feature of recent changes is that they have made significant changes to the {{citation}} template formatting but have been discussed if at all only here, at a talk page that does not relate to the citation template.
My desire would be (1) restore the past behavior, including chapter/contribution being allowed to work in cite conference/citation-with-journal/wherever it was recently broken, and also including the behavior that url= attaches to the lowest-level named heading of a citation and that attaching specifically to the title requires a more specific parameter like title-url, (2) that every change to the software be tested for regressions against a large collection of pre-existing citations with a variety of reasonable choices about how to parameterize them, and not made live until no regressions occur, (3) that any incompatible change have a full RFC before happening, and that that RFC should be advertised on all of the relevant talk pages, not just this one, (4) if a major regression is not discovered by testing and goes live (like the citation journal formatting one that was live for all of November) then we immediately revert to the previous version instead of waiting until the next scheduled update, and add those test cases to the bank of test cases for future regression testing, and (5) if Trappist the monk is not willing to be more flexible in how citations are allowed to be formatted, that someone else be found to maintain the software.
In the long term this may be moot as I think eventually we should and probably will shift to a wikidata-based reference formatting system but in the middle term I think the stability and usability of these templates is very important, has been forgotten in recent changes, and that something needs to be done about this. —David Eppstein (talk) 21:00, 4 December 2014 (UTC)
CS1 date error at Development of the New Testament canon
The last paragraph of the lead of Development of the New Testament canon contains several CS1 date errors ("Check date values in: |date= (help)". For example, the citation {{Citation | author = Eusebius | title = Church History | at = 3.25.1–7 | year=c. 303–25}} renders as "Eusebius (c. 303–25), Church History, 3.25.1–7 {{citation}}
: Check date values in: |year=
(help)CS1 maint: year (link)". According to MOS:DATERANGE the preferred form would be "c. 303 – c. 325", although that produces the same error. "303–325" works, but omits the circa. "c. 303" works, but omits the range. I've tried various other combinations without success. I assume this is some overzealous editing somewhere in the bowels of template:citation, but I've not yet managed to follow that code far enough to find where, yet. Any suggestions? Rwessel (talk) 04:02, 4 December 2014 (UTC)
- Why did the editors of that page do that? I know, a rhetorical question embodying several other questions ...
- CS1 and CS2 do not support circa date ranges. This is noted at CS1 compliance with Wikipedia's Manual of Style. At the time the date validation code was developed, circa date range style was not on the must-have list. You might add it to Module talk:Citation/CS1/Feature requests.
- —Trappist the monk (talk) 13:26, 4 December 2014 (UTC)
- At least for the Eusebius reference, it's a series of several writings, and the approximate range of years in which they were written is known, but not the exact dates. For example, because of the dedication of the last part, it's known to have been completed before 325, but whether it was 323 or 324 is not known. Some of that is covered at Church History (Eusebius). I believe the same applies to the start date. So using circa is at least reasonable. I will ask over in module talk. Thanks. Rwessel (talk) 20:33, 4 December 2014 (UTC)
Documentation updated: hyphenated parameters, removed parameters
I have updated all of the subtemplates of Template:Citation Style documentation that I could find, with the primary goal of making multi-word parameter hyphenation consistent and the secondary goal of reflecting changes in how |chapter=
and |day=
are treated in the latest round of updates. If I missed anything, or if I did anything wrong, feel free to correct my omissions or mistakes.
I think there are further updates that could add a little bit of code to separate Lua instructions from non-Lua instructions, but how and where (and even why) to do this is not clear to me.
The hyphenated parameters were standardized after this RFC in July 2014. – Jonesey95 (talk) 07:00, 2 December 2014 (UTC)
- I have also updated all of the template documentation for the individual CS1 templates that use the Lua module. If I missed anything or made any errors, let me know here or correct them. – Jonesey95 (talk) 18:00, 2 December 2014 (UTC)
- Some of my edits were reverted for reasons that have not been made clear to me. I am waiting for a response from the reverting editor, but if anyone understands the message on my talk page and can explain what I did wrong, I welcome the feedback. – Jonesey95 (talk) 04:19, 4 December 2014 (UTC)
- I was trying to figure that as well, so let us know.
- Changing the documentation is all well, but the old parameters will continue to be used until you get all the tools changed: AWB, CitationBot, RefScript, RefToolbar, ProveIt, etc. -- Gadget850 talk 11:53, 4 December 2014 (UTC)
- I created a new section below to discuss the reverts.
- I'm not worried about the tools, since aliases will continue to work. I just want the documentation to be internally consistent and easy to understand, now that all parameters have similar structures. That documentation consistency has not yet been achieved, due to the reverts. – Jonesey95 (talk) 04:34, 5 December 2014 (UTC)
Migrating cite mailing list to Module:Citation/CS1
I've been thinking about migrating {{cite mailing list}}
to Module:Citation/CS1. This template is essentially {{cite web}}
with a tweak. There is one unique parameter |mailinglist=
. If this parameter has a value, {{cite mailing list}}
uses in the same way that {{cite web}}
uses |work=
or |website=
except that it tags on the text 'mailing list' to whatever is provided in |mailinglist=
:
{{cite mailing list |title=Title |url=//example.com |mailinglist=Example |date=6 December 2014}}
- →"Title". Example (Mailing list). 6 December 2014.
{{cite mailing list}}
: Unknown parameter|mailinglist=
ignored (|mailing-list=
suggested) (help)
This functionality isn't a lot different from what {{cite AV media notes}}
, {{cite DVD notes}}
, {{cite podcast}}
, {{cite press release}}
, {{cite techreport}}
, {{cite thesis}}
do except that these templates provide the annotation text to the meta variable TitleType
if |type=
is empty or omitted.
If we migrate {{cite mailing list}}
I think that we should follow the example set by these other templates. This example, using {{cite web}}
with |website=Example
and |type=mailing list
illustrates how the migrated template would render compared to the previous example:
- "Title". Example (Mailing list). 6 December 2014.
{{cite mailing list}}
: Unknown parameter|mailinglist=
ignored (|mailing-list=
suggested) (help) – current{{cite mailing list}}
- "Title". Example (Mailing list). 6 December 2014. –
{{cite web}}
as prototype
Alternately, since there are 450ish transclusions of
{{cite mailing list}}
we could just deprecate it and run a script that would convert them all to {{cite web}}
.
Opinions?
—Trappist the monk (talk) 20:24, 6 December 2014 (UTC)
- The last thing you said, about converting them all to
{{cite web}}
, is what occurred to me when I read your second sentence. I would support converting all of them to{{cite web}}
and then turning{{cite mailing list}}
into a redirect to{{cite web}}
.
- One caveat:
{{cite web}}
requires|url=
and|title=
. It seems possible that someone could cite a mailing list post without providing a URL, although someone else might claim that doing so fails WP:V. What do we do about instances of{{cite mailing list}}
that lack|url=
?
- I don't know enough about the process for this, but I think the first step would be to gain consensus here, then to take
{{cite mailing list}}
to TfD, proposing to redirect it to{{cite web}}
. Does that seem right? – Jonesey95 (talk) 20:39, 6 December 2014 (UTC)
- Good point. First get consensus here and then do it again at TfD. Too much trouble for such a little-used template. So I've stricken that idea.
- Like
{{cite podcast}}
before it,{{cite mailing list}}
would be subject to the same tests as{{cite web}}
. Though I have not done an exhaustive search, I have not seen the case where|url=
is empty or omitted.
- Like
Migrated to Module:Citation/CS1/sandbox:
Wikitext | {{cite mailing list
|
---|---|
Live | "Title". Example (Mailing list). 9 December 2014. {{cite mailing list}} : Unknown parameter |mailinglist= ignored (|mailing-list= suggested) (help)
|
Sandbox | "Title". Example (Mailing list). 9 December 2014. {{cite mailing list}} : Unknown parameter |mailinglist= ignored (|mailing-list= suggested) (help)
|
See also testcases.
—Trappist the monk (talk) 15:37, 9 December 2014 (UTC)
Cite conference
{{cite conference}}
is broken. Fixed, I think, in the sandbox.
Wikitext | {{cite conference
|
---|---|
Live | "Chapter". Title. Conference. {{cite conference}} : Unknown parameter |sandbox= ignored (help)
|
Sandbox | "Chapter". Title. Conference. {{cite conference}} : Unknown parameter |sandbox= ignored (help)
|
Wikitext | {{cite conference
|
---|---|
Live | "Title". Booktitle. Conference. {{cite conference}} : Unknown parameter |booktitle= ignored (|book-title= suggested) (help); Unknown parameter |sandbox= ignored (help)
|
Sandbox | "Title". Booktitle. Conference. {{cite conference}} : Unknown parameter |booktitle= ignored (|book-title= suggested) (help); Unknown parameter |sandbox= ignored (help)
|
See also testcases.
—Trappist the monk (talk) 00:13, 9 December 2014 (UTC)
Encyclopedia-style output from citation
{{citation}}
does not currently support 'encyclopedia'-style output akin to that produced by {{cite encyclopedia}}
. I have tweaked Module:Citation/CS1/sandbox so that it does. This functionality is invoked when {{citation}}
uses |encyclopedia=
. These examples compare {{citation}}
output to the same parameter set rendered by {{cite encyclopedia}}
:
{{citation/new |article=Article |encyclopedia=Encyclopedia}}
- "Article", Encyclopedia
- "Article". Encyclopedia.
{{citation/new |title=Title |encyclopedia=Encyclopedia}}
- "Title", Encyclopedia
- "Title". Encyclopedia.
{{citation/new |article=Article |title=Title |encyclopedia=Encyclopedia}}
- "Article", Title, Encyclopedia
- "Article". Title. Encyclopedia.
Both {{citation}}
and {{cite encyclopedia}}
produce the same COinS output:
'"`UNIQ--templatestyles-000003B0-QINU`"'<cite class="citation cs2">"Article", ''Title'', ''Encyclopedia''</cite><span title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&rft.genre=bookitem&rft.atitle=Title&rft.btitle=Encyclopedia&rfr_id=info%3Asid%2Fen.wikipedia.org%3AHelp+talk%3ACitation+Style+1%2FArchive+6" class="Z3988"></span>
'"`UNIQ--templatestyles-000003B2-QINU`"'<cite class="citation encyclopaedia cs1">"Article". ''Title''. ''Encyclopedia''.</cite><span title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&rft.genre=bookitem&rft.atitle=Title&rft.btitle=Encyclopedia&rfr_id=info%3Asid%2Fen.wikipedia.org%3AHelp+talk%3ACitation+Style+1%2FArchive+6" class="Z3988"></span>
—Trappist the monk (talk) 16:59, 9 December 2014 (UTC)
- It's good that "three level" citations will be available to CS2 /
{{citation}}
users and I look forward to this being deployed; thanks for your prompt response. Two things I find a little odd, although probably acceptable, are:- The way that
|url=
shifts fromtitle
toencyclopedia
whentitle
is omitted. - The fact that both
|article=
and|title=
can be omitted without error if|encyclopedia=
is present.
- The way that
- I do also slightly worry that editors are being encouraged to use
|encyclopedia=
to achieve a formatting effect when semantically the top level work isn't an encyclopedia. Ideally I'd like to be able to use something more generic like|contribution=
|title=
and|work=
to achieve "three levels". Peter coxhead (talk) 19:27, 9 December 2014 (UTC)
- It isn't that
|url=
shifts, its that|encyclopedia=
shifts to fill the hole left vacant by the omitted or empty|title=
.|url=
belongs to|title=
.
- It isn't that
- You can also leave off a title from a journal citation, and get the same result:
- Conversely, you can have
{{cite journal}}
without specifying|journal=
:{{cite journal |title=Title}}
- →"Title".
{{cite journal}}
: Cite journal requires|journal=
(help)
- Both of those conditions should probably be addressed.
In the COinS metadata examples above, I notice this:
&rft.atitle=Article&rft.btitle=Title
and wonder if it is really as it should be. The COinS provides for only two title items. It seems that when {{citation}}
or {{cite encyclopedia}}
use |article=Article
, |title=Title
, and |encyclopedia=Encyclopedia
, then what the COinS should have is:
&rft.atitle=Title&rft.btitle=Encyclopedia
—Trappist the monk (talk) 20:24, 9 December 2014 (UTC)
- I have tweaked the COinS code so that when:
{{cite encyclopedia |article=Article |title=Title |encyclopedia=Encyclopedia}}
- or
{{citation |article=Article |title=Title |encyclopedia=Encyclopedia}}
- then COinS is:
&rft.atitle=Title&rft.btitle=Encyclopedia
- —Trappist the monk (talk) 12:38, 10 December 2014 (UTC)
CITEREF anchor id without names and dates
Here we have two simple templates:
{{cite book |title=Title |ref=harv}}
{{citation |title=Title}}
And here, the output rendered by Module:Citation/CS1. Neither have authors or dates yet both have id="CITEREF"
:
'"`UNIQ--templatestyles-000003BD-QINU`"'<cite class="citation book cs1">''Title''.</cite><span title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&rft.genre=book&rft.btitle=Title&rfr_id=info%3Asid%2Fen.wikipedia.org%3AHelp+talk%3ACitation+Style+1%2FArchive+6" class="Z3988"></span> <span class="cs1-visible-error citation-comment"><code class="cs1-code">{{[[Template:cite book|cite book]]}}</code>: </span><span class="cs1-visible-error citation-comment">Invalid <code class="cs1-code">|ref=harv</code> ([[Help:CS1 errors#invalid_param_val|help]])</span>
'"`UNIQ--templatestyles-000003BF-QINU`"'<cite class="citation cs2">''Title''</cite><span title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&rft.genre=book&rft.btitle=Title&rfr_id=info%3Asid%2Fen.wikipedia.org%3AHelp+talk%3ACitation+Style+1%2FArchive+6" class="Z3988"></span>
It seems to me that having an anchor id that is just CITEREF
serves no useful purpose. So, I've tweaked Module:Citation/CS1/sandbox to omit the anchor id when the template hasn't got at least one author or a date. Here, the output from the same two templates rendered by the sandbox:
'"`UNIQ--templatestyles-000003C1-QINU`"'<cite class="citation book cs1">''Title''.</cite><span title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&rft.genre=book&rft.btitle=Title&rfr_id=info%3Asid%2Fen.wikipedia.org%3AHelp+talk%3ACitation+Style+1%2FArchive+6" class="Z3988"></span> <span class="cs1-visible-error citation-comment"><code class="cs1-code">{{[[Template:cite book|cite book]]}}</code>: </span><span class="cs1-visible-error citation-comment">Invalid <code class="cs1-code">|ref=harv</code> ([[Help:CS1 errors#invalid_param_val|help]])</span>
'"`UNIQ--templatestyles-000003C3-QINU`"'<cite class="citation cs2">''Title''</cite><span title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&rft.genre=book&rft.btitle=Title&rfr_id=info%3Asid%2Fen.wikipedia.org%3AHelp+talk%3ACitation+Style+1%2FArchive+6" class="Z3988"></span>
For CS1, should we be flagging templates that have |ref=harv
but are missing one or both of author and date? No need for CS2; because |ref=harv
is the default state, the error category would be flooded. For CS1, we presume that the editor intended to use Harvard referencing if |ref=harv
is present.
—Trappist the monk (talk) 18:28, 9 December 2014 (UTC)
- Flagging this (in CS1 only) looks like a good idea to me, since there is no sensible ref=harv id to be produced. —David Eppstein (talk) 18:44, 9 December 2014 (UTC)
A new kind of author-link error to detect
Can we detect this kind of |author-link=
error, in addition to the ones we already detect?
Tolhurst, Nick (2008). The A to Z of Corporate Social Responsibility. Wiley. ISBN 978-0-470-72395-1. {{cite book}}
: Check |authorlink=
value (help); Invalid |ref=harv
(help)
– Jonesey95 (talk) 06:44, 10 December 2014 (UTC)
Tolhurst, Nick (2008). The A to Z of Corporate Social Responsibility. Wiley. ISBN 978-0-470-72395-1. {{cite book}}
: Check |authorlink=
value (help); Invalid |ref=harv
(help)
{{cite book/new |title=Title |author=Author |authorlink=Author}}
{{cite book/new |title=Title |author=Author |authorlink=[[Author]]}}
{{cite book/new |title=Title |author=Author |authorlink=[[Author]}}
- {{cite book/new |title=Title |author=Author |authorlink=[[Author]}}
{{cite book/new |title=Title |author=Author |authorlink=[[Author}}
- {{cite book/new |title=Title |author=Author |authorlink=[[Author}}
{{cite book/new |title=Title |author=Author |authorlink=[Author}}
{{cite book/new |title=Title |author=Author |authorlink=[Author]]}}
{{cite book/new |title=Title |author=Author |authorlink=[Author]}}
{{cite book/new |title=Title |author=Author |authorlink=Author]]}}
- —Trappist the monk (talk) 11:59, 10 December 2014 (UTC)
- Also, checks for authorlink = y, yes, n, no, or one digit would be appreciated. I've just cleaned up a bunch of these. Thanks! GoingBatty (talk) 00:59, 11 December 2014 (UTC)
- Just one digit?? So
|authorlink=45
is ok? Why the distinction?
- Just one digit?? So
- I've been trying to think of a case where any purely numerical string would be a valid value for
|author-link=
. I haven't been able to come up with a person or organization with a purely numerical name. The closest I've been able to come is 99, but she is a fictional character. There are hip-hop artists whose names pretty short, like D12 and D4L, which gives us an upper bound for values to mark as errors.
- I've been trying to think of a case where any purely numerical string would be a valid value for
- I propose marking any single-character entry as an error, and any purely numerical value as an error (this may bite us, so we should be willing to do a quick fix to the code). We could try marking two-character values as errors, but I suspect there are valid two-character article names out there for authors of some kind.
- On the original topic: Trappist the monk, I don't see error messages for all of the author-link values above, only for some of them. Items 3 and 4 above do not show an error message, but it seems like they should. – Jonesey95 (talk) 21:54, 11 December 2014 (UTC)
- They don't show errors because those particular conditions aren't recognized as valid templates so
{{cite book/new}}
is never called; the parser gets to the end of the file without finding the matching]]
so doesn't see the closing}}
. You can prove that by removing the<nowiki>...</nowiki>
tags from around the two square brackets in the previous sentence. The parser then finds the two curly braces and emits the check authorlink error message. Nothing that the module can do about that.
- They don't show errors because those particular conditions aren't recognized as valid templates so
- —Trappist the monk (talk) 22:37, 11 December 2014 (UTC)
- @Trappist the monk and Jonesey95: I can't think of a valid
|authorlink=
value with a purely numerical name either. (Even if we were citing something from Agent 99, we wouldn't want to link to the year 99.) Thanks for taking my suggestion a step further. GoingBatty (talk) 19:33, 13 December 2014 (UTC)
- @Trappist the monk and Jonesey95: I can't think of a valid
- —Trappist the monk (talk) 22:37, 11 December 2014 (UTC)
Duplicate punctuation fix
There has been a long-standing CS1 and CS2 bug where the code that didn't address the case where terminal punctuation of a title matched the separator character when the template had both |title=
and |url=
. Here I have set |separator=#
so that the bug is obvious:
Wikitext | {{cite book
|
---|---|
Live | Title#. Publisher. {{cite book}} : Unknown parameter |separator= ignored (help)
|
Sandbox | Title#. Publisher. {{cite book}} : Unknown parameter |separator= ignored (help)
|
This fix does not address the same thing occurring when |chapter=Chapter#
Wikitext | {{citation
|
---|---|
Live | "Chapter#", Title#, Publisher {{citation}} : Unknown parameter |separator= ignored (help)
|
Sandbox | "Chapter#", Title#, Publisher {{citation}} : Unknown parameter |separator= ignored (help)
|
There is no systematic mechanism deal with title elements that have terminal punctuation either as correct components of the title (see this feature request) or as typographical errors by editors. This will require some thought, but in the meantime this particular bug is fixed.
—Trappist the monk (talk) 18:50, 11 December 2014 (UTC)
- While I agree that terminal punctuation = separator should cause the separator to vanish, I'm not sure it's the only potential problem of this form. Suppose that the separator is a comma (the default in CS2 but also an option in CS1) and a title or chapter ends with a period (as sometimes happens). Presumably one of the two punctuation characters should vanish in this case, but which one? —David Eppstein (talk) 20:16, 13 December 2014 (UTC)
- That is the topic of the feature request I mentioned and is not part of this fix.
COinS: surname? first?
I notice in the COinS doc section it lists |surname#=
as a set of parameters yet the author doc section does not list this as a valid alias. Also, while |last#=
is listed as being used by COinS, |first#=
is absent. Does COinS use the |first#=
information? Jason Quinn (talk) 11:13, 27 November 2014 (UTC)
- Yes,
|first=
is included in the COinS metadata. Thanks for pointing that out. I've fixed the documentation. As for|surname=
and|given=
, these two parameters are rarely used. I don't think that I've seen them in the wild so am much in favor of deprecating and removing them. - —Trappist the monk (talk) 12:38, 27 November 2014 (UTC)
- I don't think I recall coming across
|surname=
and|given=
either during many thousands of cite template edits. Completely concur with deprecation and removal. Jason Quinn (talk) 13:47, 27 November 2014 (UTC)- I haven't seen many
|surname=
parameters in the wild, but they are out there. Search forinsource:/\|\s*surname\s*=\s*[A-Z\d]/
using the beta search (soon to be the default search engine at WP). I get 267 hits from that search; YMMV, as I often get different results each time I use the beta search to search. I would consider that number a minimum. – Jonesey95 (talk) 15:38, 27 November 2014 (UTC)- So, while we're thinking about this, should we just go ahead and do the deed? Should also include
|given=
as well. I can do up an AWB script to scan through the search results and change|surname#=
and|given#=
to|last#=
and|first#=
. Changing the search string toinsource:/\|\s*[Ss]urname\d?\s*=/
finds 306 pages. Change to Module:Citation/CS1/Whitelist/sandbox is just changing the value assigned to these parameters fromtrue
tofalse
. - —Trappist the monk (talk) 16:10, 27 November 2014 (UTC)
- I did not document parameters with very low use. If figured they would wither and we would eventually discard them. -- Gadget850 talk 17:36, 27 November 2014 (UTC)
- @Trappist the monk, Gadget850, and Jonesey95: We could add entries to WP:AWB/RTP to change the parameters. I am also willing to enter a AWB request to update its list of valid cite web parameters. GoingBatty (talk) 02:01, 28 November 2014 (UTC)
- I did not document parameters with very low use. If figured they would wither and we would eventually discard them. -- Gadget850 talk 17:36, 27 November 2014 (UTC)
- So, while we're thinking about this, should we just go ahead and do the deed? Should also include
- I haven't seen many
- I don't think I recall coming across
- Should we change author doc section to indicate a preference for the author[n] parameter synonym rather than the last[n] parameter when citing a corporate author?
- Is it misleading to use the last[n] parameter if the author is from a culture that usually writes the family name first? Jc3s5h (talk) 17:12, 27 November 2014 (UTC)
- There is no semantic difference between the parameters
|author=
and|last=
. -- Gadget850 talk 17:36, 27 November 2014 (UTC)- Which reminds me, why do we still have both if they mean the same thing? It just confuses people and complicates software. We ought to be phasing one or the other out. LeadSongDog come howl! 18:14, 27 November 2014 (UTC)
- There is no semantic difference between the parameters
While there is no semantic difference between |author=
and |last=
, there is a semantic difference between the words that they stand for, "author" and "last name of author". If we are going to use names for parameters that suggest the meaning of the parameter, the name should really suggest the meaning of the parameter. If not, lets use parameter names like "p74". Jc3s5h (talk) 18:28, 27 November 2014 (UTC)
(edit conflict)
@Jc3s5h: Do you have a suggested wording for an author[n] preference?
I don't know that it's necessarily misleading. It might not render correctly if the family name is placed in |last=
and the rest of the name placed in |first=
because CS1 will render the two names with a comma separator:
- Ban, Ki-moon. Title.
One can use |author-name-separator= 
: (need to fix this to be |author-name-separator=none
)
- Ban, Ki-moon. Title.
{{cite book}}
: Unknown parameter|author-name-separator=
ignored (help)CS1 maint: extra punctuation (link)
but that only works when all names have that format. If we mix in western-style names, no comma where there should be one:
- Ban, Ki-moon; Smith, Jack. Title.
{{cite book}}
: Unknown parameter|author-name-separator=
ignored (help)CS1 maint: extra punctuation (link)
Still, we want to keep the ability to have separate last/first parameters so that we can provide clean COinS metadata. I'm beginning to wonder if we should have alternate authorname parameters that are equivalent to |last=
and |first=
that somehow inhibit placement of the author separator (usually the comma) for those parameters. I don't know what these parameters might be called nor do I have any idea how we might implement them.
@Gadget850: From the template and module viewpoint, you are correct. But, I think that humans make a distinction; last is last and only last, but author is the whole enchilada. And, I wonder if the module should also make that distinction when it's creating the metadata. Right now, when |last=Smith, John
the author metadata look like this:
&rft.aulast=Smith%2C+John&rft.au=Smith%2C+John
compared to |last=Smith
|first=John
:
&rft.aufirst=John&rft.aulast=Smith&rft.au=Smith%2C+John
It seems that the former actually violates the COinS specification (see rtf.aulast). If it is in violation, then we should only create rft.aulast
when |last1=
(or any of its aliases) has a matching |first1=
.
@LeadSongDog: I agree that |last=
and |author=
having the same definition is / can be confusing. I think that there is reason to more formally distinguish them from each other as humans do.
—Trappist the monk (talk) 18:36, 27 November 2014 (UTC)
- We should not make any more changes to the sandbox version of the module before the pending merge, which is supposed to happen in two or three days. – Jonesey95 (talk) 18:38, 27 November 2014 (UTC)
- @Trappist the monk:, you asked "@Jc3s5h: Do you have a suggested wording for an author[n] preference?" I don't have an exact wording in mind. Since names of people from various parts of the world as well as corporate authors may already be in "author[n]" or last[n], any sort of bot correction of past entries is probably not feasible. I would prefer for last[n] to only apply to the family name or patronym of a person from a culture where that name is usually written last. The author[n] alias should be used for single word names of a human, corporate authors, and
familyfull names of people from cultures who usually write the family name first. Jc3s5h (talk) 20:01, 27 November 2014 (UTC) modified 20:54 UT.- I would amend that last phrase as follows: "... and
familyfull names of people from cultures who usually write the family name first." --Redrose64 (talk) 20:48, 27 November 2014 (UTC)- It's true that
|first=
and|last=
are not particularly appropriate parameter names for names written surname-first, but I don't think that means they should be combined in one|author=
parameter. We still want short citations consisting of Surname (year) for such names. Kanguole 21:27, 27 November 2014 (UTC)- Whatever they are called, I agree that we need separate parameters for the family/last name and the given/first name(s). Then there should be numbered parameters, say
|nameN-separator=
, which can be set tonone
independently, so that|last1=Ban |first1=Ki-Moon |name1-separator=none |last2=Smith |first2=Jack
produces "Ban Ki-Moon; Smith, Jack". Peter coxhead (talk) 23:14, 27 November 2014 (UTC) - @Kanguole: You can do that. You would put
{{cite book |author=Ban Ki-moon |year=2014 |title= (etc. etc.) |ref={{harvid|Ban|2014}} }}
and then you can use{{harvnb|Ban|2014|p=123}}
--Redrose64 (talk) 23:18, 27 November 2014 (UTC)- OK, but that's a roundabout fix. I don't think it gets "Ban" in rft.aulast and "Ki-Moon" in rft.aufirst either. This discussion seems to be conflating semantics and presentation. These authors have surnames and given names, and we want to treat their surnames in the same way as surnames of other authors, so it's natural to use the same parameter for the surname in both cases. In such cases it's confusing that it's called
last
, but a more meaningful alias likesurname
could be offered as well. Ditto for the given name. That is, I suggest that the solution is not to tweak the recommendation for|author=
, but to merely retain|surname=
and|given=
as aliases, possibly with|nameN-separator=
as above. Kanguole 23:58, 27 November 2014 (UTC)- Agreed. The
|nameN-separator=
idea is only for presentation. The semantics are paramount. Peter coxhead (talk) 10:15, 28 November 2014 (UTC)
- Agreed. The
- OK, but that's a roundabout fix. I don't think it gets "Ban" in rft.aulast and "Ki-Moon" in rft.aufirst either. This discussion seems to be conflating semantics and presentation. These authors have surnames and given names, and we want to treat their surnames in the same way as surnames of other authors, so it's natural to use the same parameter for the surname in both cases. In such cases it's confusing that it's called
- Whatever they are called, I agree that we need separate parameters for the family/last name and the given/first name(s). Then there should be numbered parameters, say
- It's true that
- I would amend that last phrase as follows: "... and
Since |surname=
is used in only 300ish of the 2.4ish million pages that use Module:Citation/CS1, it would seem that regardless of appropriateness, editors prefer |last=
, |first=
, and |author=
to |surname=
and |given=
. With such an overwhelming preference, I think we should deprecate and remove |surname=
and |given=
. We need to investigate and implement some method that will solve the presentation problem. I will do that and report back.
—Trappist the monk (talk) 15:47, 28 November 2014 (UTC)
- Agree that removing given & surname would be a step forward. Those 300 pages could easily use
|author=
instead. A peek at Ban's viaf record is illuminating. With all the variations listed, there's not likely much point concerning ourselves about the order we present. We'd do better to focus our efforts on linking to an independent authoritaties database. This would also help article translation efforts to more readily identify the name form that will be recognized by the target language readers. LeadSongDog come howl! 19:21, 28 November 2014 (UTC)
- The most important thing is to remove the recommendation, both here and at
{{Citation Style documentation/author}}
, to use|author=
/|last=
for some personal names. It's particularly incongruous to cite Chinese as an example, when standard practice at WP:CHINA is to use|last=
for the surname and|first=
for the given name (cf WP:MOSCHINA#Citations and WP:MOSKOREA#Citations; MOSJAPAN has no citation guidance, and WP:HUNGARY has no MoS). That way the short references work (and we get the right data in the COinS fields). Kanguole 22:03, 28 November 2014 (UTC)
- Let me state the obvious: If the documentation for CS1 is inadequate, have a go at changing it so that it's correct.
I made a simple experiment in Module:Citation/CS1/sandbox that (mis)used |author-format=nosep
to replace the default author-name-separator with a space. I chose |author-format=
simply because it was convenient for the experiment. It was enough of an experiment to show that doing |last=
and |first=
without a separator shouldn't be that difficult. The experiment has been removed from the sandbox.
The question that arises from the experiment is: were we to implement some sort of mechanism to disable the author-name-separator for individual authors, what would the editor use to do that? Some possible answers:
- create
|author-name-separatorn=
which would specify author-name-separator for authorn and where|author-name-separatorn=none
would use a space as the separator character - create
|author-name-separatorn=none
which would replace the author-name-separator for authorn with a space; any value other thannone
is an error.|author-name-separator=
(without the n) specifies the separator character for all author names if different from the default. - Something else?
Presumably, it would be necessary to do the same for editor names.
And all of that, raises other questions: Why do we have |author-name-separator=
and |editor-name-separator=
? Is there a need to separate author first from last with a character that is different from the character used to separate editor first from last? Similarly, we have |author-separator=
, |editor-separator=
, and |name-separator=
. |name-separator=
is an alias of both |author-separator=
and |editor-separator=
but |author-separator=
and |editor-separator=
are not aliases of each other. Is there a reason to separate authors in the author-list with a character that is different from the character that separates the editors in the editor-list?
—Trappist the monk (talk) 16:50, 14 December 2014 (UTC)
- Indeed, disabling the comma separator for names usually written surname-first would require a parameter for each author and each editor, because one often gets a mix of such names. The but I think the motivation for current setup is that although it doesn't cover all those cases, it handles some more, e.g. it covers a case where the sole author has a Chinese name and the editors have English names, or vice versa. That is, it's a kludge; doing it properly requires two families of parameters.
- That said, I don't think the ability to disable the name separator is that important. In works aimed at an audience familiar with Chinese names, the bibliography will have all names surname-first, with Chinese author names having no separator and Western ones having a comma. However works aimed at a more general audience will tend to use commas for all names, making the surname (which is also used in Harvard citations) clear to a reader unfamiliar with Chinese. I'd say Wikipedia should be more like the latter. Kanguole 14:49, 15 December 2014 (UTC)
Template documentation standard?
In a previous discussion we raised the topic of reducing the workload required because there are two separate and incompatible sets of documentation that must be maintained for every parameter of every template. The first set of documentation is the verbose, human readable documentation that is present on all CS1 and CS2 template pages. The second is the JSON formatted documentation used by the visual editor. This second documentation set imposes certain limits on what is and is not allowed in the documentation.
In the previous discussion, Editor Andy Mabbett suggested: documentation written in standardised, human-readable way (with links and formatting) and have a script (part of VE?) read it and convert that to JSON on the fly
. I can't speak to conversion but perhaps the standardized form for human readable documentation light take the form of a series of templates which, when used in the correct order would produce a human readable table. The templates would have parameters to match the JSON keywords. For example, this is the template data for |last=
from {{cite book}}
:
"last": { "label": "Last name", "description": "The surname of the author; don't wikilink, use 'authorlink'; can suffix with a numeral to add additional authors", "aliases": [ "author", "author1", "authors", "last1" ], "suggested": true },
This might be adapted to a template that would look like this:
{{template param doc |name=last |ve-label=Last Name |ve-description=The surname of the author; don't wikilink, use 'authorlink'; can suffix with a numeral to add additional authors |description='''last''': Surname of author. Do not wikilink—use '''author-link''' instead. For corporate authors, simply use '''last''' to include the same format as the source |alias1=author |alias2=author1 |alias3=authors |alias4=last1 |type=string <!-- undefined, string, boolean, date, page, user, file, content, unbalanced wikitext, line --> |default=none |ve-autovalue=none |suggested=true |required=false }}
So here we have most if not all of the components that ve requires for its documentation all neatly bundled and from which it may take to format as it sees fit. Similarly, we can now take this same bundle of stuff and do likewise. We might create {{template param doc start}}
and {{template param doc end}}
templates that would create wikitable header and footer and where each {{template param doc}}
would be a row in that table. We might add parameters that ve doesn't want or require: |used in COinS=true
, |prerequisites=none
, |can enumerate=true
, etc. Perhaps another presentation style would be better.
—Trappist the monk (talk) 15:49, 8 December 2014 (UTC)
- Because entering wikitext in the regular editor is so different that creating citations in VE, helpful descriptions of what to do for wikitext are useless as VE tips. So it will be necessary, in general, to provide different descriptions (although some fields might be able to use the same description for both).
|last=
is a perfect example; if you want to add another author in VE, you go to the bottom of the box and click "add more info", you don't suffix the "last" parameter with a digit. Jc3s5h (talk) 17:11, 8 December 2014 (UTC)
- Which is why there is
|ve-description=
. It can contain whatever descriptive text is appropriate to ve. Yeah, the above still has two separate descriptions but only one definition for all others and uses only one format and structure.
- Which is why there is
- —Trappist the monk (talk) 17:21, 8 December 2014 (UTC)
- I like this idea. It could help with consistency between the parameter lists and tables that are typically at the top of our documentation and the VE documentation.
- —Trappist the monk (talk) 17:21, 8 December 2014 (UTC)
- We may have some trouble with variables that are unbounded, like "lastn". I don't know how the VE documentation, which feeds the VE template editor, is set up to deal with those. It seems foolish to list last1, last2, last3, ... last30, but would that be the only way to deal with VE? I guess my question, for now, is: what happens right now if I try to edit a thirty-author "cite journal" template with VE? I haven't tried it. – Jonesey95 (talk) 18:20, 8 December 2014 (UTC)
- I charge you to try it and report back.
- The unbounded parameters is why I suggested the
|can enumerate=true
parameter so that we don't have to repeat like is currently done at Template:Cite_journal#Template_data.
- The unbounded parameters is why I suggested the
Documentation in the form I described above might be rendered this way:
name | description | aliases | type | condition |
---|---|---|---|---|
name | name of the template parameter | none | string | required |
description | wikitext that describes the purpose and or function of the parameter | none | string | required |
ve-description | plain-text that describes the purpose and or function of the parameter; used by visual editor; do not use wikimarkup | none | string | required |
aliasn | used when alternate parameter names for a parameter are available; enumerated parameter where n is 1–9 | none | string | suggested |
type | identifies the type of the parameter value:
|
none | string | suggested |
default | identifies the parameter's default value when the parameter is empty or omitted | none | string | suggested |
ve-autovalue | see mw:Help:TemplateData#Auto_value | none | string | none |
suggested | set to true when use of the parameter is recommended; default is false | none | boolean | none |
required | set to true when use of the parameter is required for proper template operation; default is false | none | boolean | none |
—Trappist the monk (talk) 11:56, 9 December 2014 (UTC)
- Strictly speaking, for the type, one should explain that all the suggested types are strings. The type described as "string" is a free-form string with minimal rules (what are those rules?). The other types are strings that must represent an instance of the type, for example, "123" is a string of three Unicode characters that represents a number. In a more formal document, a detailed description of allowed values for each type would be specified. Jc3s5h (talk) 12:33, 9 December 2014 (UTC)
- Type values are lifted from template data editor. Except for 'string', mw:Help:TemplateData doesn't define what those types actually mean. Certainly in the above example, description could wikilink to complete descriptions at an appropriate help page or, as I have modified above, brief descriptions can be provided for each optional value or, we could do both.
- This resurrects a previous problem: what if a parameter value is a true and necessary description of a source, but not supported by CS1 due to software limitations. For example, the date of a newspaper printed in England on 29 February
16001700; this is not a valid Gregorian calendar date but was a valid Julian calendar date. Accept it in VE and let the red message appear in the article? Advise the editor that CS1, and therefore, VE, are inappropriate for this article and advise the editor to use "Edit Source" and rewrite all the citations without templates? Jc3s5h (talk) 12:41, 9 December 2014 (UTC), fixed 15:53 UT
- Sure, that's an issue to be dealt with in the documentation, but is off-topic when the topic is standardizing documentation format so that the maintenance task is reduced to a single format. And 29 February ...
Well, I thought I had an idea. It seemed to me that we could write a couple of templates and some Lua code that would allow us to implement Editor Andy Mabbett's suggestion. So I took a crack at it. The results are {{template parameter doc}}
, {{template parameter doc item}}
, and Module:template parameter doc. As you can see at both template pages, the implementation doesn't work. I don't know this for sure, but I'm guessing that <TemplateData>...</TemplateData>
is processed before templates and modules are processed. I surmise this because I can copy and paste the template data created by the module, into the page, save the page, and produce the usual template data documentation table.
—Trappist the monk (talk) 14:57, 13 December 2014 (UTC)
- WP:VPT comes through again.
{{template parameter doc}}
,{{template parameter doc item}}
, and Module:template parameter doc are now doing what I had hoped they could do.
- Well I spoke too soon. The fix I mentioned above, renders a nice pretty TemplateData table but more is needed. I'm guessing that Visual Editor and the TemplateData editor both read the source file for the template (which transcludes the documentation page). They don't read the rendered page which is where template and module output goes. I believe this to be true because if I attempt to add
{{template parameter doc}}
to a page, ve produces this message:- You are adding the "Template parameter doc" template to this page. It doesn't yet have a description, but there might be some information on the template's page.
- But, if I attempt to add
{{template parameter doc item}}
, ve finds the TemplateData that I added to that page as a test of the output from Module:template parameter doc.
- Well I spoke too soon. The fix I mentioned above, renders a nice pretty TemplateData table but more is needed. I'm guessing that Visual Editor and the TemplateData editor both read the source file for the template (which transcludes the documentation page). They don't read the rendered page which is where template and module output goes. I believe this to be true because if I attempt to add
- So, this idea may have run its course.
Update to the live CS1 module weekend of 29–30 November 2014
Over the weekend of 29–30 November 2014 I propose to update the live versions of:
- Module:Citation/CS1 from Module:Citation/CS1/sandbox:
- restore |work= and its aliases format when used in
{{citation}}
; see discussion - make |interviewer= and |interviewers= aliases of |others=; adapt cite interview accordingly; |day= no longer supported;
- add language codes for script-title categorization ('bs', 'dv', 'el', 'fa', 'hy', 'ku', 'ps', 'ru', 'sd', 'sr', 'th', 'uk', 'ug', 'yi');
- added asin length and composition test; see discussion
- separate presentation
<span>...</span>
tagging from static text insertion; Bug fix; see discussion - fixed COinS chapter/title keyword swapped error; see discussion
- migrate cite newsgroup; see discussion
- retire |display-authors error message; shift categorization to Category:CS1 maint: display-authors; see discussion
- revised |chapter=, |trans-chapter=, and |chapter-url= handling; see discussion
- Add unrecognized language categorization when |language= is not ISO 639-1;
- restore |work= and its aliases format when used in
- Module:Citation/CS1/Configuration from Module:Citation/CS1/Configuration/sandbox:
- change
|trans-title=
and|trans-chapter=
error messages to use hyphens instead of underscores; - these deprecated parameters are no longer supported:
|albumlink=
,|artist=
,|cointerviewers=
,|day=
,|director=
,|notestitle=
,|publisherid=
,|titleyear=
; |interviewer=
and|interviewers=
are now aliases of|others=
;- added
|asin=
error message; see discussion - create
citation_config.presentation
; move most presentation<span>...</span>
tagging there; - retire
|display-authors=
error message; shift categorization to Category:CS1 maint: display-authors; see discussion
- change
- Module:Citation/CS1/Whitelist from Module:Citation/CS1/Whitelist/sandbox:
- these deprecated parameters are no longer supported:
|albumlink=
,|albumtype=
,|artist=
,|cointerviewers=
,|day=
,|director=
,|notestitle=
,|publisherid=
,|titleyear=
; - added
|interviewers=
; - deprecated
|chapterlink=
and|chapter-link=
;
- these deprecated parameters are no longer supported:
- Module:Citation/CS1/Date validation from Module:Citation/CS1/Date validation/sandbox:
- closed a small hole through which
|date=2nd
could wriggle; see discussion
- closed a small hole through which
—Trappist the monk (talk) 19:39, 21 November 2014 (UTC)
- Wow, that's a lot of work!
- I looked through the above list a couple of times and did not see "add Category:CS1 maint: Date and year when a citation uses both
|date=
and|year=
," per a discussion above, on this page – Jonesey95 (talk) 01:02, 22 November 2014 (UTC)
- Hey, wanted to leave a note that immediately following [15] "Synch from sandbox;", the page I was working on in my sandbox began throwing the error "Lua error in Module:Citation/CS1 at line 189: Argument map not defined for this variable." for each instance of cite web. -- Limulus (talk) 12:13, 29 November 2014 (UTC)
- @Limulus and Trappist the monk: I got the same error with {{cite book}} and {{cite news}} while previewing some edits I was making to an article. However, by the time I saved the edits, the error message disappeared and proper citations appeared in the article as normal. Imzadi 1979 → 12:25, 29 November 2014 (UTC)
- That sort of thing happens because there are four pages to update so for a short period of time there is a mix of old and new. If you find any articles with that error that aren't fixed by a null edit, let me know.
- Thanks! I tried a null edit (just entered text in summary field) and that fixed the error. -- Limulus (talk) 12:48, 29 November 2014 (UTC)
Cite report
Yeah, I'm about to open that can of worms (see here, continued here).
Apparently, {{cite report}}
is to be used only for things that are unpublished, where the definition of unpublished appears to mean that the item has not been made available to the public. This definition seems to be a bit fuzzy. The example in the template's documentation page is:
{{cite report |title=Rhode Island Roads |publisher=Rhode Island Department of Public Works |date=1956}}
- →Rhode Island Roads (Report). Rhode Island Department of Public Works. 1956.
Given what I know about that report (nothing, because I don't have access to it) this example clearly fits the definition.
This example, taken from the template's talk page, doesn't seem to fit the definition so well:
{{cite report|url=http://www.nhc.noaa.gov/archive/storm_wallets/atlantic/atl1993/gert/prenhc/prelim01.gif|title=Preliminary Report Hurricane Gert: 14-21 September 1993|series=Hurricane GERT, Hurricane Wallet Digital Archives|date=1993-11-10|first=Richard J.|last=Pasch|accessdate=2011-10-03|location=Miami, Florida|publisher=[[National Hurricane Center]]|page=[1]}}
- →Pasch, Richard J. (1993-11-10). Preliminary Report Hurricane Gert: 14-21 September 1993 (Report). Hurricane GERT, Hurricane Wallet Digital Archives. Miami, Florida: National Hurricane Center. p. [1]. Retrieved 2011-10-03.
It doesn't fit the definition because the citation has |url=
which seems to me to indicate distribution, if not publication for public consumption. That being the case, the citation should be rewritten as {{cite web}}
.
In the documentation, the template skeletons (inconsistently) have |url=
, |accessdate=
, and |format=
. While not in the skeletons, the documentation lists |laysummary=
and |laydate=
. It isn't quite clear to me if these indicate distribution or not. The template code, supports the standard set of identifiers: ISBN, DOI, JSTOR, etc. all of which, if included in {{cite report}}
would, to me, indicate distribution or publication.
{{cite report}}
is stylistically different from all other CS1 templates in how it handles the title element. In CS1, titles of items that are a part of a larger whole, are rendered quoted, while the larger whole is rendered in italics. {{cite report}}
renders its title element in normal upright font without quote marks. Yet, at the same time, it supports |chapter=
or |section=
so you end up with this:
{{cite report |title=Title |chapter=Chapter}}
- →"Chapter". Title (Report).
In the template code is this:
|Title= ''{{{title|}}}''
What is the purpose of the pair of 
(zero width no-break space) characters? Were they on the outside, I could see them separating the italic markup here from the italic markup added by {{citation/core}}
. But they aren't so it isn't clear to me why they're there. The final rendered title looks like this:
''''Title'''' 
So, what to do about {{cite report}}
? Do we maintain {{cite report}}
as a CS1 template? Do we migrate it to Module:Citation/CS1? There has been some discussion about supporting unstyled title elements (here) which may (or may not) have relevance to this discussion.
—Trappist the monk (talk) 14:21, 11 December 2014 (UTC)
- Per WP:SOURCE: "Base articles on reliable, third-party, published sources with a reputation for fact-checking and accuracy. Source material must have been published, the definition of which for our purposes is "made available to the public in some form". Unpublished materials are not considered reliable."
- Per {{cite report}}:
Unpublished reports by government departments, instrumentalities, operated companies, etc.
- These reports are to be published in the Wikipedia sense of verifiability: a responsible organisation must have fact checked them; and the selection process for publication must not have been automatic.
- Examples include: government printed reports which lack ISSN or ISBN numbers, and reports from major semi-governmental instrumentalities that are freely circulating and available for verification, but which lack a formal ISBN / ISSN publication process.
Lets take a look at a sample of uses:
- Area 51: The U-2's Intended Successor: Project Oxcart,1956-1968 (Report). approved for released by the CIA in October 1994.
The new 8,500-foot runway was completed by 15 November 1960.
{{cite report}}
: Check date values in:|date=
(help)
- Approved for release indicates to me this is published, and a quick search readily finds it on the web.[16] Date requires cleanup.
- al-Qaeda: Jenkins, Brian Michael (2014). The Dynamics of Syria's Civil War (PDF) (Report). RAND Corporation.
- Linked and publisher indicated.
- Agent Orange: Darrow Robert A. Historical, Logistical, Political and Technical Aspects of the Herbicide/Defoliant Program, 1967-1971 (Report). Plant Sciences Laboratories, US Army Chemical Corps, Fort Detrick, Frederick MD, September 1971. p. 49. A Resume of the Activities of the Subcommittee on Defoliation/Anticrop Systems (Vegetation Control Subcommittee) for the Joint Technical Coordinating Group/Chemical-Biological. Retrieved April 22, 2013.
{{cite report}}
: Cite has empty unknown parameter:|coauthors=
(help)
- Linked and publisher indicated. This one uses
|docket=
but looking at other use on the web, it is a subtitle.
- CIM-10 Bomarc: IM-99 Weapon System: 26 October - 28 November 1958 (PDF) (Report). Approved 17 December 1958, declassified. Retrieved 4 August 2013.
technical training facility at Eglin Air Force Auxiliary Field Number 9. The IM-99A and IM-99B warheads (W-40) The IM-99B had been designed to include a "Pattern Patrol" type operation. Missiles could be launched in multiples, or at very close intervals and guided in a line abreast type formation.with target seekers operating in search mode. This would provide a capability to patrol a given area where targets were suspected but where definite tracks had not been established.
{{cite report}}
: Check date values in:|date=
(help)
- Linked, document shows the publisher is the U.S. Air Force.
- Cuban missile crisis: The Naval Quarantine of Cuba, 1962: Abeyance and Negotiation, 31 October − 13 November (Report). Department of the Navy, Naval Historical Center. January 2001. Retrieved August 26, 2011.
- Linked and publisher indicated.
Chicago 16 has a section on "Unpublished and Informally Published Material, 14.224 ff.
- 14.224 THESES AND DISSERTATIONS: Titles of unpublished works appear in quotation marks--not in italics. This treatment extends to theses and dissertations, which are otherwise cited like books.
- 14.225 UNPUBLISHED MANUSCRIPTS: Titles of unpublished manuscripts, like the titles of other unpublished works, appear in quotation marks.
...and so on.
Chicago 16 does cover generic names:
- 14.234 SPECIFIC VERSUS GENERIC TITLES FOR MANUSCRIPT COLLECTIONS: In notes and bibliographies, quotation marks are used only for specific titles (e.g., "Canoeing through Northern Minnesota"), but not for generic names such as report or minutes. Generic names of this kind are capitalized if part of a formal heading actually appearing on the manuscript, lowercased if merely descriptive.
APA 6:
- 7.09, Unpublished and Informally Published Works: Unpublished work includes work that is in progress, has been submitted for publication, or has been completed but not submitted for publication. This category also includes work that has not been formally published but is available on a personal or institutional website, an electronic archive such as ERIC, or a preprint archive.
- It then goes on to show unpublished works formatted with quotes or italics as other sources.
But we need to put this into context. Chicago and APA are for a general audience and do not cover our verifiability polices and the prohibition on original research.
Summary: Every use I have encountered can be replaced by {{cite journal}}. There would be cleanup needed because many of these are badly formatted, especially with dates but that is nothing new. I see no need for |type=Report
being set as default. Darned if I know what to do with |docket=
except go through and clean it up. -- Gadget850 talk 13:26, 13 December 2014 (UTC)
- Absolutely none of the samples above are suitable for {{cite journal}}. That should only be for papers that are published in academic journals, not true for any of these. And as well as carrying the wrong metadata, {{cite journal}} will probably format these wrong. —David Eppstein (talk) 18:22, 13 December 2014 (UTC)
- The {{cite journal}} description is "used to create citations for articles in magazines, journals, newsletters, and for academic papers." Limiting it to academic journals is a lost battle and if you want to discuss it further please start a separate discussion. -- Gadget850 talk 19:39, 13 December 2014 (UTC)
- I agree that {{cite report}} appears to be redundant to other citation templates. It looks like it's time for a widely advertised TfD, since the template is used in about 5,000 articles. – Jonesey95 (talk) 16:09, 13 December 2014 (UTC)
In academic computer science, at least, and probably also in many other areas of academic publishing (CS is the one I'm most familiar with), preprints of papers that have not yet been published as journals or conferences are considered as "unpublished", but are often made publicly available online as part of a technical report series. That is what this template is for. If you eliminate it, there will be no appropriate cite template for them to go in. They are not books (too short, no isbn, etc), they are not conferences, they are not journals, etc. And they have their own somewhat specialized formatting requirements: they are generally numbered as part of a technical report series, and that number is an important part of their citation data. Being available online is not inconsistent with being "unpublished", because in this context published means having gone through a formal peer review and appearing in a publication put out by a third party rather than merely being available to the public. They are really more self-published than unpublished, but they're called unpublished. Often they should be replaced by a later published version of the same work but sometimes for whatever reason that doesn't happen. We still cite them sometimes, e.g. under the "recognized expert" clause of WP:SPS. The first few examples I found in a quick search all happened to be formatted with CS2 rather than CS1 but I think they are still reasonably representative:
- From János Komlós (mathematician): Komlós, János; Simonovits, Miklós (1996), Szemeredi's Regularity Lemma and its applications in graph theory, Technical Report: 96-10, DIMACS
- From bipartite dimension: Stockmeyer, Larry J. (1975), The set basis problem is NP-complete, Technical Report RC-5431, IBM.
- From Z-order curve: Morton, G. M. (1966), A computer Oriented Geodetic Data Base; and a New Technique in File Sequencing, Technical Report, Ottawa, Canada: IBM Ltd..
So your objections to the existence of this template seem to be founded purely on ignorance of this kind of publication. What alternative template in the CS1 series do you think (1) will adequately format these, and (2) per the CS1 philosophy that the template name tells you what kind of citation it is, will adequately convey that piece of metadata? —David Eppstein (talk) 17:58, 13 December 2014 (UTC)
- In the case of all three of your examples, the CS1 template most appropriate would seem to be
{{cite techreport}}
:- Komlós, János; Simonovits, Miklós (1996). Szemeredi's Regularity Lemma and its applications in graph theory. DIMACS (Technical report). 96-10.
- Stockmeyer, Larry J. (1975). The set basis problem is NP-complete (Technical report). IBM. RC-5431.
- Morton, G. M. (1966). A computer Oriented Geodetic Data Base; and a New Technique in File Sequencing (Technical report). Ottawa, Canada: IBM Ltd.
- —Trappist the monk (talk) 18:17, 13 December 2014 (UTC)
- Ok, then. What is the intended difference between cite techreport and cite report? Because maybe they should be merged. Also, is cite techreport capable of using a name for the technical report series other than "Technical report"? Because they're not always called exactly that. And why the parentheses around the words "Technical report" and the separation from the number in the report series? I want to see formatting like "Technical report RC-5431" or "Report no. 172", not to have "(Technical report)" somewhere in the citation and the report number divorced from its context somewhere else. —David Eppstein (talk) 18:23, 13 December 2014 (UTC)
|type=none
and|number=Report no. 172
- Why the parentheses? Because CS1 and CS2 do that with the value assigned to
|type=
:- Stockmeyer, Larry J. (1975), The set basis problem is NP-complete (Technical Report), IBM, RC-5431.
- —Trappist the monk (talk) 18:41, 13 December 2014 (UTC)
- This is the typical sort of answer from you that I've been finding really frustrating. Why? Because that's the way it's programmed. That's not what I want to know. What was the rationale for programming it that way? If CS1 and CS2 parenthesize the type parameter in this way, then either that choice of formatting is wrong, or the type parameter is the wrong one to be using for the name of a technical report series. The formatting from my {{citation}} examples above is much closer to what I want to see. Is there some approved way of obtaining this formatting, that won't suddenly get deprecated later? —David Eppstein (talk) 19:08, 13 December 2014 (UTC)
- Why the parentheses? Because CS1 and CS2 do that with the value assigned to
- The long gone editors who first created these templates made some style choices and we have consistently maintained them over the years. If you want to see a change, create a new discussion and make a specific proposal with some rationale. -- Gadget850 talk 19:57, 13 December 2014 (UTC)
- In my own editing I prefer CS2. But from the discussion above it appears that {{cite report}} can be used to generate what I would consider appropriate formatting for a technical report, and that {{cite techreport}} cannot (as a consequence of the past decision to make the name of the technical report series be a "type" instead of a "series"). If I were to use CS1 (for instance because that was the established style of an existing article) and wanted to cite a technical report, based on this discussion, I would use {{cite report}}. So the status quo is acceptable to me. What I would find objectionable would be the change proposed by others above, where we get rid of the working template {{cite report}} and shoehorn everything into other templates that don't work so well for this kind of publication. —David Eppstein (talk) 20:08, 13 December 2014 (UTC)
- There are an awful lot of words on this page that I put here. I have no problem being verbose. But, somehow, your posts to and about me have made me unwilling to respond to you with any more words than are absolutely necessary. There is precious little documented rational for why CS1/2 are the way they are. You have been here longer than I so you know this to be true. If there is anything written about why
|type=
is rendered in parentheses, it will be found in an archive somewhere.
- The long gone editors who first created these templates made some style choices and we have consistently maintained them over the years. If you want to see a change, create a new discussion and make a specific proposal with some rationale. -- Gadget850 talk 19:57, 13 December 2014 (UTC)
- It seems to me that this conversation has come adrift. The topic is
{{cite report}}
and what to do about it.
- It seems to me that this conversation has come adrift. The topic is
- Some time back I went through archives and template histories going back to 2007. There is little discussion on why certain styles were chosen. If changed is desired, I have some thoughts on formatting. -- Gadget850 talk 20:15, 13 December 2014 (UTC)
Migrated to Module:Citation/CS1/sandbox. See testcases. Should work more-or-less like the {{citation/core}}
version works. If we decide that we don't like the unstyled titles (or anything else about this template), we can change it.
—Trappist the monk (talk) 21:27, 14 December 2014 (UTC)
authorlink no longer bold when on author page itself?
It used to be that if an |authorlink=
parameter in cite templates pointed to the page itself, the author's name would not be linked but would appear in bold. Now it seems as if it is not bold or linked, it's just ignored. When did this change happen? I thought that the bolding was an excellent feature because it helped readers to see suspicious sources like the article's subject writing about themselves. It also helped locate the author in their list of Works when there were coauthors. I'm not sure removing the bolding was a good change. Jason Quinn (talk) 19:00, 19 December 2014 (UTC)
- —Trappist the monk (talk) 19:16, 19 December 2014 (UTC)
- Not that I disagree with this change, but let me repeat: when making changes of functionality that affect CS2, please include a link to this discussion at Template talk:Citation. This is the first I've heard of this one, since I wasn't watchlisting CS1. —David Eppstein (talk) 19:47, 19 December 2014 (UTC)
Edits to template documentation per RFC reverted; how to improve documentation consistency?
Back in July, an RFC on this page resulted in a consensus decision that all multi-word parameters should have at least one alias that uses hyphens to separate each word, and that "The documentation is to show this lowercase, hyphenated version as the one for 'normal use'."
I recently updated the shared template documentation, along with the documentation pages for all of the citation templates that use the Lua module, to reflect the above consensus. In the process, I appear to have caused problems with some of the TemplateData sections that are used by the Visual Editor. The edits that caused these problems were reverted in their entirety by another editor. After some discussion on my Talk page, I reinstated some of the changes to the template documentation pages, carefully leaving the TemplateData sections alone, except for a couple of outdated notes about how "et al." is used. Those edits were reverted in their entirety by the same editor.
At this point, the template documentation pages are inconsistent with one another and with the RFC outcome. They also contain inaccurate information about when "et al." is displayed. I am reluctant to edit the pages again, since it appears that I am in the middle of an edit war. Any ideas on how to resolve this situation are welcome.
In addition, if anyone knows of good reference material that explains how to avoid causing problems with the TemplateData section, please link to it here. I found Wikipedia:TemplateData/Tutorial, but it does not contain information about how to avoid or detect the sort of problem that I am told I created.
The template documentation pages in question are Template:Cite journal/doc (history), Template:Cite book/doc (history), Template:Cite press release/doc (history), and Template:Cite news/doc (history). – Jonesey95 (talk) 04:31, 5 December 2014 (UTC)
- Regarding TemplataData, some important points are:
- You have to follow the proper structure, as set out on the tutorial page
- If both normal documentation and TemplateData are both present, then the main purpose of the TemplateData is to be used in VisualEditor's template editor
- Wikilinks, external links, formatting, templates, and in fact any wikimarkup will not work in the description fields, so
[[Template:Cite journal/doc#Date]]
will display as "[[Template:Cite journal/doc#Date]]", which as plain text is probably useless for a large percentage of VisualEditor's intended users. (See Wikipedia talk:TemplateData#Extending_use.3B_removing_redundancy, and other discussions in the archives) - Referring to "(above)", as in the normal documentation, is of little value: in VisualEditor, all that will be displayed is what is in the TemplateData
- If a parameter name is changed, the previous name should be made an alias, assuming it can still be used
- The TemplateData and normal documentation, including examples, should be consistent
- —Note: comment from uninvolved editor - Evad37 [talk] 07:02, 5 December 2014 (UTC)
- It seems clear to me that the reverting editor is correct with regard to the use of wikitext in the template data parameter description field. It also seems clear to me that the reverting editor is incorrect with regard to the changes to the main template documentation pursuant to the RFC and incorrect with regard to the
|display-authors=
description. Perhaps the next step is to make the changes to the main template documentation to bring it into compliance with the RFC. Then, perhaps ask the editors at the VisualEditor feedback page how to safely update the template data to bring it into compliance with the RFC. Then, scrupulously follow their advice.
- Treating documentation as code that affects the function of an editor is an egregious sin and this methodology should be forbidden. If the visual editor developers don't agree, rip out visual editor and burn the backup tapes. Jc3s5h (talk) 12:44, 5 December 2014 (UTC)
- TemplateData includes both technical controls, and prose descriptions; it is the duplication of the latter which is the problem. Andy Mabbett (Pigsonthewing); Talk to Andy; Andy's edits 14:02, 5 December 2014 (UTC)
"If both normal documentation and TemplateData are both present"
this is a stupid practice. See Wikipedia talk:TemplateData#Extending use; removing redundancy for reasoning and a proposed resolution. Andy Mabbett (Pigsonthewing); Talk to Andy; Andy's edits 13:53, 5 December 2014 (UTC)- Evad37, thanks for the tips. Is this information available in documentation somewhere? I have been unable to find it. It is difficult to do error-free editing without documentation.
- Trappist the monk, I agree, and if you read the article history and my talk page, that is exactly what I did with my second set of edits. Nonetheless, those edits were reverted wholesale, leading to the current state of the documentation (i.e. inconsistent and incorrect).
- Pigsonthewing and Jc3s5h, I was also surprised that modifying the documentation affected the functioning of a tool. That was the first time I had encountered this effect, and it seems like an undesirable coding practice to me. Perhaps, as a workaround, we should modify these citation template documentation pages so that the TemplateData section is contained within its own subtemplate, with comments before the subtemplate call and within the subtemplate itself explaining that changing the text within the subtemplate could cause problems with VE functioning. That way, someone like me doing straightforward editing of wikitext in the documentation would be alerted that There Be Dragons and I should not mess with the subtemplate. – Jonesey95 (talk) 16:00, 5 December 2014 (UTC)
- Widely used templates are protected so only administrators can edit them, but the documentation of those templates is generally unprotected. Presumably this is because there are not enough administrators with the writing skills and interest to do the documentation of templates. But if anything in the unprotected documentation cam mess up VE, and the vandals hear about it, that's the end of VE. Jc3s5h (talk) 17:43, 5 December 2014 (UTC)
- All the more reason to separate the TemplateData text from the documentation page, via a subtemplate or other means. The subtemplate could be protected while leaving the documentation page available for editing by regular editors willing to do so. – Jonesey95 (talk) 17:51, 5 December 2014 (UTC)
- Thereby vastly increasing - virtually ensuring - the likelihood of the two not being kept in sync. Andy Mabbett (Pigsonthewing); Talk to Andy; Andy's edits 18:10, 5 December 2014 (UTC)
- Doc pages are rarely protected: it's nothing to do with admins not having "the writing skills and interest to do the documentation of templates", but because pages aren't pre-emptively protected - only when there is a demonstrable need to do so. Until TemplateData came along, a bad edit to a doc page would, at the worst, compromise the categories or interlanguage links for the template. A bad edit to the TemplateData also won't break anything on an article, although it might make the template more difficult to use in VE. Wikilinks don't work inside TemplateData and not just because the MediaWiki parser ignores Wiki markup inside
<templatedata>...</templatedata>
- the TemplateData is in JSON format, where the square bracket has a completely different meaning - it encloses an array, so a double square bracket encloses two nested arrays. --Redrose64 (talk) 18:17, 5 December 2014 (UTC)- Perhaps the answer, then is to have the documentation written in standardised, human-readable way (with links and formatting) and have a script (part of VE?) read it and convert that to JSON on the fly, when needed? Andy Mabbett (Pigsonthewing); Talk to Andy; Andy's edits 18:55, 5 December 2014 (UTC)
- I would agree with this. Some standardized documentation format that a machine could read, though probably not JSON because of its no-wiki-text limitations, that some specially developed tool could read would be at least better than what we have now.
<rant>
What we do have now is the VE crowd essentially saying to us: "We need this, so here is a limited functionality format, write our documentation for us, and, just to show what good guys we are, here is an editing tool for you to use to create and maintain our documentation for us. Yeah, it's marginally usable, but we think it's really quite pretty. Thanks, call us when it's done." You might get the impression that I object to this way of doing things. You would be right.
- I would agree with this. Some standardized documentation format that a machine could read, though probably not JSON because of its no-wiki-text limitations, that some specially developed tool could read would be at least better than what we have now.
- Perhaps the answer, then is to have the documentation written in standardised, human-readable way (with links and formatting) and have a script (part of VE?) read it and convert that to JSON on the fly, when needed? Andy Mabbett (Pigsonthewing); Talk to Andy; Andy's edits 18:55, 5 December 2014 (UTC)
- All the more reason to separate the TemplateData text from the documentation page, via a subtemplate or other means. The subtemplate could be protected while leaving the documentation page available for editing by regular editors willing to do so. – Jonesey95 (talk) 17:51, 5 December 2014 (UTC)
- Widely used templates are protected so only administrators can edit them, but the documentation of those templates is generally unprotected. Presumably this is because there are not enough administrators with the writing skills and interest to do the documentation of templates. But if anything in the unprotected documentation cam mess up VE, and the vandals hear about it, that's the end of VE. Jc3s5h (talk) 17:43, 5 December 2014 (UTC)
- Pigsonthewing and Jc3s5h, I was also surprised that modifying the documentation affected the functioning of a tool. That was the first time I had encountered this effect, and it seems like an undesirable coding practice to me. Perhaps, as a workaround, we should modify these citation template documentation pages so that the TemplateData section is contained within its own subtemplate, with comments before the subtemplate call and within the subtemplate itself explaining that changing the text within the subtemplate could cause problems with VE functioning. That way, someone like me doing straightforward editing of wikitext in the documentation would be alerted that There Be Dragons and I should not mess with the subtemplate. – Jonesey95 (talk) 16:00, 5 December 2014 (UTC)
- I object to having two sets of documentation to maintain; I object them both being visible at the same time. Can we at the least wrap
<TemplateData>...</TemplateData>
in<div style="display:none;">...</div>
so that it's out of sight?</rant>
- I object to having two sets of documentation to maintain; I object them both being visible at the same time. Can we at the least wrap
- Just so there isn't a misunderstanding: even though I object to the current state of affairs, that doesn't mean that I would not willingly participate in conversation directed toward a solution.
- —Trappist the monk (talk) 19:50, 6 December 2014 (UTC)
Can we at the least wrap
There is no need for it to be immediately visible - it can be wrapped in<TemplateData>...</TemplateData>
in<div style="display:none;">...</div>
so that it's out of sight?{{Cot|TemplateData}}
...{{Cob}}
so that it is obvious that it has been created, and those who want to look at it can expand it, but most people can just ignore it and look at the normal documentation. Obviously just an interim solution, being able to have a single, unified documentation would be better. - Evad37 [talk] 01:19, 7 December 2014 (UTC)
- —Trappist the monk (talk) 19:50, 6 December 2014 (UTC)
Documentation is still inconsistent
The above discussion wandered off to a valuable place, leading to some experiments in consolidating the template documentation with the TemplateData structure. I expect that those experiments and others like them will eventually lead somewhere useful.
But while we wait for that blessed day to arrive, the documentation pages Template:Cite journal/doc, Template:Cite book/doc, Template:Cite press release/doc, and Template:Cite news/doc are inconsistent in their application of hyphens to multi-word parameters. Per a July 2014 RFC on this page, the templates' "documentation is to show this lowercase, hyphenated version as the one for 'normal use'." We are operating in contravention of that RfC. The documentation also contains inaccurate information about when "et al." is displayed.
Any suggestions on how to resolve this inconsistency are welcome. You are also welcome to look at the diffs linked above, along with the subsequent page history, to see how to implement the fixes yourself. – Jonesey95 (talk) 05:27, 23 December 2014 (UTC)
Formatting of Cite news "issues" value not clear
We currently format the Cite news and Cite web as follows:
- "Title" Newspaper (2001). p.28.
- Author (2001). "Title of webpage"
In my opinion it is not clear that "2001" is an issue number. It is also also ambiguous with a date (especially when compared to the output of Cite web). Would formatting it as "issue #2001" be an improvement? Krinkle (talk) 05:48, 17 December 2014 (UTC)
- Perhaps. The rational behind certain styling choices may (or may not) be found in an archive somewhere. Isn't it true that the vast majority of newspapers, and consequently citations to same, are dated? Redrawing your examples:
{{cite news |author=Author |title=Title |newspaper=Newspaper |url=//example.org |date=24 July 2001 |issue=2001}}
- →Author (24 July 2001). "Title". Newspaper. No. 2001.
{{cite news}}
:|author=
has generic name (help) {{cite web |author=Author |title=Title |url=//example.org |website=Website |date=2001}}
- →Author (2001). "Title". Website.
{{cite web}}
:|author=
has generic name (help)
- the same without author:
|issue=
is also closely associated with|volume=
. How would you render|issue=
when|volume=
is present?
- It appears we uses the APA style here.[17] -- Gadget850 talk 13:55, 17 December 2014 (UTC)
- To summarize what Gadget850's link says, the issue is not the date the issue was published. Academic journals, and some magazines, are formally identified by volume and issue. Usually, a volume consists of all the issues printed during a year. The first year of publication would be volume 1, and so on. Each issue within the year is assigned a number (or sometimes an alphanumeric name, such as S1 for the first special issue). So the issue of QST I have at hand is volume 98 (the 98th year of publication) issue 12 (they print 12 issues per year; 12 is the December issue). Jc3s5h (talk) 14:12, 17 December 2014 (UTC)
- I believe that in Krinkle's example, the 2001 is an issue number.
- -- Gadget850 talk 14:24, 17 December 2014 (UTC)
- I believe Krinkle has probably misused the issue parameter to indicate the year (especially since the date is also 2001). Most publications set the issue number back to 1 at the beginning of each year, and it is unlikely a newspaper will have 2001 issues in a single year. (However, today's New York Times is Vol 164 issue 56,718. Apparently the NYT never resets the issue number and in the last 164 years they have published 56,718 issues.) Example:
- Ivory, Danielle; Ruiz, Rebbecca R. (December 17, 2014). "Recalls of Cars Abroad Prompt No U.S. Urgency". New York Times. Vol. 164, no. 56, 718.
- I believe Krinkle has probably misused the issue parameter to indicate the year (especially since the date is also 2001). Most publications set the issue number back to 1 at the beginning of each year, and it is unlikely a newspaper will have 2001 issues in a single year. (However, today's New York Times is Vol 164 issue 56,718. Apparently the NYT never resets the issue number and in the last 164 years they have published 56,718 issues.) Example:
- It is confusing if the editor fails to supply a volume parameter. Perhaps a solution is to create an error message if the issue (or the synonym number) is given but the volume is not given. Jc3s5h (talk) 15:20, 17 December 2014 (UTC)
- Jc3s5h (talk) 15:11, 17 December 2014 (UTC)
- While I can't point a finger at one, I'm pretty sure that I've seen citations that correctly used
|issue=
or|number=
without|volume=
.
- While I can't point a finger at one, I'm pretty sure that I've seen citations that correctly used
- —Trappist the monk (talk) 16:05, 17 December 2014 (UTC)
- Here's an actual journal that uses "number" but does not organize issues by volume at all: http://www.reei.org/revista/anteriores.php. I have seen others cited in WP. – Jonesey95 (talk) 17:34, 17 December 2014 (UTC)
- —Trappist the monk (talk) 16:05, 17 December 2014 (UTC)
The documentation from 2007 for cite journal had this to say:
- volume: Volume number of the journal in which the article is found
- issue: Issue number of the journal in which the article is found
It seems the process of combining the documentation from all the cite templates into one has confused the meaning of volume and issue. They really have different connotations for periodicals than they do for books or websites. (Books don't have issues, and who knows what "issue" would mean for a website.) Clearly our format was chosen to present either a volume and issue, or a volume alone (the latter would be appropriate if the page numbering is continuous throughout the volume). So if we want to keep the format the way it is, we shouldn't allow issue without volume; let the editor put suitable wording in the "at" parameter. If we want to support issue alone, we need to change the format of the citation as presented to the reader. Jc3s5h (talk) 17:47, 17 December 2014 (UTC)
Another comment: if the location of the date were made consistent, always the second element, after the author(s) if there are any, or after the title if there are no authors, it would at least be clear that a number in parentheses later in the citation isn't a date. This is already on the list of things to do. Jc3s5h (talk) 18:00, 17 December 2014 (UTC)
- We cannot assume that
|issue=n
without|volume=
is an error. The use of issue numbers is not confined to academic journals; many other periodicals - including newspapers and magazines - have issue numbers and not all have volume numbers. --Redrose64 (talk) 19:15, 17 December 2014 (UTC)- Something else that could be noted, is that volume and issue aren't exactly useful information for newspapers. If I were to look for today's edition of The Mining Journal, the local paper for my hometown, and I needed to pull it off microfilm, I'll be looking by "December 17, 2014", not "volume 12, issue 349" because the libraries don't index the volume/issue numbers on the microfilm reels. On the other hand, if I'm looking at my local university library for academic journals, they'll usually be bound by volume number. Sometimes they might be bound, microfilmed, or digitized by year of publication. Magazines could be either way, but by date is more common in my experience.
- Anyway, I'd be in favor of setting up {{cite news}} and {{cite journal}} to use the "VV (II): pp" format consistently unless only a page or page range is provided, at which point the "p." or "pp." appears. Imzadi 1979 → 21:36, 17 December 2014 (UTC)
There are actually two distinct meanings of "volume" for books, by the way. If the book is part of a numbered series, indicated in our templates with |series=
, then |volume=
is its number in that series. And if it is a single book that for reasons of length was split into multiple volumes, but is not part of a series, and we want to refer to something in one of those volumes, then |volume=
indicates which one. Often the individual volumes have subtitles as well but then it works better to put that in the title: |title=Winning Ways for your Mathematical Plays, Vol. I: Games in General
. I don't know of a good way of indicating both kinds of volumes for the same book (as sometimes happens) using |volume=
parameters. And I don't know of a good way to indicate the multiple-pieces-of-a-single-text meaning for a book that also indicates the series it's in, e.g. my copy of Heath's Euclid is published in three volumes (further split into 13 books, something else we don't have a good way to indicate) but is part of the unnumbered series "Dover Books on Advanced Mathematics". —David Eppstein (talk) 21:25, 18 December 2014 (UTC)
template | volume | issue | page(s) | at |
---|---|---|---|---|
{{citation}} | ![]() |
![]() |
![]() |
![]() |
{{cite AV media}} | No | No | No | ? |
{{cite AV media notes}} | No | No | ![]() |
![]() |
{{cite book}} | ![]() |
![]() |
![]() |
![]() |
{{cite conference}} | ![]() |
![]() |
![]() |
![]() |
{{cite DVD notes}} | No | No | ![]() |
![]() |
{{cite encyclopedia}} | ![]() |
![]() |
![]() |
![]() |
{{cite episode}} | No | No | No | ? |
{{cite interview}} | No | No | No | ? |
{{cite journal}} | ![]() |
![]() |
![]() |
![]() |
{{cite mailing list}} | No | No | No | X |
{{cite map}} | ![]() |
![]() |
![]() |
? |
{{cite news}} | ![]() |
![]() |
![]() |
![]() |
{{cite newsgroup}} | No | No | No | X |
{{cite podcast}} | No | No | No | ? |
{{cite press release}} | No | No | No | X |
{{cite report}} | ? | ? | ![]() |
![]() |
{{cite serial}} | No | No | No | ? |
{{cite sign}} | No | No | No | X |
{{cite speech}} | No | No | No | X |
{{cite techreport}} | ? | ? | ![]() |
![]() |
{{cite thesis}} | No | No | ![]() |
![]() |
{{cite web}} | No | No | ? | ![]() |
A previous post in this thread got me wondering where use of the various parameters |volume=
, |issue=
, |page(s)=
, and |at=
is appropriate. So I concocted this table. It seemed to me that |at=
might have application in any template but, for those templates where the at column is ? , a better in-source location identifier parameter exists or should exist: |time=
, |minutes=
comes to mind; for maps we have |section=
.
For those templates where the at column is X , it isn't clear to me that there is much use for |at=
, but I could be persuaded either way.
In the other columns, ? marks parameters and templates where I'm not sure that the parameters should be supported but can imagine that there are times when they should.
So then the question is: what do we do with this? Do we do nothing? Do we make decisions about the templates/parameters marked ? and X and then adopt the result of the decisions?
—Trappist the monk (talk) 14:05, 19 December 2014 (UTC)
- The documentation for cite interview and speech both indicate they may be used for published works, not just broadcasts. Press releases may extend over several pages on occasion. So the page/pages parameters apply to these. In the case of interviews, they are often contained in magazines or newspapers, so all the parameters for cite journal apply to cite interview. Jc3s5h (talk) 15:24, 19 December 2014 (UTC)
- If a speech or interview is published as a transcription then it seems to me that
{{cite interview}}
and{{cite speech}}
are the wrong templates to be using and that the correct template is{{cite book}}
,{{cite news}}
,{{cite journal}}
, etc. If the cited speech or interview is an audio or video recording then the correct template is{{cite AV media}}
,{{cite podcast}}
, etc.
- If a speech or interview is published as a transcription then it seems to me that
-
- Except that they more precisely identify for the editor reading raw wikitext what is being cited, a speech or interview as opposed to the more general magazine or video, I'm not sure there is much real benefit gained by having
{{cite interview}}
and{{cite speech}}
.
- Except that they more precisely identify for the editor reading raw wikitext what is being cited, a speech or interview as opposed to the more general magazine or video, I'm not sure there is much real benefit gained by having
-
- —Trappist the monk (talk) 13:44, 20 December 2014 (UTC)
- Two distinctions between interview citations and regular citations. One is that they are alphabetized according to who gave the interview rather than the journalist who conducted the interview. The other is that in place of a title there may be a description of who was interviewed. Here is an example from page 745 of Chicago 14th edition, which has similar distinctions to "cite interview"; I've adapted the example to Wikipedia templates:
- Cite interview:
- Bellour, Raymond (Summer 1979). "Alternation, Segmentation, Hypnosis: Interview with Ramond Bellour". Camera Obscura (Interview). No. 2–3. Interviewed by Janet Bergstrom. pp. 89–94.
- Cite journal:
- Bergstrom, Janet (Summer 1979). "Alternation, Segmentation, Hypnosis: Interview with Ramond Bellour". Camera Obscura (2–3): 89–94.
- We can see that the title handling in cite interview has become defective. Jc3s5h (talk) 15:49, 20 December 2014 (UTC)
-
- Agreed. For this interview,
{{cite interview}}
is flawed;{{cite journal}}
is much more appropriate. Here I've extended the citation as{{cite journal}}
:- Bergstrom, Janet; Bellour, Raymond (Summer 1979). "Alternation, Segmentation, Hypnosis: Interview with Raymond Bellour". Camera Obscura. 1–2 (3-1 3-4): 70–103. doi:10.1215/02705346-1-2-3-1_3-4-70.
- I also changed author order because in the journal's TOC Bergstrom is credited as the author (here and here).
- —Trappist the monk (talk) 13:37, 24 December 2014 (UTC)
- Agreed. For this interview,
- —Trappist the monk (talk) 13:44, 20 December 2014 (UTC)
- As for maps, they can appear on specific pages of an atlas or even within a journal/magazine, so while
|section=
|inset=
or both names a specific location within the map, we'd still need a way to specify the location of the map within a larger source. I've had to use|at=
to specify multiple separate maps within an atlas or a main map plus an inset at the same time. (I've also wondered if the location information for maps shouldn't be in "VV (II): pp" format, with "p." or "pp." appearing where a volume or issue isn't defined, followed by the inset name and lastly the map section [prefaced with "§" for a single section or "§§" for multiple grid sections].) Imzadi 1979 → 17:29, 19 December 2014 (UTC)- I was thinking of maps as if they were encyclopedia-like in content and form where there would be
- map name → atlas name → volume → number → page → inset → section(s)
- or
- map name → atlas name → volume → number → pages
- I was thinking of maps as if they were encyclopedia-like in content and form where there would be
-
- I can imagine that
|at=
would be appropriate when identifying a particular layer of a GIS map. But, since{{cite map}}
isn't yet part of Module:Citation/CS1 these are things to think about in the future.
- I can imagine that
- As for maps, they can appear on specific pages of an atlas or even within a journal/magazine, so while
I believe that the use of 2001 as the issue in the example was to illustrate that the date and issue have the potential for confusion. -- Gadget850 talk 03:13, 25 December 2014 (UTC)
Slight improvement to deprecated parameter error message
In this example there are three deprecated parameter. Instead of the current generic error message, the new error message identifies the first, usually the only, deprecated parameter it encounters when processing the citation:
Wikitext | {{cite book
|
---|---|
Live | Author (2014). Title. {{cite book}} : |author= has generic name (help); Unknown parameter |coauthor= ignored (|author= suggested) (help); Unknown parameter |month= ignored (help); Unknown parameter |separator= ignored (help)
|
Sandbox | Author (2014). Title. {{cite book}} : |author= has generic name (help); Unknown parameter |coauthor= ignored (|author= suggested) (help); Unknown parameter |month= ignored (help); Unknown parameter |separator= ignored (help)
|
—Trappist the monk (talk) 22:35, 20 December 2014 (UTC)
- ...and when a user fixes the deprecated parameter in the sandbox's error message, they would see then get an error for the next deprecated parameter:
Wikitext | {{cite book
|
---|---|
Live | Author; Coauthor (2014). Title. {{cite book}} : |author= has generic name (help); Unknown parameter |month= ignored (help); Unknown parameter |separator= ignored (help)
|
Sandbox | Author; Coauthor (2014). Title. {{cite book}} : |author= has generic name (help); Unknown parameter |month= ignored (help); Unknown parameter |separator= ignored (help)
|
- -GoingBatty (talk) 23:27, 20 December 2014 (UTC)
- Only if there are more than one deprecated parameter in the template. I did label this topic 'Slight improvement ...'.
- —Trappist the monk (talk) 23:42, 20 December 2014 (UTC)
- I like the idea. When reading an article with a flagged ref (or any sort of tagging really), I'm more likely to edit if it actually tells me a (or at least one) specific thing that is wrong that I recognize how to fix rather than having to work harder to even know the problem. However, I would like to see the message retain some note that there is not just the one specifically-identified problem. Drawing attention that there are multiple problems might help pull in someone interested in making more changes (or at least a louder warning about a more problematic situation). And also, it's somewhat annoying to Show-preview to check ref corrections. If I only see evidence of one easily-fixed problem and I fix it, I'm liable not to get as far as seeing that there is still a remaining new-and-different error message. DMacks (talk) 06:12, 22 December 2014 (UTC)
- —Trappist the monk (talk) 23:42, 20 December 2014 (UTC)
- Yeah, ultimately I hope to make this particular error message report all of the deprecated parameters in a template. Not yet.
Adding long text to footnotes
An editor used this citation style, and then added what seemed to be unnecessary text to the citation. In their edit summary they defended this by stating Cite_web Quote. To me it seems as if information is being added to a footnote that probably should have been added to the article, or it's just restate what's already in the article. Any help on the use of this method to add detailed text to footnotes would be appreciated. Thanks. Magnolia677 (talk) 05:51, 22 December 2014 (UTC)
- I am one of many editors who have added brief quotations to references to thousands of articles across Wikipedia using the "Quote=" parameter of the citation templates. The purpose is to provide a sample of the text that supports the material being referenced in the article. As I understand it, this is a design feature of the citation templates, but there is no policy that requires any editor to use the parameter nor anyone that prohibits its use. In Wikipedia, nothing is necessary other than reliable and verifiable sources, and this quote parameter allows editors who choose to use the feature to document the references more carefully. See the good article for Manhattan (footnotes 48, 53, 59, 62, 76, 245, etc.) and the featured article 7 World Trade Center (footnote 22), with many more examples available among Wikipedia's best articles. Alansohn (talk) 06:07, 22 December 2014 (UTC)
- I'm one who thinks that
|quote=
is much too much overused. If you hunt about in the archives of this page, or one of its progenitors, you'll find the brief squabble that resulted from the undiscussed addition of|quote=
where the rationale for the addition was something to the effect of "I needed it, so I added it". That initial edit was reverted but the reverting editor couldn't muster sufficient opposition to make the revert stick. So now, we're stuck with|quote=
. That is hardly what I would call design.
- I'm one who thinks that
- Because they were offered as examples of the proper use of
|quote=
, I looked. Mannhatten 48 is used two times in the article. The text in|quote=
pretty clearly applies to first use of the reference; not so clear for the second use of the citation. Reuse of the citations with|quote=
becomes problematic when the quotation doesn't quite apply in all uses of the citation.
- Because they were offered as examples of the proper use of
- At 7 World Trade Center 22, it isn't clear to me what it is that Mayor Giuliani is talking about. Likewise, it is not clear to me how the quotation supports the two sentences that precede its placement in the article. The quoted sentence is pretty scrambled and doesn't easily parse.
- Thank you for your response. I've been trying to improve and create new articles about the US state of New Jersey, and noticed that this editor has added lengthy "para quotes" to hundreds of articles about that state. In my opinion, they add useless text to the reference section of articles. I'm reluctant to begin removing them without some policy or consensus to support me. Trappist the monk, could a discussion be started again to evaluate the use of "para quote"? Thanks! Magnolia677 (talk) 13:27, 22 December 2014 (UTC)
- It isn't "para quote" but is a template
{{para}}
with a parameter value ofquote
so{{para|quote}}
renders thus:|quote=
.
- It isn't "para quote" but is a template
- In your initial post you refer to this edit which does not use Citation Style 1 even though the edit summary uses CS1 as partial justification. Because that case isn't CS1-specific, this talk page is probably not the best place to raise the broader issue of quotations in citations. You might consider raising the broad topic at Wikipedia talk:Citing sources.
- Before you do that, you might want to read WP:CITE#Links and ID numbers, WP:CITE#Additional annotation, and WP:CITE#Indicating availability and also search the WT:CITE archives for any previous discussion.
- Your discussion of the history of the
|quote=
parameter is an ideal metaphor for its continued usage. Some editors preferred it when the templates were being created, some opposed it, but it remains a design feature -- not a bug -- in one of Wikipedia's most used templates. Now that it exists, some editors prefer to use it and some don't, but edit warring to squabble over its use by those editors who take advantage of this feature seems extremely counterproductive. You oppose it, and you are entirely free to eschew its usage in references. Using WP:ENGVAR or the more relevant WP:CITEVAR as a model, it would seem that no one should be forced to use or not use quotations in references and that edit warring on the matter should be explicitly prohibited. Alansohn (talk) 14:49, 22 December 2014 (UTC)
- Your discussion of the history of the
- Here is the discussion that followed the initial introduction of
|quote=
to{{cite book}}
.
- Here is the discussion that followed the initial introduction of
- I'm confused. Not sure how describing the history of
|quote=
is metaphorical. Both WP:ENGVAR and WP:CITEVAR boil down to "don't change established ______" (fill in the blank) without consensus to make the change, right? So then, without successful solicitations for consensus, adding quotations to citations where quotations were not previously included is not permitted under your example. Of course, the reverse would be the same. And why are you accusing me of edit warring?
- I'm confused. Not sure how describing the history of
- Nonsense. If an article uses CS1, pretty much any CS1 template, and pretty much any parameter of those templates could be used. For example, an article that up to a certain time had only used cite journal could have a new passage with cite book added. There would be some changes that would violate WP:CITEVAR, such as changing all the separators from periods to commas. Jc3s5h (talk) 16:15, 22 December 2014 (UTC)
- That is exactly what I meant. Editor Alansohn invoked WP:ENGVAR and WP:CITEVAR (not I) apparently as armatures for the construction of some sort of new 'rule'. My intent was to point out the cost of Editor Alansohn's example 'rule'.
- "|quote=" is a great feature. No one requires you to read it, but they are there for those who need them to compare the original wording to the wording used in Wikipedia to make sure we are not undergoing semantic drift. Each editor changes the wording slightly until it is incorrect. More and more references are behind paywalls or a gone from the web through link rot so unless we store the actual text we are quoting there will be nothing to compare to. --Richard Arthur Norton (1958- ) (talk) 17:13, 22 December 2014 (UTC)
- The way I have seen this applied is as follows...
- An editor reads a piece of text in a reliable source, and then adds that information to a Wiki article in the form of a paraphrase.
- To support the information they added to the Wiki article, they include a citation, which also includes a direct quotation from the reliable source they paraphrased.
- For example, an editor adds -- Fred Smith immigrated from Foo in 1920 and settled in Maple Creek (not in quotes) -- to the body of a Wiki article.
- To support this edit, they add a citation, and in that citation--in addition to information about the author, date, and so forth--they also add the following direct quotation from the source: "In 1920, Fred Smith settled in Maple Creek after immigrating from Foo".
- My concern is that every Wiki article will soon become two articles. The first part will be the paraphrased text added to the body. The second will be the enormous reference sections filled with direct quotes, which support what was added to the body.
- This is how I have seen this used.
- Is there a more efficient way to avoid link rot, preserve the original text, and ensure honest paraphrasing? Thanks. Magnolia677 (talk) 18:16, 22 December 2014 (UTC)
- I don't know if it is more efficient, but you can preemptively archive web pages at Internet Archive and WebCite and then include the archived urls in CS1/2 templates with
|archive-url=
and|archive-date=
.
- I don't know if it is more efficient, but you can preemptively archive web pages at Internet Archive and WebCite and then include the archived urls in CS1/2 templates with
- That doesn't answer Editor Richard Arthur Norton's concerns about paywalls, of course, but there is no requirement that reliable sources be easily available or free of cost.
- My textbooks, between the table of contents, the index and the endnotes are up to 30% of the pages. No one requires me to read them, my eyes goes right past them, never registering that they exist ... until I need them, then they are indispensable. I suppose some people cannot ignore them and they become obtrusive. Before the cold open was invented, you used to have to sit through 5 minutes of credits at the beginning of a film. That was harder to ignore. --Richard Arthur Norton (1958- ) (talk) 00:53, 24 December 2014 (UTC)
- That doesn't answer Editor Richard Arthur Norton's concerns about paywalls, of course, but there is no requirement that reliable sources be easily available or free of cost.
- —Trappist the monk (talk) 20:22, 22 December 2014 (UTC)
- It's not uncommon to run into footnotes with limited quoted matter in off-wiki writing. I know that it is somewhat common in the Chicago footnote system. I'm troubled by editors quoting full paragraphs within a footnote. I've found this done frequently in some Washington state highway articles where whole paragraphs of a statute amending the routing of a highway are pasted into the footnote. If the statute were subject to copyright, we'd be pushing the boundaries of fair-use by quoting that much material. In most cases, the reference to a source that can be obtained through a library somewhere is sufficient, and in the case of online-only sources, pre-emptive archival is a great option as Trappist mentions. Quoted material in the footnote may help in some cases to emphasize a point, but it should be done sparingly. Imzadi 1979 → 20:59, 22 December 2014 (UTC)
- —Trappist the monk (talk) 20:22, 22 December 2014 (UTC)
Two authors
The ampersand no longer appears for this; there's a ; instead. Myrvin (talk) 07:57, 22 December 2014 (UTC)
Never did. Here's a comparison between the old {{citation/core}}
and the current Module:Citation/CS1 renderings of a simple {{cite book}}
with two authors:
Wikitext | {{cite book
|
---|---|
Live | Author; Author2. Title. {{cite book}} : |author= has generic name (help)CS1 maint: numeric names: authors list (link)
|
Sandbox | Author; Author2. Title. {{cite book}} : |author= has generic name (help)CS1 maint: numeric names: authors list (link)
|
—Trappist the monk (talk) 10:19, 22 December 2014 (UTC)
Thanks. I missed |last-author-amp=yes. Myrvin (talk) 11:23, 22 December 2014 (UTC)
date=Autumn 1982 – Winter 1983
I have just added a citation (currently footnote one, in the infobox) to Jean Rhys. The Template:cite journal refers to a double-issue of a journal issued quarterly, the appropriate date is "Autumn 1982 – Winter 1983". The footnote appears with the red-letter warning that the date is not in an appropriate format and a link to the appropriate help. I tried several variants, none of them appear without the warning. Is it me, or does the date-checker need tweaking? Choor monster (talk) 16:33, 23 December 2014 (UTC)
- A rather poor choice of dates on boudary 2's part. Which winter are they describing? The winter of 1 January – 21 March 1983 or the winter of 23 September – 31 December 1983? But, that is not why there is an error message. The error message is because the date contains the template
{{snd}}
which adds this to the date: – 
- Replace that mess with a simple endash and get this:
- —Trappist the monk (talk) 17:29, 23 December 2014 (UTC)
- It's too bad you can't use the – html entity. Some people, like me, don't use the editor options that display possible symbols below the edit box. Even when I did, I had trouble telling the difference between all the dash-like marks that are available. Example:
- Gardiner, Judith Kegan (Autumn 1982 – Winter 1983). "Good Morning, Midnight; Good Night, Modernism". boundary 2. 11 (1/2): 233–51. JSTOR 303027.
{{cite journal}}
: Check date values in:|date=
(help)
- Gardiner, Judith Kegan (Autumn 1982 – Winter 1983). "Good Morning, Midnight; Good Night, Modernism". boundary 2. 11 (1/2): 233–51. JSTOR 303027.
- Jc3s5h (talk) 17:42, 23 December 2014 (UTC)
- It's too bad you can't use the – html entity. Some people, like me, don't use the editor options that display possible symbols below the edit box. Even when I did, I had trouble telling the difference between all the dash-like marks that are available. Example:
- You can use
{{ndash}}
.
- You can use
- I used the explicit version, it worked perfectly, although I prefer markup and templates whenever possible. Thanks very much. As to "which" winter, so far as I have noticed, quarterlies that date themselves by the season always use "Winter YYYY" for the issue corresponding to January YYYY. Choor monster (talk) 18:21, 23 December 2014 (UTC)
Date using in the format p.e. "2014-12-26"
Hi, please excuse that xx question, but so i use the template by p.e. <ref name="xxxx">{{cite web|url=http://wasauchimmer.com|title=Titel|publisher=Beispiel|author=|language=German|date=2014-12-01|accessdate=2014-12-26}}</ref>
.... what parameters do i have to set to have shown in a related wiki 1. ^ "Titel" (in German). Beispiel. 1 December 2014. Retrieved 26 December 2014.
? btw: within p.e. DE-WP the date is 'automatically' shown in the long-date-format, that's why i'm asking. Thank you very much for a short explaination, and my best season greetings :-) Roland zh (talk) 03:40, 26 December 2014 (UTC)
- I do not know what p.e. is.
- At en-wp, dates are not automatic. If you want 1 December 2014 then
|date=1 December 2014
. Does that answer the question? - —Trappist the monk (talk) 04:12, 26 December 2014 (UTC)
- Hi, and thank you. ok, no automatization, but so another Wikipedian, p.e. (for example) from the USA, UK or another native English speaking country, may also write, for example
|date=1st December 2014
?|date=December 1, 2014
?|date=1(st) of December 2014
?
- That's why i asked to avoid date-related miss-understandings and re-editting 'just' related to that topic ;-)
- So there are no other opinions, it's recommended always to write the long-date-from
|date=1 December 2014
as mentioned, or the short 'international' form|date=2014-12-01
? - Thank you and kindly regards, Roland zh (talk) 04:36, 26 December 2014 (UTC)
- It depends on context. For publication dates, I would write out the date long-form, but for access dates to urls I usually use the short 2014-12-25 format. There's also another complication related to WP:ENGVAR and MOS:DATETIES: for topics related to England or the former British colonies, the format 25 December 2014 is usually more appropriate, but for US-related topics the format December 25, 2014 is more appropriate. And for topics that have no specific nationality (or another nationality), we should stick with whatever format is already in use (and in any case keep the format consistent within each article). —David Eppstein (talk) 04:55, 26 December 2014 (UTC)
|date=1 December 2014
?Yes
|date=December 1, 2014
?Yes
|date=2014-12-01
?Yes
|date=1st December 2014
?No
|date=1(st) of December 2014
?No
- —Trappist the monk (talk) 12:10, 26 December 2014 (UTC)
- Er, Trappist the monk, since when was
|date=1st December 2014
permitted? Did you mean|date=1 December 2014
? --Redrose64 (talk) 00:01, 27 December 2014 (UTC)- Its not. Fixed.
- —Trappist the monk (talk) 00:10, 27 December 2014 (UTC)
- Er, Trappist the monk, since when was
- Hi, and thank you. ok, no automatization, but so another Wikipedian, p.e. (for example) from the USA, UK or another native English speaking country, may also write, for example
Portal di Ensiklopedia Dunia