この記事は Vim Advent Calendar 2014の 25 日目の記事です。

Googleが、様々な言語に対する自社内でのスタイルガイドを公開しているのはご存知でしょうか。C++ のものや JavaScript のものなどがあり、この辺りは割と有名かと思います。
では、Vim script のものがあるのはご存知でしょうか?
Googleは、Vim script について、2 つのガイドを公開しています。

• Google Vimscript Style Guide
• Google Vimscript Guide

前者がカジュアルユーザー向け、後者がヘビーユーザー向け、といった位置付けのようです。さすが、Googleがまとめているだけあって、なかなかポイントを抑えています。
ただ、これはあくまで Googleが社内向けに作ったもの。鵜呑みにしてはいけない、もしくは、一般の人が使う場合は参考にしない方がいい部分もちらほら見受けられます。
そこでこの記事では、この 2 つのスタイルガイドを見るにあたって注意すべき点をまとめようと思います。全て個人の見解です。引用に入っている訳は、私による勝手訳です。

CI サービスをいくつか触ってみたのでまとめ。
今回の目的は、テストを実行すること。なので、ビルドやデプロイ辺りはちゃんとは見ていない。
ドキュメントで確認しただけの項目などもあったりするので、間違っていたらごめんなさい。教えてもらえると助かります。
ただ、これは記事を書いた時点での比較で、今後のサービスの変更に対応する予定はないです。

hash = {a: 1, b: 2, c: 3}
hash2 = hash.map {|k, v| [k, v * 2] }.to_h
p hash2  # => {a: 2, b: 4, c: 6}

めんどくさい。Scalaには mapValuesというのがあるらしい。

Rubyで書くならこうかな。

classHashdefmap_values(&block)
    dup.map_values!(&block)
  enddefmap_values!(&block)
    update(self) {|_, v| block.call(v) }
  endend


hash = {a: 1, b: 2, c: 3}
hash2 = hash.map_values {|v| v * 2 }
p hash2  # => {a: 2, b: 4, c: 6}

ググると似たような話はちらほらあるっぽい。Rubyにも標準で欲しかった。

GitHubなどで Pull Request ベースで開発をしていると、master には間違っても push したくないわけです。
GitHub側には残念ながら master への push を禁止するような設定はできないので、仕方ないのでクライアント側の Hook で対応しようってことになり、この方法についてググるとこことかこことか、いくつか方法を紹介しているページが出てくるんですが、どれもやり方が間違っている*1ので、正しい方法を紹介。

#!/bin/bashwhile read local_ref local_sha1 remote_ref remote_sha1doif [["${remote_ref##refs/heads/}"="master"]];thenecho"Do not push to master branch!!!"exit1fidone

https://github.com/OmniSharp/omnisharp-vim
顔アイコンの中にマンボウアイコンを潜り込ませることに成功しました。壮観ですね。
問題の報告や機能要望などは私に直接言ってもらっても大丈夫です。日本語でOK。サーバ絡みだと対応は難しいかもしれないですが、善処します。
GitHubの Issue の方は世界中の人が見ているので、あちらに書く場合は英語でお願いします。

例えば、以下のような問題があったとします。

全  全
    ↓  ↓
中→□→□→結
    ↓  ↓
    曲  金

□に入る漢字を答えろ

この手の問題を解く場合、自前の知識の中から、時には勘も交えて総検索することになります。
ヒラメキと言えば聞こえはいいですが、別に考え方を変えたりして解ける問題ではないので、やることはただひたすら検索です。
なら機械にやらせてもいいのでは、ってことで、こういう問題を解くやつを作りました。
とりあえず動くレベルで、仕様とか見た目がかなり雑ですが、動くので公開します。

http://thinca.github.io/word-finder/

全  全
    ↓  ↓
中→A →B →結
    ↓  ↓
    曲  金

全A
中A
A曲
全B
B結
B金
AB

Yokohama.vim.reboot #6に行ってきた！
最近は勉強会自体あまり行けてなくて、それなのに行っても感想記事サボっているので反省…。久々に書く。

まとめ

次回のYokohama.vim#7は10月24日に開催します。同じ日にOsaka.vimが横浜で開催されるという噂も #yokohamavim#osakavim

2015-08-2920:37:34via Echofon

次回も行きます！

先週、進捗キャンプという知り合いで集まって進捗を出す会に行ってきて、そこで @haya14busaさんと表題の件について色々話した。
その後個人的に手法をカイゼンしたりしたので、結果をまとめておく。

vim -u NONE -i NONE -N-n-e-s-S<(cat <<EOFfunction! s:main(input) abortlet a = a:input[0]let [b, c] = split(a:input[1], '')let s = a:input[2]return(a + b + c) . '' . sendfunctionlet s:input = getline(1, '$')enewput =s:main(s:input)1 delete _%printEOF)<(cat)

vim -u NONE -i NONE -N-n-e-s-S<(...)<(cat)

function! s:main(input) abort
  leta=a:input[0]
  let [b, c] =split(a:input[1], '')lets=a:input[2]
  return(a + b + c).''.sendfunctionlets:input =getline(1, '$')enewput=s:main(s:input)1delete _
%print

