Class: RelatonBib::BibliographicItem

Inherits:
Object
  • Object
show all
Includes:
RelatonBib
Defined in:
lib/relaton_bib/biblio_version.rb,
lib/relaton_bib/bibliographic_item.rb

Overview

Bibliographic item

Defined Under Namespace

Classes: Version

Constant Summary collapse

TYPES =
%W[article book booklet manual proceedings presentation
thesis techreport standard unpublished map electronic\sresource
audiovisual film video broadcast software graphic_work music
patent inbook incollection inproceedings journal website
webresource dataset archival social_media alert message
conversation misc internal].freeze

Constants included from RelatonBib

VERSION

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from RelatonBib

array, format_date, grammar_hash, parse_date, parse_yaml

Methods included from Config

#configuration, #configure

Constructor Details

#initialize(**args) ⇒ BibliographicItem

Returns a new instance of BibliographicItem.

Parameters:



208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
# File 'lib/relaton_bib/bibliographic_item.rb', line 208

def initialize(**args)
  if args[:type] && !TYPES.include?(args[:type])
    Util.warn %{WARNING: type `#{args[:type]}` is invalid.}
  end

  @title = if args[:title].is_a?(TypedTitleStringCollection)
             args[:title]
           else
             TypedTitleStringCollection.new(args[:title])
           end

  @date = (args[:date] || []).map do |d|
    d.is_a?(Hash) ? BibliographicDate.new(**d) : d
  end

  @contributor = (args[:contributor] || []).map do |c|
    if c.is_a? Hash
      e = c[:entity].is_a?(Hash) ? Organization.new(**c[:entity]) : c[:entity]
      ContributionInfo.new(entity: e, role: c[:role])
    else c
    end
  end

  @abstract = (args[:abstract] || []).map do |a|
    a.is_a?(Hash) ? FormattedString.new(**a) : a
  end

  @copyright = args.fetch(:copyright, []).map do |c|
    c.is_a?(Hash) ? CopyrightAssociation.new(**c) : c
  end

  @docidentifier  = args[:docid] || []
  @formattedref   = args[:formattedref] if title.empty?
  @id             = args[:id] || makeid(nil, false)
  @type           = args[:type]
  @docnumber      = args[:docnumber]
  @edition        = case args[:edition]
                    when Hash then Edition.new(**args[:edition])
                    when String, Integer, Float
                      Edition.new(content: args[:edition].to_s)
                    when Edition then args[:edition]
                    end
  @version        = args.fetch :version, []
  @biblionote     = args.fetch :biblionote, BiblioNoteCollection.new([])
  @language       = args.fetch :language, []
  @script         = args.fetch :script, []
  @status         = args[:docstatus]
  @relation       = DocRelationCollection.new(args[:relation] || [])
  @link           = args.fetch(:link, []).map do |s|
    case s
    when Hash then TypedUri.new(**s)
    when String then TypedUri.new(content: s)
    else s
    end
  end
  @series         = args.fetch :series, []
  @medium         = args[:medium]
  @place          = args.fetch(:place, []).map do |pl|
    pl.is_a?(String) ? Place.new(name: pl) : pl
  end
  @extent         = args[:extent] || []
  @size           = args[:size]
  @accesslocation = args.fetch :accesslocation, []
  @classification = args.fetch :classification, []
  @validity       = args[:validity]
  # we should pass the fetched arg from scrappers
  @fetched        = args.fetch :fetched, nil
  @keyword        = (args[:keyword] || []).map do |kw|
    case kw
    when Hash then LocalizedString.new(kw[:content], kw[:language], kw[:script])
    when String then LocalizedString.new(kw)
    else kw
    end
  end
  @license        = args.fetch :license, []
  @doctype        = args[:doctype]
  @subdoctype     = args[:subdoctype]
  @editorialgroup = args[:editorialgroup]
  @ics            = args.fetch :ics, []
  @structuredidentifier = args[:structuredidentifier]
end

Instance Attribute Details

