summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex/README
blob: 0f98620216eef7c9669fba598713c721bc58072b (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
ABOUT

The biblatex package is a complete reimplementation of the
bibliographic facilities provided by LaTeX. A custom backend "biber"
by default is used which processed the BibTeX format data files and
them performs all sorting, label generation (and a great deal
more). Legacy BibTeX is also supported as a backend, albeit with a
reduced feature set. Biblatex does not use the backend to format the
bibliography information as with traditional BibTeX: 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.). With biber as the
backend, features such as customisable sorting, multiple bibliographies
with different sorting, customisable labels, dynamic data modification
are available. The package is fully localized and can interface with
the babel package.

LICENSE

Copyright (c) 2006-2012 Philipp Lehman, 2012-present Philip Lehman,
Joseph Wright, Audrey Boruvka, Philip Kime). 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 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 github to report bugs
or submit feature requests:

   https://github.com/plk/biblatex

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/polyglossia
- csquotes 4.4 or later

Biber is available from CTAN, via TeXLive or from 

https://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

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

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

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

   or download the file

   https://mirror.ctan.org/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).

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