Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update gui_x11 from Vim 8.0 to 8.1 #315

Merged
merged 2 commits into from
Oct 10, 2018
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
153 changes: 141 additions & 12 deletions doc/gui_x11.jax
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*gui_x11.txt* For Vim バージョン 8.0. Last change: 2016 Sep 12
*gui_x11.txt* For Vim バージョン 8.1. Last change: 2018 May 06


VIMリファレンスマニュアル by Bram Moolenaar
Expand Down Expand Up @@ -52,6 +52,9 @@ GUIが開始されるときには、fork()して現在のプロセスを終了
は、":gui -b" を使用するとよい。

"gvim --nofork" と "gvim -f" は同じである。

実行中のジョブがある場合、Vim は fork しない。なぜならそれらのプロセスが子プロ
セスではなくなってしまうためである。
*E851* *E852*
GUI の初期化に失敗した場合、Vim は現在の端末で実行を継続しようとする。

Expand Down Expand Up @@ -279,14 +282,15 @@ fvwm*ファミリのウィンドウマネージャーの 1 つを使用するな

Note: 古いバージョンのfvwmでは "ImagePath" ではなく "IconPath" を使う。

CDE "dtwm" (Motifから派生)については、.Xdefaultsにこの行を追加するとよい:
> Dtwm*Vim*iconImage: /usr/local/share/vim/vim32x32.xpm
CDE "dtwm" (Motifから派生)については、.Xdefaultsにこの行を追加するとよい: >
Dtwm*Vim*iconImage: /usr/local/share/vim/vim32x32.xpm

"mwm" (Motifウィンドウマネージャー)については、その行はこうなるだろう: >
Mwm*Vim*iconImage: /usr/local/share/vim/vim32x32.xpm
Mwm*Vim*iconImage: /usr/local/share/vim/vim32x32.xpm

X11で利用できるマウスポインタ *X11_mouse_shapes*

X11で利用できるマウスポインタ ~
*X11_mouse_shapes*
|'mouseshape'| オプションを使うと、Vimがモード (挿入モードやコマンドモードなど)
を変更するたびに自動的にマウスポインタを変更できる。現在、利用できるポインタは
次の通り:
Expand Down Expand Up @@ -355,10 +359,14 @@ app-defaultsは使われない。

残りのguiコンポーネント(例えば、メニューバー、スクロールバー、どんなものでも)
の色を設定したければ、GTK特有の設定があり、何かgtkrcファイルの類にそれらを設定
する必要がある。どのようにこれをすべきかについて、どんなに小さなものしかなくて
も、GTKドキュメントを参照しなければならないだろう。
する必要がある。GTKドキュメントを参照しなければならないだろうが、この方法に関
する情報はあまりない。詳細については、
http://developer.gnome.org/doc/API/2.0/gtk/gtk-Resource-Files.html
を参照。


*gtk-tooltip-colors*
ツールチップの色 ~
*gtk-tooltip-colors*
ツールチップの色を明るい黄色の背景に黒のテキストに設定する例: >

style "tooltips"
Expand All @@ -373,16 +381,136 @@ app-defaultsは使われない。
~/.gtkrc-2.0を使わなければいけないかも知れない。環境による。

GTK+ 3 でも、以下の CSS コードのスニペットを $XDG_HOME_DIR/gtk-3.0/gtk.css
(通常 $HOME/.config/gtk-3.0/gtk.css)に追加する事で上記と同様の効果が得られる。
>
(次のセクションを参照) に追加する事で上記と同様の効果が得られる。

3.20 未満の GTK+ 3 では: >

.tooltip {
background-color: #ffffcc;
color: #000000;
}
<
3.20 以上の GTK+ 3 では: >

tooltip {
background-color: #ffffcc;
text-shadow: none;
}

tooltip label {
color: #2e3436;
}
<

GTK+ CSS の簡単な説明 ~
*gtk-css*
このサブセクションの内容は、GTK+ CSS の安定したサポートを提供する GTK+ 3.20 以
降に適用される:

