BIBCITE.php
WIKINDX : Bibliographic Management system.
Tags
Table of Contents
Functions
- settings() : mixed
- Deal with various settings, setting, getting, incrementing, decrementing etc.
- getNameString() : string
- Get the nameString variable
- checkInitials() : string
- Handle initials.
- hyphenatedInitials() : string
- Deal with hyphenated firstnames as initials
- addCreatorDelimiters() : void
- Add delimiters to creators
- formatMultiplePages() : string
- Format multiple pages.
- titleCapitalization() : string
- Do title capitalization
- setEtAl() : string
- Set et al. for multiple creators
- findAlternates() : array<string|int, mixed>
- Find alternate fields dependent on previous or following fields and deal with accordingly.
- formatTitle() : string
- Format a resource title
- formatShortTitle() : string
- Format a resource shorTitle
- mapDependencies() : array<string|int, mixed>
- Deal with __DEPENDENT_ON_PREVIOUS_FIELD__ for pre and post dependent on previous field's existence and __DEPENDENT_ON_NEXT_FIELD__ for pre and post dependent on the next field's existence
- mapTemplateIndependents() : void
- Map independent fields of templates.
- mapTemplatePlurals() : array<string|int, mixed>
- Deal with singular/plural dependencies for fields such as pages and creators
- replaceWhitespace() : string|array<string|int, mixed>
- Replace ASCII whitespace with locale's whitespace character(s) from elements of an array Callback
- stripTemplateBackticks() : array<string|int, mixed>
- Strip backticks used in template
- ordinals() : string
- format ordinals
- findAmbiguity() : array<string|int, mixed>
- Identify ambiguous in-text citations and references.
- fillinPreview() : array<string|int, mixed>
- Provide empty array elements in resourceData from the adminstyle plugin's preview functions to conform with what BIBCITEGATEWAY expects.
- setJustify() : string|false
- Generic code for setting justification
- setLineSpace() : string|false
- Generic code for setting line height
- setIndentation() : string|false
- Generic code for setting indentation
- setFontSize() : string|false
- Generic code for setting font size
Functions
settings()
Deal with various settings, setting, getting, incrementing, decrementing etc.
settings(string $method[, mixed $extra = FALSE ]) : mixed
This is a common location for this sort of thing.
Parameters
- $method : string
- $extra : mixed = FALSE
Tags
getNameString()
Get the nameString variable
getNameString(string $initialsStyle, string $firstNameInitial, string $nameStyle, string $uppercase, array<string|int, mixed> $style, array<string|int, mixed> $creator, string $localisation[, bool $citation = FALSE ][, array<string|int, mixed> $citationVars = [] ][, bool $ftUseSurname = FALSE ]) : string
Parameters
- $initialsStyle : string
- $firstNameInitial : string
- $nameStyle : string
- $uppercase : string
- $style : array<string|int, mixed>
- $creator : array<string|int, mixed>
- $localisation : string
- $citation : bool = FALSE
-
default = FALSE
- $citationVars : array<string|int, mixed> = []
-
default = []
- $ftUseSurname : bool = FALSE
-
default = FALSE
Return values
stringcheckInitials()
Handle initials.
checkInitials(array<string|int, mixed> &$creator, int $initialsStyle, bool $firstNameInitial, string $localisation) : string
Parameters
- $creator : array<string|int, mixed>
-
Associative array of creator name e.g.
array(['surname'] => 'Grimshaw', ['firstname'] => Mark, ['initials'] => 'M N G', ['prefix'] => ))
Initials must be space-delimited.
- $initialsStyle : int
- $firstNameInitial : bool
- $localisation : string
Tags
Return values
string —Formatted string of initials.
hyphenatedInitials()
Deal with hyphenated firstnames as initials
hyphenatedInitials(array<string|int, mixed> $hyphenated, int $initialsStyle) : string
'Jean-Pierre' should become 'J.-P.'
Parameters
- $hyphenated : array<string|int, mixed>
- $initialsStyle : int
Return values
stringaddCreatorDelimiters()
Add delimiters to creators
addCreatorDelimiters(array<string|int, mixed> $style, array<string|int, mixed> &$cArray, string $delimitTwo, string $delimitFirstBetween, string $delimitNextBetween, string $delimitLast) : void
Parameters
- $style : array<string|int, mixed>
- $cArray : array<string|int, mixed>
- $delimitTwo : string
- $delimitFirstBetween : string
- $delimitNextBetween : string
- $delimitLast : string
formatMultiplePages()
Format multiple pages.
formatMultiplePages(int $pageFormat, int|string $rangeDelimiter, string $start, string $end) : string
$this->style['pageFormat']: 0 == 132-9 1 == 132-39 2 == 132-139
Parameters
- $pageFormat : int
- $rangeDelimiter : int|string
- $start : string
-
Page start.
- $end : string
-
Page end.
Return values
stringtitleCapitalization()
Do title capitalization
titleCapitalization(string|null $pString, string $delimitLeft, string $delimitRight[, int $CondCapitalization = 1 ]) : string
Parameters
- $pString : string|null
-
Raw title string.
- $delimitLeft : string
- $delimitRight : string
- $CondCapitalization : int = 1
-
Default is 1.
Return values
string —Formatted title string.
setEtAl()
Set et al. for multiple creators
setEtAl(array<string|int, mixed> &$creators, int $limit, bool $italics, string $abbreviation) : string
Parameters
- $creators : array<string|int, mixed>
- $limit : int
- $italics : bool
- $abbreviation : string
Return values
stringfindAlternates()
Find alternate fields dependent on previous or following fields and deal with accordingly.
findAlternates(array<string|int, mixed> $template, array<string|int, mixed> $item) : array<string|int, mixed>
Parameters
- $template : array<string|int, mixed>
- $item : array<string|int, mixed>
Return values
array<string|int, mixed>formatTitle()
Format a resource title
formatTitle(array<string|int, mixed> $resource, array<string|int, mixed> $styleCitation, string $puncPattern, string $space[, bool $trans = FALSE ]) : string
Parameters
- $resource : array<string|int, mixed>
- $styleCitation : array<string|int, mixed>
- $puncPattern : string
- $space : string
- $trans : bool = FALSE
-
Default FALSE
Return values
stringformatShortTitle()
Format a resource shorTitle
formatShortTitle(array<string|int, mixed> $resource, array<string|int, mixed> $styleCitation[, bool $trans = FALSE ][, bool $ftUseTitle = FALSE ]) : string
Parameters
- $resource : array<string|int, mixed>
- $styleCitation : array<string|int, mixed>
- $trans : bool = FALSE
-
Default FALSE
- $ftUseTitle : bool = FALSE
-
Default FALSE
Return values
stringmapDependencies()
Deal with __DEPENDENT_ON_PREVIOUS_FIELD__ for pre and post dependent on previous field's existence and __DEPENDENT_ON_NEXT_FIELD__ for pre and post dependent on the next field's existence
mapDependencies(array<string|int, mixed> $value, bool $previousFieldExists, mixed $nextFieldExists, string $pre, string $post) : array<string|int, mixed>
Parameters
- $value : array<string|int, mixed>
- $previousFieldExists : bool
- $nextFieldExists : mixed
- $pre : string
- $post : string
Return values
array<string|int, mixed>mapTemplateIndependents()
Map independent fields of templates.
mapTemplateIndependents(array<string|int, mixed> $independent, array<string|int, mixed> &$itemArray) : void
Check for independent characters. These (should) come in pairs.
Parameters
- $independent : array<string|int, mixed>
- $itemArray : array<string|int, mixed>
mapTemplatePlurals()
Deal with singular/plural dependencies for fields such as pages and creators
mapTemplatePlurals(array<string|int, mixed> $value, string $pre, string $post, mixed $plurals) : array<string|int, mixed>
Parameters
- $value : array<string|int, mixed>
- $pre : string
- $post : string
- $plurals : mixed
Return values
array<string|int, mixed>replaceWhitespace()
Replace ASCII whitespace with locale's whitespace character(s) from elements of an array Callback
replaceWhitespace(string|array<string|int, mixed> $input, string|array<string|int, mixed> $citeLocalisation) : string|array<string|int, mixed>
Parameters
- $input : string|array<string|int, mixed>
- $citeLocalisation : string|array<string|int, mixed>
Return values
string|array<string|int, mixed>stripTemplateBackticks()
Strip backticks used in template
stripTemplateBackticks(string $pre, mixed $post) : array<string|int, mixed>
Parameters
- $pre : string
- $post : mixed
Return values
array<string|int, mixed>ordinals()
format ordinals
ordinals(array<string|int, mixed> $matches, string $output) : string
Parameters
- $matches : array<string|int, mixed>
- $output : string
Return values
stringfindAmbiguity()
Identify ambiguous in-text citations and references.
findAmbiguity(array<string|int, mixed> $sentences, array<string|int, mixed> $resIds, int $ambiguousAction) : array<string|int, mixed>
An ambiguous citation is one reference that has the same creator(s) and publication year(s) as another. There are three options: Do nothing (use the original templates for the citation and reference) Add a letter after the year with the original citation template (in which case the bibliographic entry must also use the letter) Use the ambiguous template for the in-text citation and no letter for the reference.
The order of the reference in the bibliography provides the ordering of the letters. The $resIds array provides this order.
Parameters
- $sentences : array<string|int, mixed>
- $resIds : array<string|int, mixed>
- $ambiguousAction : int
-
(1 = letter, 2 = template)
Return values
array<string|int, mixed>fillinPreview()
Provide empty array elements in resourceData from the adminstyle plugin's preview functions to conform with what BIBCITEGATEWAY expects.
fillinPreview(array<string|int, mixed> $resourceData) : array<string|int, mixed>
Parameters
- $resourceData : array<string|int, mixed>
Return values
array<string|int, mixed>setJustify()
Generic code for setting justification
setJustify(string $input) : string|false
Parameters
- $input : string
Return values
string|falsesetLineSpace()
Generic code for setting line height
setLineSpace(string $input) : string|false
Parameters
- $input : string
Return values
string|falsesetIndentation()
Generic code for setting indentation
setIndentation(string $input[, mixed $bq = FALSE ]) : string|false
Parameters
- $input : string
- $bq : mixed = FALSE
Return values
string|falsesetFontSize()
Generic code for setting font size
setFontSize(string $input) : string|false
Parameters
- $input : string