2

Rake を使用して自分のプロジェクトの RDoc ドキュメントを生成していますが、Darkfish が生成するように見えるグレー オン グレー スタイルが本当に嫌いです。他のすべてに満足しています。配色をもう少し読みやすくしたいと思います。

これが私のレーキタスクです：

Rake::RDocTask.new do |rd|
    rd.main = "README.rdoc"
    rd.title = "My Title"
    rd.rdoc_files.include("README.rdoc", "lib/**/*.rb")
    rd.options = ['--main', 'README.rdoc']
end

上記に追加しようとしまし'--style', 'doc/rdoc.css'たが、不明なオプションであるrd.optionsと不平を言い、無視します。テンプレートやcssなどをカスタマイズする方法に関するドキュメント--styleが見つからないようです。Darkfish が良さそうに見えるものを我慢する必要があるのでしょうか?

4

3 に答える 3

1

darkfishが生成する.cssファイルのコピーを取得し、変更を加えて、ハードディスクの別のディレクトリに保存することはできません。次に、rakeタスクで、rdocが完了したときに.cssファイルを上書きしますか？

于 2012-03-02T02:05:35.547 に答える
1

Darkfish テンプレートを見ると、次のような CSS 参照のみが表示されます。

<link type="text/css" media="screen" href="<%= rel_prefix %>/rdoc.css" rel="stylesheet" />

あるものとrel_prefixないものがあります。他のスタイルシートを含めるためのテンプレートはありません。おそらく、カラーリングの変更をテンプレートに適用するrdoc.cssか、テンプレートを手動で編集して、変更を加えた別のスタイルシートを含める必要があります。

より良いアプローチは、--styleサポートを Darkfish にパッチし、作者にパッチを送ることです。テンプレートに少し余分な erb を追加し、いくつかのスイッチ解析ロジックを追加し、 in への呼び出しの周りに新しい変数を追加するだけでよいようself.render_templateですlib/rdoc/generator/darkfish.rb。これは Darkfish への便利な追加機能のように思えます。作成者は、誰かが自分のソフトウェアをより良くしたいと考えていることを喜んでいるかもしれません。

于 2011-04-07T02:05:12.117 に答える
0

Darkfish は --template 'your_template_name'; でテンプレートをサポートしています。これは、rdoc プラグイン gem として設定する必要があると思います。

これも役立つかもしれません: http://fossplanet.com/f14/making-rdoc-template-gem-26986/

次のようなディレクトリ構造を持つ gem を意味する RDoc プラグイン gem:

./lib/rdoc/generator/template/#{your template name and files copied from rdoc-2.blah/lib/rdoc/generator/template/darkfish}

と

./rdoc/generate.rb上記のテンプレート ディレクトリを $LOAD_PATH の先頭に追加します。( $LOAD_PATH.unshift(File.expand_path(File.join(Dir.pwd,'..','lib', "#{..... and so on}")

于 2011-04-08T14:56:21.707 に答える