summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-mla/doc/biblatex-mla.tex
blob: 63e0567090796cdb7c18d314a7fb3d521aa9ea73 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
% biblatex-mla.tex v2.0 2021/06/07
% Maintained at <https://github.com/jmclawson/biblatex-mla/> by James Clawson.
%
% This material is subject to the LaTeX Project Public License. Feel free to improve, redistribute, and adapt to your own ends, as allowed by that license. (See http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for license details.) For inclusion in future versions, please share improvements in formatting and MLA standards compliance back to James Clawson: <biblatex-mla@konx.net>.

\documentclass{ltxdockit}
\usepackage{xcolor}
% \usepackage{btxdockit}
% \usepackage[latin9]{inputenc}
\usepackage[american]{babel}
\usepackage[strict]{csquotes}
\usepackage[style=mla,mancitepar=false]{biblatex}
\usepackage{tabularx}
\usepackage{booktabs}
\usepackage{shortvrb}
\usepackage{libertine}
\usepackage[scaled=0.8]{beramono}
\usepackage{microtype}
\usepackage{graphicx}
\usepackage{hyperref}
\hypersetup{colorlinks,% 
citecolor=black,% 
% filecolor=black,% 
% linkcolor=black,% 
% urlcolor=black}
}

\addbibresource{handbooksamples.bib}

\MakeAutoQuote{<}{>}
\MakeShortVerb{\|}