#abstract(lang: nil) ⇒ RelatonBib::FormattedString+

Parameters:

  • lang (String) (defaults to: nil)

    language code Iso639

Returns:



# File 'lib/relaton_bib/bibliographic_item.rb', line 87

#accesslocationArray<Strig> (readonly)

Returns:



112
113
114
# File 'lib/relaton_bib/bibliographic_item.rb', line 112

def accesslocation
  @accesslocation
end

#all_partsBoolean?

Returns:

  • (Boolean, nil)


46
47
48
# File 'lib/relaton_bib/bibliographic_item.rb', line 46

def all_parts
  @all_parts
end

#biblionoteRelatonBib::BiblioNoteCollection (readonly)



76
77
78
# File 'lib/relaton_bib/bibliographic_item.rb', line 76

def biblionote
  @biblionote
end

#classificationArray<Relaton::Classification> (readonly)

Returns:

  • (Array<Relaton::Classification>)


115
116
117
# File 'lib/relaton_bib/bibliographic_item.rb', line 115

def classification
  @classification
end

#contributorArray<RelatonBib::ContributionInfo> (readonly)



70
71
72
# File 'lib/relaton_bib/bibliographic_item.rb', line 70

def contributor
  @contributor
end


94
95
96
# File 'lib/relaton_bib/bibliographic_item.rb', line 94

def copyright
  @copyright
end

#dateArray<RelatonBib::BibliographicDate>



67
68
69
# File 'lib/relaton_bib/bibliographic_item.rb', line 67

def date
  @date
end

#docidentifierArray<RelatonBib::DocumentIdentifier> (readonly)



64
65
66
# File 'lib/relaton_bib/bibliographic_item.rb', line 64

def docidentifier
  @docidentifier
end

#docnumberString? (readonly)

Returns:

  • (String, nil)


49
50
51
# File 'lib/relaton_bib/bibliographic_item.rb', line 49

def docnumber
  @docnumber
end

#doctypeRelatonBib::DocumentType (readonly)

Returns document type.

Returns:



52
53
54
# File 'lib/relaton_bib/bibliographic_item.rb', line 52

def doctype
  @doctype
end

#editionRelatonBib::Edition? (readonly)

Returns edition.

Returns:



55
56
57
# File 'lib/relaton_bib/bibliographic_item.rb', line 55

def edition
  @edition
end

#editorialgroupRelatonBib::EditorialGroup? (readonly)

Returns:



127
128
129
# File 'lib/relaton_bib/bibliographic_item.rb', line 127

def editorialgroup
  @editorialgroup
end

#extentArray<RelatonBib::Locality, RelatonBib::LocalityStack> (readonly)



109
110
111
# File 'lib/relaton_bib/bibliographic_item.rb', line 109

def extent
  @extent
end

#fetchedDate

Returns:

  • (Date)


121
122
123
# File 'lib/relaton_bib/bibliographic_item.rb', line 121

def fetched
  @fetched
end

#formattedrefRelatonBib::FormattedRef? (readonly)

Returns:



85
86
87
# File 'lib/relaton_bib/bibliographic_item.rb', line 85

def formattedref
  @formattedref
end

#icsArray<RelatonBib:ICS> (readonly)

Returns:

  • (Array<RelatonBib:ICS>)


130
131
132
# File 'lib/relaton_bib/bibliographic_item.rb', line 130

def ics
  @ics
end

#idString? (readonly)

Returns:

  • (String, nil)


49
50
51
# File 'lib/relaton_bib/bibliographic_item.rb', line 49

def id
  @id
end

#keywordArray<RelatonBib::LocalizedString> (readonly)



124
125
126
# File 'lib/relaton_bib/bibliographic_item.rb', line 124

def keyword
  @keyword
end

#languageArray<String> (readonly)

Returns language Iso639 code.

Returns:

  • (Array<String>)

    language Iso639 code



79
80
81
# File 'lib/relaton_bib/bibliographic_item.rb', line 79

def language
  @language
end

