List of Editor [text.Baldanders.info]

テキストエディタ Zed を試してみる

2024-07-15T05:20:40+00:00

かつての Atom エディタの開発者が作ったという Rust 製のテキストエディタ Zed の Linux 版（安定版）が登場したらしい。

既に macOS 版は存在する。 Windows 版はまだないようだ。

インストール方法は

Linux - Zed

を参照のこと。大抵の場合はインストール用の shell スクリプトをダウンロード，実行すればいいようだ。

$ curl https://zed.dev/install.sh | sh
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  4220  100  4220    0     0   9353      0 --:--:-- --:--:-- --:--:--  9336
Downloading Zed
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   565    0   565    0     0    382      0 --:--:--  0:00:01 --:--:--   383
100 53.0M  100 53.0M    0     0  9866k      0  0:00:05  0:00:05 --:--:-- 15.9M
To run Zed from your terminal, you must add ~/.local/bin to your PATH
Run:
   echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.bashrc
   source ~/.bashrc
To run Zed now, '~/.local/bin/zed'

~/.bashrc ファイルにパスを追加しろって書いてあるが Ubuntu の場合は ~/.profile ファイルに

# set PATH so it includes user's private bin if it exists
home_local_bin_path="$HOME/.local/bin"
if [ -d "$home_local_bin_path" -a -n "${PATH##*${home_local_bin_path}}" -a -n "${PATH##*${home_local_bin_path}:*}" ] ; then
  export PATH="$home_local_bin_path:$PATH"
fi
unset home_local_bin_path

みたいな記述があれば特に追加で何かする必要はないだろう。ちなみに ~/.local/bin ディレクトリに直接インストールされるわけではなく，実体は ~/.local/zed.app ディレクトリ以下に展開され ~/.local/bin ディレクトリにはシンボリックリンクが配置されている。

Ubuntu の場合，上述のスクリプトを使ってインストールする場合は制限があって Ubuntu 18 以前（2.29 より古い glibc を使用している）のバージョンでは動かないらしい。また32ビットアーキテクチャでも動かない。まぁ，ソースからビルドすれば行けるかもしれないが（Rust って古いディストリビューションって対応してたっけ？）。

あとアプリケーションの速度を確保するために Vulkan を通じて GPU と通信しているらしい。このため GPU がないと動作が遅くなるとのこと。 GPU を確認する場合は

$ sudo apt install vulkan-tools

で vulkan-tools パッケージをインストールし，ターミナルで vkcube コマンドを叩いてみる。すると以下のウィンドウが起動して画面内の立方体が物凄い勢いで回転するのだが

vkcube

ターミナル側には

$ vkcube
Selected GPU 0: AMD Radeon Graphics (RADV RENOIR), type: IntegratedGpu

のように使用する GPU の ID が表示される。これが llvmpipe だと GPU がないか認識してないってことらしい。また AMD Radeon の場合はドライバによって “Broken Pipe” のエラーが出て上手く動かないことがあるそうな。この場合はドライバを RADV にするといいとのこと（参照： #13880）

インストールが完了してターミナルから zed コマンドが無事起動できたら以下の画面が表示される筈。

vkcube

最初から Vim モードを選択可能なのか。 Vimmer はどこにでもいるんだな（笑）その下の2つのチェックボックスはテレメータの設定なので，テレメータを送信したくないならチェックを外しておけばよい。

細かい設定は ~/.config/zed/settings.json ファイルで可能。設定可能な項目は “Configuring Zed” を参照のこと。とりあえずフォントを好みに変えたかったのだが，フォント名（buffer_font_family）はひとつしか指定できないのかな，これ。しょうがない。 Bizin Gothic を入れるか（本当は日本語は明朝体で表示してほしいんだけどねぇ）。

Git のコミットやプッシュに相当するコマンドはなさそう（ターミナルで自力で起動しろってことかな）。履歴をグラフィカルに見せる機能もなし（git blame の表示はできる）。 VSCode の拡張機能 “Git Graph” のような機能があればいいのだが Zed の拡張機能でもそれらしいのは見つからなかった。サードパーティの拡張機能がもっとたくさん生えてくるといいんだろうねぇ。

Atom エディタの元ユーザとして Zed には期待している。とはいえ，テキストエディタは機能的な性能以前に使ってて手に馴染むかどうかが決定的に重要なので，もうしばらく Zed は様子見かなぁ。

ブックマーク

Atom の落日

2022-06-11T00:19:04+00:00

GitHub が Microsoft に買収されて以来，その内そうなるだろうとは思っていたが，ついにこの日が来てしまったか。

Today, we’re announcing that we are sunsetting Atom and will archive all projects under the organization on December 15, 2022.

via Sunsetting Atom | The GitHub Blog

Atom には思い入れがある。思い返せば2015年は色々と心境の変化があった年で，たとえば Windows 7 のサポート終了をにらんで Windows 依存からの脱却を模索し始めた年で Go で遊び始めた年でもある。「Windows 依存からの脱却」の最大の障害はテキストエディタの秀丸に依存しきっていたことで，マルチプラットフォームで手に馴染むエディタを探すことが最優先事項だったのだ。

というわけで，私の中で Atom と Go はセットになっていた。 Atom の拡張機能である go-plus の出来が（当時としては）よかったのも大きい。

そういえば Twitter で「VSCode に「中華を初めて統一した始皇帝」みたいな印象ができつつある」みたいな tweet を見かけたが，エディタ界の始皇帝は vim だろうとか思ってみたり。このブログでも何度か書いているが，私は vi にトラウマがあって， vi/vim を起動するとペーペーの新人の頃に工場の片隅でガチの VT 端末を前に泣きながらデバッグしていたあの頃がフラッシュバックしてしまうのだ。なので最初から vim という選択肢はなかった。まぁ Ubuntu 環境にいると結局は vim も使わざるを得ないのだが（笑）

プログラミルクボーイ「Vim」 - YouTubeより

話を戻そう。

私の中で風向きが変わったのは “Language Server Protocol (LSP)” が登場したあたり。 LSP はホンマに画期的なアイデアで，当然 Go 用の lunguage server も登場するんだけど¹ go-plus はこれを取り込むことができなかった。

加えて，私が IT 業界に再就職して支給された Windows 10 機に Atom を入れたら堪えられないほど遅いのにビックリし，観念して VS Code に乗り換えたのだった。

パソコンに Visual Studio Code を導入する（再チャレンジ）

Microsoft Windows を嫌って Ubuntu や Atom にしたというのに，結局は Microsoft に屈してしまったわけだ（「くっころ」とか言わないよ）。今やすっかり手に馴染んでしまったけどね。

Atom が登場したのは2014年だそうだが，当時は SublimeText のカウンタという位置付けだったと思う。 8年というのはソフトウェア製品としては息が長いほうだと思うけど，テキストエディタは下手すると10年20年と使うものなので簡単に消えられては困るわけですよ。それでも時代の流れには逆らえない。ユーザ間のエコシステムが出来上がっている製品であっても廃れたらあっという間ということか。まさに「落日」だな。

せめて VS Code のエコシステムが永く続くことを祈ろう。

ブックマーク

LSP が発表された頃 Go 用の lunguage server としていくつかの実装があったが，現在はほぼ gopls 一択である。 ↩︎

Eclipse の SSH アクセスで失敗した話

2021-08-30T11:55:10+00:00

トラブル対応で自前の環境に Eclipse を入れて GitHub リポジトリにアクセスする羽目になった。 GitHub リポジトリへのアクセスには HTTPS と SSH の2通りある。このうち HTTPS のほうはアカウントのパスワードが使えなくなり，代替手段として personal access token を取得する必要がある¹。

個人アクセストークンを使用する - GitHub Docs

まぁ personal access token の話はこれくらいにして，本題は SSH 接続のほう。ちなみに今回の構成は以下の通り。

OS : Windows 10
Eclipse : Pleiades All in One 2021-06 リリース版

