2006-05-15

Xcode の API リファレンスを見やすくする

post : 2006-05-15 11:12 | , ,

Cocoaプログラミング必須アプリ、Cocoa Browser SNの新バージョン(2.4)が出ていた。このアプリケーション、NSDocumentを使っているのに新規にウインドウを作る方法が見当たらない。が、nibを編集するだけで複数ウインドウに対応できる。Interface BuilderでMainMenu.nibを開き、メニュー項目を作ってFirst ResponderのnewDocument:に繋ぐだけ。何か不具合があるからシングルウインドウにしているのかもしれないけれど、特に問題なさそうである。ついでにウインドウをUnified lookにしてみた。新機能のAPI検索は使いにくいな。

さて本題。XcodeにもAPIリファレンスは付いているのだが、Cocoa Browserのようにメソッドごとに切り取らず、クラスごとのHTMLをそのまま表示するため、視認性が良くない。WebKitで実装されているので、UserStyleSheetで見やすくしようという試み。以下のようなcssを書いた。

div.mach4 {  /* method name Xcode 2.2 ならこっち*/
h3.tight {  /* method name Xcode 2.3 ならこっち */ 
    margin:64px -8px 0px -8px !important;
    padding:6px !important;
    font-size: 14px !important;
    font-family: "Bitstream Vera Sans Mono", courier, monospace !important;
    border-top:1px solid #d6ddee !important;
    border-bottom:1px solid #d6ddee !important;
    background:#f0f5f9 !important;
    color:#333333 !important;
}

code {
font-size: 12px !important;
font-family: "Bitstream Vera Sans Mono", courier, monospace !important;
}

Cocoa APIのHTMLは構造が酷く、カスタマイズできる箇所は限られる。辛うじてメソッド名が<div class="mach4">で囲ってあるのでここを攻める。左右marginをマイナス値にすることで、背景色が端まで塗られるようにする。margin-topを多めにとって視認性を向上。これを適当な場所に保存して、Terminalで以下を実行。

defaults write com.apple.Xcode DVDocView.WebKitUserStyleSheetLocationPreferenceKey "/path/to/custom.css"

で、上記のCSSを適用するとこうなる。いい感じになりました。

Xcode API reference

Trackback 現在、受付は中止しています

No Trackbacks

Comment

No Comments