#licenseArray<Strig> (readonly)

Returns:



112
113
114
# File 'lib/relaton_bib/bibliographic_item.rb', line 112

def license
  @license
end


61
62
63
# File 'lib/relaton_bib/bibliographic_item.rb', line 61

def link
  @link
end

#mediumRelatonBib::Medium? (readonly)

Returns:



103
104
105
# File 'lib/relaton_bib/bibliographic_item.rb', line 103

def medium
  @medium
end

#placeArray<RelatonBib::Place> (readonly)

Returns:



106
107
108
# File 'lib/relaton_bib/bibliographic_item.rb', line 106

def place
  @place
end

#relationRelatonBib::DocRelationCollection (readonly)



97
98
99
# File 'lib/relaton_bib/bibliographic_item.rb', line 97

def relation
  @relation
end

#scriptArray<String> (readonly)

Returns script Iso15924 code.

Returns:

  • (Array<String>)

    script Iso15924 code



82
83
84
# File 'lib/relaton_bib/bibliographic_item.rb', line 82

def script
  @script
end

#seriesArray<RelatonBib::Series> (readonly)



100
101
102
# File 'lib/relaton_bib/bibliographic_item.rb', line 100

def series
  @series
end

#sizeRelatonBib::BibliographicSize? (readonly)



136
137
138
# File 'lib/relaton_bib/bibliographic_item.rb', line 136

def size
  @size
end

#statusRelatonBib::DocumentStatus? (readonly)

Returns:



91
92
93
# File 'lib/relaton_bib/bibliographic_item.rb', line 91

def status
  @status
end

#structuredidentifierRelatonBib::StructuredIdentifierCollection (readonly)



133
134
135
# File 'lib/relaton_bib/bibliographic_item.rb', line 133

def structuredidentifier
  @structuredidentifier
end

#subdoctypeString? (readonly)

Returns:

  • (String, nil)


49
50
51
# File 'lib/relaton_bib/bibliographic_item.rb', line 49

def subdoctype
  @subdoctype
end

#title(lang: nil) ⇒ RelatonIsoBib::TypedTitleStringCollection (readonly)

Parameters:

  • lang (String, nil) (defaults to: nil)

    language code Iso639

Returns:

  • (RelatonIsoBib::TypedTitleStringCollection)


# File 'lib/relaton_bib/bibliographic_item.rb', line 57

#typeString? (readonly)

Returns:

  • (String, nil)


49
50
51
# File 'lib/relaton_bib/bibliographic_item.rb', line 49

def type
  @type
end

#validityRelatonBib:Validity? (readonly)

Returns:

  • (RelatonBib:Validity, nil)


118
119
120
# File 'lib/relaton_bib/bibliographic_item.rb', line 118

def validity
  @validity
end

#versionArray<RelatonBib::BibliographicItem::Version> (readonly)



73
74
75
# File 'lib/relaton_bib/bibliographic_item.rb', line 73

def version
  @version
end

Class Method Details

.from_hash(hash) ⇒ RelatonBipm::BipmBibliographicItem

Parameters:

  • hash (Hash)

Returns:

  • (RelatonBipm::BipmBibliographicItem)


312
313
314
315
# File 'lib/relaton_bib/bibliographic_item.rb', line 312

def self.from_hash(hash)
  item_hash = Object.const_get(name.split("::")[0])::HashConverter.hash_to_bib(hash)
  new(**item_hash)
end

Instance Method Details

#deep_cloneObject



476
477
478
479
# File 'lib/relaton_bib/bibliographic_item.rb', line 476

def deep_clone
  dump = Marshal.dump self
  Marshal.load dump # rubocop:disable Security/MarshalLoad
end

#disable_id_attributeObject



481
482
483
# File 'lib/relaton_bib/bibliographic_item.rb', line 481

def disable_id_attribute
  @id_attribute = false
end

#makeid(identifier, attribute) ⇒ String

Parameters:

Returns:

  • (String)