\newcommand*{\biblatexmla}{\sty{biblatex-mla}\xspace}
\newcommand*{\Biblatexmla}{\sty{Biblatex-mla}\xspace}
\newcommand*{\biblatexcms}{\sty{biblatex-chicago}\xspace}
\newcommand*{\biblatexmlahome}{https://github.com/jmclawson/biblatex-mla/}
\newcommand*{\biblatexmlaonctan}{http://www.ctan.org/tex-archive/help/Catalogue/entries/biblatex-mla.html}
\newcommand*{\mycode}[1]{\texttt{\textbf{#1}}}% things the user needs to type
% Use \sty{} to indicate technical things the user will never type.
\newcommand*{\mylink}[1]{$<$\url{#1}$>$}
\newcommand*{\mla}{MLA\xspace}
\newcommand*{\mycommand}[1]{\mycode{\textbackslash{}#1}}
\newcommand{\superscript}[1]{\ensuremath{^{\textrm{\tiny{#1}}}}}

\newcommand*{\biber}{\sty{biber}\xspace}
\newcommand*{\biblatex}{\sty{Biblatex}\xspace}
\newcommand*{\biblatexhome}{http://sourceforge.net/projects/biblatex/}
\newcommand*{\biblatexctan}{http://www.ctan.org/tex-archive/macros/latex/contrib/biblatex/}

\makeatletter
\def\subsubsection{\@startsection{subsubsection}{3}{-2.2em}{-5.25ex plus -1ex minus -.2ex}{0.5ex plus .2ex}{\large\textbf}}
\newenvironment*{commandlist}
  {\list{}{%
     \setlength{\labelwidth}{\marglistwidth}%
     \setlength{\labelsep}{\marglistsep}%
     \setlength{\leftmargin}{0pt}%
     \renewcommand*{\makelabel}[1]{\hss\marglistfont##1}}%
   \def\commanditem##1{%
     \item[{\textbackslash{}##1}]%
     \ltd@pdfbookmark{##1}{##1}}}
  {\endlist}
\newenvironment*{optionslist}
  {\list{}{%
     \setlength{\labelwidth}{\marglistwidth}%
     \setlength{\labelsep}{\marglistsep}%
     \setlength{\leftmargin}{0pt}%
     \renewcommand*{\makelabel}[1]{\hss\marglistfont##1}}%
   \def\optionitem##1{%
     \item[{##1}]%
     \ltd@pdfbookmark{##1}{##1}}}
  {\endlist}
\newenvironment*{optionslistNOT}
  {\list{}{%
     \setlength{\labelwidth}{\marglistwidth}%
     \setlength{\labelsep}{\marglistsep}%
     \setlength{\leftmargin}{50pt}%
     \renewcommand*{\makelabel}[1]{\hss\marglistfont##1}}%
   \def\optionitem##1{%
     \item[{\textbf{##1}}]}}
  {\endlist}
\makeatother


\titlepage{%
  title={\biblatexmla},
  subtitle={\mla{} Style Using \biblatex},
  url={\biblatexmlahome},
  author={James Clawson},
  email={},%},
  revision={2.0},
  date={\today}}

\hypersetup{%
  pdftitle={biblatex-mla},
  pdfsubject={MLA Style Using biblatex},
  pdfauthor={James Clawson},
  pdfkeywords={mla, biblatex, bibtex, bibliography, citation}}

% colors

\definecolor{spot}{rgb}{1,0.5,0}
\definecolor{new}{rgb}{0,0.5,1}

\newcommand*{\newthis}{\textbf{\textcolor{new}{|(new in 2.0)|}} }

% tables

\newcolumntype{V}{>{\raggedright\let\\=\tabularnewline\ttfamily}p}
\newcolumntype{H}{>{\sffamily\bfseries\spotcolor}l}
\newcolumntype{P}{>{\raggedright}p{100pt}}
\newcolumntype{O}{>{\raggedright\ttfamily}p{40pt}}
\newcolumntype{S}{>{\raggedright\ttfamily}X}
\newcolumntype{N}{>{\sffamily\bfseries\spotcolor}r}
\newcolumntype{n}{>{\raggedleft\let\\\tabularnewline}p{50pt}}

\providecommand*{\numtablesetup}{\tablesetup}

\newcommand*{\sorttablesetup}{%
  \tablesetup
  \setlength{\tabcolsep}{1pt}%
  \def\new{\ensuremath\rightarrow}%
  \def\alt{\ensuremath\hookrightarrow}%
  \def\str##1{\mbox{\displayverbfont##1}}%
  \def\altstr##1{\hfill\alt\hspace{2\tabcolsep}%
    \str{##1}\hspace*{2\tabcolsep}}%
  \let\fld\bibfield}

% markup and misc

\setcounter{secnumdepth}{4}

\newrobustcmd*{\BiberOnly}{%
  \textcolor{spot}{Biber only}}
\newrobustcmd*{\BiberOnlyMark}{%
  \leavevmode\marginpar{\BiberOnly}}

\hyphenation{%
  star-red
  bib-lio-gra-phy
  white-space
  bib-latex
}

\newcommand*{\mlabibbox}[2]{\begin{center}\colorbox{#1!30}{\parbox{.9\linewidth}{#2}}\end{center}}
\newcommand*{\mlaprintbox}[2]{\begin{center}\colorbox{#1!30}{\parbox{.9\linewidth}{\begin{center}\textbf{Works Cited}\end{center}#2}}\end{center}}

\DeclareFieldFormat{braces}{\{#1\}}%
\DeclareNameAlias{default}{first-last}%
\DeclareNameAlias{author}{first-last}%
\DeclareNameAlias{editor}{first-last}%
\DeclareNameAlias{translator}{first-last}%
\DeclareNameAlias{namea}{first-last}%
\DeclareNameAlias{nameb}{first-last}%
\DeclareNameAlias{namec}{first-last}%
\DeclareListFormat{location}{%
  #1%
  \ifthenelse{\value{listcount}<\value{liststop}}
    {\addcomma\space}
    {}}%
\DeclareListFormat[article]{location}{%
  #1%
  \ifthenelse{\value{listcount}<\value{liststop}}
    {\addcomma\space}
    {}}%
\DefineBibliographyExtras{british}{%
  \protected\def\bibdatedash{$/$}
  \def\finalandcomma{}%
  \protected\def\mkbibdatelong#1#2#3{%
    \iffieldundef{#1}
      {}
      {\thefield{#1}\iffieldundef{#2}{}{-}}%
    \iffieldundef{#2}
      {}
      {\thefield{#2}\iffieldundef{#3}{}{-}}%
    \thefield{#3}}}

\renewcommand*{\multinamedelim}{\addspace\bibstring{and}\space}

\newcommand{\mlafullexample}[2]{%\newline%
\mlabibbox{orange}{\begin{description}\item\mlaexample{#1}\end{description}}%
\normalfont{#2}\selectlanguage{american}%
\mlaprintbox{white}{\begin{description}\item\normalfont\fullcite{#1}\end{description}}}

\DeclareCiteCommand{\mlaexample}[\texttt]
  {\selectlanguage{british}\printtext{$@$}\printfield{entrytype}}%
  {\{\printfield{entrykey}\usebibmacro{cite:mlaexample}}%
  {}%
  {\selectlanguage{american}}
\newbibmacro*{cite:mlaexample}{%
  \setunit{\addcomma\printtext{\newline}}
  \usebibmacro{cite:mlaexample:internal}{author}%
  \usebibmacro{cite:mlaexample:internal}{authortype}%
  \usebibmacro{cite:mlaexample:internal}{bookauthor}%
  \usebibmacro{cite:mlaexample:internal}{booktitle}%
  \usebibmacro{cite:mlaexample:internal}{booksubtitle}%
  \usebibmacro{cite:mlaexample:internal}{date}%
  \usebibmacro{cite:mlaexample:internal}{edition}%
  \usebibmacro{cite:mlaexample:internal}{editor}%
  \usebibmacro{cite:mlaexample:internal}{editortype}%
  \usebibmacro{cite:mlaexample:internal}{entrysubtype}%
  \usebibmacro{cite:mlaexample:internal}{eprint}%
  \usebibmacro{cite:mlaexample:internal}{eprinttype}%
  \usebibmacro{cite:mlaexample:internal}{howpublished}%
  \usebibmacro{cite:mlaexample:internal}{institution}%
  \usebibmacro{cite:mlaexample:internal}{introduction}%
  \usebibmacro{cite:mlaexample:internal}{journaltitle}%
  \usebibmacro{cite:mlaexample:internal}{location}%
  \usebibmacro{cite:mlaexample:internal}{maintitle}%
  \usebibmacro{cite:mlaexample:internal}{mainsubtitle}%
  \usebibmacro{cite:mlaexample:internal}{nameaddon}%
  \usebibmacro{cite:mlaexample:internal}{namea}%
  \usebibmacro{cite:mlaexample:internal}{nameatype}%
  \usebibmacro{cite:mlaexample:internal}{nameb}%
  \usebibmacro{cite:mlaexample:internal}{namebtype}%
  \usebibmacro{cite:mlaexample:internal}{namec}%
  \usebibmacro{cite:mlaexample:internal}{namectype}%
  \usebibmacro{cite:mlaexample:internal}{number}%
  \usebibmacro{cite:mlaexample:internal}{options}%
  \usebibmacro{cite:mlaexample:internal}{origdate}%
  \usebibmacro{cite:mlaexample:internal}{pages}%
  \usebibmacro{cite:mlaexample:internal}{publisher}%
  \usebibmacro{cite:mlaexample:internal}{series}%
  \usebibmacro{cite:mlaexample:internal}{subtitle}%
  \usebibmacro{cite:mlaexample:internal}{title}%
  \usebibmacro{cite:mlaexample:internal}{titleaddon}%
  \usebibmacro{cite:mlaexample:internal}{translator}%
  \usebibmacro{cite:mlaexample:internal}{type}%
  \usebibmacro{cite:mlaexample:internal}{url}%
  \usebibmacro{cite:mlaexample:internal}{urldate}%
  \usebibmacro{cite:mlaexample:internal}{version}%
  \usebibmacro{cite:mlaexample:internal}{volume}%
  \setunit{\printtext{}}\printtext{\}\selectlanguage{american}%
  }%
}
\newbibmacro{cite:mlaexample:internal}[1]{%
  \ifthenelse{\equal{#1}{date}}{%
    \iffieldundef{year}{}{%
      \printtext{\indent date}%
   	  \printtext{$=$ \addspace}%
	  \printtext[braces]{\printdate}%
	}%
  }{}%
  \ifthenelse{\equal{#1}{origdate}}{%
    \iffieldundef{origyear}{}{
	  \printtext{\indent origdate}%
	  \printtext{$=$ \addspace}%
	  \printtext[braces]{\printorigdate}%
	}%
  }{}%
  \ifthenelse{\equal{#1}{urldate}}{%
    \iffieldundef{urlyear}{}{
	  \printtext{\indent urldate}%
	  \printtext{$=$ \addspace}%
	  \printtext[braces]{\printurldate}%
	}%
  }{}%
  \iffieldundef{#1}{}{%
    \printtext{\indent#1}%
	\printtext{$=$ \addspace}%
	\printfield[braces]{#1}%
  }%
  \ifnameundef{#1}{}{%
    \printtext{\indent#1}%
	\printtext{$=$ \addspace}%
	\printtext[braces]{\printnames{#1}}%
  }%
  \iflistundef{#1}{}{%
    \printtext{\indent#1}%
	\printtext{$=$ \addspace}%
	\printtext[braces]{\printlist{#1}}%
  }%
  \setunit{\addcomma\printtext{\newline}}}




\begin{document}

\printtitlepage
\tableofcontents


% \subsection{Examples} % (fold)
% \label{ssub:examples}
% \autocite{sendak63aa}

% subsection examples (end)

\section{Version Note}
This update is to improve compatibility with the 9\superscript{th} edition of the \emph{MLA Handbook}, published April 2021. See \secref{mla:sec:use} for more on switching between editions.

\section{Introduction}
\label{int}

\Biblatexmla provides support to \biblatex, \bibtex, and \latex for citations and Works Cited lists in the style established by the Modern Language Association (\mla). For commands and options to change package defaults, see \secref{mla:subsec:commands} and \secref{mla:subsec:options}, respectively, below.

\mla style, a common standard for writers in the humanities, is outlined in the \emph{MLA Style Manual}, in its 3\superscript{rd} edition, and the \emph{MLA Handbook for Writers of Research Papers}, now in its 9\superscript{th} edition. \Biblatexmla follows the style outlined in the latter of these. It also follows the logic of the \mla{} when citing similar material repeatedly, trimming unnecessary information from citations where necessary. \Biblatexmla is compatible with \biblatex's support for \sty{hyperref} and \sty{tex4ht}, and the main word in each citation (either the author's name, the title, or the page number) serves as a link to the particular entry in the Works Cited. For anything not covered by this manual, please also see the \biblatex documentation or reach out via GitHub.

\newpage
\section{Use}
\label{mla:sec:use}

To ensure American-style quotation marks (if that's your thing),%
%%
\footnote{Other localization files, \sty{mla-spanish.lbx}, \sty{mla-portuguese.lbx}, and \sty{mla-italian.lbx}, are also available to use \biblatexmla in languages other than English. These and other localization files are included in \biblatexmla releases, but they have fallen out of sync with the English versions. The latest version of these files will be kept on GitHub (\mylink{\biblatexmlahome}); new translations are welcome. There is also support for proper punctuation in non-American dialects of English. Try \mycode{british}, \mycode{canadian}, or other Babel identifiers, such as \mycode{spanish}.} %
%%
call the \sty{babel} and \sty{csquotes} packages in the preamble
of your \latex document:
\begin{quote}
	\begin{verbatim}
		\usepackage[american]{babel}
		\usepackage{csquotes}
		\usepackage[style=mla]{biblatex}
		\addbibresource{<bibfile.bib>}
	\end{verbatim}	
\end{quote}

By default, \biblatexmla will transform some data in ways preferred by \mla style: for example, URLs will omit protocol prefixes like |http://|, some URLs will be converted to eprint entries, and publisher names will be simplified to abbreviate ``University Press'' to ``UP.'' To skip these transformations, change the style referenced in the third line to \textbf{|mla-strict|}:
\begin{quote}
	\begin{verbatim}
		\usepackage[american]{babel}
		\usepackage{csquotes}
		\usepackage[style=mla-strict]{biblatex}
		\addbibresource{<bibfile.bib>}
	\end{verbatim}	
\end{quote}

To use the older style called for by the 7\superscript{th} edition of the \emph{MLA Handbook}, change this line to \textbf{|mla7|}: 
\begin{quote}
	\begin{verbatim}
		\usepackage[american]{babel}
		\usepackage{csquotes}
		\usepackage[style=mla7]{biblatex}
		\addbibresource{<bibfile.bib>}
	\end{verbatim}	
\end{quote}

Replace <|<bibfile.bib>|> with the name of your .bib bibliography file. The style (provisionally) supports footnote citations with the \mycode{autocite=footnote} package option. Some of the other options supported by \biblatexmla include \mycode{firstlonghand}, \mycode{noremoteinfo}, \mycode{showlocation}, and others discussed in \secref{mla:subsec:options}.


\subsection{Commands}
\label{mla:subsec:commands}

The standard commands for \biblatexmla generally follow those defined by \biblatex. Included below are the most typical commands. For more commands and options, reference the \biblatex manual.

\subsubsection{Typical Commands}
\label{mla:subsubsec:typical}

\begin{commandlist}

\commanditem{printbibliography}

Insert the list of Works Cited; typically used at the end of a document. As may be expected, this command will print a bibliography including full, alphabetized, MLA-style entries for every source cited using one of the below citation commands.

\commanditem{autocite}
	
Insert a citation. This is the most common command for citing in \biblatexmla, and it defaults to printing a parenthetical citation. See \tabref{use:cit:all} for examples. For best results, use the command before punctuation like this:
\begin{quote}
	\begin{verbatim}
		\autocite{x}. 
	\end{verbatim}	
\end{quote}

In the following example, |x| represents the bibkey of the particular bibliographic entry being cited. Insert page numbers and citational prenotes using square braces: 
\begin{quote}
	\begin{verbatim}
		\autocite[z][y]{x} 
	\end{verbatim}	
\end{quote}

Here, |y| is the page number, and |z| is the prenote (such as <qtd.~in>). If indicating a prenote but no page number, you must include an empty set for the page number:
\begin{quote}
	\begin{verbatim}
		\autocite[z][]{x} 
	\end{verbatim}	
\end{quote}

When citing a page number without any prenote, only one set of square brackets is needed:
\begin{quote}
	\begin{verbatim}
		\autocite[y]{x} 
	\end{verbatim}	
\end{quote}

To omit the name of the author (or editor) responsible for the source when they've already been named in the sentence, use the starred version (\cmd{autocite*[z][y]\{x\}}) of this command.

\commanditem{autocites}

Insert a citation for multiple sources at once. The respective citations will be printed separated by semicolons.
\begin{quote}
	\begin{verbatim}
		\autocites[z1][y1]{x1}[z2][y2]{x1}[z3][y3]{x3} 
	\end{verbatim}	
\end{quote}
The curled braces always indicate the bibkey, and the squared braces respectively belong to the curly braces that follow them.

\commanditem{parencite}

Insert a citation inside parentheses. Indicate page numbers and any prenote like ``qtd.\ in'' in the spaces marked |y| and |z| below, respectively: 

\begin{quote}
	\begin{verbatim}
		\parencite[z][y]{x} 
	\end{verbatim}	
\end{quote}

All of these citation commands follow the pattern described above for |\autocite{}|, which is the preferred citation command to use. To omit the source author or editor, use the starred version of this command: \cmd{parencite*[z][y]\{x\}}

\commanditem{footcite}

Insert a citation in a footnote. The |\footcite| command should be reserved for occasional use in favor of the general use of |\autocite| with the package option |autocite=footnote|, mentioned above. To omit the name of the author or editor, use the starred version of this command: \cmd{footcite*[z][y]\{x\}}

\end{commandlist}

\begin{table}
\tablesetup
\noindent\begin{tabular}{@{}V{0.33\textwidth}@{}V{0.33\textwidth}@{}p{0.3\textwidth}@{}}
\toprule
\multicolumn{1}{@{}H}{Input} &
\multicolumn{1}{@{}H}{Output} &
\multicolumn{1}{@{}H}{Comment} \\
\cmidrule(r){1-1}\cmidrule(r){2-2}\cmidrule{3-3}
\verb!\autocite[12]{morrison02aa}! & \autocite[12]{morrison02aa} & A typical citation includes everything necessary.\\
% \hline
\\
\verb!\autocite[34]{morrison02aa}! & \autocite*[34]{morrison02aa} & Immediately subsequent citations to the same source shorten the citation by dropping redundant information.\\% I had to star it here to show the true output that happens in a paragraph. Something about the table seems to be resetting the tracker.
% \hline
\\
\verb!\autocite{morrison02aa}! & \autocite{morrison02aa} & Immediately subsequent citations lacking page reference add back information to show a citation.\\
% \hline
\\
\verb!\autocite[12]{frye57ab}! & \autocite[12]{frye57ab} & A citation to a text by an author with multiple works cited also includes a short title.\\
% \hline
\\
\verb!\autocite[34]{frye57ab}! & (34) %\autocite[34]{frye57ab} % I have to do weird things here, as the table seems to reset the tracker.
& Subsequent immediate citations to the same source shorten the citation as much as possible.\\
% \hline
\\
\verb!\autocite[56]{frye91aa}! & \autocite*[56]{frye91aa} & Citations to a new source by the same author omit the repetition of the author's name.\\
% \hline
\\
\verb!\autocite[101]{morrison02aa}! & \autocite[101]{morrison02aa} & A citation interrupting those by Frye will reset the trackers. \\
% \hline
\\
\verb!\autocite[78]{frye91aa}! & \autocite[78]{frye91aa} & With a reset author tracker, the citation includes all necessary information.\\
% \hline
\\
\verb!\autocite*[102]{morrison02aa}! & \autocite*[102]{morrison02aa} & The asterisked version suppresses the author's name---useful when the author is named in the sentence.\\
% \hline
\\
\verb!\autocite*[91]{frye57ab}! & \autocite*[91]{frye57ab} & Suppressing the name of a prolific author will still print the short title to avoid ambiguity.\\
% \hline
\\
\verb!\autocite*{morrison02aa}! & \autocite*{morrison02aa} & Suppressing the author's name without page numbers given will print the title of the work.\\
% \hline
\\
% \small& & \\
\verb!\mancite! \verb!   \autocite[34]{morrison02aa}! & \mancite\autocite[34]{morrison02aa} & Resetting the author tracker makes sure that the author's name is always printed---useful to avoid ambiguity.\\
% \hline
\bottomrule
\end{tabular}
\caption[Typical citations]
{Syntax and output showing effects of citation trackers, starred variants, and manual resets with typical citations using \biblatexmla}
\label{use:cit:all}
\end{table}

\clearpage

\subsubsection{In-Text Commands}
\label{mla:subsubsec:intext}

\begin{commandlist}

\commanditem{cite}

Insert a citation without parentheses or footnote styling. These kinds of citations aren't often used in writing for \mla{}-related fields, but the command may be useful within a parenthetical aside or a footnote. To omit the name of the author or editor, use the starred version of this command: \cmd{cite*[z][y]\{x\}}
	
\commanditem{citeauthor}

Print the names of the author(s) or editor(s) associated with a source. In its current form, the unstarred command will always print given and family names, while the starred variant (\cmd{citeauthor*\{x\}}) will omit given names.

\commanditem{citetitle}

Print the title of a source. The unstarred version will print the |shorttitle| if it is available; the starred version (\cmd{citetitle*\{x\}}) will always print the full title.

\commanditem{citeyear}

Print the year associated with a source.

% (these commands aren't yet working.)
% 
% \commanditem{fullcite}
%
% Print a full citation where a shortened citation might otherwise come.
%
% \commanditem{headlessfullcite}
%
% Except for the author's name, print a nearly-full citation where a shortened citation might otherwise come.

\end{commandlist}

\subsubsection{Special Commands}
\label{mla:subsubsec:special}

\begin{commandlist}

\commanditem{mancite}

Reset most trackers that would shorten subsequent citations. See \tabref{use:cit:all} for an example. If \biblatexmla{}'s ambition to shorten citations leads to ambiguity, using this command before a citation should print the longer version.

\commanditem{citereset}

Reset all citation trackers for \biblatexmla.%

\commanditem{headlesscite}

Suppress the author's name in a citation. This command provides an alias to \cmd{autocite*} to make it easier for anyone using \biblatexmla and \biblatexcms interchangeably.

\commanditem{textcite}

An alias to |\cite|, above.

\end{commandlist}

\subsection{Package Options}
\label{mla:subsec:options}

\Biblatexmla defaults to the recommendations established by the \mla{}, but there may be times when it is appropriate to change some of these options for publication or other uses. Package options change the default functionality of \biblatexmla.

\begin{optionslist}
% \optionitem{autocite=footnote}
%
% Using \mycommand{autocite} with biblatex-mla defaults to \mla{}-preferred inline, parenthetical citations. To style citations as footnotes, set the \mycode{autocite=footnote} option in your preamble:
% \begin{quote}
% 	\begin{verbatim}
% 		\usepackage[style=mla,autocite=footnote]{biblatex}
% 	\end{verbatim}
% \end{quote}

\optionitem{annotation}
It is possible to print annotations to entries in the Works Cited if the \mycode{annotation} field is defined in an entry. To turn on this option, add \mycode{annotation=true} to your
preamble:
\begin{quote}
	\begin{verbatim}
		\usepackage[style=mla,annotation=true]{biblatex} 
	\end{verbatim}	
\end{quote}

\optionitem{firstlonghand}\label{mla:internal:firstlonghand}
The first citation of a source with a shorthand defined will always print a citation with author's name and, potentially, the \sty{shorttitle} field. (For more on this field, see section \secref{mla:subsec:unnusualfields}, below.) Add \mycode{firstlonghand=false} to your preamble to disable this option and print only the shorthand even on the first citation:
\begin{quote}
	\begin{verbatim}
		\usepackage[style=mla,firstlonghand=false]{biblatex} 
	\end{verbatim}	
\end{quote}
% \noindent\begin{minipage}{\linewidth}
% \end{minipage}

\optionitem{guessmedium}
When using the |style=mla7| option, an entry with no defined \sty{howpublished} field will default either to a <Web> publication (if there's a defined \sty{url} field or \sty{eprint} field) or a <Print> publication (if there's not). To avoid \biblatexmla guessing the publication medium, thereby printing nothing when the field is undefined, deactivate the \mycode{guessmedium} option:
\begin{quote}
	\begin{verbatim}
		\usepackage[style=mla7,guessmedium=false]{biblatex}
	\end{verbatim}	
\end{quote}

\optionitem{longdash}\label{mla:internal:longdash}
\newthis The 9\superscript{th} edition of the \emph{\mla Handbook} clarifies that dashes indicating multiple entries by one author can either be styled wih three em-dashes or three hyphens. From version 2.0, \biblatexmla defaults to em-dashes, but setting |longdash| to false in the document header reverts to using hyphens:
\begin{quote}
	\begin{verbatim}
		\usepackage[style=mla,longdash=false]{biblatex}
	\end{verbatim}	
\end{quote}

\optionitem{mancitepar}
Although perhaps they should, the author trackers in \biblatexmla do not by default reset with each paragraph or page. As a result, shortened citations may be unclear when much distance has passed from previous, fuller citations. To avoid this ambiguity, the \cmd{mancite} command can be called before an unclear citation. (See \tabref{use:cit:all} for the effects of \cmd{mancite}.) Alternatively, consider asking \biblatexmla to silently call the \cmd{mancite} command with each new paragraph by enabling the \mycode{mancitepar} package option:
\begin{quote}
	\begin{verbatim}
		\usepackage[style=mla,mancitepar=true]{biblatex}
	\end{verbatim}	
\end{quote}

\optionitem{mladraft}
When using \mla{} parenthetical citations, it is best practice to cite only when necessary to avoid ambiguity. \Biblatexmla can flag consecutive citations to the same page range, allowing you to defer citations to the end. In draft mode, \biblatexmla will place a clover ($\clubsuit$) in the margin, along with a single footnote explanation. To use the tool outside of draft mode, set the \mycode{mladraft} option in your preamble to true; similarly, to avoid seeing these clovers and the footnote in draft mode, set the option to false:
\begin{quote}
	\begin{verbatim}
		\usepackage[style=mla,mladraft=true]{biblatex}
	\end{verbatim}	
\end{quote}

\optionitem{nofullfootnote}\label{mla:internal:nofullfootnote}
When using \biblatexmla for footnotes, the style file will provide full bibliographic detail for the first citation of every source. To turn off this option, add to your preamble \mycode{nofullfootnote}:
\begin{quote}
	\begin{verbatim}
		\usepackage[style=mla,autocite=footnote,nofullfootnote]{biblatex} 
	\end{verbatim}	
\end{quote}

\optionitem{noremoteinfo}\label{mla:internal:noremoteinfo}
Modeled after the implementation in |biblatex-apa| to suppress remote information in the \sty{.bib} file from being printed in the bibliography, this option affects \sty{isbn}, \sty{issn}, \sty{isrn}, \sty{doi}, and \sty{eprint} fields.
\begin{quote}
	\begin{verbatim}
		\usepackage[style=mla,noremoteinfo=true]{biblatex}
	\end{verbatim}	
\end{quote}

\optionitem{showlocation}\label{mla:internal:showlocation}
\newthis The 8\superscript{th} and 9\superscript{th} editions of the \emph{\mla Handbook} advise witholding publication location for most entries, so \biblatexmla omits showing the |location| field for many entry types. To show these location fields for all sources when they exist, use the |showlocation| option in the document header:
\begin{quote}
	\begin{verbatim}
		\usepackage[style=mla,showlocation=true]{biblatex}
	\end{verbatim}	
\end{quote}

Alternatively, selectively show the location for individual entries by defining the |options| field in the |.bib| file:
\begin{quote}
	\begin{verbatim}
		@book{dewey99aa,
		  ...
		  options = {showlocation=true}
		}
	\end{verbatim}	
\end{quote}

\optionitem{showmedium}
When using the |style=mla7| option, \biblatexmla will print the publication medium at the end of each entry in the list of Works Cited. Turn off this option---and some other new changes from the 3\superscript{rd} edition---by setting the \mycode{showmedium} option to false:
\begin{quote}
	\begin{verbatim}
		\usepackage[style=mla7,showmedium=false]{biblatex}
	\end{verbatim}	
\end{quote}

\end{optionslist}

\section{Database Guide}
\label{bib}

% I lost my original documentation files, including original style files I created to maintain them, so I'm transitioning everything to Philipp Lehman's \sty{ltxdockit}. This part of the user guide, explaining how to create \sty{bibtex} entries for use with \biblatexmla, will be updated shortly. Until then, please see \S{} 4 (pages 7--20) of the previous version: \mylink{http://konx.net/biblatex-mla/biblatex-mla.pdf}.

\biblatex uses \bibtex-style databases to manage the citations and list of works cited. With some notable distinctions, \biblatexmla tries to follow typical \biblatex conventions for fields and entry types. % The guide below explains some  are the different \sty{@types} and the \mycode{fields} available to them. Keep in mind that some of the fields in the \sty{@book} and \sty{@article} types (e.g., \sty{nameaddon}, \sty{origyear}, and others) are also available in others where it makes sense; I don't repeat them here to save room.
% 
% \subsection{Typical fields} % (fold)
% \label{sub:typical_fields}
%
% The best way to acquaint oneself with \biblatexmla is to explore the included \sty{.bib} file, \sty{.tex} files, and the resulting \sty{.pdf} output. Much of the the bibfile database is pretty obvious. Take a look at \tabref{fig:example-book}, for example.
% \begin{table}[tbp]
% 	\centering
% 		\includegraphics[width=4.8in]{example-book.pdf}
% 	\caption{A standard \sty{.bib} file \mycode{@book} entry and its corresponding output in the list of Works Cited, beneath.}
% 	\label{fig:example-book}
% \end{table}
% In addition to many of the standard fields one might expect to find, \biblatexmla is also capable of handling unusual fields, described below. For a fuller consideration of the fields supported by \biblatexmla, see the example files and consult the Biblatex manual.
% 
% 
% \mlafullexample{douglas93aa}{The above entry, found in the \sty{.bib} file, outputs to the below entry in the list of works cited:} %
Much of the the bibfile database is pretty obvious, so the best way to get acquainted with \biblatexmla is to explore the included \sty{.bib}, \sty{.tex}, and \sty{.pdf} files. Additionally, some of the different \sty{@types} and fields are explained below. Keep in mind that some of the fields in the \sty{@book} and \sty{@article} types (for example, \sty{nameaddon}, \sty{origyear}, and others) are also available in others where it makes sense; I don't repeat them here to save room.

% subsection typical_fields (end)

\subsection{Notable Fields}\label{mla:subsec:unnusualfields}
\biblatex supports the following fields, sometimes concerned more with presentation than bibliographic merit, in all entrytypes. Define these in your \mycode{.bib} files:

\begin{optionslistNOT}
	
	\optionitem{crossref}
	the \sty{key} of a parent source in which a shorter source is found. The \sty{crossref} field is handy to avoid spending time re-inputting similar data, but it is also useful for including \mla{}-style cross-references in the list of Works Cited. Keep in mind the problems of the \sty{crossref} field, explained in section 2.4.1 of the \biblatex manual.% In the future, \biblatexmla may provide further support for the \biblatex \sty{xref} field, making \sty{crossref} secondary in importance.
	
	\optionitem{shorttitle}
	the shortened title to be printed in citations to disambiguate among multiple titles by one author. \Biblatexmla will only print this field in citations when necessary; when this field is not defined, \biblatexmla will use the whole of the \sty{title} field.
	
	\optionitem{shorthand}
	when defined, a unique label to be printed in citations instead of the author and shorttitle. By default, \biblatexmla will only use the \sty{shorthand} label after a first citation with author (and title, if necessary). See the \mycode{firstlonghand} option on page~\pageref{mla:internal:firstlonghand} to disable this feature.
	
	\optionitem{options}
	separate the following options with a comma:
	\begin{description}
		\item[noremoteinfo=false] indicates that the ``remote'' information of an entry is to be printed, including the fields \sty{isbn}, \sty{issn}, \sty{isrn}, \sty{doi}, and \sty{eprint}. These fields are usually omitted. See also the global option also called \mycode{noremoteinfo}, on page~\pageref{mla:internal:noremoteinfo}, above, for defining this option on a per-document basis. The \mycode{noremoteinfo} option defaults to true.
		\item[showlocation=true] \newthis indicates that the publisher's city of operations for an entry is to be printed. These fields are usually omitted. See also the global option also called \mycode{showlocation}, on page~\pageref{mla:internal:showlocation}, above, for defining this option on a per-document basis. The \mycode{showlocation} option defaults to false.
		\item[totalnames=true] allows the label to include all the names in its list, rather than maxing out at three. The \mycode{totalnames} option defaults to false.
		\item[uniquetranslator=true] indicates that a translator of a particular \sty{@incollection} entry is unique to that work, rather than the collection at large. The \mycode{uniquetranslator} option defaults to false.
		\item[useauthor=false] allows the label of the entry to default to something other than the author, when the author field is defined. If the editor is defined, the label will default to that. The \mycode{useauthor} option defaults to true.
		\item[useeditor=false] allows the label of the entry default to something other than the editor in the case of the author field being undefined or the \mycode{useauthor} option set to false. The \mycode{useeditor} option defaults to true.
		\item[usetranslator=true] allows the label of the entry to inherit the name of the translator when the author and editor fields are undefined or the \mycode{useauthor} and \mycode{useeditor} options are set to false. The \mycode{usetranslator} option defaults to false.
	\end{description}	
\end{optionslistNOT}


\subsection{Standalone Sources}
The following entrytypes are for long sources not part of any other publication except, potentially, multivolume sets or publishers' series.

\subsubsection*{@book}
A book, usually with one author. \mla{}-style book entries are straightforward, and the \biblatexmla files style all the potential fields for a typical book

\begin{optionslistNOT}
	\optionitem{author}
	the author of the book

	\optionitem{title}
	book title; when using \sty{crossref}, also define \sty{booktitle} and be sure to define \sty{title} of the child entry

	\optionitem{subtitle}
	book subtitle; when using \sty{crossref}, also define \sty{booksubtitle} and be sure to define \sty{subtitle} of the child

	\optionitem{location}
	place of publication; ignored unless |showlocation| is |true|

	\optionitem{publisher}
	publishing house

	\optionitem{date}
	date of publication; defined as \sty{YYYY} for a year, \sty{YYYY-MM} for a month, \sty{YYYY-MM-DD} for a day, or \sty{YYYY-MM-DD/YYYY-MM-DD} for a range. Use a tilde to indicate uncertainty: \sty{{\raisebox{0.5ex}{\texttildelow}}1400} will print as ``circa 1400'' in the list of Works Cited.
\end{optionslistNOT}

Other fields might come in handy for further granularity:

\begin{optionslistNOT}
	\optionitem{origdate}
	original publication date, for reprints; defined as \sty{YYYY} for a year, \sty{YYYY-MM} for a month, \sty{YYYY-MM-DD} for a day, or \sty{YYYY-MM-DD/YYYY-MM-DD} for a range

	\optionitem{edition}
	edition number, preferably an integer

	\optionitem{volume}
	volume number of book

	\optionitem{volumes}
	total number of volumes

	\optionitem{maintitle}
	title of multi-volume collection of which this book is one volume

	\optionitem{mainsubtitle}
	subtitle of the above \sty{maintitle}

	\optionitem{series}
	name of a publication series

	\optionitem{number}
	number of the above \sty{series} represented by this book

\end{optionslistNOT}

Additionally, the style files support more name types for situations needing them:

\begin{optionslistNOT}
	\optionitem{editor}
	editor of a book

	\optionitem{editortype}
	to indicate if the named \sty{editor} is actually an \sty{editor} (``ed.''), a \sty{compiler} (``comp.'') or a \sty{compilerandeditor} (``comp. and ed.''). Default value is \sty{editor}.

	\optionitem{translator}
	translator of a work

	\optionitem{introduction}
	author of a book's introduction

	\optionitem{foreword}
	author of a book's foreword

	\optionitem{afterword}
	author of a book's afterword

	\optionitem{redactor}
	name of redactor

	\optionitem{commentator}
	name of commentator

	\optionitem{annotator}
	name of annotator

\end{optionslistNOT}

Finally, the style files also define the following note fields for further clarification:

\begin{optionslistNOT}
	\optionitem{nameaddon}
	pseudonym, misattribution, or other note (printed in brackets after \sty{author})

	\optionitem{booktitleaddon}
	note after the \sty{booktitle}

	\optionitem{maintitleaddon}
	note after the \sty{maintitle}

	\optionitem{note}
	miscellaneous data printed before \sty{publisher}

	\optionitem{addendum}
	miscellaneous data printed at the end of the entry

\end{optionslistNOT}

% Fields not yet supported in biblatex-mla (but which should be supported in future versions) include the following:
%
% \begin{optionslistNOT}
% 	\optionitem{howpublished}
% 	to be used in support of the MLA-style revisions in the third edition of the \emph{MLA Style Manual} and the 7th edition of the \emph{MLA Handbook}; will default to ``Print''  when undefined
%
% 	\optionitem{origlocation}
% 	original place of publication (for reprints)
%
% 	\optionitem{origpublisher}
% 	original publisher (for reprints)
%
% 	\optionitem{origtitle}
% 	original title (for reprints)
%
% 	\optionitem{origlanguage}
% 	the original language of a translated, reprinted work. Biblatex-mla will not print information in this field, but if the field has information in it, it will use the phrase ``Trans. of''  before the original title, instead of ``Rept. of''.
%
% \end{optionslistNOT}

\subsubsection*{@booklet}
Small pamphlet, often without an author listed. In \biblatexmla, \mycode{@booklet} is an alias for \mycode{@book} (see above), and is styled similarly.

\subsubsection*{@collection}
A book that is a collection of self-contained essays, stories, or poems, usually with multiple unique authors and collectively edited by a single editorial body. In \biblatexmla, \mycode{@collection} is an an alias for \mycode{@book} (see above), and is styled similarly. To accurately support \mycode{@incollection} entries using \mycode{crossref}, be sure to define the following fields instead of \mycode{title} and \mycode{subtitle} in the parent \mycode{@collection} entry:

\begin{optionslistNOT}
	\optionitem{booktitle}
	the title of a book or collection

	\optionitem{booksubtitle}
	the subtitle of a book or collection

\end{optionslistNOT}

Additionally, remember to define the \mycode{editor} field if needed.

\subsubsection*{@periodical}
An entire issue of a journal, usually cited by editor. \biblatexmla accepts the following fields:

\begin{optionslistNOT}
	\optionitem{editor}
	the editor or editors of an issue

	\optionitem{issuetitle}
	title of a special issue

	\optionitem{issuesubtitle}
	subtitle of a special issue

	\optionitem{title}
	title of the journal

	\optionitem{subtitle}
	subtitle of the journal

	\optionitem{volume}
	volume number

	\optionitem{number}
	issue number

	\optionitem{issue}
	season, when used in place of month (as in the ``spring'' issue of a journal)

	\optionitem{date}
	date of publication, defined as \sty{YYYY} for a year, \sty{YYYY-MM} for a month, \sty{YYYY-MM-DD} for a day, or \sty{YYYY-MM-DD/YYYY-MM-DD} for a range.
	
	\optionitem{pages}
	complete pagination of the issue

\end{optionslistNOT}

\subsubsection*{@proceedings}
The published proceedings of a conference. \Biblatexmla styles \sty{@proceedings} entries like \sty{@book} or \sty{@collection} entries, but it also provides support for the following unique fields:

\begin{optionslistNOT}

	\optionitem{eventtitle}
	
	title of the conference represented by the proceedings (if not included in the \sty{title} of the published proceedings)
	
	\optionitem{organization}
	
	body sponsoring the conference
	
	\optionitem{urldate}
	
	original date of the conference; defined as \sty{YYYY} for a year, \sty{YYYY-MM} for a month, \sty{YYYY-MM-DD} for a day, or \sty{YYYY-MM-DD/YYYY-MM-DD} for a range. Please note that this is an unusual and temporary use of the \sty{urldate} field; in a future version of \biblatexmla, it will change to \sty{eventdate}.
	
	\optionitem{institution}
	
	university or institution hosting the conference
	
	\optionitem{venue}
	
	location of the conference

\end{optionslistNOT}

\subsubsection*{@reference}
A reference book such as a dictionary or encyclopedia, often supporting \sty{@inreference} entries through \sty{crossref} fields. \Biblatexmla styles a \sty{@reference} entry as it would a \sty{@book} entry.

\subsubsection*{@thesis}
The thesis or dissertation resulting from a doctorate or a master's degree, whether published or unpublished. Supports the following fields typical for defining such an entry:

\begin{optionslistNOT}

	\optionitem{author}
	
	the author of the thesis/dissertation
	
	\optionitem{title}
	
	title
	
	\optionitem{subtitle}
	
	subtitle
	
	\optionitem{type}
	
	degree type. \Biblatexmla defines some MLA-style \sty{@thesis} types pre-localized; choose from the following strings to get accurate styling:
	\begin{description}
		\item[phd] for doctorate; prints as ``Diss.'' in English
		\item[dphil] for doctorate; prints as ``Diss.'' in English
		\item[lic] for licentiate; prints as ``Licentiate thesis''
		\item[ma] for master's; prints as ``MA thesis''
		\item[ms] for master's; prints as ``MS thesis''
		\item[msc] for master's; prints as ``MSc thesis''
		\item[mphil] for master's; prints as ``MPhil thesis''
		\item[mlitt] for master's; prints as ``MLitt thesis''
	\end{description}
	
	For all other types not matching the above codes, biblatex- mla will print the type field exactly as entered, respecting all existing capitalization
	
	\optionitem{institution}
	
	name of degree-granting university
	
	\optionitem{date}
	
	date degree awarded, defined as \sty{YYYY} for a year, \sty{YYYY-MM} for a month, \sty{YYYY-MM-DD}

\end{optionslistNOT}

The entry for a @thesis that has been published needs a few additional fields:

\begin{optionslistNOT}
	
	\optionitem{entrysubtype}
	
	When using the 7\superscript{th} edition style, which differentiates between published and unpublished dissertation titles, \biblatexmla recognizes two keys in the \sty{entrysubtype} field for the \sty{@thesis}:
	
	\begin{description}
		\item[published] for published theses
		\item[unpublished] for unpublished theses
	\end{description}
	
	Any key other than \sty{published} or \sty{unpublished} will be treated as if it were \sty{unpublished}.
	
	\optionitem{location}
	
	place of publication
	
	\optionitem{publisher}
	
	publisher
	
	\optionitem{origdate}
	
	date degree was awarded, defined as \sty{YYYY} for a year, \sty{YYYY-MM} for a month, \sty{YYYY-MM-DD}; please note this difference from an unpublished thesis
	
	\optionitem{date}
	
	date of publication, defined as \sty{YYYY} for a year; please note this difference from an unpublished thesis
	
	\optionitem{series}
	
	name of a publication series
	
	\optionitem{number}
	
	number of the above \sty{series} represented by this book
	
\end{optionslistNOT}


%%%%%%
\subsection{Sources within other works}
The following entrytypes are for shorter works (essays, poems, and other things) that are part of another publication. Many have corresponding standalone sources representing the larger work of which they are a part (i.e., \sty{@incollection} and \sty{@collection}). Entries of shorter works can inherit fields of parent entries by using the \sty{crossref} field.

\subsubsection*{@article}
Articles appearing in periodicals in many media, including academic journals, newspapers, and online sources. \Biblatexmla supports the following fields typical of an article in an academic journal:

\begin{optionslistNOT}

	\optionitem{author} author of the article
	
	\optionitem{title} title of the article
	
	\optionitem{subtitle} subtitle of the article
	
	\optionitem{journaltitle} title of journal
	
	\optionitem{journalsubtitle} subtitle of journal
	
	\optionitem{volume} journal volume number
	
	\optionitem{number} journal issue number
	
	\optionitem{issue} season, when used in place of month (as in the ``spring'' issue of a journal)
	
	\optionitem{date} date, defined as \sty{YYYY} for a year, \sty{YYYY-MM} for a month, \sty{YYYY-MM-DD} for a day, or \sty{YYYY-MM-DD/YYYY-MM-DD} for a range
	
	\optionitem{pages} page numbers of the article

\end{optionslistNOT}

For online and newspaper articles, the style provides additional support for the following fields:

\begin{optionslistNOT}
	
	\optionitem{entrysubtype} defines an article's medium, allowing finer control over styling. \Biblatexmla responds to the following keys in the \sty{entrysubtype} field:
	
	\begin{description}
		\item[newspaper] used for newspaper articles
		\item[magazine] used for magazine articles
	\end{description}
	
	online articles are styled by the presence or absence of a \sty{url} field
	
	\optionitem{url} the url address of an online article
	
	\optionitem{urldate} date of access of an online article, defined as \sty{YYYY-MM-DD}
	
	\optionitem{date} date a newspaper article is published, defined as \sty{YYYY-MM-DD} for a day
	
	\optionitem{location} for newspapers lacking a place-name in their title, the city of publication
	
	\optionitem{version} the printing edition of a newspaper (ie, early edition, national edition, etc.)
	
	\optionitem{chapter} the section of a newspaper article if it uses numbers instead of letters; if the newspaper uses letters, combine the letter with the page number (ie, page ``B12'') in the \sty{page} field
	
\end{optionslistNOT}

In addition, the style provides support for the following fields, used in edge cases and unusual circumstances:

\begin{optionslistNOT}

	\optionitem{nameaddon} pseudonym, misattribution, or other note (printed in brackets after author)
	
	\optionitem{titleaddon} note after the title
	
	\optionitem{origdate} year of original publication for a reprinted article
	
	\optionitem{issuetitle} title of the special issue in which it appeared
	
	\optionitem{issuesubtitle} subtitle of the special issue
	
	\optionitem{editor} editor of the special issue
	
	\optionitem{translator} translator of the article
	
	\optionitem{redactor} name of redactor
	
	\optionitem{commentator} name of commentator
	
	\optionitem{annotator} name of annotator
	
	\optionitem{introduction} author of introduction to special issue
	
	\optionitem{foreword} author of foreword to special issue
	
	\optionitem{afterword} author of afterword to special issue
	
	\optionitem{series} name of journal series; define the series name or define as \sty{newseries} or \sty{oldseries} to let \biblatexmla style the series name correctly
	
	\optionitem{note} miscellaneous data to print before the page numbers
	
	\optionitem{addendum} further miscellaneous note at the end of an entry

\end{optionslistNOT}


\subsubsection*{@bookinbook}
A particular kind of \sty{@incollection}. (See below.)

\subsubsection*{@incollection}
A self-contained unit in a \sty{@collection}. Supports the following fields typical of an essay, short story, or poem found in an anthology:

\begin{optionslistNOT}

	\optionitem{author} the author of the work
	
	\optionitem{title} title of the work
	
	\optionitem{subtitle} subtitle of the work
	
	\optionitem{entrysubtype} defines a work's medium, allowing finer control over styling. By default, \sty{@incollection} entries are printed inside quotation marks, like essays, poems, stories, and other shorter works. \Biblatexmla responds to \mycode{book} and \mycode{play} in the \sty{entrysubtype} field, each of which will cause the title to be printed italicized rather than inside quotation marks. Alternatively, set the entry to a \sty{@bookinbook} type for the same effect.
	
	\optionitem{origdate} original publication date of the work, defined as \sty{YYYY}, \sty{YYYY-MM}, or \sty{YYYY-MM-DD}
	
	\optionitem{booktitle} title of the anthology
	
	\optionitem{booksubtitle} subtitle of the anthology
	
	\optionitem{editor} anthology's editor
	
	\optionitem{location} anthology's city of publication
	
	\optionitem{publisher} anthology's publisher
	
	\optionitem{date} date anthology is published, defined as \sty{YYYY}
	
	\optionitem{pages} page numbers of the work

\end{optionslistNOT}

Further fields supported include all of those supported by the @book type.

\subsubsection*{@inproceedings}

A work published in the proceedings of a conference. Supports all the fields of the \sty{@incollection} and \sty{@proceedings} types.

\subsubsection*{@inreference}

A particular type of \sty{@incollection}, potentially without an author. In addition to those fields defined by \sty{@incollection}, \sty{@inreference} adds or refines the following:

\begin{optionslistNOT}

	\optionitem{title} name of entry in reference book
	
	\optionitem{titleaddon} particular definition of the word
	
	\optionitem{booktitle} the title of the reference book

\end{optionslistNOT}

Note that \sty{@inreference} entries do not need to cite page numbers, though they should specify the edition used. If the year and edition fields match, \biblatexmla styles the entry accordingly.

\subsubsection*{@letter}

The \sty{@letter} entry type is defined similarly to the \sty{@article} type, so it will accept additional fields used in those entries.

\begin{optionslistNOT}

	\optionitem{author} main author of the letter
	
	\optionitem{title} indication of sender and addressee
	
	\optionitem{titleaddon} additional information
	
	\optionitem{pages} pages
	
	\optionitem{origdate} original date letter was sent

\end{optionslistNOT}

\subsubsection*{@review}

A particular type of \sty{@article}, potentially without a title. In addition to those fields defined by \sty{@article}, \sty{@review} adds or refines the following:

\begin{optionslistNOT}

	\optionitem{booktitle} the title of the book being reviewed
	
	\optionitem{bookauthor} the author of the book being reviewed
	
	\optionitem{editor} the editor of the book being reviewed

\end{optionslistNOT}

Note that reviews found in special issues of journals (using the \sty{issuetitle} and \sty{issuesubtitle} fields) are not fully supported yet.

\subsubsection*{@suppbook}

A foreword, introduction, preface, or other supplementary (and often untitled) material to a \sty{@book}. Supports the following fields typical of such a piece:

\begin{optionslistNOT}

	\optionitem{author} author of the piece
	
	\optionitem{title} title of the piece
	
	\optionitem{subtitle} subtitle of the piece
	
	\optionitem{entrysubtype} the type of supplemental material, including subtypes like ``introduction,'' ``foreword,'' and ``Editor's note.''
	
	\optionitem{booktitle} title of the book the piece appears in
	
	\optionitem{booksubtitle} subtitle of the book the piece appears in 
	
	\optionitem{location} city of publication of the book the piece appears in
	
	\optionitem{publisher} publisher of the book the piece appears in
	
	\optionitem{date} date of publication of the book the piece appears in, defined as \sty{YYYY}
	
	\optionitem{pages} page numbers of the piece

\end{optionslistNOT}

Further fields supported include all of those supported by the \sty{@book} type.

\subsubsection*{@suppcollection}

A foreword, introduction, preface, or other supplementary (and often untitled) material to a \sty{@collection}. Supports all the same fields as \sty{@suppbook}.


%%%%%%
\subsection{Other media}

\subsubsection*{@artwork}
The \sty{@artwork} entry type is defined similarly to the \sty{@article} type, so it will accept additional fields used in those entries.

\begin{optionslistNOT}

	\optionitem{author} artist responsible for the work
	
	\optionitem{title} title of the piece
	
	\optionitem{type} description of the medium. (Please note that this field doesn't yet work with the current version of \biblatexmla, though support will be added to support bibliographies made for \biblatexcms.)
	
	\optionitem{note} additional note on the work
	
	\optionitem{date} date of creation, defined as \sty{YYYY} for a year, \sty{YYYY-MM} for a month, \sty{YYYY-MM-DD} for a day, or \sty{YYYY-MM-DD/YYYY-MM-DD} for a range
	
	\optionitem{institution} institution holding the artwork. (Please note that this field doesn't yet work with the current version of \biblatexmla, though support will be added to support bibliographies made for \biblatexcms.)
	
	\optionitem{location} city of the institution. (Please note that this field doesn't yet work with the current version of \biblatexmla, though support will be added to support bibliographies made for \biblatexcms.)

\end{optionslistNOT}

\subsubsection*{@audio}
The \sty{@audio} entry type is defined similarly to the \sty{@article} type, so it will accept additional fields used in those entries.

\begin{optionslistNOT}

	\optionitem{author} author or composer of a work
	
	\optionitem{title} title of the speech, song, or other short piece. (Please note that this field doesn't yet work with the current version of \biblatexmla, though support will be added.)
	
	\optionitem{booktitle} title of the opera, cycle, or other larger collection
	
	\optionitem{origdate} date work was originally written. (Please note that this field doesn't yet work with the current version of \biblatexmla, though support will be added.)
	
	\optionitem{maintitle} title of a book containing the work
	
	\optionitem{date} date of publication of work being referenced
	
	\optionitem{publisher} publisher of work being referenced. (Please note that this field doesn't yet work with the current version of \biblatexmla, though support will be added.)
	
	\optionitem{location} city of publisher. (Please note that this field doesn't yet work with the current version of \biblatexmla, though support will be added.)

\end{optionslistNOT}

\subsubsection*{@image}
The \sty{@image} entry type is defined similarly to the \sty{@article} type, so it will accept additional fields used in those entries.

\begin{optionslistNOT}

	\optionitem{author} creator of the image
	
	\optionitem{title} title of the work
	
	\optionitem{type} description of the medium. (Please note that this field doesn't yet work with the current version of \biblatexmla, though support will be added to support bibliographies made for \biblatexcms.)
	
	\optionitem{note} additional description of the work
	
	\optionitem{date} date of creation
	
	\optionitem{institution} institution holding the work. (Please note that this field doesn't yet work with the current version of \biblatexmla, though support will be added.)
	
	\optionitem{location} city of the institution holding the work. (Please note that this field doesn't yet work with the current version of \biblatexmla, though support will be added.)

\end{optionslistNOT}

\subsubsection*{@manual}
\newthis This entry type is an alias for \sty{@book}.

\subsubsection*{@misc}
\newthis This entry type behaves like \sty{@article} entries, but titles aren't printed inside quotation marks.

\subsubsection*{@movie}
\newthis This entry type is an alias for \sty{@video}.

\subsubsection*{@music}
This entry type is an alias for \sty{@audio}.

\subsubsection*{@online}
This entry type is an alias for \sty{@article}.

\subsubsection*{@patent}
\newthis This entry type is currently built onto the same backend as \sty{@article} entries, so it accepts additional fields used in that entry type. Additionally, it adds some additional operations to the type field:

\begin{optionslistNOT}

	\optionitem{type} the type of patent, with relation to the country in which it was issued. For instance, \sty{patenteu} or \sty{patentus} will automatically establish some standard expectations for the Works Cited entry of a patent from the European Union or one from the United States. See section 4.9.2.20 of the \biblatex manual for more of these expected strings.

\end{optionslistNOT}

\subsubsection*{@report}
\newthis This entry type is an alias for \sty{@book}.

\subsubsection*{@unpublished}
An unpublished manuscript or typescript. \Biblatexmla supports the following fields typical to an unpublished entry:

\begin{optionslistNOT}

	\optionitem{author} author of the work
	
	\optionitem{title} title of a short work (i.e., an essay or poem)
	
	\optionitem{subtitle} subtitle of a short work
	
	\optionitem{booktitle} title of a longer work (i.e., a book or play)
	
	\optionitem{booksubtitle} subtitle of a longer work
	
	\optionitem{titleaddon} description of untitled work
	
	\optionitem{note} further information used to classify the collection; typeset before the \sty{type} field
	
	\optionitem{type} form of the material. For example, some of the following strings are recognized:
	
	\begin{description}
		\item[manuscript] printed as ``Manuscript'' or ``ms'' in English
		\item[transcript] printed as ``Typescript'' or ``ts'' in English
	\end{description}
	
	For all other types not matching the above codes, \biblatexmla will print the \sty{type} field exactly as entered, respecting all existing capitalization
	
	\optionitem{entrysubtype} \newthis special consideration for styling the title of the work or for indicating that a given title is just a description of the material consulted. The following strings are recognized:
	
	\begin{description}
		\item[untitled] for unstyled titles
		\item[book] for titles that should be styled like a book
		\item[article] for titles that should be styled like an article
	\end{description}
	
	\Biblatexmla will further try to style the title to match any type listed in the \sty{entrysubtype} field.
	
	\optionitem{number} identifying number (such as a call number, box, or folio reference) in a library or archive
	
	\optionitem{library} library, archive, or other research institution holding the unpublished work
	
	\optionitem{location} location of the \sty{library}
	
	\optionitem{addendum} extra material printed at the end of an entry

\end{optionslistNOT}

\subsubsection*{@video}
A recording of a movie, television program, etc. \Biblatexmla supports the following fields necessary for a video:

\begin{optionslistNOT}

	\optionitem{title}
	
	title of the work
	
	\optionitem{subtitle}
	
	subtitle of the work
	
	\optionitem{bookauthor}
	
	author of the book on which the video is based
	
	\optionitem{publisher}
	
	distributor
	
	\optionitem{origdate}
	
	original date of release
	
	\optionitem{howpublished}
	
	publishing medium (ie, DVD, videocassette, etc.)

\end{optionslistNOT}

Additionally, \biblatexmla supports the \sty{author}, \sty{editor}, \sty{namea}, \sty{nameb}, and \sty{namec} fields, modified with the \sty{authortype}, \sty{editortype}, \sty{nameatype}, \sty{namebtype}, and \sty{namectype} fields, attuned to the following localization keys:

\begin{optionslistNOT}
	
	\optionitem{$<$x$>$type}
	\begin{description}
		\item[director] director of a work
		\item[screenplay] author of the screenplay
		\item[performer] list of crucial performers
		\item[composer] composer of a soundtrack
		\item[producer] producer of a work
	\end{description}
	
Note that \biblatexmla will print the \sty{author} field before the \sty{title} (styled using the appropriate \sty{authortype} key) unless the field is empty or the \mycode{useauthor} option is false---at which point it will cascade to the \sty{editor} field, unless \emph{it} is undefined or the \mycode{useeditor} option is false. No other name fields will be printed before the title. Except for any printed before the title, these fields will be printed after the title in the following order: \sty{author}, \sty{editor}, \sty{namea}, \sty{nameb}, \sty{namec}.
	
\end{optionslistNOT}

%%%%%%%
\subsection{MLA-Style Containers}

\subsubsection*{@mlasource}
\newthis In addition to these typical \biblatex-supported entry types, \biblatexmla 2.0 introduces support for defining entries using the containerized explanations of sources first described in the 8\superscript{th} edition of the \emph{MLA Handbook}. Because the non-author fields are defined to handle information literally, this kind of entry is in many ways inferior to the above semantically-defined entry types, which should handle punctuation in lists of editor names, strings like ``vol.'' and ``by,'', subtitle punctuation, and other matters. The user will need to keep output in mind as they define the metadata of an \sty{@mlasource} entry. All of these fields are optional, and they should only include information set out in the \emph{MLA Handbook}.

\begin{optionslistNOT}

	\optionitem{author} the name of the person(s) who should be used as the label for a work.
	
	\optionitem{title} title of the piece; subtitles and any necessary colons should be included within the |title| field.
	
	\optionitem{titletype} a string like \textbf{|complete|}, \textbf{|part|}, or \textbf{|unstyled|} determining how the source's |title| gets printed. This field is typically unnecessary: \biblatexmla assumes |complete| if the source lacks a |titlea| field, and it assumes |part| if the |titlea| field is defined, styling the title in italics or in quotation marks, respectively. Setting this field overrides \biblatexmla{}'s logic.
	
	\optionitem{supplemental} any supplemental information for the source.
	
	\optionitem{titlea} the title of the first container; \biblatexmla will style |titlea| in italics, but subtitles and any necessary colons should be included within the this field.
	
	\optionitem{contributora} any necessary contributors to the first container.
	
	\optionitem{versiona} the version or edition of the first container.
	
	\optionitem{numbera} the number of the first container.
	
	\optionitem{publishera} the publisher of the first container.
	
	\optionitem{datea} the date associated with the first container.
	
	\optionitem{locationa} the location of the first container.
	
	\optionitem{supplementala} any supplemental information for the first container.
	
	\optionitem{titleb} the title of the second container; \biblatexmla will style |titleb| in italics, but subtitles and any necessary colons should be included within the this field.
	
	\optionitem{contributorb} any necessary contributors to the second container.
	
	\optionitem{versionb} the version or edition of the second container.
	
	\optionitem{numberb} the number of the second container.
	
	\optionitem{publisherb} the publisher of the second container.
	
	\optionitem{dateb} the date associated with the second container.
	
	\optionitem{locationb} the location of the second container.
	
	\optionitem{supplementalb} any supplemental information for the second container.
	
	

\end{optionslistNOT}

%%%%%%%

\section{Meta}
\subsection{License}

\biblatexmla is copyrighted \textcopyright\ 2007--2021, by James Clawson. Permission is granted to copy, distribute, and modify this software under the terms of the \lppl, version 1.3: \mylink{http://www.ctan.org/tex-archive/macros/latex/base/lppl.txt}.

\subsection[Feedback]{Feedback}
\label{int:feb}

If you have any questions, requests, or other feedback please email me or reach out on GitHub. If you end up improving the code to be more accurate to the \mla{} standard, please be kind to the rest of us and share; I'm very happy to incorporate improvements! If anything works differently than you feel it ought to work, please let me know. Apart from time and my willingness to write documentation, I'm limited only by the problems of which I'm unaware.

\end{document}