Merge pull request #315 from mnishz/gui_x11_for_Vim_8.1

Update gui_x11 from Vim 8.0 to 8.1

Author: k-takata

doc/gui_x11.jax

@@ -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
@@ -52,6 +52,9 @@ GUIが開始されるときには、fork()して現在のプロセスを終了
 は、":gui -b" を使用するとよい。
 
 "gvim --nofork" と "gvim -f" は同じである。
+
+実行中のジョブがある場合、Vim は fork しない。なぜならそれらのプロセスが子プロ
+セスではなくなってしまうためである。
 								*E851* *E852*
 GUI の初期化に失敗した場合、Vim は現在の端末で実行を継続しようとする。
 
@@ -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がモード (挿入モードやコマンドモードなど)
 を変更するたびに自動的にマウスポインタを変更できる。現在、利用できるポインタは
 次の通り:
@@ -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"
@@ -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ウィ
@@ -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] をクリックするとログアウトが取り止めになる。