Module: RDoc::Generator::Markup

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In: ::RDoc::Alias, ::RDoc::AnonClass, ::RDoc::AnyMethod, ::RDoc::Attr, ::RDoc::ClassModule, ::RDoc::CodeObject, ::RDoc::Constant, ::RDoc::Context, ::RDoc::Context::Section, ::RDoc::Extend, ::RDoc::GhostMethod, ::RDoc::Include, ::RDoc::MetaMethod, ::RDoc::MethodAttr, ::RDoc::Mixin, ::RDoc::NormalClass, ::RDoc::NormalModule, ::RDoc::Require, ::RDoc::SingleClass, ::RDoc::TopLevel
Defined in:	lib/rdoc/generator/markup.rb

Overview

Handle common ::RDoc::Markup tasks for various CodeObjects

This module is loaded by generators. It allows RDoc's ::RDoc::CodeObject tree to avoid loading generator code to improve startup time for ri.

Instance Method Summary

#aref_to(target_path)

Generates a relative URL from this object's path to target_path
#as_href(from_path)

Generates a relative URL from from_path to this object's path.
#cvs_url(url, full_path)

Build a webcvs URL starting for the given url with full_path appended as the destination path.
#description

Handy wrapper for marking up this object's comment.
#formatter

Creates an ::RDoc::Markup::ToHtmlCrossref formatter.

Instance Method Details

#aref_to(target_path)

Generates a relative URL from this object's path to target_path

[ GitHub ]

# File 'lib/rdoc/generator/markup.rb', line 12


def aref_to(target_path)
  RDoc::Markup::ToHtml.gen_relative_url path, target_path
end

#as_href(from_path)

Generates a relative URL from from_path to this object's path

[ GitHub ]

# File 'lib/rdoc/generator/markup.rb', line 19


def as_href(from_path)
  RDoc::Markup::ToHtml.gen_relative_url from_path, path
end

#cvs_url(url, full_path)

Build a webcvs URL starting for the given url with full_path appended as the destination path. If url contains '%s' full_path will be will replace the %s using sprintf on the url.

[ GitHub ]

# File 'lib/rdoc/generator/markup.rb', line 49


def cvs_url(url, full_path)
  if /%s/ =~ url then
    sprintf url, full_path
  else
    url + full_path
  end
end

#description

Handy wrapper for marking up this object's comment

[ GitHub ]

# File 'lib/rdoc/generator/markup.rb', line 26


def description
  markup @comment
end

#formatter

Creates an ::RDoc::Markup::ToHtmlCrossref formatter

[ GitHub ]

# File 'lib/rdoc/generator/markup.rb', line 33


def formatter
  return @formatter if defined? @formatter

  options = @store.rdoc.options
  this = RDoc::Context === self ? self : @parent

  @formatter = RDoc::Markup::ToHtmlCrossref.new options, this.path, this
  @formatter.code_object = self
  @formatter
end