330
331
332
333
334
335
336
337
338
# File 'lib/relaton_bib/bibliographic_item.rb', line 330

def makeid(identifier, attribute)
  return nil if attribute && !@id_attribute

  identifier ||= @docidentifier.reject { |i| i.type == "DOI" }[0]
  return unless identifier

  idstr = identifier.id.gsub(/[:\/]/, "-").gsub(/[\s\(\)]/, "")
  idstr.strip
end

#revdateString?

If revision_date exists then returns it else returns published date or nil

Returns:

  • (String, nil)


531
532
533
534
535
536
537
# File 'lib/relaton_bib/bibliographic_item.rb', line 531

def revdate # rubocop:disable Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
  @revdate ||= if (v = version.detect &:revision_date)
                 v.revision_date
               else
                 date.detect { |d| d.type == "published" }&.on&.to_s
               end
end

#schemaString

Fetch schema version

Returns:

  • (String)

    schema version



297
298
299
# File 'lib/relaton_bib/bibliographic_item.rb', line 297

def schema
  @schema ||= schema_versions["relaton-models"]
end

#schema_versionsHash{String=>String}

Read schema versions from file

Returns:

  • (Hash{String=>String})

    schema versions



306
307
308
# File 'lib/relaton_bib/bibliographic_item.rb', line 306

def schema_versions
  JSON.parse File.read(File.join(__dir__, "../../grammars/versions.json"))
end

#shortref(identifier, **opts) ⇒ String

Parameters:

Returns:

  • (String)


345
346
347
348
349
350
351
352
353
# File 'lib/relaton_bib/bibliographic_item.rb', line 345

def shortref(identifier, **opts) # rubocop:disable Metrics/CyclomaticComplexity,Metrics/AbcSize,Metrics/PerceivedComplexity
  pubdate = date.select { |d| d.type == "published" }
  year = if opts[:no_year] || pubdate.empty? then ""
         else ":#{pubdate&.first&.on(:year)}"
         end
  year += ": All Parts" if opts[:all_parts] || @all_parts

  "#{makeid(identifier, false)}#{year}"
end

#to_all_partsObject

remove title part components and abstract



486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
# File 'lib/relaton_bib/bibliographic_item.rb', line 486

def to_all_parts # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength,Metrics/PerceivedComplexity
  me = deep_clone
  me.disable_id_attribute
  me.relation << DocumentRelation.new(type: "instanceOf", bibitem: self)
  me.language.each do |l|
    me.title.delete_title_part!
    ttl = me.title.select do |t|
      t.type != "main" && t.title.language&.include?(l)
    end
    next if ttl.empty?

    tm_en = ttl.map { |t| t.title.content }.join " – "
    me.title.detect do |t|
      t.type == "main" && t.title.language&.include?(l)
    end&.title&.content = tm_en
  end
  me.abstract = []
  me.docidentifier.each(&:remove_part)
  me.docidentifier.each(&:all_parts)
  me.structuredidentifier.remove_part
  me.structuredidentifier.all_parts
  me.docidentifier.each &:remove_date
  me.structuredidentifier&.remove_date
  me.all_parts = true
  me
end

#to_asciibib(prefix = "") ⇒ String

Parameters:

  • prefix (String) (defaults to: "")

Returns:

  • (String)


541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
# File 'lib/relaton_bib/bibliographic_item.rb', line 541