Eclipse で Git および SSH をドライブしてるのは EGit と JSch だそうだが，ユーザからこれが見えることはない。「自前で構築している環境（Git for Windows と PuTTY）は使えないんだろうなぁ。鍵を作るところから始めるか」とため息をつきつつ，以下のページを参考に（感謝！）作業を始めたのだが

Eclipseでgit操作(GitHubからcloneしてpushまで/ssh接続) | ITSakura

最初の1フィートで驚愕してしまった。

いやいやいや。 DSA か RSA の1024ビット鍵しか作れんのかい！まさか世の Eclipse ユーザはみんな1024ビット鍵で SSH にアクセスしてるの？アカンやろ。アカンよね！？

首を捻りながらも設定を済ませ，いざ clone しようとしたら今度は No supported authentication methods available とか言ってくさる。

ちょっと何言ってるか分からない…

周囲の人たちは問題なくアクセスできてるみたいなので私の環境の問題だと思うが，マジで分からない。これのせいで半日近く作業が止まってしまったよ。で，さんざん悩んだ挙句に気が付いた。これってひょっとして plink で SSH アクセスしようとしている？

念のために説明すると plink は Windows 用の SSH クライアント兼ターミナル・エミュレータである PuTTY が他ツールとの連携用に提供している SSH 接続ツールだ。 Git がインストールされている環境で

set GIT_SSH=C:\Program Files\PuTTY\plink.exe

とか環境設定しておけば OpenSSH ではなくPuTTY/plink で接続しようとする。どうやら Eclipse はこれを認識しているのかな？

となると話は早い。ぶっちゃけ Git for Windows & PuTTY で既に環境が出来ていれば Eclipse 側の SSH 設定は不要ということだ。というわけでめでたく GitHub リポジトリに SSH でアクセスできた。ようやくトラブル対応できる。 RSA-1024 とか玩具の南京錠のごとき鍵を作る必要もなく，既に運用している EdDSA 鍵で問題なし。上のスナップショットで作った鍵はとっとと捨てたよ（笑）

Eclipse の git リポジトリ操作も見せてもらったが面倒臭すぎてまともに運用できる気がしない。いや，これ，マジで VS Code を啓蒙しないとダメかしらん。

ブックマーク

参考図書

Spring Boot 2 入門: 基礎から実演まで: 原田けいと (著), 竹田甘地 (著), Robert Segawa (著); 2020-05-22 (Release 2020-05-22); Kindle版; B0893LQ5KY (ASIN); 評価

Spring Boot を勉強することになって急遽買った本。めっさ分かりやすかった。 PDF 版が欲しいくらい（笑） Spring Boot 3.2 対応にアップデートされていた。素敵！

reviewed by Spiegel on 2024-03-20 (powered by PA-APIv5)

Effective Java 第3版: Joshua Bloch (著), 柴田芳樹 (翻訳); 丸善出版 2018-10-30; 単行本（ソフトカバー）; 4621303252 (ASIN), 9784621303252 (EAN), 4621303252 (ISBN); 評価

再勉強中。 Kindle 版のほうがちょっと安いが，勤務先でも使いたかったので紙の本にした。

reviewed by Spiegel on 2021-03-17 (powered by PA-APIv5)

GitHub Docs の内容は少し古いみたいで，Settings の構成がちょっと違う。 Settings > Developer settings > Personal access tokens の順に辿っていけばよい。ちなみに personal access token の Expiration を無期限に設定すると GitHub が物凄い勢いで警告を出してくる（笑） ↩︎

Java と VS Code

2021-08-18T13:20:30+00:00

仕事で Spring Boot なコードを書くことになって，今更ながら基本から勉強し直している。で，どうせなら VS Code で環境を作るのがいいよねってことで，覚え書きとして記しておく。

Extension Pack for Java

$ code --install-extension vscjava.vscode-java-pack

これをインストールすると以下のパッケージも併せてインストールされる。

これだけあれば基本的な道具は一通り揃う。

みんな大好き “Hello, World!”

ここで簡単に動作確認しておこう。以下の手順でプロジェクトの雛形を作成する。

コマンドパレットから “Java: Create Java Project” を選択する
プロジェクト・タイプの一覧が表示されるので “No build tools” を選択する
作業ディレクトリを選択する
プロジェクト名を指定する（ここでは hello と入力）

これで

$ tree hello
hello
├── README.md
├── lib
└── src
    └── App.java

2 directories, 2 files

という感じにディレクトリ・ファイルが作成される。 App.java の中身はこんな感じ。

public class App {
    public static void main(String[] args) throws Exception {
        System.out.println("Hello, World!");
    }
}

エディタ上は

という感じに表示されているので main() 関数直上の Run のリンクをクリックすればコンパイル＆実行してくれる。 Java Process Console に Hello, World! と表示されれば無問題。

Import 補完

Java の import 宣言ってすぐに汚れるよね。使わない import とか。逆に import が足りなくてエラーになったり。

こういうときはコマンドパレットから “Organize Imports” でいい感じに整形してくれる。保存時に自動で整形するには settings.json に

"java.saveActions.organizeImports": true

を追加してやればよい。

Spring Boot Extension Pack

$ code --install-extension Pivotal.vscode-boot-dev-pack

これも以下のパッケージを含んでいるようだ。

雛形プロジェクトを作る

これも動作確認しておこう。

コマンドパレットから “Spring Initializr: Generate a Maven Project” を選択する
Spring Boot のバージョンを選択（2021-08-18 時点の最新は 2.5.3）
使用言語を選択。もちろん Java で
Group Id を入力。ここはデフォルトの com.example のままにしておく
Artifact Id を入力。ここもデフォルトの demo のままにしておく
パッケージタイプを選択。 Jar と War がある。とりあえす Jar にしておこうか
Java のバージョンを選択。無難に LTS 版の 11 を選択しておくか（JDK のインストールは別途行うこと）
依存パッケージを選択。 Spring Web と Lombok は必須。あとは必要に応じて
- Spring Web (必須)
- Lombok (必須)
- Spring Boot DevTools
- Thymeleaf

あとは作業ディレクトリを指定すれば完了。作業ディレクトリ直下に Artifact Id で指定した名前でディレクトリが掘られ，ディレクトリ・ファイルが展開される。

$ tree demo
demo
├── HELP.md
├── mvnw
├── mvnw.cmd
├── pom.xml
└── src
    ├── main
    │   ├── java
    │   │   └── com
    │   │       └── example
    │   │           └── demo
    │   │               └── DemoApplication.java
    │   └── resources
    │       ├── application.properties
    │       ├── static
    │       └── templates
    └── test
        └── java
            └── com
                └── example
                    └── demo
                        └── DemoApplicationTests.java

DemoApplication.java の中身はこんな感じ。

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DemoApplication {

	public static void main(String[] args) {
		SpringApplication.run(DemoApplication.class, args);
	}

}

このままだと何も表示できないので controller クラスと対応するテンプレートファイルを用意する。

まずは demo/src/main/java/com/example/demo/controller/DemoController.java ファイルを作る。中身はこんな感じ。

package com.example.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class DemoController {

	@GetMapping("/")
	public String demo() {
		return "demo";
	}

}

次に demo/src/main/resources/templates/demo.html ファイルを作る。中身はこんな感じ。

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>Demo</title>
</head>
<body>
  <h1>Hello World!</h1>
</body>
</html>

全体の構成はこんな感じ。

$ tree demo
demo
├── HELP.md
├── mvnw
├── mvnw.cmd
├── pom.xml
└── src
    ├── main
    │   ├── java
    │   │   └── com
    │   │       └── example
    │   │           └── demo
    │   │               ├── DemoApplication.java
    │   │               └── controller
    │   │                   └── DemoController.java
    │   └── resources
    │       ├── application.properties
    │       ├── static
    │       └── templates
    │           └── demo.html
    └── test
        └── java
            └── com
                └── example
                    └── demo
                        └── DemoApplicationTests.java

テストとか端折ってるけどご容赦ね。

