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
|
# biblatex-oxref: Biblatex styles inspired by the *Oxford Guide to Style*
This bundle provides two [biblatex] styles that implement (some of) the
stipulations and examples provided by the 2014 *New Hart's Rules* and the 2002
*Oxford Guide to Style*:
* `oxnotes` is a style similar to the standard `verbose`,
intended for use with footnotes;
* `oxyear` is a style similar to the standard `authoryear`,
intended for use with parenthetical in-text citations.
Both styles should be considered experimental. In particular, the ways in which
the styles handle certain tricky references are subject to change.
[biblatex]: http://ctan.org/pkg/biblatex
## Installation
### Dependencies
To compile the documentation you will need to have the [minted] package working,
which in turn relies on Python 2.6+ and Pygments. See the documentation of that
package for details.
### Automated way
A makefile is provided which you can use with the Make utility on
UNIX-like systems:
* Running `make source` generates the derived files
- README.md
- oxref.bbx, oxnotes.bbx, oxyear.bbx
- oxnotes.cbx, oxyear.cbx
- american-oxref.lbx, british-oxref.lbx, english-oxref.lbx
- oxnotes.dbx, oxyear.dbx
- oxref.bib
- oxref.ins
- oxnotes-doc.tex, oxyear-doc.tex
* Running `make` generates the above files and also oxref.pdf,
oxnotes-doc.pdf, and oxyear-doc.pdf.
* Running `make inst` installs the files in the user's TeX tree.
You can undo this with `make uninst`.
* Running `make install` installs the files in the local TeX tree.
You can undo this with `make uninstall`.
* Running `make clean` removes auxiliary files from the working directory.
* Running `make distclean` removes the generated files from the working
directory as well.
### Manual way
To install the bundle from scratch, follow these instructions. If you have
downloaded the zip file from the [Releases] page on GitHub, you can skip the
first two steps.
1. Run `luatex oxref.dtx` to generate the source files. (You can safely skip
this step if you are confident about step 2.)
2. Compile oxref.dtx, oxnotes-doc.tex and oxyear-doc.tex with LuaLaTeX and
Biber to generate the documentation. You will need to enable shell escape
so that [minted] can typeset the listings.
3. Move the files to your TeX tree as follows:
- `source/latex/biblatex-oxref`:
oxref.dtx,
(oxref.ins)
- `tex/latex/biblatex-oxref`:
american-oxref.lbx,
british-oxref.lbx,
english-oxref.lbx,
oxnotes.bbx,
oxnotes.cbx,
oxnotes.dbx,
oxref.bbx,
oxyear.bbx,
oxyear.cbx,
oxyear.dbx
- `doc/latex/biblatex-oxref`:
README.md,
oxnotes-doc.pdf,
oxnotes-doc.tex,
oxref.bib,
oxref.pdf,
oxyear-doc.pdf,
oxyear-doc.tex
4. You may then have to update your installation's file name database
before TeX and friends can see the files.
[Releases]: https://github.com/alex-ball/biblatex-oxref/releases
[minted]: http://ctan.org/pkg/minted
## Licence
Copyright 2016–7 Alex Ball.
This work consists of the documented LaTeX file oxref.dtx and a Makefile.
The text files contained in this work may be distributed and/or modified
under the conditions of the [LaTeX Project Public License (LPPL)][lppl],
either version 1.3c of this license or (at your option) any later
version.
This work is ‘maintained’ (as per LPPL maintenance status) by [Alex Ball][me].
[lppl]: http://www.latex-project.org/lppl.txt "LaTeX Project Public License (LPPL)"
[me]: https://alexball.me.uk/ "Alex Ball"
|