class Asciidoctor::Callouts

Public: Maintains a catalog of callouts and their associations.

def callout_ids li_ordinal

Returns A space-separated String of callout ids associated with the specified list item

retrieve the callouts
li_ordinal - the Integer ordinal (1-based) of the list item for which to

Public: Get a space-separated list of callout ids for the specified list item 
def callout_ids li_ordinal
  current_list.map {|it| it[:ordinal] == li_ordinal ? %(#{it[:id]} ) : '' }.join.chop
end

def current_list

Returns The Array of callouts at the position of the list index pointer

Public: The current list for which callouts are being collected 
def current_list
  @lists[@list_index - 1]
end

def generate_callout_id list_index, co_index

Returns A unique String id for a callout

co_index - The 1-based Integer index of the callout since the end of the last callout list
list_index - The 1-based Integer index of the callout list within the document

Internal: Generate a unique id for the callout at the specified position 
def generate_callout_id list_index, co_index
  %(CO#{list_index}-#{co_index})
end

def generate_next_callout_id

Returns A unique String id for this callout

Internal: Generate a unique id for the callout based on the internal indexes 
def generate_next_callout_id
  generate_callout_id @list_index, @co_index
end

def initialize 

def initialize
  @lists = []
  @list_index = 0
  next_list
end

def next_list

Returns nothing

Public: Advance to the next callout list in the document 
def next_list
  @list_index += 1
  if @lists.size < @list_index
    @lists << []
  end
  @co_index = 1
  nil
end

def read_next_id

Returns The unique String id of the next callout in the document

callout that was generated during parsing.
This method is used during conversion to retrieve the unique id of the
Reads the next callout index in the document and advances the pointer.

Public: Get the next callout index in the document 
def read_next_id
  id = nil
  list = current_list
  if @co_index <= list.size
    id = list[@co_index - 1][:id]
  end
  @co_index += 1
  id
end

def register li_ordinal

Returns The unique String id of this callout

# => "CO2-1"
callouts.register(2)
callouts.next_list
# => "CO1-1"
callouts.register(1)
callouts = Asciidoctor::Callouts.new

Examples

callout is to be associated
li_ordinal - the Integer ordinal (1-based) of the list item to which this

callout list.
list in the document and the index of this callout since the end of the last
Generates a unique id for this callout based on the index of the next callout

Public: Register a new callout for the given list item ordinal. 
def register li_ordinal
  current_list << { ordinal: li_ordinal.to_i, id: (id = generate_next_callout_id) }
  @co_index += 1
  id
end

def rewind

Returns nothing

from the parsing to conversion phase.
Public: Rewind the list index pointer, intended to be used when switching 
def rewind
  @list_index = 1
  @co_index = 1
  nil
end