あとは Spring Boot Dashboard から Start すれば OK。

Web ブラウザから http://localhost:8080/ を叩いて Hello, World! と表示されれば無問題。

Lombok Annotations Support for VS Code

$ code --install-extension GabrielBB.vscode-lombok

@Getter とか @Setter とか @Slf4j とかの Lombok アノテーションを付けると VS Code がコードにエラーマークを付けることがある（ビルドはちゃんと通る）。かなりウザいのでこの拡張機能を入れてみた。快適！

Azure App Service

$ code --install-extension ms-azuretools.vscode-azureappservice

VS code 上から Azure Web Apps にお手軽にデプロイ出来ないかなぁ，と思って探したらありました。やり方は以下のページの後半で紹介している。

Build and Deploy Java Web Apps to the cloud with Visual Studio Code

めがっさ簡単だった。 GitHub Actions を使う方法とか，何なら Azure Spring Cloud を契約する手もあるのだが，今回はとにかく JAR か WAR を投げれればよかったので。

ブックマーク

参考図書

Spring Boot 2 入門: 基礎から実演まで: 原田けいと (著), 竹田甘地 (著), Robert Segawa (著); 2020-05-22 (Release 2020-05-22); Kindle版; B0893LQ5KY (ASIN); 評価

reviewed by Spiegel on 2024-03-20 (powered by PA-APIv5)

Effective Java 第3版: Joshua Bloch (著), 柴田芳樹 (翻訳); 丸善出版 2018-10-30; 単行本（ソフトカバー）; 4621303252 (ASIN), 9784621303252 (EAN), 4621303252 (ISBN); 評価

再勉強中。 Kindle 版のほうがちょっと安いが，勤務先でも使いたかったので紙の本にした。

reviewed by Spiegel on 2021-03-17 (powered by PA-APIv5)

バイナリ・データ・ビュア zetamatta/binview の Linux 用バイナリ登場

2021-07-07T02:24:20+00:00

バイナリ・データ・ビュアの zetamatta/binview の v0.2.0 がリリースされたのだが，このリリースで Linux 用バイナリも提供されるようになった。

もともと binview のバイナリは Windows 用のみの提供だったのだ。ありがたや。

若い頃はバイナリ・エディタを使うような仕事も多くて Bz Editor などのツールのお世話になったものだが¹，もうバイナリデータを直接イジるような細かい仕事はできなくなりつつあるし，でも CUI なターミナル・エミュレータ上でちょろんと眺めてさくっと編集できるツールがあるといいなぁ，みたいな需要はあるわけですよ。

ちなみに Linux には xxd というダンプツールがあり

$ xxd -g 1 ./bindata1 
00000000: a8 03 50 47 50 c3 04 04 03 00 01 c9 38 e7 2d 2f  ..PGP.......8.-/
00000010: b1 f1 0f c3 ce 55 5d b2 8a 4b e8 4f 43 15 6e 7d  .....U]..K.OC.n}
00000020: 90 90 53 6a 9a e3 aa 1c 68 d6 d3 fc 6a 4e 79 a8  ..Sj....h...jNy.
00000030: e7 b1 a5 87 ea cc cc 99 66 31 ad ff e1 a3 03 b6  ........f1......
00000040: 47 85 76 bd 0b                                   G.v..

みたいな感じにバイナリデータを眺めることはできる。あるいは vim と xxd を組み合わせることでバイナリ・エディタのように使うこともできるけど，あんまりお手軽じゃないのよね。やり方をしょっちゅう忘れるし（笑）なので binview のようなお手軽ツールはありがたいし，最初からマルチプラットフォームな製品として構成されているのもありがたい。

ファイルを指定して binview を起動するとこんな感じになる。

入力は標準入力からでもOK。なので前処理をパイプで繋いで

てな感じにできる。カーソル位置のコードが UTF-8 (の一部) と判定された場合は下部のステータス行に Unicode 符号点が表示されるのが秀逸である。

終了する場合は [q] キー押下で

のように確認プロンプトが表示されるので [y] キー押下で終了できる。

データの保存は [w] キー押下で

とプロンプトが出るので，保存先のファイル名を指定して [Enter] キー押下で確定する。

これで，たとえば処理結果を標準出力に吐くツールと組み合わせてデータをいったん binview に流し込んで中身を確認してから任意のファイル名に保存する，てなことも簡単にできるわけだ。うんうん。

[r] キーを押下するとカーソル位置のコードを変更できる。こんな感じ。

コマンドキーの一覧は以下の通り。

キー	機能
`q`	quit
`r`	replace one byte
`i`	insert `'\0'` on the cursor
`a`	append `'\0'` at the rightside of the cursor
`x`, `DEL`	delete and yank one byte on the cursor
`p`	paste 1 byte the rightside of the cursor
`P`	paste 1 byte the leftside of the cursor
`w`	output to file

[x] と [p]/[P] は対になっていて [x] で削除したコードを [p]/[P] で任意の場所に挿入できるようだ。

なお [ESC] キー押下でコマンド前の状態に戻る。なので，状態がよく分からなくなったら [ESC] 連打である（vi/vim でありがちな光景w）。

さらにカーソルの移動には [h] [j] [k] [l] キーが使える。私のように vim を起動するとトラウマレベルで指が [h] [j] [k] [l] キーを押さえてしまう人には朗報だろう（笑）

今なら改造版 Bz がオススメ。 ↩︎

Markdown と VS Code

2021-02-28T03:45:02+00:00

今回は VS Code で markdown テキストを入出力する話。

Markdown All in One

$ code --install-extension yzhang.markdown-all-in-one

Markdown 関連の拡張機能は色々あるようだが，入力支援に関してはこれで必要十分ぽい。

お気に入りはテーブル整形の機能で， Linux/Ubuntu なら [Ctrl+Shift+I] キー（Format Document）押下で綺麗に整形してくれる。

ところが Windows 版では [Shift+Alt+F] キーが Format Document に割り当てられているようだ。プラットフォームによって違うのかよ。

というわけで Windows 版の方にキー割当を合わせることにした。

// Place your key bindings in this file to override the defaults
[
    {
        "key": "shift+alt+f",
        "command": "editor.action.formatDocument",
        "when": "editorHasDocumentFormattingProvider && editorTextFocus && !editorReadonly && !inCompositeEditor"
    },
    {
        "key": "ctrl+shift+i",
        "command": "-editor.action.formatDocument",
        "when": "editorHasDocumentFormattingProvider && editorTextFocus && !editorReadonly && !inCompositeEditor"
    },
    {
        "key": "shift+alt+f",
        "command": "editor.action.formatDocument.none",
        "when": "editorTextFocus && !editorHasDocumentFormattingProvider && !editorReadonly"
    },
    {
        "key": "ctrl+shift+i",
        "command": "-editor.action.formatDocument.none",
        "when": "editorTextFocus && !editorHasDocumentFormattingProvider && !editorReadonly"
    }
]

Prettier - Code formatter との競合

$ code --install-extension esbenp.prettier-vscode

Markdown 専用というわけではないが JavaScript/TypeScript, CSS/SCSS/Less, HTML, JSON, GraphQL, YAML など幅広い言語に対応している整形ツールで，しかも plugin 拡張もできるらしい。もちろん markdown テキストにも対応している。

で，これと Markdown All in One の整形機能（Format Document）が被るわけですよ。そこで，どちらの機能を使うか言語ごとに設定できるようになっている。私は Markdown All in One 優先でこんな感じ。

{
    "[markdown]": {
        "editor.defaultFormatter": "yzhang.markdown-all-in-one"
    }
}

さらにファイル保存時に変更した箇所だけを整形する，なんてな設定も言語ごとにできるようだ。

{
    "[markdown]": {
        "editor.defaultFormatter": "yzhang.markdown-all-in-one",
        "editor.formatOnSave": true,
        "editor.formatOnSaveMode": "modifications"
    }
}