function! s:main(input) abort
  leta=a:input[0]
  let [b, c] =split(a:input[1], '')lets=a:input[2]
  return(a + b + c).''.sendfunction

lets:input =getline(1, '$')

enew

put=s:main(s:input)1delete _

%print

" 部分を編集するバッファを開くコマンドの指定。これは縦分割したい場合の例 (デフォルトだと現在のウィンドウにそのまま開かれる)letg:partedit#opener ='vsplit'" 部分を編集するバッファの filetype。デフォルトだと元のバッファと同じ filetype が適用される。letg:partedit#filetype='vim'

" input.txt ファイルの中身を標準入力として使う
QuickRun -input input.txt

" = で始めることでファイルではなく入力文字列を直接与えられる
QuickRun -input =input-text
" i レジスタの中身を標準入力として使う
QuickRun -input =@i" b:input 変数の中身を標準入力として使う
QuickRun -input =%{b:input}" 事前に設定しておけば毎回指定する必要はないletg:quickrun_config ={'_': {}}letg:quickrun_config._.input ='=@i'letg:quickrun_config._.input ='=%{b:input}'" 実行する際に変数に値を入れれば OKletb:input ="1\n2 3\ntest\n"

lethoge='debug'put=hoge
" put の中では " はコメント扱いになり使えないので注意put="foo"これはコメントになるので動かない
put=\"foo\"  " これなら動く

function! s:main(input) abort
  leta=a:input[0]
  let [b, c] =split(a:input[1], '')lets=a:input[2]
  return(a + b + c).''.sendfunctionecho s:main(['1', '2 3', 'test'])

Splatoon してますか? 本日また大きめのアップデートが入って、まだまだ熱は冷めそうにないですね。
さて、この Splatoon 専用の SNSとして、イカリングというサービスがあります。

イカリング: https://splatoon.nintendo.net/

フレンドのオンライン状態を確認できたり、フレンド内での週間ランキングが閲覧できたり、自分やフレンドの装備や各ブキの塗り面積が確認できたり、ステージのスケジュールを知ることができて、とても便利です。
とても便利なのでいつでも見れると嬉しいですね。
というわけで Vimから見れるようにしました。

https://github.com/thinca/vim-ikaring

letg:ikaring#username ='thinca'letg:ikaring#password ='******'

:Ikaring ranking

:Ikaring profile

VimConf 2015に行ってきた。
昨年は主催的ポジションからの参加だったのだけど、今年は割と一般参加的ポジションで、一応スタッフって枠にはなってたけど大したことはしてないし、ラクさせてもらいました。

というわけで各発表についての感想を雑につらつらと。

この記事は Vim script Advent Calendar 2015の 3 日目の記事です。

letv:errors = []

function! Test() abort
  letactual=2+2call assert_equal(5, actual)endfunctioncall Test()

echov:errors" => ['function Test line 2: Expected 5 but got 4']

letv:errors = []
function! Test() abort
  letactual=2+2call assert_equal(5, actual, 'test fail!')endfunctioncall Test()echov:errors" => ['function Test line 2: ''test fail!''']

C++まったく書いてないけどなぜか Boost.勉強会 #19 東京に行ってきたよ。
C++の最近の動向に軽く触れる感じでゆるーく感想書いてく。C++よくわかってないのでよくわからない感想しか書けません。

プログラミングをしていると、混ざっていると困る全角スペース。
可視化するように設定を書いている人も多いんじゃないでしょうか。
実際ググると、全角スペースを表示するための設定がたくさん出てきます。私も vimrc に設定書いてました。
でもこれ…みんなやってるなら、もうプラグインでよくない?
ってことでプラグインにしました。

zenspace.vim - Show Ideographic Space (a.k.a. Zenkaku Space).
https://github.com/thinca/vim-zenspace

全角スペースを表示するためだけのプラグインです。(画像内のタブの表示は 'listchars'によるもの)

デフォルトでは 'list'オプションの値に連動して、可視/不可視を切り替えます。なので、'list'オプションをオンにしてください。

setlist

'list'オプションとかいいから常に表示しろよ、って場合は g:zenspace#default_modeを設定してください。

letg:zenspace#default_mode ='on'

zenspace.vimは、常に表示する "on"、表示しない "off"、'list'オプションに追従する "list"の 3 つのモードがあり、ウィンドウ毎に独立しています。
デフォルト値を変える場合は上記の通り g:zenspace#default_modeを設定してください。個別のウィンドウで変更したい場合は :ZenSpaceOn :ZenSpaceOff :ZenSpaceList を使用してください。

augroup vimrc-highlight
  autocmd!
  autocmdColorScheme * highlight ZenSpace ctermbg=Red guibg=Red
augroup END

現在手元の設定ファイル類を整理しており、どこかから拾ってきたようなファイルがいくらかあるので、それらを可能な限り排除しようとしていた。

その中にはてな記法の Vim向けの syntax ファイルがあり、これは hatena.vimに含まれているのだが、投稿機能は必要なかったので syntax ファイルだけ持っていたようだ。

hatena.vimをプラグインとして管理してしまうことも考えたが、そもそもはてなブログにしてしまえば markdown になるから hatena.vim必要なくなるのではってことで移行してみた。

以上。

