summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-mla
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-01-03 00:21:57 +0000
committerKarl Berry <karl@freefriends.org>2011-01-03 00:21:57 +0000
commitd6925fc0016a1c61cd7eecf5b0d30b360940578f (patch)
tree45560b6bed6abfa058d1b869c2ae82a3d94ccd9a /Master/texmf-dist/doc/latex/biblatex-mla
parentce17d709b220bc6cf4c7bc900420698c244bf57e (diff)
biblatex-mla (2jan11)
git-svn-id: svn://tug.org/texlive/trunk@20910 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-mla')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-mla/CHANGES225
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-mla/README40
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla-old.pdfbin0 -> 175467 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla.pdfbin0 -> 39967 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla.tex283
5 files changed, 548 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-mla/CHANGES b/Master/texmf-dist/doc/latex/biblatex-mla/CHANGES
new file mode 100644
index 00000000000..ab6ba1ef638
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-mla/CHANGES
@@ -0,0 +1,225 @@
+Changelog for version 0.9.5:
+- changes for compatibility with Biblatex 1.0
+- further support for latest MLA edition (now default); use "showmedium=false"
+ package option to revert
+- added Italian localization (from Andrea Marchitelli)
+- new entry option "nodate" to trigger display of MLA-style "n.d."
+- added support and MLA formatting for eprint sources from Project Muse (using
+ "muse" as eprinttype); in the eprint field, include the full URL to the
+ article
+- preliminary conversion of documentation to Philipp Lehman's ltxdockit, as
+ previous documentation files were lost
+
+Changelog for version 0.9:
+- many changes for compatibility with Biblatex v.0.9
+- introduced support for style from latest MLA edition (this was a major
+ undertaking)
+- new "print", "web", and "generaleditor" bibstrings
+- formatting for eprint sources from JSTOR and Google Books, as already
+ included in Biblatex
+- support and formatting for eprint sources from eBooks@Adelaide (using
+ "adelaide" as eprinttype); in the eprint field, include the full URL to the
+ article
+- new package options "showmedium" and "guessmedium" for updated MLA support
+- improved support for reprints
+- improved support for multivolume entries, including change from using
+ origyear field to using eventdate field, and added support for general
+ editor as "generaleditor" editortype
+- converted proceedings to use eventdate field
+
+Changelog for version 0.8.1:
+- did nothing but make 0.8 beta final to upgrade CTAN
+
+Changelog for version 0.8 beta:
+- added further examples from the MLA Handbook (6th edition). Almost all of
+ the non-periodical examples in section 5.6.x (and many of the periodical
+ examples in 5.7.x) contained therein can now be successfully re-created
+ using biblatex-mla.
+- nameaddon and authortype behavior standardized across entrytypes
+- added bookauthor support for suppcollection and suppbook
+- significantly improved handling of multivolume works
+- further improved handling of "et al." There should now be a comma before
+ "et al." only in reversed (last-first) naming schemes. Standard (first-last)
+ schemes and last-name only schemes will omit the comma.
+- improved support for maintitle
+- improved presentation of title in conference proceeding, where title ends in
+ an abbreviation dot
+- added preliminary support for "generaleditor" editortype in the language
+ (lbx) files
+- added preliminary support for "volstodate" string in the language (lbx)
+ files, theoretically to be used when indicating total volume numbers of
+ multi-volume works with open-ranged years
+- added title format for reference books
+- removed extra leading space before nameaddon brackets
+- added support for formatting of open-ranged years (as suggested by
+ Philipp Lehman)
+- added support for limiting remote info, using methods similar to
+ biblatex-apa
+- added totalnames support for translator field
+- re-added hyperref support mistakenly disabled in version 0.7
+- fixed many citereset problems (while potentially introducing others...)
+- many citation macros tidied and future-proofed
+- footnote presentation considerably more stable
+
+Changelog for version 0.7 final:
+- added examples from the MLA Handbook (6th edition)
+- added support for origlocation, origpublisher, origtitle, and origlanguage
+ to allow for reprints and translations. Biblatex-mla only uses the
+ origlanguage field to trigger the use of \bibstring{transof} in place of
+ \bibstring{reprintof} for reprinted articles and will not actually print the
+ contents of the origlanguage field.
+- re-added support for translators in articles (mistakenly lost in 0.6)
+- added localization and bibstrings for "bytypecompilerandeditor" and
+ "transof" (in addition to "typecompilerandeditor")
+- significantly improved footnote support, bringing it inline with support for
+ entries in the bibliography. This work is currently in progress, but non-
+ periodical entries should be fully supported.
+- in addition to Spanish and Portuguese localizations (contributed by Ivan
+ Fernandez and Paulo Ferreira, respectively) and existing American
+ localizations, version 0.7 is also compatible with non-American English
+ dialects for localized punctuation patterns. In your preamble, call Babel
+ with the language of your choice: british, canadian, australian, spanish,
+ and american should all work equally well (though some newer bibstrings
+ remain untranslated in Spanish). Portuguese support is not yet included with
+ biblatex.
+
+Changelog for version 0.7 beta:
+- added partial support for @suppbook, @suppcollection
+- made style definitions independent from sample Biblatex style files
+- segregated localizations into external .lbx files
+- added comma before name affixes
+- added test for comma before "et al.": negative in citations, positive in
+ list of Works Cited
+- added test for colon before subtitle, returning negative after terminal
+ punctuation (such as exclamation point, question mark)
+- added "totalnames" entry option for listing all authors and editors in the
+ list of Works Cited for a particular entry
+- added "uniquetranslator" entry option, used for an @incollection entry with
+ its own translator not shared with the rest of the collection
+- slightly changed default name dash in Works Cited
+- added support for year editions for @inreference works
+- improved logic of @video macro
+- added support for "eds." before title when editors are plural
+- renamed "strict" package option to "footnoterulestrict"
+- added draft mode style helper for multiple citations
+- added "mladraft" package option for calling style helper outside of draft
+ mode
+- added localization for "typecompilerandeditor" editortype
+
+Changelog for version 0.6.1:
+- IMPORTANT CHANGE: because of difficulties formatting articles without volume
+ numbers as newspaper articles, I've had to regress that option sooner than I
+ expected. Updated bibtex files by adding the entrysubtype field and setting
+ it to "newspaper" or "magazine". Article entries with undefined volume
+ fields are now formatted as journal articles without any volume numbers (as
+ one might have expected biblatex-mla to have done all along...)
+- updated documentation for the above change; added link for installing
+ Biblatex from CTAN in installation instructions
+- fixed bugs with spacing, problems with spurious punctuation in Reviews, and
+ some other minor things
+- updated footnote internal macros to use native quotation marks and
+ punctuation nesting, thereby fully regressing mkbibquotepunct command
+- added "strict" package option after biblatex-chicago-notes-df; feature is
+ undocumented for now
+
+Changelog for version 0.6:
+- native support for biblatex-, csquote-, and babel-empowered American-style
+ punctuation and double quotation marks added in biblatex 0.8 (footnotes not
+ yet updated)
+- add support for @unpublished, @proceedings, @inproceedings, @periodical
+ entrytypes
+- add support for published theses
+- standardized .bib file keys, strings, fields across entrytypes
+- improve minor presentation errors, including misplaced comma before "et al,"
+ the size of the name dash in Works Cited (to match that in the Style Manual
+ more closely (redefine \mlanamedash to change)), and other things
+- simplified and made many internal macros less hack-y and more localizable
+- defined many new bibliography strings and redefined existing ones
+- commented out issn, isbn, doi, and similar fields as a temporary fix
+- allow idem after shorthands in citations
+- improved presentation of dates, dropping opening zero
+- added support for articles in special issues of journals
+- added support for annotated bibliographies using the "annotation" option
+- improved support/presentation for subtitles
+- usetranslator entry-option now stable, uses native biblatex support
+- improved documentation
+- add support for nameaddon
+
+Changelog for version 0.5 (final):
+- introduction of firstlonghand and nofullnote package options
+- changed approach of shorthand citations, defaulting to a "longhand" citation
+ for the first citation
+- introduction of usetranslator entry option
+- fixed more stupid errors
+- added support for video and booklet entrytypes
+- added hyperlinks for citations with only page numbers
+- added better support for useauthor and useeditor entry options
+- added location to newspaper articles
+- added edition ("version") to newspaper articles (ie, late, national,
+ morning, etc.)
+- added Spanish localization by Ivan Fernandez
+
+Changelog for version 0.5 (beta):
+- introduction of MLA-style footnote citation support
+- fixed many more stupid errors (made since the beginning)
+- added support for book reviews and reference articles (use "review"
+ entrytype and "inreference" entrytype, respectively)
+- tidied stylistic problems including erroneous punctuation before URLs
+ (pointed out by Stephen Brumbaugh), stray spaces, a few doubled
+ punctuations, etc.
+- added support for anonymous incollection works (for example, "Beowulf" in an
+ English literature anthology shouldn't by default be referenced by the
+ editor of that anthology)
+- added support for single-author collections (for example, a single poet's
+ Collected Poems, with or without a named editor)
+- preliminary support for "video" entrytype
+- a few other things I'm forgetting
+
+Changelog for version 0.4:
+- proper MLA-style crossref support (though Philipp Lehmann's warnings of the
+ dangers of crossrefs in Bibtex files still hold: the parent will overwrite
+ anything undefined in the child, like Title and Author)
+- fixed many stupid errors (made when converting to biblatex 0.7 in version
+ 0.3)
+- introduced logic for idems, ibids, and prenotes (reduces chances of prenotes
+ and ibids obscuring the actual author's name)
+- changed style name to biblatex-mla to fit in with everything else being
+ lowercase
+- fixed compatibility with tex4ht (documents made with biblatex-mla can now be
+ converted to OpenOffice format easily)
+- added support for Newspaper articles (use "article" type, set no volume and
+ no issue number)
+- added access dates for online articles
+- got rid of a couple stray periods lurking in some places.
+- defined \fullcite command to provide examples of bibliographic citations (as
+ seen in the new samples page)
+- added samples page
+
+Changelog for version 0.3:
+- updated for compatibility to biblatex 0.7
+- incorporated improvements made by Jay Savage regarding URL presentation in
+ Works Cited and the handling of edited books lacking authors
+- added support for the starred variants of \cite* and \autocite* for citing
+ titles when the author is already named in the sentence (e.g., "Joyce says
+ many fine things (Ulysses 34)," written as "Joyce says many fine things
+ \autocite*[34]{citekey}"). This variation will basically just force skip the
+ author's name in a citation. If it's an author with multiple titles in the
+ Works Cited, it will list the title and page; otherwise it will list just
+ the page.
+- added functionality to use first name initials to differentiate among common
+ surnames (option uniquename=init made available in biblatex 0.7) in
+ citations
+- added localizations for "Ed. and trans.," etc. I'm not sure how accurate
+ these are yet, but it at least lets us have nicer Works Cited lists. You'll
+ see this change when works have a single person responsible for any
+ combination of editing, translating, introducing, annotating, or providing
+ commentary, forewards, or afterwards. With this change, the person is listed
+ only once, with the appropriate words before the name.
+- restyled the URL font in the Works Cited to be the same as the rest of the
+ documents (as suggested by Jay Savage)
+- added support for \cite (same as \autocite) to be more supportive to
+ existing programs that assume cite as the command used for references and to
+ make conversion easier for newcomers who've already been using \cite
+- improved idem handling with boolean triggers
+- cleaned up macro names to make them easier to follow
+
diff --git a/Master/texmf-dist/doc/latex/biblatex-mla/README b/Master/texmf-dist/doc/latex/biblatex-mla/README
new file mode 100644
index 00000000000..e4009a48737
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-mla/README
@@ -0,0 +1,40 @@
+Description:
+Biblatex-mla provides Biblatex support for references and citations in the
+style defined by the Modern Language Association (MLA). The style is a common
+standard for writers in the humanities and is outlined in the MLA Style Manual
+and the MLA Handbook for Writers of Research Papers. These files follow
+definitions for the 3rd edition of the Manual and the 7th edition of the
+Handbook. Before using biblatex-mla, you will need to install Biblatex:
+http://www.ctan.org/tex-archive/help/Catalogue/entries/biblatex.html
+
+
+Installation:
+1. Locate your latex installation folder
+ - In OS X, it can be found at
+ ~/Library/texmf/tex/latex/
+2. Create a new folder called "biblatex-mla" if there isn't already one there
+3. Place the biblatex-mla files into this folder
+
+
+Usage:
+1. Call the MLA style in your Latex document using the following four lines in
+your Latex preface:
+ \usepackage[american]{babel}
+ \usepackage{csquotes}
+ \usepackage[style=mla]{biblatex}
+ \bibliography{<bibfile>}
+ - (replace "<bibfile>" with the name of your .bib bibliography file)
+ - to use MLA-style footnotes, use the "autocite=footnote" package option
+2. Cite a text with \autocite{<key>}, cite a page with
+\autocite[<page>]{<key>}, and include a citational prenote---"'To be or not to
+be,' he wrote (Shakespeare qtd. in Brown 34)"---with
+\autocite[<prenote>][<page>]{<key>}.
+ - (replace <key>, <page>, and <prenote> with their respective elements)
+3. Before the end of your document, include the following line where you want
+your bibliography to appear:
+ \printbibliography
+
+
+This material is subject to the LaTeX Project Public License. See
+http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for the
+details of that license. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla-old.pdf b/Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla-old.pdf
new file mode 100644
index 00000000000..db0629fe892
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla-old.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla.pdf b/Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla.pdf
new file mode 100644
index 00000000000..7cf71fa4304
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla.tex b/Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla.tex
new file mode 100644
index 00000000000..5f4fef03655
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-mla/doc/biblatex-mla.tex
@@ -0,0 +1,283 @@
+% biblatex-mla.tex v0.95 2010/12/18
+% Maintained at <http://konx.net/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>.
+%
+% File is in constant progress. Things are messy. Ignore platypi.
+
+\documentclass{ltxdockit}[2010/11/19]
+\usepackage{btxdockit}
+\usepackage[latin9]{inputenc}
+\usepackage[american]{babel}
+\usepackage[strict]{csquotes}
+\usepackage{tabularx}
+\usepackage{booktabs}
+\usepackage{shortvrb}
+\MakeAutoQuote{<}{>}
+\MakeAutoQuote*{«}{»}
+\MakeShortVerb{\|}
+
+\rcsid{$Id: biblatex-mla.tex,v 0.95 2010/12/18 13:01:50 clawson beta $}
+
+\newcommand*{\BiblatexMLAhome}{http://konx.net/biblatex-mla/}
+\newcommand*{\BiblatexMLAonCTAN}{http://www.ctan.org/tex-archive/help/Catalogue/entries/biblatex-mla.html}
+\newcommand*{\mycode}[1]{\texttt{\textbf{#1}}}
+\newcommand*{\mylink}[1]{$<$\url{#1}$>$}
+% \newcommand*{\mla}{\textsf{\textsc{Mla}}}
+\newcommand*{\mla}{MLA}
+\newcommand*{\mycommand}[1]{\mycode{\textbackslash{}#1}}
+\newcommand{\superscript}[1]{\ensuremath{^{\textrm{\tiny{#1}}}}}
+
+\makeatletter
+\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}
+\makeatother
+
+
+\titlepage{%
+ title={\sty{biblatex-mla}},
+ subtitle={\mla{} Style Using \sty{biblatex}},
+ url={\BiblatexMLAhome},
+ author={James Clawson},
+ email={biblatex-mla@konx.net},
+ revision={\rcsrevision},
+ date={\rcstoday}}
+
+\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}
+
+% tables
+
+\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
+}
+
+\begin{document}
+
+\printtitlepage
+\tableofcontents
+
+\section{Introduction}
+\label{int}
+
+The \sty{biblatex-mla} files provide support to \sty{biblatex}, \sty{bibtex}, and \sty{latex} for citations and Works Cited lists in the style established by the Modern Language Association (\mla{}). The style defaults to inline parenthetical citations, but it also offers support for \mla{}-style footnotes. For more on the commands and options for changing package defaults, see \secref{mla:subsec:commands} and \secref{mla:subsec:options}, respectively, below.
+
+The \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 7\superscript{th} edition. By default, these files follow definitions for these latest editions, though they also offer the option of support for the previous style. \sty{Biblatex-mla} also follows the logic of the \mla{} when citing similar material repeatedly, borrowing the function---but not the form---of \emph{ibid} and \emph{idem}. \sty{Biblatex-mla} is compatible with \sty{biblatex}'s support for \sty{hyperref} and \sty{tex2ht}, 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 \sty{biblatex} documentation or contact me by email.
+
+\subsection{License}
+
+\sty{Biblatex-mla} is copyrighted \textcopyright\ 2007--2010, 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. My email address is at the top of this document. 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.
+
+
+\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 \sty{biblatex-mla} in languages other than English. These and other localization files are included in \sty{biblatex-mla} releases, but they will not always be the latest versions available. Updated and new localization files will be uploaded to \mylink{http://konx.net/biblatex-mla/lbx} once they are ready. 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}.} %
+%%
+you need to 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}
+ \bibliography{<bibfile>}
+ \end{verbatim}
+\end{quote}
+Replace <|<bibfile>|> with the name of your .bib bibliography file. The style supports footnote citations with the \mycode{autocite=footnote} package option. Other options supported by \sty{biblatex-mla} include \mycode{firstlonghand}, \mycode{mladraft}, \mycode{annotation}, \mycode{noremoteinfo}, \mycode{nofullfootnote}, \mycode{publimedium}, and \mycode{guessmedium}, all discussed below in \secref{mla:subsec:options}.
+
+
+\subsection{Commands}
+\label{mla:subsec:commands}
+
+The standard commands for \sty{biblatex-mla} generally follow those defined by \sty{biblatex}. Included below are the most typical commands. For more commands and options, reference the \sty{biblatex} manual.
+
+\begin{commandlist}
+
+\commanditem{autocite}
+
+Insert a citation. For best results, use the command before punctuation like this \mycommand{autocite}|{x}|. \sty{Biblatex-mla} defaults to parenthetical citations for \mycommand{autocite}, but a package option---\mycode{autocite=footnote}, explained below in \secref{mla:subsec:options}---changes this default behavior. In this 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 are needed:
+\begin{quote}
+ \begin{verbatim}
+ \autocite[y]{x}
+ \end{verbatim}
+\end{quote}
+
+\commanditem{autocite*}
+
+Suppress the author's name in a citation. Use this starred variant of the above command when indicating the author's name in the sentence calling the citation.
+
+\commanditem{autocites}
+
+Insert a citation for multiple sources at once. The respective citations will be 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{printbibliography}
+
+Insert the list of Works Cited.
+
+\end{commandlist}
+
+
+
+\subsection{Package Options}
+\label{mla:subsec:options}
+
+\sty{Biblatex-mla} defaults to the recommendations established by the \mla{}, but there may be times when you need to change some of these options for publication or other uses. As such, a number of package options have been defined to change the functionality of \sty{biblatex-mla} within reason.
+
+\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{firstlonghand}
+The first citation of a source with a shorthand defined will always print a citation with author's name and, potentially, the shorttitle field. (See section XXX, 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}
+
+\optionitem{nofullfootnote}
+When using biblatex-mla for footnotes, the style file will provide full bibliographic detail for the first citation of every source. To turn off this option, add \mycode{nofullfootnote=true} to your preamble:
+\begin{quote}
+ \begin{verbatim}
+ \usepackage[style=mla,nofullfootnote=true]{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{mladraft}
+When using MLA parenthetical citations, it is best practice to cite as seldom as is necessary to avoid ambiguity. \sty{Biblatex-mla} can flag consecutive citations to the same page range, allowing you to defer citations to the end. In draft mode, \sty{biblatex-mla} 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{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. It's included here mostly as a proof of concept for future expansion.
+\begin{quote}
+ \begin{verbatim}
+ \usepackage[style=mla,noremoteinfo=true]{biblatex}
+ \end{verbatim}
+\end{quote}
+
+\optionitem{showmedium}
+\sty{Biblatex-mla} version 0.9 introduced support for the latest \mla{} style, defined in the 3\superscript{rd} edition of the \emph{Style Manual}, requiring the publication medium of each entry to be printed in the list of Works Cited. By default, \sty{biblatex-mla} will do the same, using the \sty{howpublished} field. Turn off this option---and the other new changes from the 3\superscript{rd} edition---by setting the \mycode{showmedium} option to false:
+\begin{quote}
+ \begin{verbatim}
+ \usepackage[style=mla,showmedium=false]{biblatex}
+ \end{verbatim}
+\end{quote}
+
+\optionitem{guessmedium}
+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 \sty{biblatex-mla} guessing the publication medium, thereby printing nothing when the field is undefined, deactivate the \mycode{guessmedium} option:
+\begin{quote}
+ \begin{verbatim}
+ \usepackage[style=mla,guessmedium=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 \sty{biblatex-mla}, 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}.
+
+\end{document}