ちなみに EditorConfig for VS Code が有効な場合は .editorconfig の設定（インデントや改行コードなど）を考慮してくれるようだ。これを無効にするには “Use Editor Config” の項目を OFF にする。

{
    "prettier.useEditorConfig": false
}

ただし， EditorConfig が有効な場合でも .prettierrc ファイルなどによる Prettier 独自の設定がある場合は，そちらのほうが優先されるようだ。ややこしい…

自動補完を有効にする

VS Code の売りのひとつはスニペットを含む強力な自動補完機能だが，何故か markdown ファイルには自動補完が効かない。と思ったら，既定で無効になっているらしい。いや，有効にしとけよ。

というわけで settings.json に以下の設定を手動で書き込む。

{
    "[markdown]": {
        "editor.quickSuggestions": true,
        "editor.snippetSuggestions": "top"
    },
}

これでスニペットを優先して自動補完候補に挙げてくれる。

Markdown Preview 機能は必要か

私個人で言うなら No で，仕事なら場合によっては Yes かな。

そもそも markdown テキストってのは，見出しや段落や箇条書き等の文書構造がそのままでも human-readable である点が利点と言える。さらに言えば，ここのブログは Hugo の shortcodes 等で入力自体をカスタマイズしまくってるので，ただの markdown preview なんか使いものにならないのだ（Hugo はサーバ・モードで起動できるので，リアルタイムでブラウザ表示を確認しながら記事を書いている）。

一方で， Office ツールなどレガシーな環境を捨てて markdown 等の構造化テキストをベースにしたドキュメンテーションをしようとするなら，それなりにリッチな markdown preview 機能と PDF 等へ「最終出力」するためのツールチェーンが必要となる。

そのための手段（または道具立て）として VS Code をベースに環境を整えるというのは合理的と言えるかもしれない。

というわけで，以降では PDF 等への「最終出力」を念頭に置いたドキュメントツールとして幾つかの拡張機能を紹介してみる。上述したように，私個人は全く必要ないのでレビューしないが，仕事で使うようなことがあれば，そのうち記事にすることもあるだろう。

Markdown Preview Enhanced

$ code --install-extension shd101wyy.markdown-preview-enhanced

TeX の数学記法あるいは PlantUML や mermaid 等の記法も認識して preview 表示できるらしい。 DOT 言語も使えるのか。 CSS をカスタマイズ可能。

HTML や PDF へ出力できるようだ（PDF 出力は Chrome 経由）。

Markdown PDF

$ code --install-extension yzane.markdown-pdf

コマンド一発で PDF 変換してくれる。簡易的な出力しか出来ないのかと思ったら，意外にもかなりカスタマイズできるらしい。

Marp for VS Code

$ code --install-extension marp-team.marp-vscode

Marp を使って markdown テキストからスライドを生成する。 PDF へエクスポートできるらしい。

【VS Code + Marp】Markdown から爆速・自由自在なデザインで、プレゼンスライドを作る - Qiita

Draw.io Integration

$ code --install-extension hediet.vscode-drawio

Draw.io (diagrams.net) を利用した作図ツール。データはテキストで保持して PNG や SVG へエクスポート可能って感じなのかな。

VSCode で Draw.io が使えるようになったらしい！ - Qiita

PlantUML

$ code --install-extension jebbs.plantuml

PlantUML 作図・出力支援。あらかじめ PlantUML 作図環境を用意する必要がある（ただし plantuml.jar ファイルは拡張機能内にあらかじめ格納されている？）。

真面目に PlantUML (1) : PlantUML のインストール

ブックマーク

参考図書

Software Design (ソフトウェアデザイン) 2020年8月号 [雑誌]: Software Design 編集部 (編集); 技術評論社 2020-07-18 (Release 2020-07-18); Kindle版; B08CZ2C3NZ (ASIN)

特集記事は「Vim vs. Visual Studio Code」

reviewed by Spiegel on 2021-02-28 (powered by PA-APIv5)

Go と VS Code

2021-02-27T09:47:11+00:00

どっちのセクションで書こう悩んだが，所詮ツールの話だし，こっち側で。

それでは前回の続き。 VS Code に Go 言語開発支援環境を入れる。といっても一択だけどね。

Go - Visual Studio Marketplace

インストールはこちら。

$ code --install-extension golang.go

一応 Google が公式に参加している拡張機能らしい。

しかも最近，こちらも事実上のオフィシャルである gopls が，この拡張機能の既定の language server となったようだ。

Gopls on by default in the VS Code Go extension - The Go Blog

個人的にひとつだけ気に入らないところがあって，既定の設定のままではプロジェクト・フォルダを開いたときにトップに go.mod ファイルがないと上手く動かないみたいなんだよね（モジュール対応モードの場合）。

最初は拡張機能側の問題かと思っていたが，どうも gopls の制限らしい。

tools/workspace.md at master · golang/tools · GitHub

一応の回避策はあって settings.json に以下のオプションを設定することでトップ以外の複数の go.mod ファイルに対応できるようだ。

{
    "gopls": {
        "build.experimentalWorkspaceModule": true
    }
}

ただし go.mod ファイルで定義したモジュール名は開いたプロジェクト・フォルダ内で一意でなければならない。名前が被ってるとめっさ怒られる。

まぁ，理屈は分からんでもないが，私の場合，ブログなどのドキュメント環境でサンプルコードを書き散らしていて，それらのモジュール名が大抵 “sample” だったりするので被りまくりなんだよなぁ sigh…

ちなみに，この experimentalWorkspaceModule オプションは一時的な措置なので将来的にはなくなるようだ。それまでには何とかするということだろう。

それ以外の部分ではぶっちゃけ ATOM の go-plus よりも出来がいいので，ゆるゆると移行していきますよっと。

現時点での settings.json の内容はこんな感じ。

{
"go.buildOnSave": "off",
	"go.autocompleteUnimportedPackages": true,
	"go.formatTool": "goimports",
	"go.lintTool": "golangci-lint",
	"go.gotoSymbol.includeGoroot": true,
	"go.testOnSave": true,
	"go.coverageOptions": "showUncoveredCodeOnly",
	"go.coverOnSave": true,
	"go.coverOnSingleTestFile": true,
	"go.coverageDecorator": {
		"type": "gutter"
	},
	"gopls": {
		"build.experimentalWorkspaceModule": true
	}
}

【2021-03-02 追記】

書き忘れていたが，コマンドパレットから

>Go: Install/Update Tools

と入力すると関連ツールのインストールおよびアップデートができる。

Go: Install/Update Tools

これを実行すると

Tools environment: GOPATH=/home/username/go
Installing 9 tools at /home/username/go/bin in module mode.
  gopkgs
  go-outline
  gotests
  gomodifytags
  impl
  goplay
  dlv
  golangci-lint
  gopls

Installing github.com/uudashr/gopkgs/v2/cmd/gopkgs (/home/username/go/bin/gopkgs) SUCCEEDED
Installing github.com/ramya-rao-a/go-outline (/home/username/go/bin/go-outline) SUCCEEDED
Installing github.com/cweill/gotests/... (/home/username/go/bin/gotests) SUCCEEDED
Installing github.com/fatih/gomodifytags (/home/username/go/bin/gomodifytags) SUCCEEDED
Installing github.com/josharian/impl (/home/username/go/bin/impl) SUCCEEDED
Installing github.com/haya14busa/goplay/cmd/goplay (/home/username/go/bin/goplay) SUCCEEDED
Installing github.com/go-delve/delve/cmd/dlv (/home/username/go/bin/dlv) SUCCEEDED
Installing github.com/golangci/golangci-lint/cmd/golangci-lint (/home/username/go/bin/golangci-lint) SUCCEEDED
Installing golang.org/x/tools/gopls (/home/username/go/bin/gopls) SUCCEEDED

All tools successfully installed. You are ready to Go :).

てな感じで go install してくれるようだ。自動でアップデートしてくれるといいのだが…

参考図書

