Мне нравится генерировать справочные страницы, используя вывод '--help' через help2man и txt2man. Система Ruby RDoc очень удобна, но я не могу настроить RDoc::usage именно так, как хочу. Вот пример сценария: #!/usr/bin/env ruby # # === Name # #...

Что означают эти ошибки? [root@localhost config]# gem install bluecloth Building native extensions. This could take a while... ERROR: Error installing bluecloth: ERROR: Failed to build gem native extension. /usr/bin/ruby extconf.rb can't...

Я пытаюсь улучшить свою документацию по rdoc, используя версию 3.5.3. Я не фанат встроенной темы darkfish, поэтому я попытался найти способ заменить ее тем, что используется в официальной документации API Rails по адресу http://api.rubyonrails.org/...

Я создал образ с помощью «визуального» инструмента, который хочу разместить на первой странице моей документации по rdoc. Первая страница определяется в *.rdoc. Я обнаружил, что можно включать внешние изображения, но как включить локальные?...

Я использую rbenv и пытаюсь выяснить, где находится rdoc моих локальных драгоценных камней. Когда я устанавливаю гем, он говорит, что rdoc сгенерирован правильно, то есть: % gem install rails -v "2.3.2" Successfully installed rails-2.3.2 1...

У меня есть файл readme в проекте rails и задача rake, которая генерирует текстовый файл. Я хочу включить содержимое из этого файла в мой Readme.rdoc, возможно ли все, что я получаю после поиска в Google - некоторые директивы :include: Я включаю...

Существует отличный инструмент rustdoc (в настоящее время используется cargo ) для тестовые примеры комментариев к документации в Rust . Дает ли нам rdoc или yard что-то подобное в Ruby?

После поиска в документации RDoc я не могу найти, как задокументировать файл / верхнюю метод уровня в RDoc... Предположим, у меня есть следующий код: ## # File documentation. # File:: foo.rb # Date:: 09/05/2018 ## require 'stuff' ## #...

Я хочу, чтобы фрагмент кода, например хеш, отображался с фиксированным шрифтом в результирующем html. Предположим, это содержимое моего файла: =begin One example of valid hash to this function is: { :name => "Engelbert", :id =>...