Class: BibTeX::Entry
- Extended by:
- Forwardable
- Includes:
- Enumerable
- Defined in:
- lib/bibtex/entry.rb
Overview
Represents a regular BibTeX entry.
Defined Under Namespace
Classes: BibTeXMLConverter, CiteProcConverter, RDFConverter
Constant Summary collapse
- REQUIRED_FIELDS =
Defines the required fields of the standard entry types
Hash.new([]).merge( article: %i[author title journal year], book: [%i[author editor], :title, :publisher, :year], booklet: [:title], conference: %i[author title booktitle year], inbook: [%i[author editor], :title, %i[chapter pages], :publisher, :year], incollection: %i[author title booktitle publisher year], inproceedings: %i[author title booktitle year], manual: [:title], mastersthesis: %i[author title school year], misc: [], phdthesis: %i[author title school year], proceedings: %i[title year], techreport: %i[author title institution year], unpublished: %i[author title note] ).freeze
- FIELD_ALIASES =
Defines the default fallbacks for values defined in cross-references
{ booktitle: :title # :editor => :author }.freeze
- NAME_FIELDS =
%i[author editor translator director producer composer].freeze
- DATE_FIELDS =
%i[year month day date].freeze
- MONTHS =
%i[jan feb mar apr may jun jul aug sep oct nov dec].freeze
- MONTHS_FILTER =
Hash.new do |h, k| h[k] = case k.to_s.strip when /^(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)/i Value.new(k.to_s[0, 3].downcase.to_sym) when /^\d\d?$/ Value.new(MONTHS[k.to_i - 1] || k) else Value.new(k) end end
Instance Attribute Summary collapse
-
#fields ⇒ Object
readonly
Returns the value of attribute fields.
-
#type ⇒ Object
Returns the value of attribute type.
Attributes inherited from Element
Instance Method Summary collapse
- #<=>(other) ⇒ Object
-
#[](name) ⇒ Object
(also: #get)
Returns the value of the field with the given name.
-
#[]=(name, value) ⇒ Object
Adds a new field (name-value pair) to the entry.
-
#add(*arguments) ⇒ Object
(also: #<<)
call-seq: add(:author, “Edgar A. Poe”) add(:author, “Edgar A. Poe”, :title, “The Raven”) add([:author, “Edgar A. Poe”, :title, “The Raven”]) add(:author => “Edgar A. Poe”, :title => “The Raven”) add(:author => Names.new(Name.new(:first => ‘Edgar A.’, :last => ‘Poe’))).
-
#added_to_bibliography(bibliography) ⇒ Object
Called when the element was added to a bibliography.
-
#aliases ⇒ Object
Returns the Entry’s field name aliases.
-
#children ⇒ Object
(also: #cross_referenced_by)
Returns a list of all entries in the Bibliography containing a cross-reference to this entry or [] if there are no references to this entry.
-
#contained? ⇒ Boolean
Returns true if this entry is published inside a book, collection or journal.
- #container_title ⇒ Object
-
#content(options = {}) ⇒ Object
Returns a string of all the entry’s fields.
-
#convert(*filters) ⇒ Object
Returns a duplicate entry with all values converted using the filter(s).
-
#convert!(*filters) ⇒ Object
In-place variant of @see #convert.
- #date ⇒ Object
-
#delete(name) ⇒ Object
Removes the field with a given name from the entry.
-
#digest(filter = []) ⇒ String
Creates the entry’s digest based on the passed-in filters.
-
#each ⇒ Object
(also: #each_pair)
call-seq: entry.each { |key, value| block } -> entry entry.each_pair { |key, value| block } -> entry entry.each -> an_enumerator entry.each_pair -> an_enumerator.
- #fetch(name, default = nil) ⇒ Object
-
#field_names(filter = [], include_inherited = true) ⇒ Object
Returns a sorted list of the Entry’s field names.
-
#has_children? ⇒ Boolean
(also: #cross_referenced?)
Returns true if the entry is cross-referenced by another entry in the Bibliography.
- #has_field?(*names) ⇒ Boolean (also: #field?)
-
#has_parent? ⇒ Boolean
(also: #has_cross_reference?)
Returns true if the Entry has a valid cross-reference in the Bibliography.
- #has_type?(type) ⇒ Boolean (also: #type?)
- #identifier ⇒ Object
-
#inherited_fields ⇒ Object
Returns a sorted list of all field names referenced by this Entry’s cross-reference.
- #inherits?(*names) ⇒ Boolean
-
#initialize(attributes = {}) {|_self| ... } ⇒ Entry
constructor
Creates a new instance.
- #initialize_copy(other) ⇒ Object
- #join ⇒ Object
- #key ⇒ Object (also: #id)
-
#key=(key) ⇒ Object
(also: #id=)
Sets the Entry’s key.
- #merge(other, filter = field_names) ⇒ Object
- #merge!(other, filter = field_names) ⇒ Object
- #method_missing(name, *args, &block) ⇒ Object
- #month=(month) ⇒ Object
- #month_numeric ⇒ Object
-
#names ⇒ Object
Returns a list of all names (authors, editors, translators).
- #pages_from ⇒ Object
- #pages_to ⇒ Object
-
#parent ⇒ Object
(also: #cross_reference)
Returns the cross-referenced Entry from the Bibliography or nil if this Entry does define a cross-reference.
-
#parent_missing? ⇒ Boolean
(also: #cross_reference_missing?)
Returns true if the Entry cross-references an Entry which is not registered in the current Bibliography.
- #parse_month ⇒ Object (also: #parse_months)
-
#parse_names ⇒ Object
Parses all name values of the entry.
-
#provide(name) ⇒ Object
Returns the field value referenced by the passed-in name.
-
#provides?(*names) ⇒ Boolean
Returns true if the Entry has a field (or alias) for any of the passed-in names.
- #provides_or_inherits?(*names) ⇒ Boolean
-
#register(key) ⇒ Object
Registers this Entry in the associated Bibliographies entries hash.
-
#registered? ⇒ Boolean
Returns true if the Entry is currently registered with the associated Bibliography.
-
#removed_from_bibliography(bibliography) ⇒ Object
Called when the element was removed from a bibliography.
-
#rename(*arguments) ⇒ Object
(also: #rename_fields)
Returns a copy of the Entry with all the field names renamed.
-
#rename!(*arguments) ⇒ Object
(also: #rename_fields!)
Renames the given field names unless a field with the new name already exists.
- #replace(*arguments) ⇒ Object
- #respond_to?(method, include_all = false) ⇒ Boolean
-
#save_inherited_fields ⇒ Object
If the Entry has a cross-reference, copies all referenced all inherited values from the parent.
- #to_citeproc(options = {}) ⇒ Object
- #to_hash(options = {}) ⇒ Object
-
#to_rdf(_options = {}) ⇒ Object
(also: #to_bibo)
Returns a RDF::Graph representation of the entry using the BIBO ontology.
-
#to_s(options = {}) ⇒ Object
Returns a string representation of the entry.
- #to_xml(options = {}) ⇒ Object
- #update(fields) ⇒ Object
-
#valid? ⇒ Boolean
Returns false if the entry is one of the standard entry types and does not have definitions of all the required fields for that type.
-
#values_at(*arguments) ⇒ Object
Returns an array containing the values associated with the given keys.
- #year ⇒ Object
Methods inherited from Element
#inspect, #matches?, #meets?, #meets_all?, #meets_any?, parse, #to_json, #to_yaml
Constructor Details
#initialize(attributes = {}) {|_self| ... } ⇒ Entry
Creates a new instance. If a hash is given, the entry is populated accordingly.
72 73 74 75 76 77 78 79 80 81 82 |
# File 'lib/bibtex/entry.rb', line 72 def initialize(attributes = {}) @fields = {} @key = nil self.type = attributes.delete(:bibtex_type) if attributes.key?(:bibtex_type) self.key = attributes.delete(:bibtex_key) if attributes.key?(:bibtex_key) add(attributes) yield self if block_given? end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(name, *args, &block) ⇒ Object
303 304 305 306 307 308 309 310 311 312 313 314 315 |
# File 'lib/bibtex/entry.rb', line 303 def method_missing(name, *args, &block) if fields.key?(name) fields[name] elsif name.to_s =~ /^(.+)=$/ send(:add, Regexp.last_match(1).to_sym, args[0]) elsif name =~ /^(?:convert|from)_([a-z]+)(!)?$/ Regexp.last_match(2) ? convert!(Regexp.last_match(1), &block) : convert(Regexp.last_match(1), &block) elsif has_parent? && parent.provides?(name) parent.provide(name) else super end end |
Instance Attribute Details
#fields ⇒ Object (readonly)
Returns the value of attribute fields.
67 68 69 |
# File 'lib/bibtex/entry.rb', line 67 def fields @fields end |
#type ⇒ Object
Returns the value of attribute type.
67 68 69 |
# File 'lib/bibtex/entry.rb', line 67 def type @type end |
Instance Method Details
#<=>(other) ⇒ Object
624 625 626 |
# File 'lib/bibtex/entry.rb', line 624 def <=>(other) type != other.type ? type <=> other.type : key != other.key ? key <=> other.key : to_s <=> other.to_s end |
#[](name) ⇒ Object Also known as: get
Returns the value of the field with the given name. If the value is not defined and the entry has cross-reference, returns the cross-referenced value instead.
346 347 348 |
# File 'lib/bibtex/entry.rb', line 346 def [](name) fields[name.to_sym] || parent&.provide(name) end |
#[]=(name, value) ⇒ Object
Adds a new field (name-value pair) to the entry. Returns the new value.
358 359 360 |
# File 'lib/bibtex/entry.rb', line 358 def []=(name, value) add(name.to_sym, value) end |
#add(*arguments) ⇒ Object Also known as: <<
call-seq:
add(:author, "Edgar A. Poe")
add(:author, "Edgar A. Poe", :title, "The Raven")
add([:author, "Edgar A. Poe", :title, "The Raven"])
add(:author => "Edgar A. Poe", :title => "The Raven")
add(:author => Names.new(Name.new(:first => 'Edgar A.', :last => 'Poe')))
Adds a new field (name-value pair) or multiple fields to the entry. Returns the entry for chainability.
371 372 373 374 375 376 377 |
# File 'lib/bibtex/entry.rb', line 371 def add(*arguments) Hash[*arguments.flatten].each_pair do |name, value| fields[name.to_sym] = Value.create(value) end self end |
#added_to_bibliography(bibliography) ⇒ Object
Called when the element was added to a bibliography.
433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 |
# File 'lib/bibtex/entry.rb', line 433 def added_to_bibliography(bibliography) super @key = register(key) %i[parse_names parse_months].each do |parser| send(parser) if bibliography.[parser] end if bibliography..key?(:filter) [*bibliography.[:filter]].each do |filter| convert!(filter) end end self end |
#aliases ⇒ Object
Returns the Entry’s field name aliases.
179 180 181 |
# File 'lib/bibtex/entry.rb', line 179 def aliases @aliases ||= FIELD_ALIASES.dup end |
#children ⇒ Object Also known as: cross_referenced_by
Returns a list of all entries in the Bibliography containing a cross-reference to this entry or [] if there are no references to this entry.
573 574 575 |
# File 'lib/bibtex/entry.rb', line 573 def children bibliography&.q("@entry[crossref=#{key}]") || [] end |
#contained? ⇒ Boolean
Returns true if this entry is published inside a book, collection or journal
592 593 594 595 |
# File 'lib/bibtex/entry.rb', line 592 def contained? has_field?(:container, :journal) || has_field?(:booktitle) && get(:booktitle) != get(:title) end |
#container_title ⇒ Object
579 580 581 |
# File 'lib/bibtex/entry.rb', line 579 def container_title get(:booktitle) || get(:journal) || get(:container) end |
#content(options = {}) ⇒ Object
Returns a string of all the entry’s fields.
629 630 631 |
# File 'lib/bibtex/entry.rb', line 629 def content( = {}) fields.map { |k, _v| "#{k} = #{fields[k].to_s()}" }.join(",\n") end |
#convert(*filters) ⇒ Object
Returns a duplicate entry with all values converted using the filter(s). If an optional block is given, only those values will be converted where the block returns true (the block will be called with each key-value pair).
609 610 611 |
# File 'lib/bibtex/entry.rb', line 609 def convert(*filters) block_given? ? dup.convert!(*filters, &Proc.new) : dup.convert!(*filters) end |
#convert!(*filters) ⇒ Object
In-place variant of @see #convert
614 615 616 617 618 619 620 621 622 |
# File 'lib/bibtex/entry.rb', line 614 def convert!(*filters) filters = filters.flatten.map { |f| Filters.resolve!(f) } fields.each_pair do |k, v| !block_given? || yield(k, v) ? v.convert!(*filters) : v end self end |
#date ⇒ Object
515 516 517 |
# File 'lib/bibtex/entry.rb', line 515 def date get(:date) || get(:year) end |
#delete(name) ⇒ Object
Removes the field with a given name from the entry. Returns the value of the deleted field; nil if the field was not set.
383 384 385 |
# File 'lib/bibtex/entry.rb', line 383 def delete(name) fields.delete(name.to_sym) end |
#digest(filter = []) ⇒ String
Creates the entry’s digest based on the passed-in filters.
The digest contains the type and all key-value pairs based on the passed in filter.
If a block is given, the computed digest will be passed to the block for post-processing (the entry itself will be passed as the second parameter).
408 409 410 411 412 413 414 415 416 417 418 |
# File 'lib/bibtex/entry.rb', line 408 def digest(filter = []) names = field_names(filter) digest = type.to_s names.zip(values_at(*names)).each do |key, value| digest << "|#{key}:#{value}" end digest = yield(digest, self) if block_given? digest end |
#each ⇒ Object Also known as: each_pair
call-seq:
entry.each { |key, value| block } -> entry
entry.each_pair { |key, value| block } -> entry
entry.each -> an_enumerator
entry.each_pair -> an_enumerator
Calls block once for each key in entry, passing the key-value pair as parameters.
If no block is given, an enumerator is returned instead.
167 168 169 170 171 172 173 174 |
# File 'lib/bibtex/entry.rb', line 167 def each if block_given? fields.each(&Proc.new) self else to_enum end end |
#fetch(name, default = nil) ⇒ Object
352 353 354 |
# File 'lib/bibtex/entry.rb', line 352 def fetch(name, default = nil) get(name) || (block_given? ? yield(name) : default) end |
#field_names(filter = [], include_inherited = true) ⇒ Object
Returns a sorted list of the Entry’s field names. If a filter
is passed as argument, returns all field names that are also defined by the filter. If the filter
is empty, returns all field names.
If the second optional argument is true (default) and the Entry contains a cross-reference, the list will include all inherited fields.
281 282 283 284 285 286 287 288 289 290 |
# File 'lib/bibtex/entry.rb', line 281 def field_names(filter = [], include_inherited = true) names = fields.keys names.concat(inherited_fields) if include_inherited && has_parent? names &= filter.map(&:to_sym) unless filter.empty? names.sort! names end |
#has_children? ⇒ Boolean Also known as: cross_referenced?
Returns true if the entry is cross-referenced by another entry in the Bibliography.
564 565 566 |
# File 'lib/bibtex/entry.rb', line 564 def has_children? !children.empty? end |
#has_field?(*names) ⇒ Boolean Also known as: field?
224 225 226 227 228 |
# File 'lib/bibtex/entry.rb', line 224 def has_field?(*names) names.flatten.any? do |name| name.respond_to?(:to_sym) ? fields.key?(name.to_sym) : false end end |
#has_parent? ⇒ Boolean Also known as: has_cross_reference?
Returns true if the Entry has a valid cross-reference in the Bibliography.
540 541 542 |
# File 'lib/bibtex/entry.rb', line 540 def has_parent? !parent.nil? end |
#has_type?(type) ⇒ Boolean Also known as: type?
218 219 220 |
# File 'lib/bibtex/entry.rb', line 218 def has_type?(type) type.to_s.match(/^(?:entry|\*)$/i) || @type == type.to_sym || super end |
#identifier ⇒ Object
420 421 422 423 424 425 426 427 428 429 430 |
# File 'lib/bibtex/entry.rb', line 420 def identifier if provides?(:doi) "info:doi/#{get(:doi)}" elsif provides?(:isbn) "urn:isbn:#{get(:isbn)}" elsif provides?(:issn) "urn:issn:#{get(:issn)}" else "urn:bibtex:#{key}" end end |
#inherited_fields ⇒ Object
Returns a sorted list of all field names referenced by this Entry’s cross-reference.
293 294 295 296 297 298 299 300 301 |
# File 'lib/bibtex/entry.rb', line 293 def inherited_fields return [] unless has_parent? names = parent.fields.keys - fields.keys names.concat(parent.aliases.select { |_k, v| parent.has_field?(v) }.keys) names.sort! names end |
#inherits?(*names) ⇒ Boolean
232 233 234 235 236 |
# File 'lib/bibtex/entry.rb', line 232 def inherits?(*names) names.flatten.any? do |name| !has_field(name) && has_parent? && parent.provides?(name) end end |
#initialize_copy(other) ⇒ Object
84 85 86 87 88 89 90 91 |
# File 'lib/bibtex/entry.rb', line 84 def initialize_copy(other) @fields = {} self.type = other.type self.key = other.key add(other.fields) end |
#join ⇒ Object
483 484 485 486 |
# File 'lib/bibtex/entry.rb', line 483 def join fields.values.each(&:join) self end |
#key ⇒ Object Also known as: id
202 203 204 205 206 207 208 |
# File 'lib/bibtex/entry.rb', line 202 def key if @key.nil? || @key.empty? @key = default_key else @key end end |
#key=(key) ⇒ Object Also known as: id=
Sets the Entry’s key. If the Entry is currently registered with a Bibliography, re-registers the Entry with the new key; note that this may change the key value if another Entry is already regsitered with the same key.
Returns the new key.
189 190 191 192 193 194 195 196 197 198 199 200 |
# File 'lib/bibtex/entry.rb', line 189 def key=(key) key = key.to_s if registered? bibliography.entries.delete(@key) key = register(key) end @key = key rescue StandardError => e raise BibTeXError, "failed to set key to #{key.inspect}: #{e.}" end |
#merge(other, filter = field_names) ⇒ Object
93 94 95 |
# File 'lib/bibtex/entry.rb', line 93 def merge(other, filter = field_names) dup.merge!(other, filter) end |
#merge!(other, filter = field_names) ⇒ Object
97 98 99 100 101 102 103 104 105 106 107 108 109 110 |
# File 'lib/bibtex/entry.rb', line 97 def merge!(other, filter = field_names) raise InvalidArgument, "failed to merge entries: type mismatch: #{type} #{other.type}" unless type == other.type other.each do |name, value| if has_field?(name) get(name).merge!(value) if filter.include?(name) else add name, value.dup end end self end |
#month=(month) ⇒ Object
488 489 490 491 492 |
# File 'lib/bibtex/entry.rb', line 488 def month=(month) fields[:month] = month ensure parse_month end |
#month_numeric ⇒ Object
494 495 496 497 498 499 |
# File 'lib/bibtex/entry.rb', line 494 def month_numeric return unless has_field?(:month) return unless (num = MONTHS.index fields[:month].to_sym) num.succ end |
#names ⇒ Object
Returns a list of all names (authors, editors, translators).
535 536 537 |
# File 'lib/bibtex/entry.rb', line 535 def names NAME_FIELDS.map { |k| has_field?(k) ? @fields[k].tokens : nil }.flatten.compact end |
#pages_from ⇒ Object
583 584 585 |
# File 'lib/bibtex/entry.rb', line 583 def pages_from fetch(:pages, '').split(/\D+/)[0] end |
#pages_to ⇒ Object
587 588 589 |
# File 'lib/bibtex/entry.rb', line 587 def pages_to fetch(:pages, '').split(/\D+/)[-1] end |
#parent ⇒ Object Also known as: cross_reference
Returns the cross-referenced Entry from the Bibliography or nil if this Entry does define a cross-reference.
556 557 558 |
# File 'lib/bibtex/entry.rb', line 556 def parent bibliography && bibliography[fields[:crossref]] end |
#parent_missing? ⇒ Boolean Also known as: cross_reference_missing?
Returns true if the Entry cross-references an Entry which is not registered in the current Bibliography.
548 549 550 |
# File 'lib/bibtex/entry.rb', line 548 def parent_missing? has_field?(:crossref) && !has_parent? end |
#parse_month ⇒ Object Also known as: parse_months
501 502 503 504 505 506 507 508 509 510 511 |
# File 'lib/bibtex/entry.rb', line 501 def parse_month fields.delete(:month_numeric) return unless has_field?(:month) fields[:month] = MONTHS_FILTER[fields[:month]] numeric = MONTHS.index(fields[:month].to_sym) fields[:month_numeric] = Value.new(numeric.succ) if numeric self end |
#parse_names ⇒ Object
Parses all name values of the entry. Tries to replace and join the value prior to parsing.
521 522 523 524 525 526 527 528 529 530 531 532 |
# File 'lib/bibtex/entry.rb', line 521 def parse_names strings = bibliography ? bibliography.strings.values : [] NAME_FIELDS.each do |key| if name = fields[key] name = name.dup.replace(strings).join.to_name fields[key] = name unless name.nil? end end self end |
#provide(name) ⇒ Object
Returns the field value referenced by the passed-in name. For example, this will return the ‘title’ value for ‘booktitle’ if a corresponding alias is defined.
256 257 258 259 260 261 |
# File 'lib/bibtex/entry.rb', line 256 def provide(name) return nil unless name.respond_to?(:to_sym) name = name.to_sym fields[name] || fields[aliases[name]] end |
#provides?(*names) ⇒ Boolean
Returns true if the Entry has a field (or alias) for any of the passed-in names.
239 240 241 242 243 244 245 246 247 |
# File 'lib/bibtex/entry.rb', line 239 def provides?(*names) names.flatten.any? do |name| if name.respond_to?(:to_sym) has_field?(name) || has_field?(aliases[name.to_sym]) else false end end end |
#provides_or_inherits?(*names) ⇒ Boolean
249 250 251 |
# File 'lib/bibtex/entry.rb', line 249 def provides_or_inherits?(*names) provides?(names) || inherits?(names) end |
#register(key) ⇒ Object
Registers this Entry in the associated Bibliographies entries hash. This method may change the Entry’s key, if another entry is already registered with the current key.
Returns the key or nil if the Entry is not associated with a Bibliography.
468 469 470 471 472 473 474 475 |
# File 'lib/bibtex/entry.rb', line 468 def register(key) return nil if bibliography.nil? k = key.dup k.succ! while bibliography.key?(k) bibliography.entries[k] = self k end |
#registered? ⇒ Boolean
Returns true if the Entry is currently registered with the associated Bibliography.
459 460 461 |
# File 'lib/bibtex/entry.rb', line 459 def registered? !!(bibliography && bibliography.entries[key].equal?(self)) end |
#removed_from_bibliography(bibliography) ⇒ Object
Called when the element was removed from a bibliography.
452 453 454 455 456 |
# File 'lib/bibtex/entry.rb', line 452 def removed_from_bibliography(bibliography) super bibliography.entries.delete(key) self end |
#rename(*arguments) ⇒ Object Also known as: rename_fields
Returns a copy of the Entry with all the field names renamed.
324 325 326 |
# File 'lib/bibtex/entry.rb', line 324 def rename(*arguments) dup.rename!(*arguments) end |
#rename!(*arguments) ⇒ Object Also known as: rename_fields!
Renames the given field names unless a field with the new name already exists.
330 331 332 333 334 335 336 337 338 |
# File 'lib/bibtex/entry.rb', line 330 def rename!(*arguments) Hash[*arguments.flatten].each_pair do |from, to| if fields.key?(from) && !fields.key?(to) fields[to] = fields[from] fields.delete(from) end end self end |
#replace(*arguments) ⇒ Object
477 478 479 480 481 |
# File 'lib/bibtex/entry.rb', line 477 def replace(*arguments) arguments = bibliography.q('@string') if arguments.empty? fields.values.each { |v| v.replace(*arguments) } self end |
#respond_to?(method, include_all = false) ⇒ Boolean
317 318 319 320 321 |
# File 'lib/bibtex/entry.rb', line 317 def respond_to?(method, include_all = false) provides?(method.to_sym) || method.to_s.match(/=$/) || method =~ /^(?:convert|from)_([a-z]+)(!)?$/ || (has_parent? && parent.respond_to?(method, include_all)) || super end |
#save_inherited_fields ⇒ Object
If the Entry has a cross-reference, copies all referenced all inherited values from the parent.
Returns the Entry.
267 268 269 270 271 272 273 |
# File 'lib/bibtex/entry.rb', line 267 def save_inherited_fields inherited_fields.each do |name| fields[name] = parent.provide(name) end self end |
#to_citeproc(options = {}) ⇒ Object
646 647 648 |
# File 'lib/bibtex/entry.rb', line 646 def to_citeproc( = {}) CiteProcConverter.convert(self, ) end |
#to_hash(options = {}) ⇒ Object
639 640 641 642 643 644 |
# File 'lib/bibtex/entry.rb', line 639 def to_hash( = {}) [:quotes] ||= %w[{ }] hash = { bibtex_key: key, bibtex_type: type } each_pair { |k, v| hash[k] = v.to_s() } hash end |
#to_rdf(_options = {}) ⇒ Object Also known as: to_bibo
Returns a RDF::Graph representation of the entry using the BIBO ontology.
655 656 657 658 659 660 661 |
# File 'lib/bibtex/entry.rb', line 655 def to_rdf( = {}) if defined?(::RDF) RDFConverter.convert(self) else BibTeX.log.error 'Please `gem install rdf` for RDF support.' end end |
#to_s(options = {}) ⇒ Object
Returns a string representation of the entry.
634 635 636 637 |
# File 'lib/bibtex/entry.rb', line 634 def to_s( = {}) [:quotes] ||= %w[{ }] ["@#{type}{#{key},", content().gsub(/^/, ' '), "}\n"].join("\n") end |
#to_xml(options = {}) ⇒ Object
650 651 652 |
# File 'lib/bibtex/entry.rb', line 650 def to_xml( = {}) BibTeXMLConverter.convert(self, ) end |
#update(fields) ⇒ Object
112 113 114 115 116 117 118 |
# File 'lib/bibtex/entry.rb', line 112 def update(fields) fields.each do |name, value| add name, value end self end |
#valid? ⇒ Boolean
Returns false if the entry is one of the standard entry types and does not have definitions of all the required fields for that type.
389 390 391 392 393 |
# File 'lib/bibtex/entry.rb', line 389 def valid? REQUIRED_FIELDS[type].all? do |f| f.is_a?(Array) ? !(f & fields.keys).empty? : !fields[f].nil? end end |
#values_at(*arguments) ⇒ Object
Returns an array containing the values associated with the given keys.
598 599 600 601 602 |
# File 'lib/bibtex/entry.rb', line 598 def values_at(*arguments) arguments.map do |key| get key end end |
#year ⇒ Object
665 666 667 668 669 670 |
# File 'lib/bibtex/entry.rb', line 665 def year return fields[:year] if has_field?(:year) return unless has_field?(:date) fields[:date].to_s[/\d{4}/] end |