• 個人の作業メモになるので、内容の保証は一切できないけれど、誰かの参考になれば。
• 各レイヤーで何をやっているか知りたかったので、低レベルなところをコマンドラインでやってみている。
• 実際に開発する場合はもうちょっとちゃんと環境を整えた方が良いように思う。
• 私自身そんなに詳しいわけではないので突っ込み歓迎。

環境

• Gentoo Linux
• Java 1.8.0_74 (dev-java/oracle-jdk-bin)
• Spigot 1.9
• Kotlin 1.0

このメモの手順通りに作業した場合には以下のようなディレクトリ構造になる。

.
|- kotlin            (Kotlin コンパイラ)
|- kikori-plugin     (木こりプラグイン)
|- kotlin-plugin     (Kotlin サンプルプラグイン)
|- hello-plugin     (Pure Java サンプルプラグイン)
|- spigot           (Spigot 自体のビルド作業用)
`- spigot-server    (Spigot サーバを動かす用)

Spigot とは

https://www.spigotmc.org/

Minecraftのサーバ。プラグインを入れられる。Javaで動く。

Spigot の導入

大人の事情により Spigot はバイナリ配布されていない。代わりに簡単にビルドできるビルドツールがあるので、これでビルドする。

https://www.spigotmc.org/wiki/buildtools/

↑に各環境の詳細な手順が書かれているので、うまく行かない場合は読むとよい。

まずはビルドツールを取得する。

$ mkdir spigot
$ cd spigot
$ curl https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar -o BuildTools.jar

そしてこれを使ってビルド。今回は 1.9 を使う。今のところ、指定なしだと 1.8 がビルドされる模様。

ちなみにビルドツールを動かすには、Javaの他に Git も必要。ない場合はインストールしておく。

$ java -jar BuildTools.jar --rev 1.9

めっちゃがんばってビルドしてくれる。しばし待つと、カレントディレクトリに spigot-1.9.jarができる。これがサーバになる。

実際に起動してみる

https://www.spigotmc.org/wiki/spigot-installation/

まずはプラグインなしでとりあえず動かしてみる。実行は spigot-1.9.jarだけがあればできる。

こいつは起動時にカレントディレクトリにあれこれファイルやディレクトリを生成するので、新しいディレクトリで作業するのがよい。

$ mkdir ../spigot-server
$ cp spigot-1.9.jar ../spigot-server
$ cd ../spigot-server

引数が長いので、簡単に起動用のシェルスクリプトを作っておくと便利。

$ echo 'java -Xms512M -Xmx1024M -XX:MaxPermSize=128M -jar spigot-1.9.jar' > start.sh
$ chmod +x start.sh

起動する。

$ ./start.sh
Java HotSpot(TM) 64-Bit Server VM warning: ignoring option MaxPermSize=128M; support was removed in 8.0
Loading libraries, please wait...
[19:04:47 INFO]: Starting minecraft server version 1.9
[19:04:48 INFO]: Loading properties
[19:04:48 WARN]: server.properties does not exist
[19:04:48 INFO]: Generating new properties file
[19:04:48 WARN]: Failed to load eula.txt
[19:04:48 INFO]: You need to agree to the EULA in order to run the server. Go to eula.txt for more info.
[19:04:48 INFO]: Stopping server
>

$ ls
eula.txt  logs/  server.properties  spigot-1.9.jar

$

初回は起動に失敗する。使用許諾契約に同意する必要がある。eula.txtというファイルが生成されているので、これを Vimなどの適当なエディタで開く。

#By changing the setting below to TRUE you are indicating your agreement to our EULA (https://account.mojang.com/documents/minecraft_eula).
#Sun Mar 13 19:04:48 JST 2016
eula=false

EULAの URL があるので開いて目を通し、問題がなければ eula=falseを eula=trueに書き換えて保存。再び起動する。

$ ./start.sh
Java HotSpot(TM) 64-Bit Server VM warning: ignoring option MaxPermSize=128M; support was removed in 8.0
Loading libraries, please wait...
[21:22:23 INFO]: Starting minecraft server version 1.9
[21:22:23 INFO]: Loading properties
[21:22:23 INFO]: Default game type: SURVIVAL
[21:22:24 INFO]: This server is running CraftBukkit version git-Spigot-6f291ea-55a8535 (MC: 1.9) (Implementing API version 1.9-R0.1-SNAPSHOT)
[21:22:24 INFO]: Unable to find file banned-players.json, creating it.
[21:22:24 INFO]: Unable to find file banned-ips.json, creating it.
[21:22:24 INFO]: Unable to find file ops.json, creating it.
[21:22:24 INFO]: Unable to find file whitelist.json, creating it.

...(中略)...

[21:23:31 INFO]: Preparing start region for level 2 (Seed: 5519750147800174725)
[21:23:32 INFO]: Preparing spawn area: 11%
[21:23:33 INFO]: Preparing spawn area: 25%
[21:23:34 INFO]: Preparing spawn area: 39%
[21:23:35 INFO]: Preparing spawn area: 51%
[21:23:36 INFO]: Preparing spawn area: 62%
[21:23:37 INFO]: Preparing spawn area: 75%
[21:23:38 INFO]: Preparing spawn area: 90%
[21:23:39 INFO]: Done (73.641s)! For help, type "help" or "?"
>

無事起動した。最後の >はプロンプトで、管理用のコマンドなどが実行できる。

この状態で Minecraft 1.9 のクライアントから Multiplayer でサーバに接続すれば、ゲームが遊べる。サーバとクライアントが同じマシンなら、接続先のサーバアドレスに localhostと入力して接続すれば OK。

サーバを終了させるには stopコマンドを実行すればよい。

Pure Javaでプラグインを作ってみる

Kotlin に入る前に、まずは Pure Javaでプラグインを作ってみる。改めて断っておくと、とりあえず動くことを確認するための作業なので、構成はものすごく適当。

まずはプラグインのプロジェクト用にディレクトリを作る。

$ mkdir ../hello-plugin
$ cd ../hello-plugin

プラグインをビルドするには、Spigot のライブラリが必要になる。最初にビルドした中にあるので、コピーしてくる。

$ cp ../spigot/Spigot/Spigot-API/target/spigot-api-1.9-R0.1-SNAPSHOT.jar spigot-api.jar

HelloPlugin.javaとして、以下のようなファイルを作る。

import org.bukkit.plugin.java.JavaPlugin;

publicclass HelloPlugin extends JavaPlugin {
  @Overridepublicvoid onEnable() {
    getLogger().info("Hello, world!");
  }
}

プラグインがロードされた際に、ログに Hello, world!と表示するだけのプラグインだ。

これをコンパイルする。

$ javac -cp spigot-api.jar HelloPlugin.java

次に、プラグインの構成情報のためのファイル、plugin.ymlを作成する。プラグインにはこれが必要になる。

# プラグイン名name: hello
# プラグインのメインクラス。パッケージ付きのフルネームを書くmain: HelloPlugin
# プラグインのバージョンversion:1.0

ここまででファイルは以下のような感じ。

.
|- HelloPlugin.class
|- HelloPlugin.java
|- hello.jar
|- plugin.yml
`- spigot-api.jar

