$Id: README,v 0.9 2010/02/14 15:42:33 lehman beta $ ABOUT The biblatex package is a complete reimplementation of the bibliographic facilities provided by LaTeX in conjunction with BibTeX. It redesigns the way in which LaTeX interacts with BibTeX at a fairly fundamental level. With biblatex, BibTeX is only used to sort the bibliography and to generate labels. Instead of being implemented in BibTeX's style files, the formatting of the bibliography is entirely controlled by TeX macros. Good working knowledge in LaTeX should be sufficient to design new bibliography and citation styles. There is no need to learn BibTeX's postfix stack language. Just like the bibliography styles, all citation commands may be freely (re)defined. Apart from the features unique to biblatex, the package also incorporates core features of the following packages: babelbib, backref, bibtopic, bibunits, chapterbib, cite, citeref, inlinebib, mlbib, multibib, natbib, splitbib. There are also some conceptual parallels to the amsrefs package. The biblatex package supports split bibliographies, multiple bibliographies within one document, and separate lists of bibliographic shorthands. Bibliographies may be subdivided into parts (by chapter, by section, etc.) and/or segmented by topics (by type, by keyword, etc.). The package is fully localized and can interface with the babel package. LICENSE Copyright (c) 2006--2010 Philipp Lehman. Permission is granted to copy, distribute and/or modify this software under the terms of the LaTeX Project Public License (LPPL), version 1.3. This package is author-maintained. 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. FEEDBACK Please use the biblatex project page on SourceForge to report bugs or submit feature requests: http://sourceforge.net/projects/biblatex/ There are two trackers on this page, 'Bugs' for bug reports and 'Features' for feature requests: http://sourceforge.net/tracker2/?group_id=244752 Select a tracker, then click on "Add new" to submit your report or request. If you do not want to report a bug or request a feature but are simply in need of assistance, you might want to consider posting your question on the comp.text.tex newsgroup. I can not provide any end-user support by email or via the project page. REQUIREMENTS Strictly required: - e-TeX - BibTeX - etoolbox 1.8 or later - keyval - ifthen - url Strongly recommended: - Biber or bibtex8 - csquotes 4.4 or later - babel etoolbox and csquotes are non-standard but available from CTAN: http://www.ctan.org/tex-archive/macros/latex/contrib/etoolbox/ http://www.ctan.org/tex-archive/macros/latex/contrib/csquotes/ SEMI-AUTOMATIC INSTALLATION Get the file biblatex.tds.zip from ftp://tug.ctan.org/tex-archive/install/macros/latex/exptl/ or http://sourceforge.net/projects/biblatex/files/ and move it to the root directory of the local TeX installation tree, for example /usr/local/share/texmf/ or /usr/share/texmf-local/ or C:\Local TeX Files\ Unzip the file in place. Don't forget to update the file hash tables (also known as the file name database) after installing the files. On teTeX and TeX Live systems, run texhash as root ('sudo texhash'). On MiKTeX, run 'initexmf --update-fndb' in a command window or use the 'Refresh FNDB' button of the MiKTeX Options window. Please see the TeX FAQ at http://www.tex.ac.uk/faq for further hints about package installation. MANUAL INSTALLATION Copy all files and subdirectories in the 'latex' directory to: /tex/latex/biblatex/ where denotes the root of the local TeX installation tree, for example /usr/local/share/texmf/ or /usr/share/texmf-local/ or C:\Local TeX Files\ Copy all files in the 'bibtex/bst' subdirectory to: /bibtex/bst/biblatex/ Copy all files in the 'bibtex/bib' subdirectory to: /bibtex/bib/biblatex/ If you are using bibtex8, copy all files in the 'bibtex/csf' subdirectory to: /bibtex/csf/biblatex/ Note that you may need to set/adjust the environmental variables BIBTEX8_BSTINPUT, BIBTEX8_BIBINPUT, and BIBTEX8_CSFINPUT for biblatex8 to work properly. The manual ('biblatex.pdf') and the files in 'doc/examples' go to /doc/latex/biblatex/ or to any other place where you will find it later. Note that you may have to create those directories if this is the first package you're installing locally (as opposed to via a package manager). Don't forget to update the file hash tables (also known as the file name database) after installing the files. On teTeX and TeX Live systems, run texhash as root ('sudo texhash'). On MiKTeX, run 'initexmf --update-fndb' in a command window or use the 'Refresh FNDB' button of the MiKTeX Options window. Please see the TeX FAQ at http://www.tex.ac.uk/faq for further hints about package installation. ADDITIONAL RESOURCES latin1.csf A codepage and sort definition file for the 8-bit implementation of BibTeX. This file adds support for ISO 8859-1 (Latin 1). It is a modified and expanded version of the 88591lat.csf file that ships with bibtex8. latin1.csf implements a generic sorting order; the latin1_*.csf files are optimized for specific languages. latin9.csf A codepage and sort definition file for the 8-bit implementation of BibTeX. This file adds support for ISO 8859-15 (Latin 9). latin9.csf implements a generic sorting order; the latin9_*.csf files are optimized for specific languages. winansi.csf A codepage and sort definition file for the 8-bit implementation of BibTeX. This file adds support for Microsoft Codepage 1252 (Windows Ansi). winansi.csf implements a generic sorting order; the winansi_*.csf files are optimized for specific languages. bibtoolrsc A configuration file for bibtool with support for the additional entry types and fields provided by biblatex. Add the contents of this file to your existing '.bibtoolrsc' file. USAGE Refer to biblatex.pdf for a systematic reference manual and to the 'doc/examples' subdirectory for usage examples. CHANGES A list of changes relevant to users of this package is included at the end of 'biblatex.pdf'. See also the release notes in 'RELEASE'.