summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-publist/README
blob: ceb2264c24a217aeb9c515efa3e48a45cdf86b9a (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
==================================================================
The biblatex-publist package

A biblatex bibliography style file to produce academic
publication lists.

Maintained by Jürgen Spitzmüller
E-mail: juergen (at) spitzmueller (dot) org
Code repository and issue tracker:
    https://github.com/jspitz/biblatex-publist

Released under the LaTeX Project Public License v1.3 or later
See http://www.latex-project.org/lppl.txt
==================================================================

== PURPOSE ==

The biblatex-publist package provides a biblatex bibliography
style file (*.bbx) for publication lists, i.e. a bibliography
containing one's own publications. The style file draws on
biblatex's authoryear style per default (which can be changed),
but provides some extra features needed for publication lists,
such as the omission of the own name from author or editor data.

The package requires at least version 3.4 of the biblatex
package.


== CONTENTS ==

The package consists of the following files:

* publist.bbx (biblatex bibliography style file)
* publist.cbx (biblatex citation style file)
* biblatex-publist.pdf (package documentation)
* biblatex-publist.tex (documentation source)
* README (this very file)


== DOCUMENTATION ==

See the included manual biblatex-publist.pdf for usage
instructions.


== CHANGES ==

* V. 1.18 (2020-07-31)
	- Support name truncation via maxnames.
	- Fix mine filter with author lists longer than maxnames.
	- Fix double editor with @periodical type.
	- Use editortypedelim.

* V. 1.17 (2020-07-10):
	- Add options to get clickable titles.

* V. 1.16 (2019-04-16):
	- Major code cleanup.

* V. 1.15 (2019-02-22):
	- Add support for omitting multiple authors.
	- Fix documentation issues.

* V. 1.14 (2019-02-21):
	- Add support for highlighting multiple authors.
	- Fix handling of non-ASCII names.
	- Use \DeclareStyleSourcemap rather that \DeclareSourcemap.
	- Update sorting documentation in the wake of biblatex changes.

* V. 1.13 (2018-11-30):
        - Introduce new sorting templates that ignore names.
        - CHANGE OF OUTPUT! Use ydt tempate by default.
        - Assign extralabel independent of author group with plauthorhandling=omit.

* V. 1.12 (2018-11-25):
        - Switch name parsing toggles globally (fixes regression with biblatex 3.12).
        - Account for omitted author when adding \finalnamedelim.
        - Fix issue with initial dot in nameorder=family-given.
	- Add option "plauthorfirstinit" that allows for specifying initials in
          first names of \plauthorname.

* V. 1.11 (2018-09-01):
	- Fix marginyear=true with labeldateparts=false.
	- Fix problem with empty parentheses in article with standard base style
	  and with labeldateparts=false.

* V. 1.10 (2018-04-08):
	- Extend option "plnumbered" with "plnumbered=reset".
	  This allows to restart the numbering of the publication list items
	  at \refsection's.
	- Documentation improvements.

* V. 1.9 (2018-03-01):
	- Add option "plnumbered" to switch of numbering in bibliography.
	- Documentation improvements.

* V. 1.8 (2017-11-14):
	- Adapt to biblatex 3.8. This version is now required.
	- Rename some macros, using pseudo-namespaces:
		* date:makedate => bpl:date:makedate
	    	* date:labelyear+extrayear => bpl:date:labeldate+extradate
	    	* marginyear => bpl:marginyear
	    	* rauthor => bpl:review:author
	    	* rauthor/label => bpl:review:author/label
	    	* year+labelyear => bpl:year+labelyear

* V. 1.7 (2017-04-12):
        - Output marginyear before the author list. This prevents it from being vertically
          shifted in case of long author lists.

* V. 1.6 (2017-04-02):
	- New option 'nameorder' that allows to change the ordering of author and editor
	  name ("given-family" vs. "family-given" [= default]).
	- Use proper name delimiters also for bookauthor.

* V. 1.5 (2017-02-28):
	- Fix extra "and" in name list with plauthorhandling=highlight.
	- Whitespace fix with plauthorhandling=highlight.
	- Use proper name delimiters.

* V. 1.4 (2017-02-12):
	- New option 'plauthorhandling' that defines how the publist author is
	  handled in the publication list (possible values: "omit" [= default],
	  "highlight").
	- New command \plauthorhl that determines the aforementioned highlighting.
	- Rename \omitname to \plauthorname (the old macro is still functional,
	  but marked as deprecated).
	- Rename omit* options to plauthor* (the old options are still functional,
	  but marked as deprecated).
	- Assure the margin text always starts uppercased (relevant for pubstates).
	- Minor corrections to the manual.

* V. 1.3 (2016-08-06):
	- It is now possible to change the base style that is used.
	- Proper sorting of pubstates.
	- Add possibility to increase the indentation of items (by means
          of the length extralabelnumberwidth).
	- Use pagetracker=true instead of pagetracker=spread by default
	  (avoids warning, no change in functionality).

* V. 1.2 (2016-05-12):
	- Accomodate to the backwards-incompatible changes of biblatex 3.4
	  (prefixnumber > labelprefix, \ifempty > \ifdefvoid).
	  This version of biblatex is now required.

* V. 1.1 (2016-03-09):
	- Adapt to the \Declare*Name changes of biblatex 3.3.

* V. 1.0 (2015-01-04):
	- Add portmanteau *.cbx file to allow loading biblatex-publist
	  also via the "style" option (next to "bibstyle").

* V. 0.9 (2014-03-13):
	- Fix problem with multi-token names.
	- Support name prefix in \omitname.
	- Support for pubstate.

* V. 0.8 (2013-08-16):
	- Add custom sorting schemes "ddnt", "ydmdnt" and "dnt".
	- Revise the documentation.

* V. 0.7 (2013-07-25):
	- Support full dates.

* V. 0.6 (2013-07-21):
	- Fix numbering with recent biblatex versions.

* V. 0.5 (2013-05-03):
	- Fix numbering if \printbibliography is used multiple
	  times without refsection.

* V. 0.4 (2012-10-30):
	- More robust name parsing (especially for names with
	  non-ASCII characters encoded with LaTeX macros).
	- Add \omitname command.
	- Support "firstinits" option.

* V. 0.3 (2012-10-23):
	- Bug fix: Add missing "and" if omitted name was last
	  minus one.
	- Bug fix: Fix output with "et al." if omitted name is
	  first and liststop is 1.
	- Set maxnames default to 4.
	- Add filter possibility.
	- Add French localization.
	- Some corrections to the manual.

* V. 0.2 (2012-10-21): Initial release to CTAN.