模块 RDoc

RDoc 通过解析源代码并提取类、模块、方法、包含和要求的定义来生成 Ruby 源文件的文档。它将这些与紧接其前的注释块中包含的可选文档相关联，然后使用输出格式化程序呈现结果。

有关使用 RDoc 编写或生成文档的简单介绍，请参阅 README。

路线图 ↑

如果您认为在 RDoc 中发现了错误，请参阅 CONTRIBUTING 中的错误。

如果您想使用 RDoc 为您的 Ruby 源文件创建文档，请参阅 RDoc::Markup 并参考 rdoc --help 以获取命令行用法。

如果您想设置默认标记格式，请参阅 RDoc::Markup 中的受支持格式

如果您想在您的 gem 中存储 rdoc 配置（例如默认标记格式），请参阅 RDoc::Options 中的已保存选项

如果您想为 Ruby 文件编写文档，请参阅 RDoc::Parser::Ruby

如果您想为用 C 编写的扩展编写文档，请参阅 RDoc::Parser::C

如果您想使用 rake 生成文档，请参阅 RDoc::Task。

如果您想以编程方式驱动 RDoc，请参阅 RDoc::RDoc。

如果您想使用库将文本块格式化为 HTML 或其他格式，请查看 RDoc::Markup。

如果您想制作一个 RDoc 插件，例如生成器或指令处理程序，请参阅 RDoc::RDoc。

如果您想编写自己的输出生成器，请参阅 RDoc::Generator。

如果您想了解 RDoc 的工作原理，请参阅 CONTRIBUTING 中的错误。

贡献者 ↑

RDoc 目前由 Eric Hodel <[email protected]> 维护。

Dave Thomas <[email protected]> 是 RDoc 的最初作者。

常量

ATTR_MODIFIERS

RDoc 属性修饰符

CLASS_MODIFIERS

RDoc 类修饰符

CONSTANT_MODIFIERS

RDoc 常量修饰符

DOT_DOC_FILENAME

包含当前目录中要处理的文件描述的点文件的名称

GENERAL_MODIFIERS

通用 RDoc 修饰符

KNOWN_CLASSES

Ruby 的内置类、模块和异常

METHOD_MODIFIERS

RDoc 方法修饰符

VERSION

您正在使用的 RDoc 版本

VISIBILITIES

Method 可见性

公共类方法

home() 点击切换源代码

搜索并返回设置目录。

  1. $HOME/.rdoc 目录（如果存在）。

  2. XDG_DATA_HOME 环境变量指定的路径下的 rdoc 目录（如果已设置）。

  3. $HOME/.local/share/rdoc 目录。

除了主目录外，包含目录将自动创建。

# File lib/rdoc.rb, line 134
def self.home
  rdoc_dir = begin
              File.expand_path('~/.rdoc')
            rescue ArgumentError
            end

  if File.directory?(rdoc_dir)
    rdoc_dir
  else
    require 'fileutils'
    begin
      # XDG
      xdg_data_home = ENV["XDG_DATA_HOME"] || File.join(File.expand_path("~"), '.local', 'share')
      unless File.exist?(xdg_data_home)
        FileUtils.mkdir_p xdg_data_home
      end
      File.join xdg_data_home, "rdoc"
    rescue Errno::EACCES
    end
  end
end
load_yaml() 点击切换源代码

加载最佳可用的 YAML 库。

# File lib/rdoc.rb, line 107
def self.load_yaml
  begin
    gem 'psych'
  rescue NameError => e # --disable-gems
    raise unless e.name == :gem
  rescue Gem::LoadError
  end

  begin
    require 'psych'
  rescue ::LoadError
  ensure
    require 'yaml'
  end
end