123456789_123456789_123456789_123456789_123456789_

Class: RDoc::Markup::ToTableOfContents

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, Formatter
Instance Chain:
self, Formatter
Inherits: RDoc::Markup::Formatter
Defined in: lib/rdoc/markup/to_table_of_contents.rb

Overview

Extracts just the RDoc::Markup::Heading elements from a Document to help build a table of contents

Class Method Summary

Formatter - Inherited

.gen_relative_url

Converts a target url to one that is relative to a given path.
.new

Creates a new Formatter.

Instance Attribute Summary

Formatter - Inherited

#in_tt?

Are we currently inside tt tags?

Instance Method Summary

Formatter - Inherited

#accept_document

Adds document to the output.
#add_regexp_handling_RDOCLINK

Adds a regexp handling for links of the form rdoc-…:
#add_regexp_handling_TIDYLINK

Adds a regexp handling for links of the form <text> and <word>.
#add_tag

Add a new set of tags for an attribute.
#annotate

Allows tag to be decorated with additional information.
#convert

Marks up content
#convert_flow

Converts flow items flow
#convert_regexp_handling

Converts added regexp handlings.
#convert_string

Converts a string to be fancier if desired.
#ignore

Use ignore in your subclass to ignore the content of a node.
#off_tags

Turns off tags for item on #res
#on_tags

Turns on tags for item on #res
#parse_url

Extracts and a scheme, url and an anchor id from url and returns them.
#tt?

Is tag a tt tag?

Constructor Details

.new ⇒ ToTableOfContents

This method is for internal use only.
[ GitHub ] 

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 27



def initialize # :nodoc:
  super nil

  @omit_headings_below = nil
end


  







Class Method Details



  

    .to_toc  
  



  

    

Singleton for table-of-contents generation


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 13



def self.to_toc
  @to_toc ||= new
end


  







Instance Attribute Details



  

    #omit_headings_below   (rw)
  



  

    

Omits headings with a level less than the given level.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 25



attr_accessor :omit_headings_below


  








  

    #res   (readonly)
  



  

    

Output accumulator


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 20



attr_reader :res


  







Instance Method Details



  

    #accept_blank_line(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 77



alias accept_blank_line      ignore


  








  

    #accept_block_quote(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 74



alias accept_block_quote     ignore


  








  

    #accept_document(document)  
  



  

    

Adds document to the output, using its heading cutoff if present


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 36



def accept_document document
  @omit_headings_below = document.omit_headings_below

  super
end


  








  

    #accept_heading(heading)  
  



  

    

Adds heading to the table of contents


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 45



def accept_heading heading
  @res << heading unless suppressed? heading
end


  








  

    #accept_list_end(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 80



alias accept_list_end        ignore


  








  

    #accept_list_end_bullet(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 83



alias accept_list_end_bullet ignore


  








  

    #accept_list_item_end(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 82



alias accept_list_item_end   ignore


  








  

    #accept_list_item_start(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 81



alias accept_list_item_start ignore


  








  

    #accept_list_start(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 84



alias accept_list_start      ignore


  








  

    #accept_paragraph(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 78



alias accept_paragraph       ignore


  








  

    #accept_raw(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 75



alias accept_raw             ignore


  








  

    #accept_rule(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 76



alias accept_rule            ignore


  








  

    #accept_verbatim(*node)  
  

  

    This method is for internal use only.
  



  

    

::RDoc::Alias for Formatter#ignore.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 79



alias accept_verbatim        ignore


  








  

    #end_accepting  
  



  

    

Returns the table of contents


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 52



def end_accepting
  @res
end


  








  

    #start_accepting  
  



  

    

Prepares the visitor for text generation


  



  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 59



def start_accepting
  @omit_headings_below = nil
  @res = []
end


  








  

    #suppressed?(heading)  ⇒ Boolean 
  



  

    

Returns true if heading is below the display threshold


  





  


  [ GitHub ]


  

  


# File 'lib/rdoc/markup/to_table_of_contents.rb', line 67



def suppressed? heading
  return false unless @omit_headings_below

  heading.level > @omit_headings_below
end