プラグインに必要な plugin.ymlと HelloPlugin.classを jar で固めて、サーバの pluginsディレクトリに放り込む。

$ jar cf hello.jar HelloPlugin.class plugin.yml
$ cp hello.jar ../spigot-server/plugins

あとはサーバを起動すれば、プラグインが読み込まれる。

$ cd ../spigot-server
$ ./start.sh
Java HotSpot(TM) 64-Bit Server VM warning: ignoring option MaxPermSize=128M; support was removed in 8.0
Loading libraries, please wait...
[22:18:07 INFO]: Starting minecraft server version 1.9
[22:18:07 INFO]: Loading properties
[22:18:07 INFO]: Default game type: SURVIVAL
[22:18:08 INFO]: This server is running CraftBukkit version git-Spigot-6f291ea-55a8535 (MC: 1.9) (Implementing API version 1.9-R0.1-SNAPSHOT)
[22:18:08 INFO]: Server Ping Player Sample Count: 12
[22:18:08 INFO]: Using 4 threads for Netty based IO
[22:18:08 INFO]: Debug logging is disabled
[22:18:08 INFO]: Generating keypair
[22:18:09 INFO]: Starting Minecraft server on *:25565
[22:18:09 INFO]: Using epoll channel type
[22:18:09 INFO]: Set PluginClassLoader as parallel capable
[22:18:09 INFO]: [hello] Loading hello v1.0
[22:18:09 INFO]: **** Beginning UUID conversion, this may take A LONG time ****

...(中略)...

[22:10:53 INFO]: Preparing spawn area: 66%
[22:10:53 INFO]: Preparing start region for level 2 (Seed: 5519750147800174725)
[22:10:54 INFO]: [hello] Enabling hello v1.0
[22:10:54 INFO]: [hello] Hello, world!
[22:10:54 INFO]: Server permissions file permissions.yml is empty, ignoring it
[22:10:54 INFO]: Done (9.339s)! For help, type "help" or "?"
>

ログに Hello, world!と表示されている。[hello]はプラグイン名だ。

Kotlin とは

https://kotlinlang.org/

JVMで動く実用的な言語。Androidとかで動かすことも考えて作られてる。 先月の 2/15 に待望のバージョン 1.0 がリリースされた。

まとめると、私もよくわかってない。わかってないので今回触ってみることにした感じ。

インストール

今回はコマンドラインで動くコンパイラを入れる。

$ cd ..
$ curl -sL https://github.com/JetBrains/kotlin/releases/download/build-1.0.0/kotlin-compiler-1.0.0.zip -o kotlin-compiler-1.0.0.zip
$ unzip -q kotlin-compiler-1.0.0.zip
$ PATH=$PATH:$PWD/kotlinc/bin

$PATHはとりあえず設定したけど、必要なら .bachrcなどできちんと設定すること。

Kotlin でプラグインを作ってみる

Kotlin もインストールできたので、プラグインを作ってみる。まずはディレクトリの作成。

$ mkdir ../kotlin-plugin
$ cd ../kotlin-plugin

ライブラリと plugin.ymlも先に用意しちゃう。

$ cp ../spigot/Spigot/Spigot-API/target/spigot-api-1.9-R0.1-SNAPSHOT.jar spigot-api.jar

