Добавить исходный код Ruby как HTML в RDoc - PullRequest
Новая
       41

Добавить исходный код Ruby как HTML в RDoc

3 голосов
/ 02 ноября 2010

Как включить файл кода ruby, как есть, в RDoc?

У меня есть файл example.rb, в котором описано, как использовать мой гем, и я хотел бы включитьэто как один из файлов, таких как README.rdoc и HISTORY.rdoc.

Я уже выяснил, как преобразовать исходный код ruby ​​в HTML, используя синтаксис gem , но я не могу понять, как заставить RDoc включить файл, не анализируя его.

Когда я говорю RDoc включить html-файл, его нет в списке, и если я его подделываю, используя rdoc или txt в качестве расширения файла, он не отображается должным образом (файл по-прежнему фактически html).1011 *

У меня есть решение, которое работает, оно просто невероятно уродливо.Должен быть лучший способ сделать это, родной для rdoc, но я этого не вижу.

Вот что у меня есть в моем Rakefile: 

# Build rdocs
require 'rake/rdoctask'
require 'syntax/convertors/html'
rdoc_dir = 'rdoc'
# This is rdoc1 but it doesn't work unless you DON'T wrap it in a task
# Generate html files from example ruby files
convertor = Syntax::Convertors::HTML.for_syntax "ruby"
replacement_key = "REPLACE_THIS_TEXT_WITH_PROPER_HTML"
# Create dummy files
Dir.glob('examples/*.rb').each do |file|
  File.open("#{file}.txt", "w") do |dummy_file|
    dummy_file.write(replacement_key)
  end
end

# Call the rdoc task
Rake::RDocTask.new(:rdoc2) do |rdoc|
  rdoc.rdoc_dir = rdoc_dir
  rdoc.title = "pickled_optparse #{version}"
  rdoc.rdoc_files.include('README*')
  rdoc.rdoc_files.include('HISTORY*')
  rdoc.rdoc_files.include('examples/*.txt')
  rdoc.rdoc_files.include('lib/**/*.rb')
end

task :rdoc3 do
  # Now use a hammer to replace the dummy text with the
  # html we want to use in our ruby example code file.
  html_header = File.read('rake_reqs/html_header.html')
  Dir.glob('examples/*.rb').each do |file|
    html_ruby = convertor.convert(File.read(file))
    rdoc_file = "#{rdoc_dir}/examples/#{File.basename(file,".rb")}_rb_txt.html"
    fixed_html = File.read(rdoc_file).gsub!(replacement_key, "#{html_header}#{html_ruby}")
    File.open(rdoc_file, "w") {|f| f.write(fixed_html)}
    File.delete("#{file}.txt")
  end
end

task :rdoc => [:rdoc2, :rdoc3]

1 Ответ

1 голос
/ 10 ноября 2010

Извините, я не могу дать вам точный ответ, но я сам смотрю на sdoc .Вы можете установить самоцвет из рубиновых самоцветов.

...