Skip to content

Commit

Permalink
significant bibliography update
Browse files Browse the repository at this point in the history
- added @online entrytype
- support for noremoteinfo package option (defaults to true) for
choosing to load URLs
- added hyperref linking to "Web" bibstring
- updated date backend to be at parity with Biblatex
- added limited examples from the MLA handbook
  • Loading branch information
jmclawson committed Mar 24, 2013
1 parent 9d43b01 commit 99ea1da
Show file tree
Hide file tree
Showing 16 changed files with 2,152 additions and 2,189 deletions.
Binary file modified .DS_Store
Binary file not shown.
26 changes: 0 additions & 26 deletions american-mla-old.lbx

This file was deleted.

36 changes: 22 additions & 14 deletions american-mla.lbx
Original file line number Diff line number Diff line change
@@ -1,22 +1,30 @@
% american-mla.lbx v1.0 2012/08/30
% american-mla.lbx v0.2.5 2013/03/24

\ProvidesFile{american-mla.lbx}[2012/08/30 v1.0 biblatex style localization]
\ProvidesFile{american-mla.lbx}[2013/03/24 v0.2.5 biblatex style localization]

\InheritBibliographyExtras{american}

\DeclareBibliographyExtras{%
\def\bibdatelong{%
\@tempcnta0\thefield{day} \the\@tempcnta\nobreakspace%
\mkbibmonth{\thefield{month}}\nobreakspace
\thefield{year}}%
\def\bibdateshort{%
\thefield{day}/\thefield{month}/\thefield{year}}%
\def\biburldatelong{%
\@tempcnta0\thefield{urlday} \the\@tempcnta\nobreakspace%
\mkbibmonth{\thefield{urlmonth}}\nobreakspace
\thefield{urlyear}}%
\def\biburldateshort{%
\thefield{urlday}/\thefield{urlmonth}/\thefield{urlyear}}%
\protected\def\mkbibdatelong#1#2#3{%
\iffieldundef{#3}
{}
{\thefield{#3}%
\iffieldundef{#2}{}{\nobreakspace}}%
\iffieldundef{#2}
{}
{\mkbibmonth{\thefield{#2}}%
\iffieldundef{#1}{}{\space}}%
\stripzeros{\thefield{#1}}}%
\protected\def\mkbibdateshort#1#2#3{%
\iffieldundef{#3}
{}
{\mkdatezeros{\thefield{#3}}%
\iffieldundef{#2}{}{/}}%
\iffieldundef{#2}
{}
{\mkdatezeros{\thefield{#2}}%
\iffieldundef{#1}{}{/}}%
\mkdatezeros{\thefield{#1}}}%
}

\DeclareBibliographyStrings{%
Expand Down
22 changes: 11 additions & 11 deletions doc/biblatex-mla.tex
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
% biblatex-mla.tex v0.95 2010/12/18
% Maintained at <http://konx.net/biblatex-mla> by James Clawson.
% biblatex-mla.tex v2.0 2013/03/23
% 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>.
%
Expand All @@ -14,12 +14,12 @@
\usepackage{booktabs}
\usepackage{shortvrb}
\MakeAutoQuote{<}{>}
\MakeAutoQuote*{«}{»}
% \MakeAutoQuote*{«}{»}
\MakeShortVerb{\|}

\rcsid{$Id: biblatex-mla.tex,v 1.0 2011/05/20 13:01:50 clawson beta $}
\rcsid{$Id: biblatex-mla.tex,v 2.0 2013/03/23 13:01:50 clawson $}

\newcommand*{\BiblatexMLAhome}{http://konx.net/biblatex-mla/}
\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.
Expand Down Expand Up @@ -122,7 +122,7 @@ \section{Introduction}

\subsection{License}

\sty{Biblatex-mla} is copyrighted \textcopyright\ 2007--2011, 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}.
\sty{Biblatex-mla} is copyrighted \textcopyright\ 2007--2013, 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}
Expand All @@ -135,7 +135,7 @@ \section{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}.} %
\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 GitHub 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:
Expand All @@ -147,7 +147,7 @@ \section{Use}
\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}.
Replace <|<bibfile>|> with the name of your .bib bibliography file. The style (provisionally) 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}
Expand All @@ -173,7 +173,7 @@ \subsection{Commands}
\end{verbatim}
\end{quote}

When citing a page number without any prenote, only one set of square brackets are needed:
When citing a page number without any prenote, only one set of square brackets is needed:
\begin{quote}
\begin{verbatim}
\autocite[y]{x}
Expand Down Expand Up @@ -218,7 +218,7 @@ \subsection{Package Options}
\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:
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 \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}
Expand Down Expand Up @@ -285,7 +285,7 @@ \section{Database Guide}

Whether exporting from Zotero or another program, whether managing your .bib files in a standalone editor or manipulating them in a text editor, you will at some point have to know the fields available to \sty{biblatex-mla}---especially as some of these are unique to \sty{biblatex}, and as I've had to repurpose some of the fields to suit \sty{biblatex-mla}. Below are the different \sty{@types} and the fields available to them. 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{Unusual Fields}
\subsection{Unusual Fields}\label{mla:subsec:unnusualfields}
\sty{Biblatex} supports the following fields, usually concerned more with presentation than bibliographic merit, in all entrytypes. Define these in your \mycode{.bib} files:

\begin{optionslist}
Expand Down
119 changes: 0 additions & 119 deletions english-mla-old.lbx

This file was deleted.

27 changes: 25 additions & 2 deletions english-mla.lbx
Original file line number Diff line number Diff line change
@@ -1,8 +1,31 @@
% english-mla.lbx v1.0 2012/08/30
% english-mla.lbx v0.4.5 2013/03/24

\ProvidesFile{english-mla.lbx}[2012/08/30 v1.0 biblatex style localization]
\ProvidesFile{english-mla.lbx}[2013/03/24 v0.4.5 biblatex style localization]
\InheritBibliographyExtras{english}

\DeclareBibliographyExtras{%
\protected\def\mkbibdatelong#1#2#3{%
\iffieldundef{#3}
{}
{\thefield{#3}%
\iffieldundef{#2}{}{\nobreakspace}}%
\iffieldundef{#2}
{}
{\mkbibmonth{\thefield{#2}}%
\iffieldundef{#1}{}{\space}}%
\stripzeros{\thefield{#1}}}%
\protected\def\mkbibdateshort#1#2#3{%
\iffieldundef{#3}
{}
{\mkdatezeros{\thefield{#3}}%
\iffieldundef{#2}{}{/}}%
\iffieldundef{#2}
{}
{\mkdatezeros{\thefield{#2}}%
\iffieldundef{#1}{}{/}}%
\mkdatezeros{\thefield{#1}}}%
}

\DeclareBibliographyStrings{%
inherit = {english},
bibliography = {{Works Cited}{Works Cited}},
Expand Down
Binary file added examples.pdf
Binary file not shown.
19 changes: 19 additions & 0 deletions examples.tex
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
\documentclass[a4paper]{article}
\usepackage[T1]{fontenc}
\usepackage[american]{babel}
\usepackage{csquotes}
\usepackage[style=mla]{biblatex}
\addbibresource{handbooksamples.bib}
\usepackage{hyperref}
\begin{document}
% \cite[20]{caro02aa}
\cite[test][22]{caro02aa}
\cite[23]{doctorow82aa}
\cite[24]{caro02ab}
\cite[24]{doctorow96aa}
\cite{Grammar-Girl2008}
\cite{buzetto-more2007aa}

\nocite{*}
\printbibliography
\end{document}
Loading

0 comments on commit 99ea1da

Please sign in to comment.