Где найти шаблон rdoc API Rails - PullRequest
1 голос
/ 05 мая 2011

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

На данный момент я нашел

, что может бытьнемного устарела, и это вилка

Оба хороши, но не совсем то, что я хочу.Итак, прежде чем я начну возиться с этими шаблонами, кто-нибудь знает, доступен ли шаблон, используемый документами Rails API, где-нибудь как драгоценный камень?

Спасибо!

Ответы [ 2 ]

3 голосов
/ 03 сентября 2011

Я знаю, что уже очень поздно, но похоже, что в новой версии Rails используется что-то под названием sdoc, которое улучшает вывод с помощью поиска JavaScript и немного чище IMO.Выполнение простого "gem install sdoc" получит то, что вам нужно, затем просто используйте rdoc.options << '-f' << 'sdoc'.

Проект github выглядит как https://github.com/voloko/sdoc/

Кстати, спасибо завопрос!Без опубликованного первоначального ответа я бы никогда не нашел, где искать, и застрял в этой ужасной темной рыбе для моих собственных проектов!

3 голосов
/ 05 мая 2011

Это выглядит так. Игнорируйте инструкции, которые говорят сделать gem install horo --pre - это на самом деле даст вам более старую бета-версию. Просто сделайте gem install horo, и вы получите текущую версию 1.0.3 ( Редактировать : я отправил запрос на обновление, чтобы обновить инструкции, которые уже приняты).

https://github.com/tenderlove/horo

Кстати, я нашел это, посмотрев исходный код Rails и просмотрев Rakefile, чтобы увидеть параметры RDoc. В частности, строка 67 показывает rdoc.options << '-f' << 'horo'.

...