def to_asciibib(prefix = "") # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
  pref = prefix.empty? ? prefix : "#{prefix}."
  out = prefix.empty? ? "[%bibitem]\n== {blank}\n" : ""
  out += "#{pref}id:: #{id}\n" if id
  out += "#{pref}fetched:: #{fetched}\n" if fetched
  title.each { |t| out += t.to_asciibib(prefix, title.size) }
  out += "#{pref}type:: #{type}\n" if type
  docidentifier.each do |di|
    out += di.to_asciibib prefix, docidentifier.size
  end
  out += "#{pref}docnumber:: #{docnumber}\n" if docnumber
  out += edition.to_asciibib(prefix) if edition
  language.each { |l| out += "#{pref}language:: #{l}\n" }
  script.each { |s| out += "#{pref}script:: #{s}\n" }
  version.each { |v| out += v.to_asciibib prefix, version.size }
  biblionote&.each { |b| out += b.to_asciibib prefix, biblionote.size }
  out += status.to_asciibib prefix if status
  date.each { |d| out += d.to_asciibib prefix, date.size }
  abstract.each do |a|
    out += a.to_asciibib "#{pref}abstract", abstract.size
  end
  copyright.each { |c| out += c.to_asciibib prefix, copyright.size }
  link.each { |l| out += l.to_asciibib prefix, link.size }
  out += medium.to_asciibib prefix if medium
  place.each { |pl| out += pl.to_asciibib prefix, place.size }
  extent.each { |ex| out += ex.to_asciibib "#{pref}extent", extent.size }
  out += size.to_asciibib pref if size
  accesslocation.each { |al| out += "#{pref}accesslocation:: #{al}\n" }
  classification.each do |cl|
    out += cl.to_asciibib prefix, classification.size
  end
  out += validity.to_asciibib prefix if validity
  contributor.each do |c|
    out += c.to_asciibib "contributor.*", contributor.size
  end
  out += relation.to_asciibib prefix if relation
  series.each { |s| out += s.to_asciibib prefix, series.size }
  out += doctype.to_asciibib prefix if doctype
  out += "#{pref}subdoctype:: #{subdoctype}\n" if subdoctype
  out += "#{pref}formattedref:: #{formattedref}\n" if formattedref
  keyword.each { |kw| out += kw.to_asciibib "#{pref}keyword", keyword.size }
  out += editorialgroup.to_asciibib prefix if editorialgroup
  ics.each { |i| out += i.to_asciibib prefix, ics.size }
  out += structuredidentifier.to_asciibib prefix if structuredidentifier
  out
end

#to_bibtex(bibtex = nil) ⇒ String

Reander BibTeX

Parameters:

  • bibtex (BibTeX::Bibliography, nil) (defaults to: nil)

Returns:

  • (String)


443
444
445
# File 'lib/relaton_bib/bibliographic_item.rb', line 443

def to_bibtex(bibtex = nil)
  Renderer::BibtexBuilder.build(self, bibtex).to_s
end

#to_bibxml(builder = nil, include_keywords: false) ⇒ String, Nokogiri::XML::Builder::NodeBuilder

Render BibXML (RFC)

Parameters:

  • builder (Nokogiri::XML::Builder, nil) (defaults to: nil)
  • include_keywords (Boolean) (defaults to: false)

    (false)

Returns:

  • (String, Nokogiri::XML::Builder::NodeBuilder)

    XML



379
380
381
# File 'lib/relaton_bib/bibliographic_item.rb', line 379

def to_bibxml(builder = nil, include_keywords: false)
  Renderer::BibXML.new(self).render builder: builder, include_keywords: include_keywords
end

#to_citeproc(bibtex = nil) ⇒ Hash

Render citeproc

Parameters:

  • bibtex (BibTeX::Bibliography, nil) (defaults to: nil)

Returns:

  • (Hash)

    citeproc



454
455
456
457
458
# File 'lib/relaton_bib/bibliographic_item.rb', line 454

def to_citeproc(bibtex = nil)
  Renderer::BibtexBuilder.build(self, bibtex).to_citeproc.map do |cp|
    cp.transform_keys(&:to_s)
  end
end

#to_hash(embedded: false) ⇒ Hash

Returns:

  • (Hash)


384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
# File 'lib/relaton_bib/bibliographic_item.rb', line 384

