summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex/README
blob: f54904fb4a61c18a0d45ccea94bc771ccb4b1c76 (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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
$Id: README,v 1.6 2011/07/29 19:21:28 lehman stable $

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-2011 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, bibtex8, or Biber
- etoolbox 2.1 or later
- logreq 1.0 or later
- keyval
- ifthen
- url

Strongly recommended:

- Biber
- babel
- csquotes 4.4 or later

Biber is available from CTAN or:

http://sourceforge.net/projects/biblatex-biber/

AUTOMATIC INSTALLATION

TeX Live: The biblatex package is included in TeX Live.
          Use the TeX Live package manager to install it.
	  Biber can also be installed with the package manager.

MiKTeX:   The biblatex package is included in MiKTeX.
          Use the MiKTeX package manager to install it.
	  Biber can also be installed with the package manager.

SEMI-AUTOMATIC INSTALLATION

1. Get the file biblatex-<version>.tds.zip from

   http://sourceforge.net/projects/biblatex/files/

   or download the file

   http://www.ctan.org/tex-archive/install/macros/latex/contrib/biblatex.tds.zip

2. Unpack the archive in 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\

3. Update the file hash tables (also known as the file name
   database).
   
   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.

MANUAL INSTALLATION

1. Get the file biblatex-<version>.tar.gz from

   http://sourceforge.net/projects/biblatex/files/

   or download the file

   http://www.ctan.org/tex-archive/macros/latex/contrib/biblatex.zip

2. Unpack the archive in a temporary working directory.

3. Copy all files and subdirectories in the 'latex' directory to:

   <texmflocal>/tex/latex/biblatex/

   where <texmflocal> 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\

4. Copy all files in the 'bibtex/bst' subdirectory to:

   <texmflocal>/bibtex/bst/biblatex/

5. Copy all files in the 'bibtex/bib' subdirectory to:

   <texmflocal>/bibtex/bib/biblatex/

6. If you are using bibtex8, copy all files in the 'bibtex/csf'
   subdirectory to:

   <texmflocal>/bibtex/csf/biblatex/

7. The manual and example files in 'doc' subdirectory go to

   <texmflocal>/doc/latex/biblatex/

8. Update the file hash tables (also known as the file name
   database).

   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.

Note that you may have to create some or all of the above
directories if this is the first package you're installing locally
(as opposed to via a package manager).

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.

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'.