summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-software/README.md
blob: cfd7f303a0406f2141ba0947e623f3a0af064207 (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
# biblatex software style

This directory contains the reference `biblatex` implementation of a
bibliography style extension that includes software-specific BibTeX entries.

## Relevant files 

The key files are the following:

 - `software.bbx` for the bibliography style extension
 - `software.dbx` for the data model extension to support the new entries
 - `english-software.lbx` and `french-software.lbx` for the localization
 - `software-biblatex.sty` the LaTeX package to include for using the style as an extension

The distribution contains other material, for demonstration purposes, and for
more advanced use.

## Documentation

Full documentation of the style, with a description of the new entries and
fields and detailed examples, is in `software-biblatex.tex`; a compiled PDF
version is included as `software-biblatex.pdf` for ease of reference.

We recall briefly here the two main approaches available for using this style extension.

### Using the software biblatex style as an extension

The simplest way to use this style is to follow the example given
in the file `sample-use-sty.tex` that shows how one can *extend* any
existing `biblatex` style by simply doing the following:

 - pass the `datamodel=software` option to the `biblatex` package
 - load the software biblatex style with `\usepackage{software-biblatex}`
 - set software specific bibliography options using the macro `\ExecuteBibliographyOptions`;
   the options with their default values are as in
   `\ExecuteBibliographyOptions{halid=true,swhid=true,swlabels=true,vcs=true,license=true}`

This approach is extremely simple: it only requires that you include the relevant files
mentioned above in the directory where your LaTeX file is located.

### Generating biblatex styles that include the software entries

It may be useful to generate a new biblatex style that includes support for the
software entries right away.

A simple mechanism is provided for this use case:

 - add to the `stublist` file the names of all the existing styles one needs to extend
 - run `make biblatex-styles` to produce new style files, with an added `+sw` suffix,
   for each of the existing style
 - install the newly generated files in the standard path where `biblatex` files are found

The stock `stublist` file contains the names of all the standard `biblatex`
styles.  If this approach is followed, then one can load directly the extended
file, and the software specific bibliography options become available when
loading the `biblatex` package directly.  See the `sample.tex` file for a
concrete example.

# License

This material is subject to the LATEX Project Public License version 1.3 or (at
your option) any later version.

# Contact author

This style is maintained by Roberto Di Cosmo <roberto@dicosmo.org>