summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-chicago/README
blob: 41f15a9331cab276044d34874f968348f63e60cf (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
IMPORTANT NOTE:

This is the package formerly known as biblatex-chicago-notes-df.  It
is intended for use only with the latest version of biblatex -- you
need at least version 0.9c, though 0.9d is current.  If you have been
using biblatex-chicago-notes-df, then you should be sure to consult
the RELEASE file to find out what alterations you may need to make to
your .bib files and document preambles to bring them up to date.

README (version 0.9.5a):

Biblatex-chicago contains two biblatex styles implementing the
specifications of the Chicago Manual of Style, 15th edition.  The
"notes & bibliography" style was formerly available in the package
biblatex-chicago-notes-df, and is intended primarily for writers in
the humanities.  The "author-date" style is new to this release, and
is generally favored by writers in the sciences and social sciences.

This is a beta release, but its feature set is already fairly
extensive.  If you have used the package before under its old name you
may, after perusing the RELEASE file, want to look at the changelog at
the end of biblatex-chicago.pdf, which contains cross-references to
more detailed explanations about how this update will affect parts of
your .bib file.  If you are just getting started, the best way to
learn the system is to read the documentation in that same pdf file,
which contains both a Quickstart section and a complete reference
guide to both styles (sections 4 and 5).  The package also contains
annotated .bib files (notes-test.bib and dates-test.bib) which each
offer over 100 entries demonstrating how to present a wide range of
sources, nearly all of them taken from the Chicago Manual of Style
itself, so that you can compare the output of your system
(cms-notes-sample.tex, cms-dates-sample.tex) or my system
(cms-notes-sample.pdf, cms-dates-sample.pdf) with the actual examples
in the Manual.

I have, wherever possible, attempted to maintain backward
compatibility with the standard biblatex styles, but there are a
significant number of situations where I have been unable to do so,
which means that switching among various styles while using the same
bibliography database will not be as simple and painless as it could
be.  If you can see ways better to preserve this compatibility, or
indeed to improve the package in any way whatsoever, please let me
know, or better yet, send a patch.  As the author-date style is
relatively new, now is the time to suggest changes in field or
entry-type usage there, before questions of backward compatibility
become more pressing.  If the styles don't behave as you expect or if
you discover a bug, I'd be very happy to hear about it, but do please
read biblatex-chicago.pdf first, as you may find that your question
has already been answered there.  If you do find a bug, please send me
the .bib entry, your LaTeX preamble, and your output .log, so that I
can try to reproduce it here.  My email address is at the head of
biblatex-chicago.pdf.

Installation:

If you wish to place these files in your TeX directory tree instead of
in your working directory, I recommend the following for the moment,
an arrangement which at least has the virtue of minimizing the
footprint of the package in the main tree, allowing for easier
updating:

 - The nine files biblatex-chicago.sty, chicago-notes.cbx,
   chicago-notes.bbx, chicago-authordate.cbx, chicago-authordate.bbx,
   cms-american.lbx, cms-french.lbx, cms-german.lbx, and cms-ngerman.lbx
   can go in <TEXMFLOCAL>/tex/latex/biblatex-contrib/biblatex-chicago,
   where <TEXMFLOCAL> is the root of your local TeX installation --
   for example, and depending on your system, /usr/share/texmf-local,
   /usr/local/texmf, or C:\Local TeX Files\.  You may need to create
   this directory first, and after copying the files there please
   remember to update your TeX file name database so that TeX can find
   them.

 - The eight files biblatex-chicago.tex, biblatex-chicago.pdf,
   cms-notes-sample.tex, cms-dates-sample.tex, cms-notes-sample.pdf,
   cms-dates.sample.pdf, notes-test.bib, and dates-test.bib can go in
   <TEXMFLOCAL>/doc/latex/biblatex-contrib/biblatex-chicago.


Changelog: See the RELEASE file, and also the end of
biblatex-chicago.pdf.


Copyright (c) 2008-2010 David Fussner.  This package is
author-maintained.  This work may be copied, distributed and/or
modified under the conditions of the LaTeX Project Public License,
either version 1.3 of this license or (at your option) any later
version.  The latest version of this license is in
http://www.latex-project.org/lppl.txt and version 1.3 or later is part
of all distributions of LaTeX version 2005/12/01 or later.  This
software is provided "as is," without warranty of any kind, either
expressed or implied, including, but not limited to, the implied
warranties of merchantability and fitness for a particular purpose.