def to_hash(embedded: false) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
  hash = {}
  hash["schema-version"] = schema unless embedded
  hash["id"] = id if id
  hash["title"] = title.to_hash if title&.any?
  hash["link"] = single_element_array(link) if link&.any?
  hash["type"] = type if type
  hash["docid"] = single_element_array(docidentifier) if docidentifier&.any?
  hash["docnumber"] = docnumber if docnumber
  hash["date"] = single_element_array(date) if date&.any?
  if contributor&.any?
    hash["contributor"] = single_element_array(contributor)
  end
  hash["edition"] = edition.to_hash if edition
  hash["version"] = version.map &:to_hash if version.any?
  hash["revdate"] = revdate if revdate
  hash["biblionote"] = single_element_array(biblionote) if biblionote&.any?
  hash["language"] = single_element_array(language) if language&.any?
  hash["script"] = single_element_array(script) if script&.any?
  hash["formattedref"] = formattedref.to_hash if formattedref
  hash["abstract"] = single_element_array(abstract) if abstract&.any?
  hash["docstatus"] = status.to_hash if status
  hash["copyright"] = single_element_array(copyright) if copyright&.any?
  hash["relation"] = single_element_array(relation) if relation&.any?
  hash["series"] = single_element_array(series) if series&.any?
  hash["medium"] = medium.to_hash if medium
  hash["place"] = single_element_array(place) if place&.any?
  hash["extent"] = single_element_array(extent) if extent&.any?
  hash["size"] = size.to_hash if size&.any?
  if accesslocation&.any?
    hash["accesslocation"] = single_element_array(accesslocation)
  end
  if classification&.any?
    hash["classification"] = single_element_array(classification)
  end
  hash["validity"] = validity.to_hash if validity
  hash["fetched"] = fetched.to_s if fetched
  hash["keyword"] = single_element_array(keyword) if keyword&.any?
  hash["license"] = single_element_array(license) if license&.any?
  hash["doctype"] = doctype.to_hash if doctype
  hash["subdoctype"] = subdoctype if subdoctype
  if editorialgroup&.presence?
    hash["editorialgroup"] = editorialgroup.to_hash
  end
  hash["ics"] = single_element_array ics if ics.any?
  if structuredidentifier&.presence?
    hash["structuredidentifier"] = structuredidentifier.to_hash
  end
  hash["ext"] = { "schema-version" => ext_schema } if !embedded && respond_to?(:ext_schema) && ext_schema
  hash
end

#to_most_recent_referenceObject

convert ISO:yyyy reference to reference to most recent instance of reference, removing date-specific infomration: date of publication, abstracts. Make dated reference Instance relation of the redacated document



517
518
519
520
521
522
523
524
525
526
527
# File 'lib/relaton_bib/bibliographic_item.rb', line 517

def to_most_recent_reference
  me = deep_clone
  disable_id_attribute
  me.relation << DocumentRelation.new(type: "instanceOf", bibitem: self)
  me.abstract = []
  me.date = []
  me.docidentifier.each &:remove_date
  me.structuredidentifier&.remove_date
  me.id&.sub!(/-[12]\d\d\d/, "")
  me
end

#to_xml(**opts, &block) ⇒ String

Returns XML.

Parameters:

  • opts (Hash)

Options Hash (**opts):

  • :builder (Nokogiri::XML::Builder)

    XML builder

  • :bibdata (Boolean)
  • :date_format (Symbol, nil) — default: :short

    , :full

  • :lang (String, Symbol)

    language

Returns:

  • (String)

    XML



361
362
363
364
365
366
367
368
369
# File 'lib/relaton_bib/bibliographic_item.rb', line 361

def to_xml(**opts, &block)
  if opts[:builder]
    render_xml(**opts, &block)
  else
    Nokogiri::XML::Builder.new(encoding: "UTF-8") do |xml|
      render_xml builder: xml, **opts, &block
    end.doc.root.to_xml
  end
end

#url(type = :src) ⇒ String?

Parameters:

  • type (Symbol) (defaults to: :src)

    type of url, can be :src/:obp/:rss

Returns:

  • (String, nil)


468
469
470
# File 'lib/relaton_bib/bibliographic_item.rb', line 468

def url(type = :src)
  @link.detect { |s| s.type == type.to_s }&.content&.to_s
end