Software Design (ソフトウェアデザイン) 2020年8月号 [雑誌]: Software Design 編集部 (編集); 技術評論社 2020-07-18 (Release 2020-07-18); Kindle版; B08CZ2C3NZ (ASIN)

特集記事は「Vim vs. Visual Studio Code」

reviewed by Spiegel on 2021-02-28 (powered by PA-APIv5)

プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES): Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田芳樹 (翻訳); 丸善出版 2016-06-20; 単行本（ソフトカバー）; 4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN); 評価

著者のひとりは（あの「バイブル」とも呼ばれる）通称 “K&R” の K のほうである。この本は Go 言語の教科書と言ってもいいだろう。と思ったら絶版状態らしい（2025-01 現在）。復刊を望む！

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

パソコンに Visual Studio Code を導入する（再チャレンジ）

2021-02-27T05:23:23+00:00

今の職場では当然のように Windows 10 機を支給されていてテキスト・エディタ等の普段使いのツールであれば割と自由に使わせてくれるのはいいのだが，6 年ほど使い込んで手に馴染んでる筈の ATOM が使えなくてねぇ。理由は大きく 2 つ。

起動が遅すぎる（もともと遅いが堪えられないほど遅い）
Go 言語開発支援の go-plus が実質的に動かない

特に 2 番目が致命的。私の観測範囲が狭いせいか，この手の話をほとんど聞かないのだが Windows で ATOM で Go で開発をしてる人はいないってことなのかねぇ。

さらに言うと ATOM を開発している GitHub が VS Code を開発している Microsoft に買収され，オフィシャルの Go Language Server である gopls が，これまた Google オフィシャルの VS Code 用拡張機能の既定の Language Server になったというのも大きい。 ATOM の go-plus なんて今だに gocode 使ってるんだぜ。完全に廃れているよなぁ orz

というわけで，観念して VS Code を導入することにした。

実は昨年 5 月に自宅の Ubuntu 機に VS Code を入れたんだけど，結局挫折して削除しちゃったんだよねぇ。今回は職場の Windows 機で先行して導入している。なので Windows 機と Ubuntu 機を比較しながら，何回かに分けて記事を書いていく予定である。

VS Code のインストール

Windows 版のインストールはサイトからインストーラをダウンロードすればよい。

問題は Ubuntu だが Snap 版と APT 版がある。昨年の話だが Snap 版を入れたら日本語入力が壊滅してたので，今回も選択肢には入れない。

APT 版は Microsoft がリポジトリを公開しているので，これを設定してインストールする。

sudo apt-get install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
rm -f packages.microsoft.gpg

sudo apt install apt-transport-https
sudo apt update
sudo apt install code # or code-insiders

via Running Visual Studio Code on Linux

起動は Shell やコマンド・プロンプト等でファイル名またはディレクトリ名を指定して

$ code .

とすれば起動する¹。 Windows 版の ATOM はコマンド・プロンプトから任意の場所を開けなくて往生したんだよなぁ。

VS Code 本体以外の各種ファイルは以下のディレクトリに格納される。

Windows 版
- %USERPROFILE%\.vscode\
- %APPDATA%\Code\
Ubuntu 版
- $HOME/.vscode/
- $HOME/.config/Code/

settings.json や keybindings.json といった設定ファイルやスニペットを格納する snippets/ ディレクトリは Code/User/ ディレクトリ直下にあるので，必要に応じてバックアップを取るのがいいだろう。

ぶっちゃけ日本語化は不要。つか，コマンドパレットや検索フィルタを常用するなら下手に日本語化しても混乱するだけだろう。

テレメトリの無効化

これは任意だが，ベンダ・メーカによるテレメトリを嫌うなら，最初の起動時に無効化の設定をしておく。具体的には設定画面（[Ctrl+,] 押下で起動）で telemetry を入力し，出てきた項目のチェックを外す。

telemetry

テレメトリを無効化すると settings.json に以下の内容が書き込まれる。

{
    "telemetry.enableCrashReporter": false,
    "telemetry.enableTelemetry": false
}

VS Code の設定画面は拡張機能も含めて全てフラットに表示してしまうので，検索フィルタで絞り込まないとめちゃめちゃ使い辛い。慣れるまでは設定画面で操作しながら settings.json の内容を確認していく（必要に応じてバックアップ）のがいいだろう。

こういのが面倒くさいんだよなぁ， VS Code って。

キー設定

まずはキー設定を確認しておく。キー割当の公式情報が PDF で公開されているので，参考にするとよいだろう。

拡張機能に「◯◯ エディタ風」とかまとめて設定できるものもあるが，歳をとるとそういうカスタマイズは面倒になってくる²。今回はできるだけキー割当を変えないで Linux 版と Windows 版で挙動が異なるもののみに注目してチューニングしていく。

なお，キー割当は “Keyboard Shortcuts” 画面で変更するのが無難で安全である。 settings.json と同じく，慣れるまでは keybindings.json の内容を確認しながら必要に応じてバックアップをとるのがいいだろう。

コマンドパレット等

この辺は最低限おぼえておくべき。

キー割当	機能
`[Ctrl+Shift+P]` `[F1]`	Show All Commands (コマンドパレット)
`[Ctrl+,]`	Open Settings (UI)
`[Ctrl+K]` `[Ctrl+S]`	Open Keyboard Shortcuts

最初から [F1] キーにコマンドパレットが割り当てられているのはありがたい。まぁ，コマンドパレットさえ使えれば，あとはうろ覚えでも何とかなる（笑）

マルチカーソル

きょうびのテキスト・エディタでマルチカーソルが使えないのはク ◯ だろう（下品でごめん）。

キー割当	機能
`[Ctrl+Alt+↑]` `[Shift+Alt+↑]`	Add Cursor Above
`[Ctrl+Alt+↓]` `[Shift+Alt+↓]`	Add Cursor Below
`[Ctrl+D]`	Add Selection To Next Find Match
`[Ctrl+Shift+L]`	Select All Occurrences of Find Match
`[Ctrl+F2]`	Change All Occurrences
`[Shift+Alt+I]`	Add Cursors to Line Ends

Windows 版ではマルチカーソルの追加（上の 2 つの機能ね）が[Ctrl+Alt+↑] および [Ctrl+Alt+↓] にしか割り当てられてないんだけど，それやったらうちの環境ではモニタ表示の向きが変わってしまうんだよね。うちだけの現象なのだろうか。

ちうわけで Windows 版では [Shift+Alt+↑], [Shift+Alt+↓] に変更する。 keybindings.json にはこんな感じに設定されるようだ。

// Place your key bindings in this file to override the defaultsauto[]
[
    {
        "key": "shift+alt+up",
        "command": "editor.action.insertCursorAbove",
        "when": "editorTextFocus"
    },
    {
        "key": "ctrl+alt+up",
        "command": "-editor.action.insertCursorAbove",
        "when": "editorTextFocus"
    },
    {
        "key": "shift+alt+down",
        "command": "editor.action.insertCursorBelow",
        "when": "editorTextFocus"
    },
    {
        "key": "ctrl+alt+down",
        "command": "-editor.action.insertCursorBelow",
        "when": "editorTextFocus"
    }
]

行の 2 重化

何故この機能がキーに割り当てられてないのだ！というわけで [Ctrl+F10] に割り当てた。

キー割当	機能
`[Ctrl+F10]`	Duplicate Selection

keybindings.json にはこんな感じに設定される。

// Place your key bindings in this file to override the defaultsauto[]
[
    {
        "key": "ctrl+f10",
        "command": "editor.action.duplicateSelection"
    }
]

Integrated Terminal

VS Code には標準でターミナル機能が付いている。ありがたや。

キー割当	機能
`[Ctrl+Shift+@]`	Toggle Integrated Terminal

この機能は頻繁に使うので [Ctrl+F1] キーに割り当て直す。 keybindings.json にはこんな感じに設定された。

