summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/citation-style-language/styles/apa.csl
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/tex/latex/citation-style-language/styles/apa.csl')
-rw-r--r--Master/texmf-dist/tex/latex/citation-style-language/styles/apa.csl519
1 files changed, 151 insertions, 368 deletions
diff --git a/Master/texmf-dist/tex/latex/citation-style-language/styles/apa.csl b/Master/texmf-dist/tex/latex/citation-style-language/styles/apa.csl
index a71a9926895..3734d8d76e1 100644
--- a/Master/texmf-dist/tex/latex/citation-style-language/styles/apa.csl
+++ b/Master/texmf-dist/tex/latex/citation-style-language/styles/apa.csl
@@ -14,7 +14,7 @@
<category citation-format="author-date"/>
<category field="psychology"/>
<category field="generic-base"/>
- <updated>2023-05-13T12:14:52-04:00</updated>
+ <updated>2023-07-16T18:56:49-04:00</updated>
<rights license="http://creativecommons.org/licenses/by-sa/3.0/">This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 License</rights>
</info>
<locale xml:lang="en">
@@ -35,298 +35,88 @@
<term name="circa" form="short">ca.</term>
<term name="bc"> B.C.E.</term>
<term name="ad"> C.E.</term>
- <term name="letter">personal communication</term>
- <term name="letter" form="short">letter</term>
<term name="issue" form="long">
<single>issue</single>
<multiple>issues</multiple>
</term>
- </terms>
- </locale>
- <locale xml:lang="af">
- <terms>
- <term name="letter">persoonlike kommunikasie</term>
- <term name="letter" form="short">brief</term>
- </terms>
- </locale>
- <locale xml:lang="ar">
- <terms>
- <term name="letter">اتصال شخصي</term>
- <term name="letter" form="short">خطاب</term>
- </terms>
- </locale>
- <locale xml:lang="bg">
- <terms>
- <term name="letter">лична комуникация</term>
- <term name="letter" form="short">писмо</term>
- </terms>
- </locale>
- <locale xml:lang="ca">
- <terms>
- <term name="letter">comunicació personal</term>
- <term name="letter" form="short">carta</term>
- </terms>
- </locale>
- <locale xml:lang="cs">
- <terms>
- <term name="letter">osobní komunikace</term>
- <term name="letter" form="short">dopis</term>
- </terms>
- </locale>
- <locale xml:lang="cy">
- <terms>
- <term name="letter">cyfathrebu personol</term>
- <term name="letter" form="short">llythyr</term>
+ <term name="software">computer software</term>
</terms>
</locale>
<locale xml:lang="da">
<terms>
<term name="et-al">et al.</term>
- <term name="letter">personlig kommunikation</term>
- <term name="letter" form="short">brev</term>
</terms>
</locale>
<locale xml:lang="de">
<terms>
<term name="et-al">et al.</term>
- <term name="letter">persönliche Kommunikation</term>
- <term name="letter" form="short">Brief</term>
- </terms>
- </locale>
- <locale xml:lang="el">
- <terms>
- <term name="letter">προσωπική επικοινωνία</term>
- <term name="letter" form="short">επιστολή</term>
</terms>
</locale>
<locale xml:lang="es">
<terms>
<term name="from">de</term>
- <term name="letter">comunicación personal</term>
- <term name="letter" form="short">carta</term>
- </terms>
- </locale>
- <locale xml:lang="et">
- <terms>
- <term name="letter">isiklik suhtlus</term>
- <term name="letter" form="short">kiri</term>
- </terms>
- </locale>
- <locale xml:lang="eu">
- <terms>
- <term name="letter">komunikazio pertsonala</term>
- <term name="letter" form="short">gutuna</term>
- </terms>
- </locale>
- <locale xml:lang="fa">
- <terms>
- <term name="letter">ارتباط شخصی</term>
- <term name="letter" form="short">نامه</term>
- </terms>
- </locale>
- <locale xml:lang="fi">
- <terms>
- <term name="letter">henkilökohtainen viestintä</term>
- <term name="letter" form="short">kirje</term>
</terms>
</locale>
<locale xml:lang="fr">
<terms>
- <term name="letter">communication personnelle</term>
- <term name="letter" form="short">lettre</term>
<term name="editor" form="short">
<single>éd.</single>
<multiple>éds.</multiple>
</term>
</terms>
</locale>
- <locale xml:lang="he">
- <terms>
- <term name="letter">תקשורת אישית</term>
- <term name="letter" form="short">מכתב</term>
- </terms>
- </locale>
- <locale xml:lang="hr">
- <terms>
- <term name="letter">osobna komunikacija</term>
- <term name="letter" form="short">pismo</term>
- </terms>
- </locale>
- <locale xml:lang="hu">
- <terms>
- <term name="letter">személyes kommunikáció</term>
- <term name="letter" form="short">levél</term>
- </terms>
- </locale>
- <locale xml:lang="id">
- <terms>
- <term name="letter">komunikasi pribadi</term>
- <term name="letter" form="short">surat</term>
- </terms>
- </locale>
- <locale xml:lang="is">
- <terms>
- <term name="letter">persónuleg samskipti</term>
- <term name="letter" form="short">bréf</term>
- </terms>
- </locale>
- <locale xml:lang="it">
- <terms>
- <term name="letter">comunicazione personale</term>
- <term name="letter" form="short">lettera</term>
- </terms>
- </locale>
- <locale xml:lang="ja">
- <terms>
- <term name="letter">個人的なやり取り</term>
- <term name="letter" form="short">手紙</term>
- </terms>
- </locale>
- <locale xml:lang="ko">
- <terms>
- <term name="letter">개인 서신</term>
- <term name="letter" form="short">편지</term>
- </terms>
- </locale>
- <locale xml:lang="la">
- <terms>
- <term name="letter"/>
- <term name="letter" form="short">epistula</term>
- </terms>
- </locale>
- <locale xml:lang="lt">
- <terms>
- <term name="letter">communicationis personalis</term>
- <term name="letter" form="short"/>
- </terms>
- </locale>
- <locale xml:lang="lv">
- <terms>
- <term name="letter">personīga komunikācija</term>
- <term name="letter" form="short">vēstule</term>
- </terms>
- </locale>
- <locale xml:lang="mn">
- <terms>
- <term name="letter">хувийн харилцаа холбоо</term>
- <term name="letter" form="short">захиа</term>
- </terms>
- </locale>
<locale xml:lang="nb">
<terms>
<term name="et-al">et al.</term>
- <term name="letter">personlig kommunikasjon</term>
- <term name="letter" form="short">brev</term>
</terms>
</locale>
<locale xml:lang="nl">
<terms>
<term name="et-al">et al.</term>
- <term name="letter">persoonlijke communicatie</term>
- <term name="letter" form="short">brief</term>
</terms>
</locale>
<locale xml:lang="nn">
<terms>
<term name="et-al">et al.</term>
- <term name="letter">personlig kommunikasjon</term>
- <term name="letter" form="short">brev</term>
- </terms>
- </locale>
- <locale xml:lang="pl">
- <terms>
- <term name="letter">osobista komunikacja</term>
- <term name="letter" form="short">list</term>
- </terms>
- </locale>
- <locale xml:lang="pt">
- <terms>
- <term name="letter">comunicação pessoal</term>
- <term name="letter" form="short">carta</term>
- </terms>
- </locale>
- <locale xml:lang="ro">
- <terms>
- <term name="letter">comunicare personală</term>
- <term name="letter" form="short">scrisoare</term>
- </terms>
- </locale>
- <locale xml:lang="ru">
- <terms>
- <term name="letter">личная переписка</term>
- <term name="letter" form="short">письмо</term>
- </terms>
- </locale>
- <locale xml:lang="sk">
- <terms>
- <term name="letter">osobná komunikácia</term>
- <term name="letter" form="short">list</term>
- </terms>
- </locale>
- <locale xml:lang="sl">
- <terms>
- <term name="letter">osebna komunikacija</term>
- <term name="letter" form="short">pismo</term>
- </terms>
- </locale>
- <locale xml:lang="sr">
- <terms>
- <term name="letter">лична комуникација</term>
- <term name="letter" form="short">писмо</term>
- </terms>
- </locale>
- <locale xml:lang="sv">
- <terms>
- <term name="letter">personlig kommunikation</term>
- <term name="letter" form="short">brev</term>
- </terms>
- </locale>
- <locale xml:lang="th">
- <terms>
- <term name="letter">การสื่อสารส่วนบุคคล</term>
- <term name="letter" form="short">จดหมาย</term>
- </terms>
- </locale>
- <locale xml:lang="tr">
- <terms>
- <term name="letter">kişisel iletişim</term>
- <term name="letter" form="short">mektup</term>
- </terms>
- </locale>
- <locale xml:lang="uk">
- <terms>
- <term name="letter">особисте спілкування</term>
- <term name="letter" form="short">лист</term>
- </terms>
- </locale>
- <locale xml:lang="vi">
- <terms>
- <term name="letter">giao tiếp cá nhân</term>
- <term name="letter" form="short">thư</term>
- </terms>
- </locale>
- <locale xml:lang="zh-CN">
- <terms>
- <term name="letter">的私人交流</term>
- <term name="letter" form="short">信函</term>
- </terms>
- </locale>
- <locale xml:lang="zh-TW">
- <terms>
- <term name="letter">私人通訊</term>
- <term name="letter" form="short">信函</term>
</terms>
</locale>
+ <!-- TODO: New types: classic collection document event hearing performance periodical regulation -software- standard -->
+ <!-- TODO: New creator roles: chair compiler contributor curator executive-producer guest host narrator organizer performer producer script-writer series-creator -->
+ <!-- TODO: New variables:
+ available-date submitted
+ part-number printing-number supplement-number
+ part-title volume-title
+ archive_collection
+ division jurisdiction
+ event-title
+ language
+ license
+ reviewed-genre
+ -->
+ <!-- TODO: New terms:
+ advance-online-publication
+ album on audio-recording
+ original-work-published
+ personal-communication
+ preprint
+ review-of
+ item types
+ -->
+ <!-- TODO: Check Indigeneous Knowledge format -->
<!-- General categories of item types:
Periodical: article-journal article-magazine article-newspaper post-weblog review review-book
Periodical or Booklike: paper-conference
- Booklike: article book broadcast chapter dataset entry entry-dictionary entry-encyclopedia figure
+ Booklike: article book broadcast chapter classic collection dataset document
+ entry entry-dictionary entry-encyclopedia event figure
graphic interview manuscript map motion_picture musical_score pamphlet patent
- personal_communication report song speech thesis post webpage
- Legal: bill legal_case legislation treaty
+ performance periodical personal_communication post report
+ software song speech standard thesis webpage
+ Legal: bill hearing legal_case legislation regulation treaty
-->
<!-- APA references contain four parts: author, date, title, source -->
<macro name="author-bib">
+ <!-- TODO: New creator roles (media, contributor) -->
+ <!-- TODO: Add new item types -->
<names variable="composer" delimiter=", ">
<name name-as-sort-order="all" and="symbol" sort-separator=", " initialize-with=". " delimiter=", " delimiter-precedes-last="always"/>
<substitute>
@@ -355,7 +145,7 @@
</choose>
</if>
</choose>
- <!-- Test for editortranslator and put that first as that becomes available -->
+ <!-- TODO: Test for editortranslator and put that first as that becomes available -->
<names variable="editor" delimiter=", ">
<name name-as-sort-order="all" and="symbol" sort-separator=", " initialize-with=". " delimiter=", " delimiter-precedes-last="always"/>
<label form="short" prefix=" (" suffix=")" text-case="title"/>
@@ -383,6 +173,8 @@
</names>
</macro>
<macro name="author-intext">
+ <!-- TODO: New creator roles -->
+ <!-- TODO: Add new item types -->
<choose>
<if type="bill legal_case legislation treaty" match="any">
<text macro="title-intext"/>
@@ -399,8 +191,7 @@
<text macro="title-intext"/>
</substitute>
</names>
- <!-- Replace with term="personal-communication" if that becomes available -->
- <text term="letter"/>
+ <text term="personal-communication"/>
</group>
</if>
<else>
@@ -438,6 +229,7 @@
</choose>
</macro>
<macro name="date-bib">
+ <!-- TODO: Add new item types -->
<group delimiter=" " prefix="(" suffix=")">
<choose>
<if is-uncertain-date="issued">
@@ -476,6 +268,7 @@
</if>
<else-if variable="status">
<group>
+ <!-- TODO: Should I print status as-is, or should I print the in-press term? -->
<text variable="status" text-case="lowercase"/>
<text variable="year-suffix" prefix="-"/>
</group>
@@ -503,6 +296,7 @@
</choose>
</macro>
<macro name="date-intext">
+ <!-- TODO: Add new item types -->
<choose>
<if variable="issued">
<group delimiter="/">
@@ -550,6 +344,7 @@
</group>
</if>
<else-if variable="status">
+ <!-- TODO: Should I print status as-is, or should I print the in-press term? -->
<text variable="status" text-case="lowercase"/>
<text variable="year-suffix" prefix="-"/>
</else-if>
@@ -579,6 +374,7 @@
</choose>
</macro>
<macro name="title">
+ <!-- TODO: Add new item types -->
<choose>
<if type="post webpage" match="any">
<!-- Webpages are always italicized -->
@@ -600,7 +396,7 @@
<if variable="collection-editor editor editorial-director" match="any">
<group delimiter=": " font-style="italic">
<text variable="title"/>
- <!-- Replace with volume-title as that becomes available -->
+ <!-- TODO: Replace with volume-title -->
<choose>
<if is-numeric="volume" match="none">
<group delimiter=" ">
@@ -619,7 +415,7 @@
<else>
<group delimiter=": " font-style="italic">
<text variable="title"/>
- <!-- Replace with volume-title as that becomes available -->
+ <!-- TODO: Replace with volume-title -->
<choose>
<if is-numeric="volume" match="none">
<group delimiter=" ">
@@ -635,27 +431,28 @@
</choose>
</macro>
<macro name="title-intext">
+ <!-- TODO: Add new item types -->
<choose>
<if variable="title" match="none">
<text macro="bracketed-intext" prefix="[" suffix="]"/>
</if>
+ <else-if type="hearing">
+ <!-- Hearings are italicized -->
+ <text variable="title" form="short" font-style="italic" text-case="title"/>
+ </else-if>
<else-if type="bill">
- <!-- If a bill has no number or container-title, assume it is a hearing; italic -->
+ <!-- Bills are not italicized and substitute bill number if no title. -->
<choose>
- <if variable="number container-title" match="none">
- <text variable="title" form="short" font-style="italic" text-case="title"/>
- </if>
- <else-if variable="title">
+ <if variable="title">
<text variable="title" form="short" text-case="title"/>
- </else-if>
+ </if>
<else>
<group delimiter=" ">
<text variable="genre"/>
<group delimiter=" ">
<choose>
<if variable="chapter-number container-title" match="none">
- <!-- Replace with label variable="number" as that becomes available -->
- <text term="issue" form="short"/>
+ <label variable="number" form="short"/>
</if>
</choose>
<text variable="number"/>
@@ -686,6 +483,7 @@
</choose>
</macro>
<macro name="parenthetical">
+ <!-- TODO: Add new item types -->
<!-- (Secondary contributors; Database location; Genre no. 123; Report Series 123, Version, Edition, Volume, Page) -->
<group prefix="(" suffix=")">
<choose>
@@ -698,13 +496,11 @@
<text variable="genre" text-case="capitalize-first"/>
</if>
<else>
- <!-- This should be localized -->
- <text value="patent" text-case="capitalize-first"/>
+ <text term="patent" text-case="capitalize-first"/>
</else>
</choose>
<group delimiter=" ">
- <!-- Replace with label variable="number" if that becomes available -->
- <text term="issue" form="short" text-case="capitalize-first"/>
+ <label variable="number" form="short" text-case="capitalize-first"/>
<text variable="number"/>
</group>
</group>
@@ -741,6 +537,7 @@
</group>
</macro>
<macro name="parenthetical-container">
+ <!-- TODO: Add new item types -->
<choose>
<if variable="container-title" match="any">
<group prefix="(" suffix=")">
@@ -759,6 +556,7 @@
</choose>
</macro>
<macro name="bracketed">
+ <!-- TODO: Add new item types -->
<!-- [Descriptive information] -->
<!-- If there is a number, genre is already printed in macro="number" -->
<group prefix="[" suffix="]">
@@ -779,7 +577,9 @@
<text variable="medium" text-case="capitalize-first"/>
</else-if>
<else>
- <!-- Replace with term="review" as that becomes available -->
+ <!-- TODO: Replace with term="review" -->
+ <!-- TODO: Handle review vs review-of depending on presence of reviewed-title -->
+ <!-- TODO: Add reviewed-genre -->
<text value="Review of"/>
</else>
</choose>
@@ -790,7 +590,9 @@
<text variable="medium" text-case="capitalize-first"/>
</if>
<else>
- <!-- Replace with term="review" as that becomes available -->
+ <!-- TODO: Replace with term="review" -->
+ <!-- TODO: Handle review vs review-of depending on presence of reviewed-title -->
+ <!-- TODO: Add reviewed-genre -->
<text value="Review of"/>
</else>
</choose>
@@ -882,7 +684,7 @@
<text variable="medium" text-case="capitalize-first"/>
</else-if>
<else>
- <text term="letter" form="short" text-case="capitalize-first"/>
+ <text term="letter" text-case="capitalize-first"/>
</else>
</choose>
</if>
@@ -892,7 +694,7 @@
<text variable="medium" text-case="capitalize-first"/>
</if>
<else>
- <text term="letter" form="short" text-case="capitalize-first"/>
+ <text term="letter" text-case="capitalize-first"/>
</else>
</choose>
</else>
@@ -927,20 +729,20 @@
<choose>
<if variable="genre">
<text variable="genre" text-case="capitalize-first"/>
- <!-- Replace prefix with performer label as that becomes available -->
+ <!-- TODO: Replace prefix with performer label -->
<names variable="author" prefix="recorded by ">
<name and="symbol" initialize-with=". " delimiter=", "/>
</names>
</if>
<else-if variable="medium">
<text variable="medium" text-case="capitalize-first"/>
- <!-- Replace prefix with performer label as that becomes available -->
+ <!-- TODO: Replace prefix with performer label -->
<names variable="author" prefix="recorded by ">
<name and="symbol" initialize-with=". " delimiter=", "/>
</names>
</else-if>
<else>
- <!-- Replace prefix with performer label as that becomes available -->
+ <!-- TODO: Replace prefix with performer label -->
<names variable="author" prefix="Recorded by ">
<name and="symbol" initialize-with=". " delimiter=", "/>
</names>
@@ -953,13 +755,13 @@
<choose>
<if variable="medium">
<text variable="medium" text-case="capitalize-first"/>
- <!-- Replace prefix with performer label as that becomes available -->
+ <!-- TODO: Replace prefix with performer label -->
<names variable="author" prefix="recorded by ">
<name and="symbol" initialize-with=". " delimiter=", "/>
</names>
</if>
<else>
- <!-- Replace prefix with performer label as that becomes available -->
+ <!-- TODO: Replace prefix with performer label -->
<names variable="author" prefix="Recorded by ">
<name and="symbol" initialize-with=". " delimiter=", "/>
</names>
@@ -993,14 +795,7 @@
</if>
</choose>
</if>
- <else-if type="book">
- <choose>
- <if variable="version" match="none">
- <text macro="format"/>
- </if>
- </choose>
- </else-if>
- <else-if type="report" match="none">
+ <else-if type="report software" match="none">
<text macro="format"/>
</else-if>
</choose>
@@ -1009,11 +804,14 @@
</group>
</macro>
<macro name="bracketed-intext">
+ <!-- TODO: Add new item types -->
<group prefix="[" suffix="]">
<choose>
<if variable="reviewed-author reviewed-title" type="review review-book" match="any">
- <!-- This should be localized -->
- <text macro="reviewed-title-intext" prefix="Review of "/>
+ <group delimiter=" ">
+ <text term="review-of" text-case="capitalize-first"/>
+ <text macro="reviewed-title-intext"/>
+ </group>
</if>
<else-if variable="interviewer" type="interview" match="any">
<names variable="interviewer">
@@ -1034,7 +832,7 @@
<text variable="genre" text-case="capitalize-first"/>
</if>
<else>
- <text term="letter" form="short" text-case="capitalize-first"/>
+ <text term="letter" text-case="capitalize-first"/>
</else>
</choose>
<names variable="recipient" delimiter=", ">
@@ -1055,6 +853,7 @@
</group>
</macro>
<macro name="bracketed-container">
+ <!-- TODO: Add new item types -->
<group prefix="[" suffix="]">
<choose>
<if type="paper-conference speech" match="any">
@@ -1065,7 +864,7 @@
</if>
</choose>
</if>
- <else-if type="book" variable="version" match="all">
+ <else-if type="software" match="all">
<!-- For entries in mobile app reference works, place bracketed after the container-title -->
<text macro="format"/>
</else-if>
@@ -1077,6 +876,8 @@
</group>
</macro>
<macro name="secondary-contributors">
+ <!-- TODO: Add new item types -->
+ <!-- TODO: Add new creator roles -->
<choose>
<if type="article-journal article-magazine article-newspaper post-weblog review review-book" match="any">
<text macro="secondary-contributors-periodical"/>
@@ -1113,6 +914,7 @@
</group>
</macro>
<macro name="secondary-contributors-booklike">
+ <!-- TODO: Add new item types -->
<group delimiter="; ">
<choose>
<if variable="title">
@@ -1122,7 +924,7 @@
</names>
</if>
</choose>
- <!-- When editortranslator becomes available, add a test: variable="editortranslator" match="none"; then print translator -->
+ <!-- TODO: When editortranslator becomes available, add a test: variable="editortranslator" match="none"; then print translator -->
<choose>
<if type="post webpage" match="none">
<!-- Webpages treat container-title like publisher -->
@@ -1160,12 +962,13 @@
<choose>
<if variable="archive-place" match="none">
<!-- With `archive-place`: physical archives. Without: online archives. -->
- <!-- Add archive_collection as that becomes available -->
+ <!-- TODO: Add archive_collection -->
<text variable="archive_location"/>
</if>
</choose>
</macro>
<macro name="number">
+ <!-- TODO: Add new item types -->
<choose>
<if variable="number">
<group delimiter=", ">
@@ -1173,8 +976,7 @@
<text variable="genre" text-case="title"/>
<choose>
<if is-numeric="number">
- <!-- Replace with label variable="number" if that becomes available -->
- <text term="issue" form="short" text-case="capitalize-first"/>
+ <label variable="number" form="short" text-case="capitalize-first"/>
<text variable="number"/>
</if>
<else>
@@ -1197,6 +999,7 @@
</choose>
</macro>
<macro name="locators-booklike">
+ <!-- TODO: Add new item types -->
<choose>
<if type="article-journal article-magazine article-newspaper broadcast interview patent post post-weblog review review-book speech webpage" match="any"/>
<else-if type="paper-conference">
@@ -1223,8 +1026,7 @@
<choose>
<if is-numeric="version">
<group delimiter=" ">
- <!-- replace with label variable="version" if that becomes available -->
- <text term="version" text-case="capitalize-first"/>
+ <label variable="version" text-case="capitalize-first"/>
<text variable="version"/>
</group>
</if>
@@ -1247,6 +1049,7 @@
</choose>
</macro>
<macro name="volume-booklike">
+ <!-- TODO: Add new item types -->
<group delimiter=", ">
<!-- Report series [ex. 52] -->
<choose>
@@ -1259,6 +1062,7 @@
</choose>
<choose>
<if variable="volume" match="any">
+ <!-- TODO: Update using volume-title -->
<choose>
<!-- Non-numeric volumes are already printed as part of the book title -->
<if is-numeric="volume" match="none"/>
@@ -1272,8 +1076,7 @@
</if>
<else>
<group>
- <!-- Replace with label variable="number-of-volumes" if that becomes available -->
- <text term="volume" form="short" text-case="capitalize-first" suffix=" "/>
+ <label variable="number-of-volumes" form="short" text-case="capitalize-first" suffix=" "/>
<text term="page-range-delimiter" prefix="1"/>
<number variable="number-of-volumes" form="numeric"/>
</group>
@@ -1315,6 +1118,7 @@
</choose>
</macro>
<macro name="format">
+ <!-- TODO: Add new item types -->
<choose>
<if variable="genre medium" match="any">
<group delimiter="; ">
@@ -1327,18 +1131,17 @@
</group>
</if>
<!-- Generic labels for specific types -->
- <!-- These should be localized when possible -->
+ <!-- TODO: Add terms for other types? -->
<else-if type="dataset">
- <text value="Data set"/>
+ <text term="dataset"/>
</else-if>
- <else-if type="book" variable="version" match="all">
- <!-- Replace with type="software" and term="software" as that becomes available -->
- <text value="Computer software"/>
+ <else-if type="software">
+ <text term="software" text-case="capitalize-first"/>
</else-if>
<else-if type="interview personal_communication" match="any">
<choose>
<if variable="archive container-title DOI publisher URL" match="none">
- <text term="letter" text-case="capitalize-first"/>
+ <text term="personal-communication" text-case="capitalize-first"/>
</if>
<else-if type="interview">
<text term="interview" text-case="capitalize-first"/>
@@ -1346,11 +1149,12 @@
</choose>
</else-if>
<else-if type="map">
- <text value="Map"/>
+ <text term="map" text-case="capitalize-first"/>
</else-if>
</choose>
</macro>
<macro name="format-intext">
+ <!-- TODO: Add new item types -->
<choose>
<if variable="genre" match="any">
<text variable="genre" text-case="capitalize-first"/>
@@ -1359,18 +1163,17 @@
<text variable="medium" text-case="capitalize-first"/>
</else-if>
<!-- Generic labels for specific types -->
- <!-- These should be localized when possible -->
+ <!-- TODO: Add terms for other types? -->
<else-if type="dataset">
- <text value="Data set"/>
+ <text term="dataset"/>
</else-if>
- <else-if type="book" variable="version" match="all">
- <!-- Replace with type="software" and term="software" as that becomes available -->
- <text value="Computer software"/>
+ <else-if type="software">
+ <text term="software" text-case="capitalize-first"/>
</else-if>
<else-if type="interview personal_communication" match="any">
<choose>
<if variable="archive container-title DOI publisher URL" match="none">
- <text term="letter" text-case="capitalize-first"/>
+ <text term="personal-communication" text-case="capitalize-first"/>
</if>
<else-if type="interview">
<text term="interview" text-case="capitalize-first"/>
@@ -1378,13 +1181,14 @@
</choose>
</else-if>
<else-if type="map">
- <text value="Map"/>
+ <text term="map"/>
</else-if>
</choose>
</macro>
<!-- APA 'source' element contains four parts:
container, event, publisher, access -->
<macro name="container">
+ <!-- TODO: Add new item types -->
<choose>
<if type="article-journal article-magazine article-newspaper post-weblog review review-book" match="any">
<!-- Periodical items -->
@@ -1440,6 +1244,7 @@
<if variable="issued">
<choose>
<if variable="issue page volume" match="none">
+ <!-- TODO: Should I print status as-is, or should I print the in-press term? -->
<text variable="status" text-case="capitalize-first"/>
</if>
</choose>
@@ -1448,13 +1253,14 @@
</group>
</macro>
<macro name="container-booklike">
+ <!-- TODO: Add new item types -->
<choose>
<if variable="container-title" match="any">
<group delimiter=" ">
<text term="in" text-case="capitalize-first"/>
<group delimiter=", ">
<names variable="editor translator" delimiter=", &amp; ">
- <!-- Change to editortranslator and move editor to substitute as that becomes available -->
+ <!-- TODO: Change to editortranslator and move editor to substitute -->
<name and="symbol" initialize-with=". " delimiter=", "/>
<label form="short" text-case="title" prefix=" (" suffix=")"/>
<substitute>
@@ -1465,7 +1271,7 @@
</names>
<group delimiter=": " font-style="italic">
<text variable="container-title"/>
- <!-- Replace with volume-title as that becomes available -->
+ <!-- TODO: Replace with volume-title -->
<choose>
<if is-numeric="volume" match="none">
<group delimiter=" ">
@@ -1483,6 +1289,7 @@
</choose>
</macro>
<macro name="publisher">
+ <!-- TODO: Add new item types -->
<group delimiter="; ">
<choose>
<if type="thesis">
@@ -1517,7 +1324,7 @@
<!-- With `archive-place`: physical archives. Without: online archives. -->
<!-- For physical archives, print the location before the archive name.
For electronic archives, these are printed in macro="description". -->
- <!-- Split "archive_location" into "archive_collection" and "archive_location" as that becomes available -->
+ <!-- TODO: Split "archive_location" into "archive_collection" and "archive_location" -->
<!-- Must test for archive_collection:
With collection: archive_collection (archive_location), archive, archive-place
No collection: archive (archive_location), archive-place
@@ -1552,6 +1359,7 @@
</choose>
</macro>
<macro name="event">
+ <!-- TODO: Add new item types (e.g., event, collection, performance) -->
<choose>
<if variable="event event-title" match="any">
<!-- To prevent Zotero from printing event-place due to its double-mapping of all 'place' to
@@ -1584,6 +1392,7 @@
</macro>
<!-- After 'source', APA also prints publication history (original publication, reprint info, retraction info) -->
<macro name="publication-history">
+ <!-- TODO: Add new item types -->
<choose>
<if type="patent" match="none">
<group prefix="(" suffix=")">
@@ -1595,6 +1404,7 @@
<text variable="references"/>
</if>
<else>
+ <!-- TODO: Replace these with terms -->
<group delimiter=" ">
<text term="original-work-published" text-case="capitalize-first"/>
<choose>
@@ -1617,86 +1427,60 @@
</macro>
<!-- Legal citations have their own rules -->
<macro name="legal-cites">
+ <!-- TODO: Add new item types -->
<choose>
- <if type="legal_case">
- <group delimiter=". ">
- <group delimiter=", ">
- <text variable="title"/>
- <group delimiter=" ">
- <text macro="container-legal"/>
- <text macro="date-legal"/>
- </group>
- <text variable="references"/>
- </group>
+ <if type="treaty">
+ <!-- APA generally defers to Bluebook for legal citations, but diverges without
+ explanation for treaty items. The Bluebook format that was used in APA 6th
+ ed. is used here. -->
+ <group delimiter=", ">
+ <text variable="title" text-case="title"/>
+ <names variable="author">
+ <name initialize-with="." form="short" delimiter="-"/>
+ </names>
+ <text macro="date-legal"/>
+ <text macro="container-legal"/>
<text macro="access"/>
</group>
</if>
- <else-if type="bill">
- <!-- Currently designed to handle bills, resolutions, hearings, rederal reports. -->
+ <else>
+ <!-- For `bill`: currently designed to handle bills, resolutions, federal reports. -->
+ <!-- For `legislation`: currently designed to handle statutes, codified regulations, executive orders. -->
<group delimiter=". ">
<group delimiter=", ">
<choose>
- <if variable="number container-title" match="none">
- <!-- If no number or container-title, then assume it is a hearing -->
- <text variable="title" font-style="italic"/>
- </if>
- <else>
+ <if type="bill legal_case legislation" match="any">
<text variable="title"/>
- </else>
+ </if>
+ <else-if type="hearing">
+ <text variable="title" font-style="italic"/>
+ </else-if>
</choose>
<group delimiter=" ">
<text macro="container-legal"/>
<text macro="date-legal"/>
<choose>
- <if variable="number container-title" match="none">
- <!-- If no number or container-title, then assume it is a hearing -->
+ <if type="hearing">
<names variable="author" prefix="(testimony of " suffix=")">
+ <!-- TODO: Localize this with the hearing term. -->
<name and="symbol" delimiter=", "/>
</names>
</if>
- <else>
+ <else-if type="bill legislation" match="any">
+ <!-- `legislation`: For uncodified regulations, assume future code section is in status. -->
<text variable="status" prefix="(" suffix=")"/>
- </else>
+ </else-if>
</choose>
</group>
<text variable="references"/>
</group>
<text macro="access"/>
</group>
- </else-if>
- <else-if type="legislation">
- <!-- Currently designed to handle statutes, codified regulations, executive orders.
- For uncodified regulations, assume future code section is in status. -->
- <group delimiter=". ">
- <group delimiter=", ">
- <text variable="title"/>
- <group delimiter=" ">
- <text macro="container-legal"/>
- <text macro="date-legal"/>
- <text variable="status" prefix="(" suffix=")"/>
- </group>
- <text variable="references"/>
- </group>
- <text macro="access"/>
- </group>
- </else-if>
- <else-if type="treaty">
- <!-- APA generally defers to Bluebook for legal citations, but diverges without
- explanation for treaty items. The Bluebook format that was used in APA 6th
- ed. is used here. -->
- <group delimiter=", ">
- <text variable="title" text-case="title"/>
- <names variable="author">
- <name initialize-with="." form="short" delimiter="-"/>
- </names>
- <text macro="date-legal"/>
- <text macro="container-legal"/>
- <text macro="access"/>
- </group>
- </else-if>
+ </else>
</choose>
</macro>
<macro name="date-legal">
+ <!-- TODO: Add new item types -->
<choose>
<if type="legal_case">
<group prefix="(" suffix=")" delimiter=" ">
@@ -1712,7 +1496,7 @@
</choose>
</group>
</if>
- <else-if type="bill legislation" match="any">
+ <else-if type="bill legislation hearing" match="any">
<group prefix="(" suffix=")" delimiter=" ">
<group delimiter=" ">
<date variable="original-date">
@@ -1731,6 +1515,7 @@
</choose>
</macro>
<macro name="container-legal">
+ <!-- TODO: Add new item types -->
<!-- Expect legal item container-titles to be stored in short form -->
<choose>
<if type="legal_case">
@@ -1741,8 +1526,7 @@
<text variable="volume"/>
<text variable="container-title"/>
<group delimiter=" ">
- <!-- Change to label variable="section" as that becomes available -->
- <text term="section" form="symbol"/>
+ <label variable="section" form="symbol"/>
<text variable="section"/>
</group>
<choose>
@@ -1759,8 +1543,7 @@
<group delimiter=" ">
<choose>
<if is-numeric="number">
- <!-- Replace with label variable="number" if that becomes available -->
- <text term="issue" form="short" text-case="capitalize-first"/>
+ <label variable="number" form="short" text-case="capitalize-first"/>
</if>
</choose>
<text variable="number"/>
@@ -1776,8 +1559,7 @@
<group delimiter=" ">
<choose>
<if variable="chapter-number container-title" match="none">
- <!-- Replace with label variable="number" as that becomes available -->
- <text term="issue" form="short"/>
+ <label variable="number" form="short"/>
</if>
</choose>
<text variable="number"/>
@@ -1812,7 +1594,7 @@
<choose>
<if variable="section">
<group delimiter=" ">
- <!-- Change to label variable="section" as that becomes available -->
+ <!-- TODO: Change to label variable="section" -->
<text term="section" form="symbol"/>
<text variable="section"/>
</group>
@@ -1835,8 +1617,7 @@
</if>
<else>
<group delimiter=" ">
- <!-- Replace with label variable="number" if that becomes available -->
- <text term="issue" form="short" text-case="capitalize-first"/>
+ <label variable="number" form="short" text-case="capitalize-first"/>
<text variable="number"/>
</group>
</else>
@@ -1846,6 +1627,7 @@
</choose>
</macro>
<macro name="citation-locator">
+ <!-- TODO: Add new locator types? -->
<group delimiter=" ">
<choose>
<if locator="chapter">
@@ -1883,6 +1665,7 @@
</sort>
<layout>
<choose>
+ <!-- TODO: Add new item types -->
<if type="bill legal_case legislation treaty" match="any">
<!-- Legal items have different orders and delimiters -->
<choose>