diff options
author | Karl Berry <karl@freefriends.org> | 2012-07-11 23:30:43 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-07-11 23:30:43 +0000 |
commit | 562ae685591240b0ea768aa3de044339bcaee64e (patch) | |
tree | fe67bf362ccf70a9434b3a4ed2760af84eaa42ab /Master/texmf-dist/doc/latex/biblatex-chicago/README | |
parent | 6d1e02f252c44d2e43c13d9d0608e628812a8a90 (diff) |
biblatex-chicago 16th (6jul12)
git-svn-id: svn://tug.org/texlive/trunk@27002 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-chicago/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-chicago/README | 115 |
1 files changed, 68 insertions, 47 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/README b/Master/texmf-dist/doc/latex/biblatex-chicago/README index 77c5c2354af..c964fb09b9e 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/README +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/README @@ -1,41 +1,58 @@ 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 -- 1.7 is -current. If you have used the package before, 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. Most particularly please note that Biber 0.9.6 is now required -for the author-date style, and indeed for the notes & bibliography -style if you choose to use Biber with it. +is intended for use only with version 1.7 of biblatex, and hasn't been +tested with version 2.0, now in beta. It contains, for the first +time, both the 15th- and 16th-edition Chicago style files. If you +have used the package before, 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. Most +particularly please note that Biber 0.9.8 or 0.9.9 is now required for +the author-date style, and indeed for the notes & bibliography style +if you choose to use Biber with it. -README (version 0.9.8d, 2011-11-15): +README (version 0.9.9, 2012-07-05): -Biblatex-chicago contains two biblatex styles implementing the -specifications of the Chicago Manual of Style, 15th edition. (If you -are interested in adopting the changes introduced in the 16th edition, -published last fall, then please note that the next release of -biblatex-chicago will provide what you need.) The "notes & -bibliography" style was formerly available in the package -biblatex-chicago-notes-df, and is intended primarily for writers in -the humanities, whereas the "author-date" style is generally favored -by writers in the sciences and social sciences. +Biblatex-chicago contains four biblatex styles implementing the +specifications of the Chicago Manual of Style in both its 15th and +16th editions. The "notes & bibliography" style was formerly +available in the package biblatex-chicago-notes-df, and is intended +primarily for writers in the humanities. I would encourage all users +of the 15th edition style to upgrade to the 16th: it contains many new +features, and the changes involved, being largely incremental, +generally won't require major alterations to your .bib files. The +"author-date" style, generally favored by writers in the sciences and +social sciences, presents a somewhat different case. The 16th edition +of the Manual has brought the presentation of sources in this style +much more into line with the notes & bibliography specification, +especially regarding the formatting of titles. If you still require +titles to be capitalized sentence style, and article titles, for +example, not to be enclosed in quotation marks, then you may wish to +continue using the 15th-edition files until I have provided, in the +next release, these features as an option to the 16th-edition style. +Other users should upgrade to the most recent specification. To +continue using the 15th-edition files, you'll need to specify +"notes15" or "authordate15" in the options when loading +biblatex-chicago. This is a beta release, but its feature set is already fairly extensive. If you have used the package before 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. +biblatex-chicago.pdf (and/or biblatex-chicago15.pdf), which contain +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 those +same pdf files, which contain both a Quickstart section and a complete +reference guide to both notes & bibliography and author-date 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, cms15-notes-sample.tex, cms15-dates-sample.tex) +or my system (cms-notes-sample.pdf, cms-dates-sample.pdf, +cms15-notes-sample.pdf, cms15-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 @@ -44,7 +61,7 @@ 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 +know, or better yet, send a patch. As the 16th edition styles are 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 @@ -57,19 +74,20 @@ biblatex-chicago.pdf. Installation: -With the recent proliferation of files, I have thought it best to -implement, with this release, a different directory structure for the -package archive. I have adopted the structure found in biblatex.zip, -so if you want to place these files in your TeX directory tree instead -of in your working directory, I recommend the following, which should -be familiar from the main biblatex package: +With the recent proliferation of files, I have adopted the directory +structure found in biblatex.zip, so if you want to place these files +in your TeX directory tree instead of in your working directory, I +recommend the following, which should be familiar from the main +biblatex package: - - The nine files biblatex-chicago.sty, chicago-notes.cbx, + - The thirteen 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 are located in the latex/ subdirectory, itself - further subdivided into bbx/, cbx/, and lbx/. The entire contents - of this latex/ directory, including its subdirectories, can go in + chicago-notes15.cbx, chicago-notes15.bbx, chicago-authordate15.cbx, + chicago-authordate15.bbx, cms-american.lbx, cms-french.lbx, + cms-german.lbx, and cms-ngerman.lbx are located in the latex/ + subdirectory, itself further subdivided into bbx/, cbx/, and lbx/. + The entire contents of this latex/ directory, including its + subdirectories, 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, @@ -78,19 +96,22 @@ be familiar from the main biblatex package: remember to update your TeX file name database so that TeX can find them. - - The eight files biblatex-chicago.tex, biblatex-chicago.pdf, + - The fourteen files biblatex-chicago.tex, biblatex-chicago.pdf, + biblatex-chicago15.tex, biblatex-chicago15.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 all be - found in the doc/ directory in the package archive, the last 6 in - the examples/ subdirectory. You can place all of this in + cms-dates.sample.pdf, cms15-notes-sample.tex, + cms15-dates-sample.tex, cms15-notes-sample.pdf, + cms15-dates.sample.pdf, notes-test.bib, and dates-test.bib can all + be found in the doc/ directory in the package archive, the last 10 + in the examples/ subdirectory. You can place all of this in <TEXMFLOCAL>/doc/latex/biblatex-contrib/biblatex-chicago. Changelog: See the RELEASE file, and also the end of -biblatex-chicago.pdf. +biblatex-chicago.pdf (or biblatex-chicago15.pdf). -Copyright (c) 2008-2011 David Fussner. This package is +Copyright (c) 2008-2012 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 |