Class: YARD::CLI::YardocOptions

Inherits:
Templates::TemplateOptions show all
Defined in:
lib/yard/cli/yardoc.rb

Overview

Default options used in yard doc command.

Direct Known Subclasses

Server::Commands::LibraryOptions

Instance Attribute Summary (collapse)

Instance Method Summary (collapse)

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class YARD::Options

Instance Attribute Details

- (String) default_return Originally defined in class Templates::TemplateOptions

The default return type for a method with no return tags

Returns:

  • (String)

    the default return type for a method with no return tags

- (Array<String>) embed_mixins Originally defined in class Templates::TemplateOptions

An array of module name wildcards to embed into class documentation as if their methods were defined directly in the class. Useful for modules like ClassMethods. If the name contains '::', the module is matched against the full mixin path, otherwise only the module name is used.

Examples:

A list of mixin path names (including wildcards)

opts.embed_mixins #=> ['ClassMethods', '*Helper', 'YARD::*']

Returns:

  • (Array<String>)

    an array of module name wildcards to embed into class documentation as if their methods were defined directly in the class. Useful for modules like ClassMethods. If the name contains '::', the module is matched against the full mixin path, otherwise only the module name is used.

- (CodeObjects::ExtraFileObject) file

The file object being rendered. The object key is not used so that a file may be rendered in the context of an object's namespace (for generating links).

Returns:

  • (CodeObjects::ExtraFileObject)

    the file object being rendered. The object key is not used so that a file may be rendered in the context of an object's namespace (for generating links).



47
48
49
# File 'lib/yard/cli/yardoc.rb', line 47

def file
  @file
end

- (Symbol) format Originally defined in class Templates::TemplateOptions

The template output format

Returns:

  • (Symbol)

    the template output format

- (OpenStruct) globals Also known as: __globals Originally defined in class Templates::TemplateOptions

An open struct containing any global state across all generated objects in a template.

Returns:

  • (OpenStruct)

    an open struct containing any global state across all generated objects in a template.

- (Boolean) hide_void_return Originally defined in class Templates::TemplateOptions

Whether void methods should show “void” in their signature

Returns:

  • (Boolean)

    whether void methods should show “void” in their signature

- (Boolean) highlight Originally defined in class Templates::TemplateOptions

Whether code blocks should be syntax highlighted

Returns:

  • (Boolean)

    whether code blocks should be syntax highlighted

- (Numeric) index

An index value for rendering sequentially related templates

Returns:

  • (Numeric)

    An index value for rendering sequentially related templates



38
39
40
# File 'lib/yard/cli/yardoc.rb', line 38

def index
  @index
end

- (CodeObjects::Base) item

An extra item to send to a template that is not the main rendered object

Returns:

  • (CodeObjects::Base)

    an extra item to send to a template that is not the main rendered object



42
43
44
# File 'lib/yard/cli/yardoc.rb', line 42

def item
  @item
end

- (Symbol) markup Originally defined in class Templates::TemplateOptions

The markup format to use when parsing docstrings

Returns:

  • (Symbol)

    the markup format to use when parsing docstrings

- (Class) markup_provider Originally defined in class Templates::TemplateOptions

The markup provider class for the markup format

Returns:

  • (Class)

    the markup provider class for the markup format

- (Boolean) no_highlight Originally defined in class Templates::TemplateOptions

Deprecated.

use #highlight instead.

Whether highlighting should be ignored

Returns:

  • (Boolean)

    whether highlighting should be ignored

- (CodeObjects::Base) object Originally defined in class Templates::TemplateOptions

The main object being generated in the template

Returns:

- (Array<CodeObjects::Base>) objects

The list of code objects to render the templates with.

Returns:



35
36
37
# File 'lib/yard/cli/yardoc.rb', line 35

def objects
  @objects
end

- (CodeObjects::Base) owner Originally defined in class Templates::TemplateOptions

The owner of the generated object

Returns:

- (String) page_title Originally defined in class Templates::TemplateOptions

The title of a given page

Returns:

  • (String)

    the title of a given page

- (CodeObjects::ExtraFileObject) readme

The README file object rendered along with objects

Returns:



31
32
33
# File 'lib/yard/cli/yardoc.rb', line 31

def readme
  @readme
end

- (Boolean) serialize Originally defined in class Templates::TemplateOptions

Whether serialization should be performed

Returns:

  • (Boolean)

    whether serialization should be performed

- (Serializers::Base) serializer Originally defined in class Templates::TemplateOptions

The serializer used to generate links and serialize output. Serialization output only occurs if #serialize is true.

Returns:

  • (Serializers::Base)

    the serializer used to generate links and serialize output. Serialization output only occurs if #serialize is true.

- (Symbol) template Originally defined in class Templates::TemplateOptions

The template name used to render output

Returns:

  • (Symbol)

    the template name used to render output

- (Symbol) type Originally defined in class Templates::TemplateOptions

The template type used to generate output

Returns:

  • (Symbol)

    the template type used to generate output

- (Verifier) verifier Originally defined in class Templates::TemplateOptions

The verifier object

Returns:

Instance Method Details

- (Array<CodeObjects::ExtraFileObject>) files

The list of extra files rendered along with objects

Returns:



10
# File 'lib/yard/cli/yardoc.rb', line 10

default_attr :files, lambda { [] }

- (Symbol) format

The default output format (:html).

Returns:

  • (Symbol)

    the default output format (:html).



23
# File 'lib/yard/cli/yardoc.rb', line 23

default_attr :format, :html

- (Boolean) onefile

Whether the data should be rendered in a single page, if the template supports it.

Returns:

  • (Boolean)

    whether the data should be rendered in a single page, if the template supports it.



27
# File 'lib/yard/cli/yardoc.rb', line 27

default_attr :onefile, false

- (Serializers::Base) serializer

The default serializer for generating output to disk.

Returns:



20
# File 'lib/yard/cli/yardoc.rb', line 20

default_attr :serializer, lambda { Serializers::FileSystemSerializer.new }

- (String) title

The default title appended to each generated page

Returns:

  • (String)

    the default title appended to each generated page



13
# File 'lib/yard/cli/yardoc.rb', line 13

default_attr :title, "Documentation by YARD #{YARD::VERSION}"

- (Verifier) verifier

The default verifier object to filter queries

Returns:

  • (Verifier)

    the default verifier object to filter queries



16
# File 'lib/yard/cli/yardoc.rb', line 16

default_attr :verifier, lambda { Verifier.new }