Contents

# Utility functions for citations class
#
# Copyright (c) Peter Lane, 2013.
# Released under Open Works License, 0.9.2

module AsciidoctorBibliography
  # Some utility functions used in Citations class
  module CitationUtils

    # Given a line, return a list of CitationData instances
    # containing information on each set of citation information
    def retrieve_citations line
      result = []
      md = CITATION_FULL.match line
      while md
        data = CitationData.new md[0], md[1], nil, []
        cm = CITATION_KEY.match md[2]
        while cm
          pages = nil
          if cm[2]
            pages = cm[2][1...-1]
          end
          data.cites << Citation.new(cm[1], pages)
          # look for next ref within citation
          cm = CITATION_KEY.match cm.post_match 
        end
        result << data
        # look for next citation on line
        md = CITATION_FULL.match md.post_match 
      end

      return result
    end

    # arrange author string, flag for order of surname/initials
    def arrange_authors authors, surname_first 
      return [] if authors.nil?
      authors.split(/\band\b/).collect do |name|
        if name.include?(", ")
          parts = name.strip.rpartition(", ")
          if surname_first
            "#{parts.first}, #{parts.third}"
          else
            "#{parts.third} #{parts.first}"
          end
        else
          name
        end
      end
    end

    # Arrange given author string into Chicago format
    def author_chicago authors 
      arrange_authors authors, true 
    end

    # matches a citation key, such as 'Dan2012(99-100)'
    CITATION_KEY = /([^\s,()\[\]]+)(\(\d+(-\d+)*\))?/
    # matches a citation type
    CITATION_TYPE = /cite|citenp|fullcite/
    # matches a citation list
    CITATION_LIST_TAIL = /(\s*,\s*#{CITATION_KEY})*/
    CITATION_LIST = /(?:#{CITATION_KEY}#{CITATION_LIST_TAIL})/
    # matches the whole citation
    CITATION_FULL = /(#{CITATION_TYPE}):\[(#{CITATION_LIST})\]/
  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
asciidoctor-bibliography-0.1	deprecated/asciidoctor-bibliography/citationutils.rb
asciidoctor-bibliography-0.0.1.dev	deprecated/asciidoctor-bibliography/citationutils.rb