Feature #188 [ruby-reference-manual:966]

メソッド名のリンクをもっと目立たせる。

Added by Yutaka HARA 380 days ago. Updated 321 days ago.

Status :Open Start :06/18/2008
Priority :Normal Due date :08/13/2008
Assigned to :Minero Aoki % Done :

0%

Category :bitclust
Target version :-
reporter :

ruby_version :


Description

各クラスのメソッド一覧で、現状だとメソッド名にしかリンクが張られていないので、
初めて見た人はそこがクリックできることに気がつかないらしい。
(複数人から報告を受けました^^;)

リンクのCSSを変えるか、メソッドのシグネチャもリンクに含めるか、<td>全体をクリックできるようにするなどしてリンクを目立たせるといい。

Associated revisions

Revision 3008
Added by aamine 324 days ago

  • lib/bitclust/methodsignature.rb: new class MethodSignature, which represents RRD method signature line ("--- m(param) {...} -> type").
  • lib/bitclust/screen.rb (foreach_method_chunk): yields a MethodSignature to the template.
  • lib/bitclust/rdcompiler.rb (method_signature): show method signature in user-friendly form ("x + y" rather than "+(y)"). (refs #170)
  • template/class: ditto.
  • lib/bitclust/rdcompiler.rb (method_signature): makes the whole signature a hyperlink. (refs #188)
  • template/class: ditto.
  • template/search: ditto.
  • tools/check-signature.rb: a new tool to check method signature format.

History

06/18/2008 11:36 PM - Takashi Tamura

こんばんは sheepman です。

シグネチャに下線を引いたりすると見にくくなると思うので、
マウスオーバーで td 全体の色が変わるか、メソッドの説明に「続きを読む」を
表示するのが良いと思います。

On Wed, 18 Jun 2008 19:19:33 +0900
Yutaka HARA <redmine@ruby-lang.org> wrote:

> チケット #188 が報告されました。 (by Yutaka HARA)
> 
> ----------------------------------------
> Feature #188: メソッド名のリンクをもっと目立たせる。
> http://redmine.ruby-lang.org/issues/show/188
> 
> 起票者: Yutaka HARA
> ステータス: Open
> 優先度: Normal
> 担当者: 
> カテゴリ: bitclust
> Target version: 
> reporter: 
> ruby_version: 
> 
> 
> 各クラスのメソッド一覧で、現状だとメソッド名にしかリンクが張られていないので、
> 初めて見た人はそこがクリックできることに気がつかないらしい。
> (複数人から報告を受けました^^;)
> 
> リンクのCSSを変えるか、メソッドのシグネチャもリンクに含めるか、<td>全体をクリックできるようにするなどしてリンクを目立たせるといい。
> 
> 

-- 
sheepman / TAMURA Takashi

--
ML: ruby-reference-manual@ml.fdiary.net
使い方: http://QuickML.com/

06/19/2008 12:45 AM - okkez _

okkez です。

あんまり HTML とか CSS には詳しくないのですが、ちょっと試してみました。

最後に付けたパッチでマウスオーバーの際に td の背景色は変わりますが、リンクは以前のままです。

a { display: block; }

とかやれば td の内部が a タグのみの場合は td 全体にリンクが付くのですが、今回の場合はちょっと
厳しそうです。
bitclust のソースもちょっとだけ見てみましたが、リンクがメソッド名にしか付かないので
上記の方法を実現しようと思うと、ちょっと本体に手を入れる必要がありそうです。

yhara さん案でも sheepman さん案でも、bitclust に手を入れる必要があるのかなと思いました。

# td の onClick を使って javascript でリンクを実現する手もあるかな。

Index: theme/default/style.css
===================================================================
--- theme/default/style.css     (revision 2793)
+++ theme/default/style.css     (working copy)
@@ -186,6 +186,11 @@
     width: 20em;
 }

+td.signature:hover {
+    color: #fff;
+    background-color: #4aa;
+}
+
 td.description {
     padding: 0.5em;
     background-color: #EEE;



-- 
okkez
okkez000@gmail.com

--
ML: ruby-reference-manual@ml.fdiary.net
使い方: http://QuickML.com/

08/13/2008 02:19 PM - Minero Aoki

  • Due date set to 08/13/2008
  • Assigned to set to Minero Aoki

08/16/2008 03:50 PM - Minero Aoki

幅は広げてみたが、高さが<td>の100%に広がらない。

Also available in: Atom PDF