name: kotlin
main: KotlinPlugin
version:1.0

そして Kotlin のソースコード、kotlin.ktを作る。

import org.bukkit.plugin.java.JavaPlugin

class KotlinPlugin : JavaPlugin() {
    override fun onEnable() {
        getLogger().info("Hello, Kotlin!")
    }
}

コンパイルする。

$ kotlinc -cp spigot-api.jar kotlin.kt -include-runtime -d kotlin.jar

-include-runtimeは、Kotlin のランタイムを jar に同梱して standalone にするためのオプション。実を言うと現段階のコードでは Kotlin のランタイムに依存していないので、これがなくても動くのだけど、書いていったらどうせ依存すると思うので今から入れておく。

さて、jar はできたけど、これには plugin.ymlが含まれていないので入れる。

$ jar uf kotlin.jar plugin.yml

そしてサーバの pluginsへ放り込んで動作確認。

$ cp kotlin.jar ../spigot-server/plugins
$ cd ../spigot-server
$ ./start.sh
Java HotSpot(TM) 64-Bit Server VM warning: ignoring option MaxPermSize=128M; support was removed in 8.0
Loading libraries, please wait...
[05:24:36 INFO]: Starting minecraft server version 1.9
[05:24:36 INFO]: Loading properties
[05:24:36 INFO]: Default game type: SURVIVAL
[05:24:37 INFO]: This server is running CraftBukkit version git-Spigot-6f291ea-55a8535 (MC: 1.9) (Implementing API version 1.9-R0.1-SNAPSHOT)
[05:24:37 INFO]: Server Ping Player Sample Count: 12
[05:24:37 INFO]: Using 4 threads for Netty based IO
[05:24:37 INFO]: Debug logging is disabled
[05:24:37 INFO]: Generating keypair
[05:24:37 INFO]: Starting Minecraft server on *:25565
[05:24:37 INFO]: Using epoll channel type
[05:24:37 INFO]: Set PluginClassLoader as parallel capable
[05:24:38 INFO]: [kotlin] Loading kotlin v1.0
[05:24:38 INFO]: [hello] Loading hello v1.0
[05:24:38 INFO]: **** Beginning UUID conversion, this may take A LONG time ****

...(中略)...

[05:24:46 INFO]: Preparing spawn area: 68%
[05:24:47 INFO]: Preparing start region for level 2 (Seed: 5519750147800174725)
[05:24:48 INFO]: [kotlin] Enabling kotlin v1.0
[05:24:48 INFO]: [kotlin] Hello, Kotlin!
[05:24:48 INFO]: [hello] Enabling hello v1.0
[05:24:48 INFO]: [hello] Hello, world!
[05:24:48 INFO]: Server permissions file permissions.yml is empty, ignoring it
[05:24:48 INFO]: Done (10.087s)! For help, type "help" or "?"
>

ちゃんと動いてる。

もうちょっと実践的なやつを作ってみる

せっかくなので何か簡単に作ろうと思う。というわけで、木を破壊したらその木より上にある木も全部破壊してくれる、いわゆる木こり機能を作ってみる。

コードは Gist に貼っておく。以下。Kotlin のコードをまともに書いたのは今回が初めてなので、Kotlin らしくなっていいるかはわからない。良ければアドバイスください(Gistにコメントなど歓迎)。

kikori mod for Spigot by Kotlin

Spigot では様々なイベントに対して処理を行える。Listenerインターフェースを実装したクラスで @EventHandlerアノテーションをつけたメソッドを定義し、そこでイベントを受け取る。引数のイベントの型で受け取れるイベントが決まり、イベントのオブジェクトからイベントに関する情報が取れる。今回使った BlockBreakEventなら、壊れたブロックや壊したプレイヤーの情報が取得できる。あとはこのクラスをプラグインマネージャに登録すればよい。

今まで通りビルドすれば動かせる。

$ kotlinc -cp spigot-api.jar kikori.kt -include-runtime -d kikori.jar
$ jar uf kikori.jar plugin.yml
$ cp kikori.jar ../spigot-server/plugins

結果は自分の手でご確認ください。(動画とか用意するの面倒)

参考リンク

• Bukkit Coding For Dummies - Google ドキュメント
  • プラグインの作り方のチュートリアル。Eclipseを使っている
• Spigot-API 1.9-R0.1-SNAPSHOT API
  • Spigot の APIリファレンス(Javadoc)
• Reference - Kotlin Programming Language
  • Kotlin のリファレンス。Kotlin についてほとんど知らなかったので見ながら作業した。

最近 Vimのカラースキームの自作に関する記事をちらほら見かける。

私自身も最近、いいカラースキームないかなーと探していたりするので(作る気は皆無)、私が探す際のポイントなんかを書いておく。

ちなみにこの記事では主にカラースキームの機能面についてのみ言及する。 配色に関しては私はセンスがほぼないので、色について完全に感覚で選んでいて参考にならない。

一通りの色が定義してある

最重要項目なのだけど、できていないものが多い。個人的には全て設定されていてほしい。 大きく分けて Vim自身が使う部品のハイライトと、テキスト内の構文ハイライトで使うものがある。