https://developer.gnome.org/gtk3/stable/theming.html

GTK+ は、ウィジェットのスタイリングおよびレイアウトに CSS を使用する。このサブ
セクションでは、単純な実例を通して GTK+ CSS の簡単な説明を行う。

通常、設定は次のようにして編集できる: >
vim $HOME/.config/gtk-3.0/gtk.css


例 1. 空白領域の調整 ~

標準では、GTK+ 3 GUI のツールバーおよびタブラインは GTK+ 2 GUI のものよりも幾
分大きい。一部の人は GTK+ 2 GUI と同じサイズの見た目にしたいかもしれない。

これを行うには、明らかに余分に見えるアイコンおよびラベル周辺の空白領域を削除す
る。

以下の行を $XDG_HOME_DIR/gtk-3.0/gtk.css (通常は $HOME/.config/gtk-3.0/gtk.css)
に追加する: >

toolbar button {
margin-top: -2px;
margin-right: 0px;
margin-bottom: -2px;
margin-left: 0px;

padding-top: 0px;
padding-right: 0px;
padding-bottom: 0px;
padding-left: 0px
}

notebook tab {
margin-top: -1px;
margin-right: 3px;
margin-bottom: -1px;
margin-left: 3px;

padding-top: 0px;
padding-right: 0px;
padding-bottom: 0px;
padding-left: 0px
}
<
CSS なので、一括指定プロパティを使って書き直すこともできる: >

toolbar button {
margin: -2px 0px;
padding: 0px;
}

notebook tab {
margin: -1px 3px;
padding: 0px
}
<
Note: アイコンサイズを調整するには 'toolbariconsize' を使用することもできる。

Note: 使用しているアイコンのテーマやフォントによっては、満足いく結果のために更
なる調整が必要かもしれない。

Note: margin や padding に加えて、border も使うことができる。詳細については、
次のような CSS のボックスモデルを参照すること。

https://www.w3schools.com/css/css_boxmodel.asp

例 2. 単なる色よりも ~

GTK+ CSS は同様にグラデーションもサポートしている: >

tooltip {
background-image: -gtk-gradient(linear,
0 0, 0 1,
color-stop(0, #344752),
color-stop(0.5, #546772),
color-stop(1, #243742));
}

tooltip label {
color: #f3f3f3;
}
<
グラデーションは、高いコントラストに頼ることなく GUI 要素を他のものと視覚的に
区別するために使用することができる。したがって、これらの効果的な活用は、テーマ
に色や輝度の統一感を与える有効なテクニックである。

Note: テーマは、すべてのアプリケーションの見た目を等しく良くしなければならない
ため困難となることもある。1 つのアプリケーションの見た目をより良くすることは、
しばしば他のものの魅力を意図せず下げてしまったり、使用感を悪化させてしまうこと
さえある。テーマを改善しようとするときには常にこれらを気に留めておくこと。


例 3. ボーダーの色

最大化したときのボーダーを取り除く: >

@define-color bg_color #1B2B34;
#vim-main-window {
background-color: @bg_color;
}

GTK+プラグインとしてVimを使う *gui-gtk-socketid*

GTK+ プラグインとして Vim を使用する ~
*gui-gtk-socketid*
GTK+版のVimを普通に起動すると、Vimは自身のトップレベルウィンドウを作成する(技
術的には 'GtkWindow')。GTK+はGtkSocket、GtkPlugウィジェットを使った埋め込み機
能を提供している。あるGTK+アプリケーションが自分のウィンドウにGtkSocketウィ
Expand Down Expand Up @@ -425,7 +553,8 @@ Note: GTK+ 3 GUIビルドで --enable-gnome-check を使用しない。上記で
GTK+ 3で統合されている。


GNOME セッションサポート *gui-gnome-session* *gnome-session*
GNOME セッションサポート ~
*gui-gnome-session* *gnome-session*

ログアウト時、Vim はバッファのどれかが変更されていると、よく知られた終了確認
ダイアログを表示する。[Cancel] をクリックするとログアウトが取り止めになる。
Expand Down
Loading