// Place your key bindings in this file to override the defaultsauto[]
[
    {
        "key": "ctrl+f1",
        "command": "workbench.action.terminal.toggleTerminal"
    },
    {
        "key": "ctrl+shift+[BracketLeft]",
        "command": "-workbench.action.terminal.toggleTerminal"
    }
]

Windows 版なら NYAGOS を shell として使いたいものである。そこで settings.json に以下の設定を直接書き込む。

{
    "terminal.integrated.shell.windows": "C:\\Users\\username\\scoop\\apps\\nyagos\\current\\nyagos.exe"
}

（Scoop で NYAGOS をインストールした場合）

Search Editor

簡単な検索と置換は [Ctrl+F] と [Ctrl+H] で可能だがファイルを跨いだ grep や grep 置換を行う場合は [Ctrl+Shift+F] または [Ctrl+Shift+H] でサイドバーを検索に切り替えた上で [Ctrl+Shift+J] で詳細項目を展開する。

ただサイドバーの操作ってマウス前提だし使い勝手がよくないんだよねぇ。

と思ったら設定に Search Editor という項目があって，“Search: Mode” 項目を変更することで [Ctrl+Shift+F] キー押下時にどちらを起動するか選べるようだ。これを newEditor に変更したら settings.json にはこんな感じに設定された。

{
    "search.mode": "newEditor"
}

これでサイドバーではなくエディタのタブとして検索画面が開く。検索結果から検索元のファイル：行にジャンプするには [F12] キー押下で OK（ソースコードのシンボル定義元へのジャンプと同じ）。

Grep 置換機能には該当の項目がなくサイドバーから行うしかないようだ。まぁ，ファイルを跨いでの一括置換処理は滅多にしないけどな（笑）

【2021-03-02 追記】ウィンドウの設定

画面起動時のウィンドウ画面サイズ

VS Code を起動する際のウィンドウ画面は前回時の状態を継承するのだが，そのまま 2 つ目を起動すると何故かウィンドウサイズが既定で起動してしまう。これがめちゃめちゃストレスだったのだが，何と設定で変えれるらしい。具体的には

{
    "window.newWindowDimensions": "inherit"
}

とすれば 2 つ目以降もウィンドウの状態を「継承」してくれる。つか，最初からこれを既定にしてくれよ orz

ウィンドウのタイトルバーを非表示にする

Windows 版は既定でウィンドウのタイトルバーが非表示になっている。今どきの Windows アプリケーションって大抵そんな見た目なのでそれが普通だと思っていたが，なんか設定で変えれるらしい。具体的には

{
    "window.titleBarStyle": "native"
}

とすれば，タイトルバーが表示されるようになった（VS Code 要再起動）。まぁ，特に嬉しいわけではないのだけど。

で，実は Linux 版でもこの値を custom にすることでタイトルバーを非表示にできるようだ。早速試してみた。

タイトルバーを非表示に

おー，ホンマじゃ。これは嬉しい。

カラー・テーマは… 入れなくてもいいか

歳をとるとだんだん目が弱くなってくる。 Windows にせよ Ubuntu にせよ，パソコンのデスクトップ画面は基本的にダーク・テーマにしているのだが， VS Code もこれに合わせて自動的にダークテーマになるようだ。これならカラー・テーマを別途入れる必要はないか。

ただし標準のままではカーソル行が分かりにくいので settings.json に以下の設定を直接書き込む。

{
    "workbench.colorCustomizations": {
        "editor.lineHighlightBackground": "#303030"
    }
}

よーし，うむうむ，よーし。

必須の拡張機能

えっと，私にとって「ないと困る機能」だからね。念のため。

ちなみに

$ code --install-extension <package name>

とすることでも拡張機能をインストールできる。 Shell スクリプト（またはバッチ・ファイル）にまとめておけば再インストールの際にちょっとは楽になると思う。

EditorConfig for VS Code

$ code --install-extension EditorConfig.EditorConfig

コード書きなら EditorConfig は MUST だろう。

インデントおよび行末は EditorConfig で始末する

zenkaku

$ code --install-extension mosapride.zenkaku

全角空白を見やすく表示してくれる優れもの。つか，滅びろ全角空白！

Zenkaku-Hankaku

$ code --install-extension masakit.zenkaku-hankaku

全角半角変換。日本語入力環境では必須。というか半角カナとか全角英数とかマジで勘弁してほしい。

Render Line Endings

$ code --install-extension medo64.render-crlf

改行コードの可視化。色々あったけどユーザが多そうだったのでコレにした。行末の余分な空白文字も目立たせてくれるスグレモノ。つか，改行コードを表示するのに拡張機能が必要なのかよ orz

settings.json はこんな感じに設定している。

{
    "code-eol.highlightExtraWhitespace": true,
    "code-eol.highlightNonDefault": true
}

ついでに設定の “Render Control Characters” も ON にしている。

{
    "editor.renderControlCharacters": true
}

Duplicate action

$ code --install-extension mrmlnc.vscode-duplicate

VS Code のファイル・エクスプローラー機能がショボい。特にファイルの duplicate 機能がないのは不便って思ってたら拡張機能にあった。何故これを標準装備しないのだ！

あるとよさげな拡張機能

Material Icon Theme

$ code --install-extension PKief.material-icon-theme

よい。

Bracket Pair Colorizer 2

$ code --install-extension CoenraadS.bracket-pair-colorizer-2

括弧の対応を色付きで見やすくしてくれる。ホンマに見やすいな。 2 のほうが出来がいいらしい。

【2021-09-03 追記】

[VS Code] 1.60 で括弧類のカラー化がサポートされた。設定で “Bracket Pair Colorization” の項目を探してチェックを入れるか settings.json で

{
    "editor.bracketPairColorization.enabled": true
}

などとすればいいようだ。ただ Bracket Pair Colorizer 2 と比べると微妙に見え方が違うので，好みが分かれるかも知れない。

Git Graph

$ code --install-extension mhutchie.git-graph

git commit などの基本的なコマンドはコマンドパレットから簡単に呼び出せるが， GUI で操作したいときもあるので。しかも以下のオプションを付ければ電子署名の検証も表示してくれる。

{
    "git-graph.repository.commits.showSignatureStatus": true
}

というわけで採用。つか，これがあれば他の git GUI ツール要らなくね？

キーボードで操作しやすいよう [Shift+F1] キー押下で表示するようにした。

// Place your key bindings in this file to override the defaultss
[
    {
        "key": "shift+f1",
        "command": "git-graph.view"
    }
]

Visual Studio IntelliCode

$ code --install-extension VisualStudioExptTeam.vscodeintellicode

最初は「別になくてもいいや」と思っていたのだが，使ってみるとめがっさ便利。

GitLens

$ code --install-extension eamodio.gitlens

多分，チーム運用で相互レビューするときなんかには重宝するんだろう。かなり詳細な情報が見れるんだけど，私個人にはちょっと過剰な機能なんだよなぁ。とりあえず保留。

Excel Viewer

$ code --install-extension GrapeCity.gc-excelviewer

GrapeCity が公開してるのか。どーりで（笑）

仕事で使うならよさげだけど，個人レベルじゃ特に要らないかな。

【レビュー】「Visual Studio Code」で Excel スプレッドシートや CSV データを表示「Excel Viewer」 - 窓の杜

Rainbow CSV

CSV 支援用の拡張機能はいくつかあるが，スプレッドシートにこだわらず，元の状態を維持しつつ分かりやすい。おすすめ。

現在日時を設定するスニペット

現在日時をセットする方法はいくつかあるようだが，スニペットを使うのがお手軽な感じである。

Code/User/ ディレクトリ直下に snippets/datetime.code-snippets というファイルを作って³，以下の内容をセットすれば OK。

{
    "Today": {
        "prefix": ["today"],
        "body": ["$CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE"],
        "description": "Today (RFC3339)"
    },
    "Now": {
        "prefix": ["now"],
        "body": ["$CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND"],
        "description": "Now time (local time)"
    },
    "TodayFull": {
        "prefix": ["todaytime"],
        "body": [
            "$CURRENT_YEAR-$CURRENT_MONTH-${CURRENT_DATE}T$CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND+09:00"
        ],
        "description": "Today and time (RFC3339)"
    }
}