前者の一覧は :help highlight-groupsで見ることができる。この記事を書いている時点での最新版である Vim 7.4.1639 では以下の 45 個だ。たまーに本体への機能追加で増えるので、注意したい。

*hl-ColorColumn*
ColorColumn     'colorcolumn'で設定された列の表示に使われる
*hl-Conceal*
Conceal         Conceal されたテキストの代わりに表示される代替文字の表示に使わ
                れる ('conceallevel'参照)
*hl-Cursor*
Cursor          カーソル下の文字
*hl-CursorIM*
CursorIM        Cursorと同じだが、IMEモードにいるとき使われる|CursorIM|。
*hl-CursorColumn*
CursorColumn    'cursorcolumn'がオンになっているときのカーソルがある画面上の桁
*hl-CursorLine*
CursorLine      'cursorline'がオンになっているときのカーソルがある画面上の行
*hl-Directory*
Directory       ディレクトリ名(とリストにある特別な名前)
*hl-DiffAdd*
DiffAdd         差分モード: 追加された行 |diff.txt|
*hl-DiffChange*
DiffChange      差分モード: 変更された行 |diff.txt|
*hl-DiffDelete*
DiffDelete      差分モード: 削除された行 |diff.txt|
*hl-DiffText*
DiffText        差分モード: 変更された行中の変更されたテキスト |diff.txt|
*hl-ErrorMsg*
ErrorMsg        コマンドラインに現れるエラーメッセージ
*hl-VertSplit*
VertSplit       垂直分割したウィンドウの区切りとなる桁
*hl-Folded*
Folded          閉じた折り畳みの行
*hl-FoldColumn*
FoldColumn      'foldcolumn'*hl-SignColumn*
SignColumn      目印|signs|が表示される行。
*hl-IncSearch*
IncSearch       'incsearch'のハイライト; ":s///c" で置換されたテキストにも使
                われる。
*hl-LineNr*
LineNr          ":number" と ":#" コマンドの行番号。'number'オプションか
                'relativenumber'オプションが設定されているときにはその表示に
                も使われる。
*hl-CursorLineNr*
CursorLineNr    LineNr と同じだが 'cursorline'か 'relativenumber'が設定され
                ているときに現在行に使われる。
*hl-MatchParen*
MatchParen      カーソル下の文字、または直後の文字が括弧であるとき、その文字と
                対応する括弧に使われる。|pi_paren.txt|

*hl-ModeMsg*
ModeMsg         'showmode'のメッセージ (例. "-- INSERT --")
*hl-MoreMsg*
MoreMsg         |more-prompt|
*hl-NonText*
NonText         ウィンドウの端の '~'と '@'、'showbreak'で設定された文字など、
                実際のテキストには存在しない文字(例. 全角文字が行末に収まらな
                いとき ">" が表示される)。
*hl-Normal*
Normal          通常のテキスト
*hl-Pmenu*
Pmenu           ポップアップメニュー: 通常の項目。
*hl-PmenuSel*
PmenuSel        ポップアップメニュー: 選択されている項目。
*hl-PmenuSbar*
PmenuSbar       ポップアップメニュー: スクロールバー。
*hl-PmenuThumb*
PmenuThumb      ポップアップメニュー: スクロールバーのつまみ部分。
*hl-Question*
Question        ヒットエンタープロンプト|hit-enter|とyes/noクエスチョン
*hl-Search*
Search          最後に検索した語のハイライト('hlsearch')を参照。
                quickfixウィンドウ内の現在行のハイライトや、それに類するものに
                使われる。
*hl-SpecialKey*
SpecialKey      ":map" でリストされるメタキーと特別なキー。テキスト中の
                unprintableな文字を表示するのにも使われる。
                一般に: 実際とは異なる文字で表示されるテキスト
*hl-SpellBad*
SpellBad        スペルチェッカに認識されない単語。|spell|
                これは他のハイライトと同時に組み合わせられる。
*hl-SpellCap*
SpellCap        大文字で始まるべき単語。 |spell|
                これは他のハイライトと同時に組み合わせられる。
*hl-SpellLocal*
SpellLocal      スペルチェッカによって他の地域で使われると判断される単語。
                |spell|これは他のハイライトと同時に組み合わせられる。
*hl-SpellRare*
SpellRare       スペルチェッカによってまず使わないと判断される単語。|spell|
                これは他のハイライトと同時に組み合わせられる。
*hl-StatusLine*
StatusLine      カレントウィンドウのステータスライン
*hl-StatusLineNC*
StatusLineNC    非カレントウィンドウのステータスライン。
                Note: これが "StatusLine" に等しい場合、カレントウィンドウのス
                テータスラインに "^^^" が使われる。
*hl-TabLine*
TabLine         タブページの行の、アクティブでないタブページのラベル
*hl-TabLineFill*
TabLineFill     タブページの行の、ラベルがない部分
*hl-TabLineSel*
TabLineSel      タブページの行の、アクティブなタブページのラベル
*hl-Title*
Title           ":set all"、":autocmd" などによる出力のタイトル。
*hl-Visual*
Visual          ビジュアルモード選択
*hl-VisualNOS*
VisualNOS       vimが "Not Owning the Selection" のときのビジュアルモード選択。
                これをサポートしているのはX11GUI|gui-x11|と|xterm-clipboard|の
                み。
