Class: RelatonBib::BibliographicItem

Inherits:
Object
  • Object
show all
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 conference manual proceedings presentation
           thesis techreport standard unpublished map electronic\sresource
           audiovisual film video broadcast graphic_work music patent
           inbook incollection inproceedings journal
].freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ BibliographicItem

Returns a new instance of BibliographicItem.

Parameters:



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
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
 
# File 'lib/relaton_bib/bibliographic_item.rb', line 164

def initialize(**args)
  if args[:type] && !TYPES.include?(args[:type])
    raise ArgumentError, %{Type "#{args[:type]}" is invalid.}
  end

  @title = (args[:title] || []).map do |t|
    t.is_a?(Hash) ? TypedTitleString.new(t) : t
  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

  if args[:copyright]
    @copyright = if args[:copyright].is_a?(Hash)
                   CopyrightAssociation.new args[:copyright]
                 else args[:copyright]
                 end
  end

  @docidentifier  = args[:docid] || []
  @formattedref   = args[:formattedref] if title.empty?
  @id             = args[:id] || makeid(nil, false)
  @type           = args[:type]
  @docnumber      = args[:docnumber]
  @edition        = args[:edition]
  @version        = args[:version]
  @biblionote     = args.fetch :biblionote, []
  @language       = args.fetch :language, []
  @script         = args.fetch :script, []
  @status         = args[:docstatus]
  @relation      = DocRelationCollection.new(args[:relation] || [])
  @link           = args.fetch(:link, []).map { |s| s.is_a?(Hash) ? TypedUri.new(s) : s }
  @series         = args.fetch :series, []
  @medium         = args[:medium]
  @place          = args.fetch(:place, [])
  @extent         = args[:extent] || []
  @accesslocation = args.fetch :accesslocation, []
  @classification = args[:classification]
  @validity       = args[:validity]
  @fetched        = args.fetch :fetched, nil # , Date.today # we should pass the fetched arg from scrappers
end

Instance Attribute Details

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

Parameters:

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

    language code Iso639

Returns:




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

#accesslocation ⇒ Array<Strig> (readonly)

Returns:

  • (Array<Strig>) 


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

def accesslocation
  @accesslocation
end

#biblionote ⇒ Array<RelatonBib::BiblioNote>, NilClass (readonly)

Returns:



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

def biblionote
  @biblionote
end

#classification ⇒ Relaton::Classification, NilClass (readonly)

Returns:

  • (Relaton::Classification, NilClass) 


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

def classification
  @classification
end

#contributor ⇒ Array<RelatonBib::ContributionInfo> (readonly)

Returns:



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

def contributor
  @contributor
end

#copyright ⇒ RelatonBib::CopyrightAssociation (readonly)

Returns:



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

def copyright
  @copyright
end

#date ⇒ Array<RelatonBib::BibliographicDate> (readonly)

Returns:



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

def date
  @date
end

#docidentifier ⇒ Array<RelatonBib::DocumentIdentifier> (readonly)

Returns:



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

def docidentifier
  @docidentifier
end

#docnumber ⇒ String (readonly)

Returns docnumber.

Returns:

  • (String) —

    docnumber



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

def docnumber
  @docnumber
end

#edition ⇒ String, NillClass (readonly)

Returns:

  • (String, NillClass) 


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

def edition
  @edition
end

#extent ⇒ Array<RelatonBib::BibItemLocality> (readonly)

Returns:



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

def extent
  @extent
end

#fetched ⇒ Date (readonly)

Returns:

  • (Date) 


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

def fetched
  @fetched
end

#formattedref ⇒ RelatonBib::FormattedRef (readonly)

Returns:



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

def formattedref
  @formattedref
end

#id ⇒ String (readonly)

Returns:

  • (String) 


36
37
38
 
# File 'lib/relaton_bib/bibliographic_item.rb', line 36

def id
  @id
end

#language ⇒ Array<String> (readonly)

Returns language Iso639 code.

Returns:

  • (Array<String>) —

    language Iso639 code



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

def language
  @language
end

#link ⇒ Array<RelatonBib::TypedUri> (readonly)

Returns:



42
43
44
 
# File 'lib/relaton_bib/bibliographic_item.rb', line 42

def link
  @link
end

#medium ⇒ RelatonBib::Medium, NilClass (readonly)

Returns:



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

def medium
  @medium
end

#place ⇒ Array<String> (readonly)

Returns:

  • (Array<String>) 


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

def place
  @place
end

#relation ⇒ RelatonBib::DocRelationCollection (readonly)

Returns:



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

def relation
  @relation
end

#script ⇒ Array<String> (readonly)

Returns script Iso15924 code.

Returns:

  • (Array<String>) —

    script Iso15924 code



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

def script
  @script
end

#series ⇒ Array<RelatonBib::Series> (readonly)

Returns:



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

def series
  @series
end

#status ⇒ RelatonBib::DocumentStatus, NilClass (readonly)

Returns:



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

def status
  @status
end

#title ⇒ Array<RelatonBib::TypedTitleString> (readonly)

Returns:



39
40
41
 
# File 'lib/relaton_bib/bibliographic_item.rb', line 39

def title
  @title
end

#type ⇒ String (readonly)

Returns:

  • (String) 


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

def type
  @type
end

#validity ⇒ RelatonBib:Validity, NilClass (readonly)

Returns:

  • (RelatonBib:Validity, NilClass) 


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

def validity
  @validity
end

#version ⇒ RelatonBib::BibliongraphicItem::Version (readonly)

Returns:

  • (RelatonBib::BibliongraphicItem::Version) 


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

def version
  @version
end

Instance Method Details

#makeid(id, attribute) ⇒ Object 



231
232
233
234
235
236
237
238
239
240
241
242
243
 
# File 'lib/relaton_bib/bibliographic_item.rb', line 231

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

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

  # contribs = publishers.map { |p| p&.entity&.abbreviation }.join '/'
  # idstr = "#{contribs}#{delim}#{id.project_number}"
  # idstr = id.project_number.to_s
  idstr = id.id.gsub(/:/, "-").gsub /\s/, ""
  # if id.part_number&.size&.positive? then idstr += "-#{id.part_number}"
  idstr.strip
end

#shortref(identifier, **opts) ⇒ String

Returns:

  • (String) 


246
247
248
249
250
251
252
253
254
 
# File 'lib/relaton_bib/bibliographic_item.rb', line 246

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

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

#to_xml(builder = nil, **opts, &block) ⇒ String

Parameters:

  • builder (Nokogiri::XML::Builder, NillClass) (defaults to: nil) —

    (nil)

Returns:

  • (String) 


258
259
260
261
262
263
264
265
266
 
# File 'lib/relaton_bib/bibliographic_item.rb', line 258

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