これで today, now, todaytime の補完候補として表示される。自動で表示されない場合は [Ctrl+space] で候補一覧が出る。

単純な置換ならスニペットのほうがお手軽なので積極的に使っていきたいところである。

ブックマーク

参考図書

Software Design (ソフトウェアデザイン) 2020年8月号 [雑誌]: Software Design 編集部 (編集); 技術評論社 2020-07-18 (Release 2020-07-18); Kindle版; B08CZ2C3NZ (ASIN)

特集記事は「Vim vs. Visual Studio Code」

reviewed by Spiegel on 2021-02-28 (powered by PA-APIv5)

Windows 版でコマンド・プロンプトから開くには，インストール時に PATH を通す設定をする必要がある。また Windows 版ではエクスプローラのコンテキスト・メニューから開くオプションもあるので積極的に利用していいだろう。 ↩︎
大昔の Mifes や Vz Editor くらいしか選択肢がなかった頃ならともかく，今はいくらでも選択肢があるのにわざわざ「◯◯ エディタ風キーマップ」とかするくらいなら「◯◯ エディタ」を使えよ，と思うのは私だけだろうか。 ↩︎
汎用で使うスニペットを定義する場合，拡張子が .code-snippets なファイルであればいいらしい。 ↩︎

Windows Terminal × NYAGOS × Scoop ＝ ♥

2020-10-27T13:17:46+00:00

アルファ・ベータ・オメガの割り振りはご想像にお任せします 😄 って，そういう話ではない。

さて，職場で Windows 10 機を支給されたので，とりあえず ATOM エディタと NYAGOS を入れたいわけですよ。

Windows 10 に ATOM を入れる

まぁこちらはサラッと。

公式ページからインストーラを取ってきて普通にインストールすればいいだけ。なのだが，何故か Windows 版はコマンドラインからの起動が冷遇されているのよ。古いバージョンにはあった atom.cmd がなくなっている。

じゃあ，どうやって起動するのかというと “System Settings” で

System Settings in ATOM

てな感じにエクスプローラ等のコンテキストメニューから開けるように設定できる。また ATOM が起動している状態でタスクバーの ATOM アイコンをピン留めしておけば

ATOM icon in task bar

みたいな感じにコンテキストメニューを展開できる。

困るのが apm コマンドなのだが，これにはパスを通さずに直接カレントまで降りて操作するしかないだろう。 v1.52.0 なら

$ cd C:\Users\username\AppData\Local\atom\app-1.52.0\resources\app\apm\bin

まで降りる。この場所で apm を使ってログインできる。

$ apm login
Welcome to Atom!

Before you can publish packages, you'll need an API token.

Visit your account page on Atom.io https://atom.io/account,
copy the token and paste it below when prompted.

Press [Enter] to open your account page on Atom.io.

ここで [Enter] キーを押すと Web ブラウザでアカウントページが開く（要 GitHub アカウント）。開かない場合は Web ブラウザで直接 https://atom.io/account を開く。アカウントページに表示されたアクセス・トークンを入力すればログイン完了。

Token> ****************
Saving token to Keychain done

あとは

$ apm stars --install

で ⭐ を付けたパッケージをまとめてインストールできる。ちなみに，どのパッケージに ⭐ を付けたかは

$ apm stars

で確認できる。その他の細々した設定は Gist に貼り付けておいたのを流用した。なんでも取っておくものである 😄

Windows Terminal のインストール

これでようやく「メモ帳」から脱することができたので，本格的に環境を作っていこう。

かつて Windows 7 を使ってた頃はターミナル・エミュレータに ConEmu を使っていたが，本家 Microsoft からようやくまともなターミナル・エミュレータがリリースされた。

Windows ターミナルの概要 | Microsoft Docs

Windows Terminal は Microsoft Store からインストールできる。ひとまずこれをインストールして起動し，既定の PowerShell 上で作業する。

Scoop のインストール

Scoop は Windows 用のパッケージ・マネージャである。 Windows 用のパッケージ・マネージャといえば Chocolatey が有名だが，今回は Scoop で。 Scoop の特徴は以下の通り。

利用に管理者権限は不要！

実行ファイルは ~\scoop\shims に集約され、環境変数 PATH の肥大化が抑制される

インストーラのセットアップが簡単