*hl-WarningMsg*
WarningMsg      警告メッセージ
*hl-WildMenu*
WildMenu        'wildmenu'補完における現在の候補

後者の、構文ハイライトに使われるもののリストは、:help group-nameで確認できる。

*Comment        o コメント

*Constant       o 定数
         String         o 文字列定数: "これは文字列です"
         Character      o 文字定数: 'c', '\n'
         Number         o 数値定数: 234, 0xff
         Boolean        o ブール値の定数: TRUE, false
         Float          o 不動小数点数の定数: 2.3e10

*Identifier     o 変数名
         Function       o 関数名(クラスメソッドを含む)

*Statement      o 命令文
         Conditional    o if, then, else, endif, switch, その他
         Repeat         o for, do, while, その他
         Label          o case, default, その他
         Operator       o "sizeof", "+", "*", その他
         Keyword        o その他のキーワード
         Exception      o try, catch, throw

*PreProc        o 一般的なプリプロセッサー命令
         Include        o #include プリプロセッサー
         Define         o #define プリプロセッサー
         Macro          o Defineと同値
         PreCondit      o プリプロセッサーの #if, #else, #endif, その他

*Type           o int, long, char, その他
         StorageClass   o static, register, volatile, その他
         Structure      o struct, union, enum, その他
         Typedef        o typedef宣言

*Special        o 特殊なシンボル
         SpecialChar    o 特殊な文字定数
         Tag            o この上で CTRL-]を使うことができる
         Delimiter      o 注意が必要な文字
         SpecialComment o コメント内の特記事項
         Debug          o デバッグ命令

*Underlined     o 目立つ文章, HTMLリンク

*Ignore         o (見た目上)空白, 不可視  |hl-Ignore|

*Error          o エラーなど、なんらかの誤った構造

*Todo           o 特別な注意が必要なもの; 大抵はTODO FIXME XXXなど
                          のキーワード

こちらは、先頭に *が付いているものだけ定義されていればよい。それ以外のものはデフォルトで同じグループの *付きのものにリンクされているので、同じ色で表示される。

CUI/GUI対応

私は Vimを CUIでも GUIでも使うので、両対応のものが欲しい。両者でほぼ同じ見た目だと嬉しい。

実は CSApprox.vimというプラグインを使うと任意の GUI向けカラースキームを CUI向けに変換することができるのだけど…変換したファイルの管理などを考えると面倒なのであまりやりたくない。最初から対応していてくれると嬉しい。

background=dark

そろそろ完全に個人の好みの領域に入ってきました。黒背景が好きです。

単色系より色んな色が使われているやつ

単色系のはスタイリッシュではあると思うけども、せっかく色がついてるのに見分けづらかったりして実用性に疑問があるので。はい。個人的な好みになります。

VertSplit は文字が見えないやつ

完全に指定が細かくなってきた。ウィンドウの垂直分割(左右に分ける)の縦区切りの線、あれ |が使われているのだけど、背景色と前景色を同じにして見えなくなってるほうが好き。

すごく細かいところを挙げるとまだある気がするけどこの辺にしておこう。

以上

なにかオススメあったら教えてください。

参考

カラースキームを作ってみよう - 永遠に未完成

技術評論社から発売される Software Design 2016年5月号の第1特集「Vim[実践]投入」に寄稿しました。

gihyo.jp

全5章の構成で、5人の Vimmerが1人1章を担当する豪華な内容になっています。

書いたこと

私は第2章「Vimだからできる、一歩先行く編集術」を担当しました。

今回の特集は、4月から新社会人になった方々をメインターゲットに、入門者向けの内容になっています。 その中でも第2章では、Vimならではの機能について紹介しました。

この記事を見て、多くあるエディタの中から Vimを選ぶ意義について感じてもらえれば幸いです。

書けなかったこと

今回、これから Vimを使い始める人達を対象に記事を書くということで、help の引き方についての解説を入れたかったのですが、紙面の都合上叶いませんでした。

Vimを使っていくにあたって、help を引くことはとても重要です。Vimは設計上の目標(:help design-goals)の一つによくドキュメント化されていることを挙げており、大抵のことは help に書いてあります。また、プラグインについても、まともなプラグインであればドキュメントが書かれていて、Vimの中からいつでも参照できるようになっています。

調べ方を知っておくというのは Vimに限らず重要なことです。記事内での解説は叶いませんでしたが、もし Vimを使うことに決めた場合は、まずはヘルプのヘルプ(:help helphelp)などを見て引き方を知っておくとよいでしょう。

それでは、よい Vimライフを！

先日、はてなダイアリーからはてなブログへ移行した。

thinca.hatenablog.com

移行に際して問題があったので書き記しておく。

TL;DR

はてなダイアリーで <hoge>って書いてたら、はてなブログに移行すると死ぬ。

あらすじ

私は今まではてなダイアリーでそれなりに記事を公開していた。Vim中でも記事が多く、<Leader>のようなキーの記法をあちこちで多様していた。 はてなダイアリーでは html タグは一部のタグしか使えない仕様だったため、それ以外の <Leader>のようなタグっぽい文字列はそのまま表示されていたので、なんの問題もなかった。

