How many authors would be emitted for entry, considering style and entry.getIsFirstAppearanceOfSource() If entry is unresolved, return 0.

Parameters

authorList:@NonNull AuthorList

Parsed list of authors.

maxAuthors:int

The maximum number of authors to write out. If there are more authors, then ET_AL_STRING is emitted to mark their omission. Set to -1 to write out all authors. maxAuthors=0 is pointless, now throws IllegalArgumentException (Earlier it behaved as maxAuthors=1) maxAuthors less than -1 : throw IllegalArgumentException

andString:String

For "A, B[ and ]C"

Returns:String

"Au[AS]Bu[AS]Cu[OXFORD_COMMA][andString]Du[yearSep]" or "Au[etAlString][yearSep]" where AS = AUTHOR_SEPARATOR Au, Bu, Cu, Du are last names of authors.

Note

- The "Au[AS]Bu[AS]Cu" (or the "Au") part may be empty (maxAuthors==0 or nAuthors==0). - OXFORD_COMMA is only emitted if nAuthors is at least 3. - andString is only emitted if nAuthors is at least 2.

Look up the nth author and return the "proper" last name for citation markers.

Parameters

authorList:AuthorList

The author list.

number:int

The number of the author to return.

Returns:String

The author name, or an empty String if inapplicable.

Produce (Author, year) or "Author (year)" style citation strings.

Parameters

purpose:OOBibStyleGetCitationMarker.AuthorYearMarkerPurpose

IN_PARENTHESIS and NORMALIZED puts parentheses around the whole, IN_TEXT around each (year,uniqueLetter,pageInfo) part. NORMALIZED omits uniqueLetter and pageInfo, ignores isFirstAppearanceOfSource (always style.getMaxAuthors, not getMaxAuthorsFirst)

entries:List<CitationMarkerEntry>

The list of CitationMarkerEntry values to process. Here we do not check for duplicate entries: those are handled by getCitationMarker by omitting them from the list. Unresolved citations recognized by entry.getBibEntry() and/or entry.getDatabase() returning empty, and emitted as "Unresolved${citationKey}". Neither uniqueLetter nor pageInfo are emitted for unresolved citations.

startsNewGroup:boolean[]

Should have the same length as entries, and contain true for entries starting a new group, false for those that only add a uniqueLetter to the grouped presentation.

maxAuthorsOverride:Optional<Integer>

If not empty, always show this number of authors. Added to allow NORMALIZED to use maxAuthors value that differs from style.getMaxAuthors()

Returns:OOText

The formatted citation.

This method looks up a field for an entry in a database. Any number of backup fields can be used if the primary field is empty.

Parameters

fields:OrFields

A list of fields, to look up, using first nonempty hit. If backup fields are needed, separate field names by /. E.g. to use "author" with "editor" as backup, specify FieldFactory.serializeOrFields(StandardField.AUTHOR, StandardField.EDITOR)

Returns:String

The resolved field content, or an empty string if the field(s) were empty.

Returns:Optional<OOBibStyleGetCitationMarker.FieldAndContent>

the field and the content of the first nonempty (after trimming) field (or alias) from fields found in entry. Return Optional.empty() if found nothing.