nyagos が公式レポジトリにある (Chocolatey にもあるけど）

scoop / nyagos で始めるコマンドライン生活より

では早速。

まずは PowerShell でスクリプトを起動できるよう権限を取得する。

PS > Set-ExecutionPolicy RemoteSigned -scope CurrentUser

既に許可を取得している場合はこの操作は不要である。そうしておいて Scoop をインストールする。

PS > iwr -useb get.scoop.sh | iex

これで OK。簡単！

NYAGOS のインストール

NYAGOS のインストールは scoop install コマンドで一発 OK。

PS > scoop install nyagos

よーし，うむうむ，よーし。

Windows Terminal に NYAGOS を登録する

Windows Terminal では PowerShell を含む複数の shell を登録できる。

まずは [Ctrl+,] で config.json ファイル（のコピー）がメモ帳で表示される（コメントを端折っているので注意）。これを編集して NYAGOS を登録するのだ。具体的には以下の部分を追記する。

{
    "$schema": "https://aka.ms/terminal-profiles-schema",
    "defaultProfile": "{61c54bbd-c2c6-5271-96e7-009a87ff44bf}",
    "copyOnSelect": false,
    "copyFormatting": false,
    "profiles":
    {
        "defaults":
        {
        },
        "list":
        [
            {
                "guid": "{61c54bbd-c2c6-5271-96e7-009a87ff44bf}",
                "name": "Windows PowerShell",
                "commandline": "powershell.exe",
                "hidden": false
            },
            {
                "guid": "{0caa0dad-35be-5f56-a8ff-afceeeaa6101}",
                "name": "コマンド プロンプト",
                "commandline": "cmd.exe",
                "hidden": false
            },
            {
                "guid": "{b453ae62-4e3d-5e58-b989-0a998ec441b8}",
                "hidden": false,
                "name": "Azure Cloud Shell",
                "source": "Windows.Terminal.Azure"
            },
            {
                "guid": "{19ddaf5e-e045-481a-bf88-37f7ebe66292}",
                "hidden": false,
                "name": "Nihongo Yet Another GOing Shell",
                "commandline": "%USERPROFILE%\\scoop\\apps\\nyagos\\current\\nyagos.exe",
                "cursorShape": "vintage",
                "startingDirectory": "%USERPROFILE%"
            }
        ]
    },
    "schemes": [],
    "actions":
    [
        { "command": {"action": "copy", "singleLine": false }, "keys": "ctrl+c" },
        { "command": "paste", "keys": "ctrl+v" },
        { "command": "find", "keys": "ctrl+shift+f" },
        { "command": { "action": "splitPane", "split": "auto", "splitMode": "duplicate" }, "keys": "alt+shift+d" }
    ]
}

ちなみに guid 項目はローカルマシン内で一意であればなんでもいいのだが（上の記述をそのままコピペしても無問題），気になるのであれば PowerShell の以下のコマンドで取得できる。

PS > New-Guid

Guid
----
6c48ee13-e32b-4937-95a5-7e95a2e88613

更に config.json ファイル（のコピー）の

{
    "defaultProfile": "{61c54bbd-c2c6-5271-96e7-009a87ff44bf}",
}

の部分を NYAGOS の GUID に書き換えれば

{
    "defaultProfile": "{19ddaf5e-e045-481a-bf88-37f7ebe66292}",
}

Windows Terminal の既定の shell を NYAGOS にできる。

編集した config.json ファイル（のコピー）を保存すれば設定が反映される。ふぃー，よーやくここまでたどり着いた。

NYAGOS を使った楽しいアレコレは以下の Zenn 本に書かれている。

scoop / nyagos で始めるコマンドライン生活

上述のセットアップについても，もう少し丁寧に書かれているので，是非どうぞ。

Go で GUID を取得する

そういや Go の github.com/google/uuid パッケージを使えば UUID を取得可能だが， UUID は実質 GUID と同じなので，これを利用して

package main

import (
    "fmt"

    "github.com/google/uuid"
)

func main() {
    fmt.Println(uuid.New())
}

とすれば簡単に UUID/GUID が取れる。

$ go run sample.go 
f6bdc505-e417-4b7d-a247-a06504cf03a9

Scoop を使うなら git は必須

これでインストールは全て完了だが，今後のためにもう少し Scoop で遊んでみよう。

まず Scoop のバージョンを見ようとしたら

$ scoop -v
Current Scoop version:
git : 用語 'git' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。
名前が正しく記述されていることを確認し、パスが含まれている場合はそのパスが正しいことを確認してから、再試行してください
。
発生場所 行:1 文字:1
+ git --no-pager log --oneline HEAD -n 1
+ ~~~
    + CategoryInfo          : ObjectNotFound: (git:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

って，どエラ怒られた（笑）どうやら Scoop はパッケージ管理を git ベースで行っているらしく，ちゃんと使うなら git の導入が必須のようだ。ほんじゃあ，まぁ

$ scoop install git
Scoop uses Git to update itself. Run 'scoop install git' and try again.
...

おっ，アップデートした後にもっかいやれって言ってるな。ならば，アップデートしよう。

$ scoop update
Updating Scoop...
Updating 'main' bucket...
Checking repo... ok
The main bucket was added successfully.
Scoop was updated successfully!
'itcode"' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。
exit status 1

おりょ，また変なエラーが出たよ。 itcode" 云々というのは PowerShell 絡みらしい。なので，同じコマンドを PowerShell 上で走らせれば問題なく完了する。

うむ，次回から気をつけよう。

これでもっかい

$ scoop update git

とすれば，最新版が取れるわけだ。

ついでに Scoop で GnuPG もインストールする

ついでに Scoop で GnuPG もインストールしてみよう。あるかな？

$ scoop search gnupg
'main' bucket:
    gnupg (2.2.23)
    gnupg1 (1.4.23)

$ scoop search gpg
'main' bucket:
    gnupg1 (1.4.23) --> includes 'gpg.exe'
    gpg (2.2.23)

どっちだよ（笑）

実はこれ，中身は同じなのだが別々のパッケージとしてインストールされちゃうようだ。ふむむー。

まぁ，いいや。今回は gnupg で。

$ scoop install gnupg
Installing 'gnupg' (2.2.23) [64bit]

...

Linking ~\scoop\apps\gnupg\current => ~\scoop\apps\gnupg\2.2.23
Persisting home
'gnupg' (2.2.23) was installed successfully!

Scoop で提供されるパッケージのうち，シングルバイナリのコマンドは %USERPROFILE%\scoop\shims フォルダに集められるのだが， GnuPG のように複数のバイナリで構成されているものは専用のフォルダを作り環境変数 PATH にインストールしたフォルダを追加するようだ。その際に

Linking ~\scoop\apps\gnupg\current => ~\scoop\apps\gnupg\2.2.23

のように current フォルダをシンボリックリンクとして設置することで複数のバージョンに対応できるようにしているみたい。

GnuPG の動作確認をしておこう。

$ gpg --version
gpg (GnuPG) 2.2.23
libgcrypt 1.8.6
Copyright (C) 2020 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Home: C:/Users/username/scoop/apps/gnupg/current/home
サポートしているアルゴリズム:
公開鍵: RSA, ELG, DSA, ECDH, ECDSA, EDDSA
暗号方式: IDEA, 3DES, CAST5, BLOWFISH, AES, AES192, AES256, TWOFISH,
    CAMELLIA128, CAMELLIA192, CAMELLIA256
ハッシュ: SHA1, RIPEMD160, SHA256, SHA384, SHA512, SHA224
圧縮: 無圧縮, ZIP, ZLIB, BZIP2

上述の Home だが，これもシンボリックリンクが切られていて，実体は %USERPROFILE%\scoop\persist\gnupg\home にある。

【2020-11-02 追記】 GnuPG については以下の記事でもう少し掘り下げて紹介している。

GnuPG の HOME はどこにある？

今回はここまで

おっと。昼休憩が終わったようだ。次回があれば，また今度。

ブックマーク

参考図書

暗号化プライバシーを救った反乱者たち: スティーブン・レビー (著), 斉藤隆央 (翻訳); 紀伊國屋書店 2002-02-16; 単行本; 4314009071 (ASIN), 9784314009072 (EAN), 4314009071 (ISBN); 評価

20世紀末，暗号技術の世界で何があったのか。知りたかったらこちらを読むべし！

reviewed by Spiegel on 2015-03-09 (powered by PA-APIv5)

暗号技術入門第3版　秘密の国のアリス: 結城浩 (著); SBクリエイティブ 2015-08-25 (Release 2015-09-17); Kindle版; B015643CPE (ASIN); 評価

SHA-3 や Bitcoin/Blockchain など新しい知見や技術要素を大幅追加。暗号技術を使うだけならこれ1冊でとりあえず無問題。

reviewed by Spiegel on 2015-09-20 (powered by PA-APIv5)

Ubuntu に Visual Studio Code を導入する

2020-05-28T03:31:57+00:00

ちうわけで Visual Studio Codeを導入して試してみることにした。

継続的に使うなら今後も追記するつもり。

VS Code のインストール

Ubuntu に VS Code をインストールするのであれば Snap を使うのが一番簡単なのだが，うちの環境では何故か Snap 版で日本語入力ができないという致命的な問題があるため，今回は公式サイトから deb ファイルをダウンロードして直接 apt install した。

$ sudo apt install ./code_1.45.1-1589445302_amd64.deb

インストールに成功すれば以下のコマンドでバージョンが取得できるはず。

$ code -v
1.45.1
5763d909d5f12fe19f215cbfdd29a91c0fa9208a
x64

よしよし。ちゃんと最新バージョンだな。

実際に VS Code を起動してアプリケーション情報（メニューの Help → About を選択）も確認してみる。

うむうむ。

APT によるインストール【2021-02-20 追記】

実は Microsoft から [VS Code] 用の APT リポジトリが提供されている。これを読み込んでインストールすることもできる。

まず電子署名鍵のインポートから

$ wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add -

次にリポジトリの登録を行う。

$ sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main"

これで準備完了。あとは

$ sudo apt update
$ sudo apt install code

でインストールできる。

VS Code のカスタマイズ

カスタマイズはメニューの File → Preferences から選択できる。

File → Preferences → Settings で設定画面が開く（または Ctrl+, キー押下）
File → Preferences → Keyboard Shortcuts でキー割当の確認・変更ができる
- 既定のキー割当は ATOM とほとんど同じなので悩むところは少なかった
- File → Preferences → Keymaps で他エディタの割当を導入することもできる
f1 キー押下でもコマンド・パレット（Show All Commands）が開く

設定の行方

VS Code は $HOME ディレクトリに以下の設定ディレクトリを作成する。

~/.vscode/
~/.config/Code/

このうち，ユーザ設定は ~/.config/Code/User/ ディレクトリ直下の以下のファイルに書き込まれる。

settings.json
keybindings.json

最低でもこれらのファイルを保持っておけば再現しやすくなるだろう。

とりあえず導入してみた拡張機能

ATOM エディタみたいに印を付けておいて纏めてインストールできるといいんだけどねぇ。

EditorConfig for VS Code - Visual Studio Marketplace : EditorConfig
zenkaku - Visual Studio Marketplace : 全角空白文字を色付きで表示できる
Zenkaku-Hankaku - Visual Studio Marketplace : 全角⇔半角文字変換
vscode-icons - Visual Studio Marketplace : file icon theme
Insert Date String - Visual Studio Marketplace
Power Tools - Visual Studio Marketplace