はてなブログでは、はてなダイアリーで使えた「はてな記法」と Markdown の両方が選択できるようになっており、はてなダイアリーで書いた記事は「はてな記法」で書かれた記事として公開されるので、そのまま移行できるとの話だったので、はてなブログへの移行を行った。

ところが、はてなブログに移行後しばらくして気付いたのだが、この <Leader>のような文字列が、はてなブログの記事内では表示されなくなってしまっていた。

はてなダイアリーからはてなブログに記事を import したら、はてな記法内で <Leader> みたいに書いている部分がダイアリーでは普通に表示されていたのにブログに import された記事では全て表示されなくなってる。はてな許さない。

— thinca (@thinca) 2016年3月13日

ゆるせなかったのでサポートにメールし、調査を行ってもらったのだけど、最終的に以下のような返事が返ってきた(本文のみ抜粋)。

いつもはてなをご利用いただきありがとうございます。

返信が遅くなりまして申し訳ございませんでした。

はてなダイアリーでは特定のタグしか書けない仕様となっているため、 「<」 や 「>」をそのまま表示させることができましたが、 はてなブログでは、任意のタグを書ける仕様となっているため、 実体参照表記でないと表示がされません。

インポート時に一括置換できないか検討いたしましたが、今回は見送ることになりました。 大変お手数をおかけ致しますが、記事の編集画面を開いていただき、 手作業で置換をしていただくようお願い致します。

【置換例】 <Leader> → &lt;Leader&gt;

どうぞよろしくお願いいたします。

どうやらはてなダイアリーでの「はてな記法」と、はてなブログでの「はてな記法」には厳密には互換性はないらしい。

改めて移行に関するヘルプページを確認すると、以下のような説明が足されていた。

• HTMLタグの扱いの違いに注意してください。はてなブログでは、はてなダイアリーと違ってHTMLタグがすべて利用できるため、<と>で囲まれた任意の文字列をHTMLタグとして解釈します

※はてなブログで、<と>で囲まれた任意の文字列を表示するには、たとえば&lt;foo&gt;のように実体参照で表記してください。

先月の時点の同ページにはこの記述はないため、恐らく私の問い合わせを契機に追記されたのだと思う。

返事に1ヶ月半ほどかかっているところを見ると、それなりに検討した結果だと思うので、残念だけども仕方ない。

というわけで、これから移行を考えている人は注意してください。 また、私の古い記事の中にはこれらの理由により一部文字が消えている可能性があるので、ご了承頂きたい。さすがに過去の記事全てをチェックするのはしんどすぎる。もし発見された方は報告してもらえれば可能な限り直そうと思います。

色々あって node.js から Vimの help を引く必要が出てきたので、npm パッケージにしてみた。人生初 npm パッケージです。

https://www.npmjs.com/package/vimhelp
https://github.com/thinca/node-vimhelp

特に必然性はなかったのだけど、せっかくなので勉強も兼ねて ES2015 で書いてみた。node.js にも依存しているので、node.js 6 以降が必須です。 このパッケージは外部プロセスとして Vimを起動して、help を引きます。なので環境に Vimが必要です。また、プラグインの help も引きたいというそれだけのために Git を使った簡易プラグインマネージャも付いてます。こちらを使う場合は Git が必要。 使い方とかは README を参照してください。

苦労した点

初めての npm

今回初めてだったので、npm の作法やら ES2015 の機能やら、ついでにテストやらカバレッジ計測やら色々調べながらやった結果、必要以上に時間がかかってしまった…。

非同期地獄

node.js の非同期 APIは、呼び出しスタックの奥底に 1 つでも非同期が混じると根本から非同期の APIにする必要が出てくるのがだいぶしんどく感じた。Promise のおかげでネスト深いは回避できているものの、やはりまだしんどい印象が拭えない。ES2016 で入るとの噂の await があるとここがかなりマシになりそうな予感がするので、はよ。

外部プロセスのテスト

外部プロセスを起動するようなプログラムのテストはどこまでモックにするべきかがかなり悩ましい。コマンド実行部分をモックにすると、想定したコマンドが実行されているかまではテストできるが、想定したコマンドが期待した結果を生むかまではテストできない。そこまですべきなのかどうなのか…。 今はモック化するのが難しかったという理由もあって、テストでも実際にコマンドが実行されている。なのでプラグインマネージャのテストが走る度に git cloneが実行されるという感じに…。実行も遅くなるので正直しんどい。

機能実現のアプローチについて

今回 Vimの help を引くという機能を実現するにあたって、Vimを実際に実行するという手段を選んだわけだけど、helptags や help ファイルを直接読んでパースするという手段も考えられた。 実際のところ、直接読んだ方が速度や効率は良いと思う。ただ、tags ファイルをパースしたり、Vimがやっている :helpの引数の独自解釈などを自分でやるのが面倒だったため、今回は直接起動する方法を取った。こちらの方法だと、今後 Vimが :help の動作を拡張などした場合にも対応できる。そういう機会はそうそうないとは思うけども。少なくとも私が必要としている用途においてはこれでも十分な速度で動いている。

さいごに

初 npm パッケージ、作ってみたのはいいけど自分以外には需要なさそう。まだ欲しい機能がいくつかあるので、のんびり更新していく予定。