diff options
Diffstat (limited to 'macros/latex/contrib/biblatex/README')
-rw-r--r-- | macros/latex/contrib/biblatex/README | 165 |
1 files changed, 165 insertions, 0 deletions
diff --git a/macros/latex/contrib/biblatex/README b/macros/latex/contrib/biblatex/README new file mode 100644 index 0000000000..4137b2420e --- /dev/null +++ b/macros/latex/contrib/biblatex/README @@ -0,0 +1,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.md'. |