List of Vscode [text.Baldanders.info]

GitHub Copilot で遊ぶ

2025-02-08T09:04:57+00:00

GitHub Copilot の無料版（制限あり）が開放されて VS Code 上で使えるようになった。

GitHub Copilot - Visual Studio Marketplace

といってもコメントの補完とかコミットメッセージくらいにしか使ってないけど。英語不得手なので，これだけでもめっちゃ助かっている。

ちょっと思いついて github.com/goark/koyomi/value パッケージに曜日（Weekday）型を追加しようと思うのだが，試しに GitHub Copilot に手伝ってもらうことにした。

GitHub Copilot で遊ぶ

まず Ctrl + I でプロンプトを表示し「time.Weekday と同等な機能で日本語の曜日名を出力する型」で問い合わせてみる。

time.Weekday と同等な機能で日本語の曜日名を出力する型

おー。一通り提示してくれるんだな。既に作っている koyomi/value.DateJp 型と関連するメソッドも追加されている。

これはこれで（エラーもバグもないし）使えなくもないのだが，いくつか調整したい。

WeekdayJp 型の基底型は int ではなく time.Weekday としたい
- 機能上のメリットがあるわけではないが「文芸」的に WeekdayJp 型と time.Weekday 型が「関連」することを明示したい（Go に「継承」はない）
曜日名の出力メソッドは String(), ShortString() ではなく StringJp(), ShortStringJp() としたい
- String() メソッドは time.Weekday と同じ機能にする
WeekdayJp 型の値が Sunday 〜 Saturday 以外なら，曜日名の出力は time.Weekday.String() メソッドと同じにしたい

というわけで，最終的には以下のようなコードにした。

// WeekdayJp is a type that represents the days of the week in the Japanese context.
// It is based on the time.Weekday type from the standard library.
type WeekdayJp time.Weekday

const (
    Sunday    WeekdayJp = WeekdayJp(time.Sunday) + iota // 日曜日
    Monday                                              // 月曜日
    Tuesday                                             // 火曜日
    Wednesday                                           // 水曜日
    Thursday                                            // 木曜日
    Friday                                              // 金曜日
    Saturday                                            // 土曜日
)

var weekdayNames = [7]string{"日曜日", "月曜日", "火曜日", "水曜日", "木曜日", "金曜日", "土曜日"}
var weekdayShortNames = [7]string{"日", "月", "火", "水", "木", "金", "土"}

// String returns the English name of the Japanese weekday (WeekdayJp)
// by converting it to the standard time.Weekday type and calling its String method.
func (w WeekdayJp) String() string {
    return time.Weekday(w).String()
}

// StringJp returns the Japanese name of the WeekdayJp if it is between Sunday and Saturday.
// If the WeekdayJp is out of this range, it returns the standard time.Weekday string representation.
func (w WeekdayJp) StringJp() string {
    if w < Sunday || w > Saturday {
        return time.Weekday(w).String()
    }
    return weekdayNames[w]
}

// ShortStringJp returns the short Japanese name of the WeekdayJp.
// If the WeekdayJp is not within the valid range (Sunday to Saturday),
// it returns the default string representation of the time.Weekday.
func (w WeekdayJp) ShortStringJp() string {
    if w < Sunday || w > Saturday {
        return time.Weekday(w).String()
    }
    return weekdayShortNames[w]
}

たとえば String() メソッドは

コード補完

という感じにコードを提案してくる。この状態で Tab キー押下で確定する。テストコードも関数名から推測して妥当なコードを提案してくる。変数・定数もクラス・メソッド名も名前が大事ってことですね（笑）

コメントの補完も同様。

コメント補完

ドキュメント生成もやってくれる。

ドキュメント生成

ATOM や VS Code の使い始めの頃はスニペットベースのコード補完機能に感動したものだが， Copilot によって柔軟なコード補完や生成ができるのマジ助かる。今回はコードレビュー機能等は紹介しないが，ちょろんと試した感じではなかなかいい感じである。人間にレビューを投げる前に Copilot 相手にレビューを行うのはアリかもしれない。

「自律」機械は（今のところ）存在しない

教科書に載っているサンプルコード程度ならともかく，プログラムコードに 唯一の正解 はない。今回のような小さなコードですらそうなのだ。 Copilot を含む生成 AI による提案を受け入れるか否かについては「人」による判断が不可欠だし，判断を行うためには，扱う対象に関する知識・技能・技術が要求される。「自律」的な判断を行うのは今なお，機械ではなく，人の側なのである。

自立とは、仮想代理人ソフトウェアであるところのエージェントが自ら動き、誰の力も借りずに意思決定できることを言う。 [...] 一方、自律というのは哲学的な意味であり、自らが行動する際の基準と目的を明確を持ち、自ら規範を作り出すことができることをいう。

そろそろ、人工知能の真実を話そうより

今、世の中で懸念されているのは、自立ではなく自律の方だが、学習能力を与えられ、自らのプログラムを改善できるようになっても、機械が自律することは考えられない。なぜなら、機械は結局、人間に与えられた理論やルールにのっとって行動することになるからである。

そろそろ、人工知能の真実を話そうより

GitHub Copilot をはじめとする最近流行りの生成 AI の機能とは「翻案の大量生産」であり，その膨大な翻案空間から何をどうやって拾い上げるかについては，アルゴリズムの設計を含め（今のところ）人の側に委ねられている¹。そういう意味で GitHub Copilot が文字通りコパイロット（ナビゲーション）の立ち位置に徹しているのは上手い割り切り方だと思う。

生成 AI の時代に求められる人材とはプロンプトを駆使（して翻案空間を放浪）する技能を持つ人ではなく（積極的に利用しつつ）生成 AI の提案に NO と言える見識と技術を持つ「狂狷の徒」ではないだろうか。

ブックマーク

参考図書

そろそろ、人工知能の真実を話そう (早川書房): ジャン＝ガブリエルガナシア (著), 小林重裕・他 (翻訳), 伊藤直子 (監修); 早川書房 2017-05-25 (Release 2017-05-31); Kindle版; B071FHBGW8 (ASIN); 評価

シンギュラリティは起きない。

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

日経サイエンス2025年3月号 [雑誌]: 日経サイエンス (編集); 日経サイエンス 2025-01-24 (Release 2025-01-24); Kindle版; B0DTT1L1KL (ASIN); 評価

Kindle 版は固定レイアウトなのでブラウザ（Kindle Cloud Reader）で読める。特集は「ことばが世界を作る」と「CO2回収の現実味」。

reviewed by Spiegel on 2025-02-03 (powered by PA-APIv5)

効率的なGo ―データ指向によるGoアプリケーションの性能最適化: Bartłomiej Płotka (著), 山口能迪 (翻訳); オライリー・ジャパン 2024-02-24; 単行本（ソフトカバー）; 4814400535 (ASIN), 9784814400539 (EAN), 4814400535 (ISBN); 評価

版元で Ebook を買える。Go言語のリファレンス本ではない。フトウェア工学，プログラミング（の考え方）を学ぶ教科書的な位置づけかなぁ。

reviewed by Spiegel on 2024-04-21 (powered by PA-APIv5)

著作権は文化を発展させるのか: 人権と文化コモンズ: 山田奨治 (著); 人文書院 2021-07-29 (Release 2021-07-29); Kindle版; B099RTG3J7 (ASIN); 評価

著作権を「ユーザーの人権」という観点から捉え直す。その後文化→コモンズ→文化コモンズと進み，本当の意味で「文化の発展に寄与する」とはどういうことか考察していく。

reviewed by Spiegel on 2022-10-23 (powered by PA-APIv5)

社会は情報化の夢を見る (河出文庫): 佐藤俊樹 (著); 河出書房新社 2010-09-03 (Release 2016-07-29); Kindle版; B01J1I8PRQ (ASIN); 評価

1996年に出版された『ノイマンの夢・近代の欲望―情報化社会を解体する』の改訂新装版。しかし内容はこれまでと変わりなく，繰り返し語られる技術決定論を前提とする安易な未来予測を「情報化」社会論だとして批判する。

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

作業中の BGV (メン限配信以外)

ReGLOSS の五色のバラバラな声がパズルのようにカチッと填まると本当にかっこいいよね。

生成 AI の背後にある翻案元のコンテンツやアルゴリズムと知財権との関係についてはここでは知らないふりをする。 ↩︎

Chromebook を導入する 7 — VS Code の導入

2024-05-12T08:48:44+00:00

このシリーズとしては多分最終回。スキマ時間でちまちまやってたから，やたら時間がかかってしまった。

VS Code のインストール

ググってみると Chromebook の古いバージョンの記事が多く悩ましいのだが，現状では APT 版をインストールするので問題ないようだ。

Running Visual Studio Code on Linux

上の記事を参考に以下の手順でインストールした¹。

$ cd /etc/apt/keyrings/
$ sudo curl -L https://packages.microsoft.com/keys/microsoft.asc -O
$ echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/microsoft.asc] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list > /dev/null
$ sudo apt update
$ sudo apt install code

これでランチャーに VS Code のアイコンが入る。

Chromebook ランチャー

さっそく前回作った hello プロジェクトのディレクトリに入って code . で起動してみる。

VS Code

うんうん。問題ないかな。自宅機に比べれば若干もったりしてるが，気になるほどではない。 ChromeOS 標準のエディタに比べればキビキビ動く（笑）

細かい設定や Go や markdown 関連の設定については以前に書いた記事を参照のこと。

一部記述が古くなってるが，まだ使えるな。何でも取っておくものである。

Inconsolata フォントのインストール

私はコード表示用のフォントに昔から Inconsolata を使っている。

今回の Chromebook には既定で入ってないようなので入れておく。フォントは GitHub のリポジトリからダウンロードできる。

Releases · googlefonts/Inconsolata · GitHub

Zip ファイルを解凍し，中に入ってる OTF フォント全部を /usr/local/share/fonts ディレクトリに突っ込んで fc-cache -fv とすればOK。確認は fc-list コマンドでできる。

VS Code で使う場合は設定の “Editor: Font Family” の項目に設定すればよい。

Editor: Font Family

VS Code は複数のフォントを（優先順位を付けて）指定できるのがいいよね。

ファンクションキーがない？

VS Code のキーアサインの設定をしようとして気がついたのだが Chromebook にはファンクションキーがなかった。いや，いまさら気づくとか orz

Chromebook でファンクションキーを使う方法。F1 から F12 までどこに割り振られているのか？！

なるほど。キーと組み合わせて使うのか。覚えておこう。しかし Shift+Ctrl+F1 とかって組み合わせたらエラいことになるな。

ようやく

Chromebook のセットアップが終わったよ。これで外出先でも遊べるようになった。

でも1kg強の重量は重いよなぁ。このスペックでせめて1kg未満にならんもんかねぇ。それとも Chromebook を担ぐためにもう少し容量の大きいメッセンジャーバッグかリュックを買うべきだろうか。それも本末転倒だよなー。

参考

【Amazon.co.jp限定】 ASUS Chromebook クロームブック Flip CX1 11.6インチ 2-in-1 タッチスクリーン日本語キーボード重量1.32kg トランスペアレントシルバー CX1102FKA-MK0037: ASUS (Release 2022-11-04); Personal Computers; B0BKKF7JHV (ASIN), 0195553939942 (EAN), 195553939942 (UPC); 評価

ASUS 製 Chromebook。11.6インチディスプレイ，8GBメモリ，32GBストレージ。正直，ストレージはもう少し欲しかったがメモリ容量優先で選んだ。

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

CloudValley 0.6mm 超薄型ウェブカメラカバー、メタルカメラカバーカメラ目隠し MacBook air・ノートパソコン・iMac・デスクトップ・PC・MacBook Pro・iPad・iPhone 8/7/6用、プライバシーウェブカメラプロテクション【2本セット】ブラック: CloudValley; Personal Computers; B079MCPJGH (ASIN), 0654070887322 (EAN), 654070887322 (UPC); 評価

ノートPCに見られるのが嫌なので目隠しした。

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

エレコムワイヤレスマウス Bluetooth Slint M-TM10BBBU/EC 薄型静音 4ボタンプレゼンモード機能付 Windows Mac Android iOS iPadOS FireOS対応ネイビーブルー: エレコム(ELECOM) (Release 2020-11-24); Personal Computers; B08LMYWKZD (ASIN), 4549550198189 (EAN); 評価

静音マウスを使いだしたら普通のマウスがカチカチ煩いと感じるようになってしまい，仕方ないので Bluetooth 無線マウスも静音マウスに替えた。単三電池一本で駆動するの助かる。

reviewed by Spiegel on 2024-04-13 (powered by PA-APIv5)

Anker PowerExpand+ 7-in-1 USB-C PD メディアハブ 85Wパススルー充電 Power Delivery USB-Cポート HDMI USB-Aポート: Anker; B07KJWYQJW (ASIN), 0848061003871 (EAN), 848061003871 (UPC); 評価

購入した Chromebook と周辺機器を繋ぐために購入。 USB-C は電源用（Power Delivery 対応）とデータ用の口がある。 HDMI の口もありモニタと繋ぐこともできる。 USB-DAC も繋がる。助かる。

reviewed by Spiegel on 2024-05-06 (powered by PA-APIv5)

[クローム] メッセンジャーバッグ SIMPLE MESSENGER/シンプルメッセンジャー BLACK (現行モデル) 12L 防水メンズ: CHROME(クローム); ウェア&シューズ; B08P54PQDB (ASIN), 0841916163973 (EAN), 841916163973 (UPC); 評価

プライベートお出かけ用。たまたま安売りの時に購入できた。チャリンコ乗ってても背中がゆさゆさしない。大きすぎず丁度いいサイズ。鞄の蓋がマジックテープでちょっと煩いのが玉に瑕だが，概ね満足。

reviewed by Spiegel on 2022-10-08 (powered by PA-APIv5)

Chromebook仕事術最速で業務に生かす基本＋活用ワザできるビジネスシリーズ: 株式会社インサイトイメージ (著); インプレス 2021-08-04 (Release 2021-08-04); Kindle版; B09BMPZ3BZ (ASIN); 評価

Chromebook の操作・設定の基本部分について一通り網羅している感じ。参考になった。

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

スーパーユーザーなら知っておくべきLinuxシステムの仕組み: Brian Ward (著), 柴田芳樹 (翻訳); インプレス 2022-03-08 (Release 2022-03-08); 単行本（ソフトカバー）; 4295013498 (ASIN), 9784295013495 (EAN), 4295013498 (ISBN); 評価

版元で PDF 版が買える。セキュリティ・エリアにも持ち込めるよう紙の本を買ったのだが，オンライン読書会が始まったので PDF 版も購入。Linux システムの扱い方に関するリファレンス本として優れている。最初に軽く流し読みして，必要に応じて該当項目を拾い読みしていけばいいだろう。

reviewed by Spiegel on 2023-02-11 (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)

Ubuntu の話であるが APT v2.8 から仕様が色々と変わるらしい（第812回　aptの新機能あれこれ［Ubuntu 24.04 LTS版］）。特にリポジトリ情報の記述が deb822 形式に変わるようで，おそらく ChromeOS にも影響が出てくるはず。ちなみに現行（2024-05 時点）の APT のバージョンを見たら 2.6.1 だった。 ↩︎

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 一択である。 ↩︎

TechCrunch Japan 終了後の後始末

2022-05-04T07:03:59+00:00

2月に TechCrunch Japan が終了してバックナンバーも残さず消滅する話を書いた。んで，実際に GW 中にサイトが消滅したわけだが，以前の URL を叩いてみたところ 404 ではなく本家 TechCrunch にリダイレクトされるようだ。

いや，そこまでしてくれるなら，せめて翻訳記事は本家の原文記事にリダイレクトしてくれよ orz

まぁ，愚痴ってもしょうがない。こちらで可能な限り URL の書き換えを試みることにしよう。

まずこのブログ・サイトの作業リポジトリ上で TechCrunch Japan の URL がどのくらいあるか軽く grep してみる¹。

$ grep -c "jp\.techcrunch\.com" "content/**/*.md"
1121

おぅふ。アホほどあるがな orz

TechCrunch Japan 記事の URL を機械的に変換できるか

たとえば TechCrunch Japan 記事の URL を

https://jp.techcrunch.com/2020/08/14/2020-08-13-instagram-delete-photos-messages-servers/

とする。この記事に対する原文記事の URL は

https://techcrunch.com/2020/08/13/instagram-delete-photos-messages-servers/

である。ドメインが jp.techcrunch.com → techcrunch.com なのは当然として

翻訳記事と原文記事では URL パスの日付部分が違う
原文記事の日付は翻訳記事の slug に含まれている
日付部分を除く slug の文字列は翻訳記事と原文記事で同じ

これくらいなら正規表現を使った置換処理で何とかなりそうだ。最近のテキスト・エディタは置換処理で正規表現が使えるものが多いが，私が愛用している VS Code でも正規表現を使った一括置換が可能である。

Visual Studio Codeを用いた簡単な正規表現検索 - Qiita

例外 (AMP) を潰す

私の作業環境で2箇所ほど例外というか間違いがあって

https://jp.techcrunch.com/2017/12/12/2017-12-11-some-hp-laptops-are-hiding-a-deactivated-keylogger/amp/
https://jp.techcrunch.com/2020/01/03/2020-01-02-ex-google-policy-chief-dumps-on-the-tech-giant-for-dodging-human-rights/amp/?__twitter_impression=true

などと，うっかり AMP 用の URL を載せちゃったみたいで，しかも片方は変なパラメータがくっついている。これらも機械的に置換できなくはないのだが，2箇所だけだし，手作業で原文記事の URL に書き換えた。

AMP ページはマジで滅びて欲しい。なんでこんな下らないことで Google に気を使わにゃならんの。メディアが気を遣うべき相手は私ら閲覧者だろうが。本末転倒だよ。

あと，古い URL でスキーマが HTTP のままになってるのが結構あったので，これは http://jp.techcrunch.com → https://jp.techcrunch.com に一括置換した。

Slug パターン

前節の例外を排除したことで TechCrunch Japan 記事のURL

https://jp.techcrunch.com/yyyy/mm/dd/slug/

のうち slug 部分にのみ注目すればよくなった。この Slug 部分も複数のパターンが見受けられるので整理しておく

パターン1: 日付情報 yyyy-mm-dd を含む Slug

最初に挙げた例の通り yyyy-mm-dd-originalslug に要素分解できるパターン。このパターンには別のバリエーションがあって

https://jp.techcrunch.com/2020/07/15/x2020-07-14-harvard-mit-sue-ice-student-visas-rule/
https://jp.techcrunch.com/2020/11/21/https-techcrunch-com-2020-11-20-google-facebook-and-twitter-threaten-to-leave-pakistan-over-censorship-law/

のように日付情報の前に余分な文字列がくっついている。 2番目のとか原文記事の URL そのままぢゃん。「なにすんねん」ってツッコんじゃったよ（笑）

パターン2: 日付情報 yyyymmdd を含む Slug

以下のような URL パターン：

https://jp.techcrunch.com/2017/09/13/20170912new-bluetooth-vulnerability-can-hack-a-phone-in-ten-seconds/
https://jp.techcrunch.com/2016/07/08/automotive-fortune-tesla20160706tesla-says-drivers-using-autopilot-remain-safer-than-regular-drivers/

パターン1のハイフンが抜けた状態。

パターン3: Slug に日付情報がない

https://jp.techcrunch.com/2021/06/10/netflix-cowboy-bebop-streaming-this-fall/

jp.techcrunch.com → techcrunch.com と置換するだけで行けるかなぁと思ったが駄目だった（本家サイトが404になる）。原文記事の日付情報が得られないので置換不可。

パターン4: Slug がパーセント・エンコーディングされている

https://jp.techcrunch.com/2017/03/13/%e3%80%8c%e6%b3%95%e4%bb%a4%e4%b8%8a%e9%81%95%e5%8f%8d%e3%81%ae%e5%8f%af%e8%83%bd%e6%80%a7%e3%80%81%e5%80%ab%e7%90%86%e7%9a%84%e3%81%ab%e3%82%82%e5%95%8f%e9%a1%8c%e3%80%8ddena%e3%81%8cwelq%e5%95%8f/

多分，というか間違いなく日本版オリジナル記事だよね。これは置換対象外とした。

置換用正規表現

というわけで，今回はパターン1と2のみが対象となる。置換処理は VS Code を使っている。

パターン1の検索・置換正規表現は以下の通り。

	正規表現
検索	`https://jp\.techcrunch\.com/\d{4}/\d{2}/\d{2}/.*(\d{4})-(\d{2})-(\d{2})-(.+)/`
置換	`https://techcrunch.com/$1/$2/$3/$4/`
対象ファイル	`*.md`

パターン2の検索・置換正規表現は以下の通り。

	正規表現
検索	`https://jp\.techcrunch\.com/\d{4}/\d{2}/\d{2}/.*(\d{4})(\d{2})(\d{2})(.+)/`
置換	`https://techcrunch.com/$1/$2/$3/$4/`
対象ファイル	`*.md`

もう少し頑張ればひとつにまとめられたかもしれないが，副作用が出るのが嫌だったので分けた。これで未変換の TechCrunch Japan 記事の URL は118個まで減ったが，今のところ，これ以上は無理なので，放置ということで。

どっとはらい

ブックマーク

基本的な正規表現一覧 | murashun.jp

私の環境では mattn/jvgrep を grep に alias して使っている。ファイル指定を "content/**/*.md" などと再帰的に指定できるのが嬉しい。 ↩︎

やっと Codespaces が使える

2022-04-23T13:45:12+00:00

さて，独り GitHub Team も契約したし，よーやく Codespaces が使えるようになったよ。

今のところ Codespaces は GitHub Team または GitHub Enterprise Cloud のメンバで利用できる。 2022-04-23 時点の料金（米ドル建て）は以下の通り。

via About billing for Codespaces - GitHub Docs

ちなみに，使いすぎないよう上限を設定することも可能。

Codespaces クラウドに立つ

Codespaces の起動にはまず，ブラウザでリポジトリ・ページを開き，[Code] ボタンを押下する。

Create codespace on master

[Create codespace on master] ボタン押下で Codespaces のインスタンス生成が始まる。上手く起動すればこんな感じに表示される。

Create codespace on master

拡張機能も普通に入れられる。

Extensions

設定はユーザごとに保持して同期させることもできるようだ。

Go が動くぞ！

Codespaces 上のターミナルで試しに Go コンパイラを動かしてみたら普通に動いた。

こいつ・・・動くぞ！

GitHub Codespaces 拡張機能

VS Code の拡張機能に GitHub Codespaces というのがあって，これを使うとローカルの VS Code 上で Codespaces のリソースにアクセスできる。コマンドパレットから Codespaces: Connect to Codespace を選択すると生成済みのインスタンスの一覧が表示されるので，選択して接続すると Codespaces に接続した VS Code が起動する。

Codespace on the VS Code

パソコンで作業する場合はこっちのほうがいいかもねぇ。

Andorid タブレットでも動いた

Codespace on the Android Browser

おわ。ターミナルの状態も共有できるのか。凄いな。

ちなみに Android の Firefox では Codespaces を起動できなかった。冷遇されてるなぁ（笑）

後始末

Codespaces を終了する場合はコマンドパレットから Codespaces: Stop Current Codespace を選択して明示的に停止させること。まぁ，最悪でも30分非活性状態なら自動的に停止するらしいけど。

Codespaces のインスタンスはリポジトリごとに生成されるのでご注意を。また，使わなくなったインスタンスはマメに削除することをお勧めする。インスタンスの削除は “Your codespaces” でできる。

Your codespaces

ブックマーク

Azure App Service に VS Code でデプロイできなかった話

2022-04-06T11:37:03+00:00

私は Azure App Service に手動でデプロイする際は VS Code の Azure App Service 拡張機能を使ってるんだけど，ここのところ頻繁にデプロイに失敗してたのよ。最初は App Service のほうがやらかしてるんだと思ってたんだけど（だって上手く行くときもあるし），ググったら違ってたようだ。

VS Code 1.66 upgraded to Node 16 which has been causing deployment issues for both Functions and App Service. Unfortunately, the only current known workaround is to downgrade VS Code to 1.65.x. We're currently investigating a proper fix.

via ECONNRESET trying azure deploy webapp VS Code · Issue #2194 · microsoft/vscode-azureappservice

まじすか orz

ダウングレードってどうやんだ？と思ったが単純に 1.65.x のインストール・パッケージを拾ってきて上書きインストールすればいいようだ。

Visual Studio Code February 2022

Windows 環境では自動更新を無効にするのをお忘れなく。やれやれ

【2022-04-14 追記】 v1.66.2 で直った。よかったよかった。

Release March 2022 Recovery 2 · microsoft/vscode · GitHub

ブックマーク

Investigate ECONNRESET issue during “zipdeploy” call · Issue #2844 · microsoft/vscode-azurefunctions · GitHub

改めて TeX Live を Ubuntu に（APT を使わずに）導入する

2021-09-09T13:20:36+00:00

6月にパソコンを買い換えてから新しいマシンには $\mathrm{\TeX}$ 環境を入れてなかったのだが，先日『LaTeX2ε美文書作成入門』第8版の読書感想文を書いたばかりなので，調子に乗って TeX Live 2021 を入れてしまおうと思い立った。

『LaTeX2ε美文書作成入門』の付録Aには

あらかじめ /usr/local/texlive というディレクトリを作成し，インストールする人の権限で書き込めるようにしておくのが簡単です

［改訂第8版］LaTeX2ε美文書作成入門より

とか書かれてあって「やっぱそーなのか」と納得してしまった。激しくダサい気がするがしょうがないか。まぁ，今回は個人パソコンなので素直に

$ cd /usr/local/
$ sudo mkdir texlive
$ sudo chown -R username:username texlive

としてしおう。

サーバ機などでは，インストール完了後にオーナーを root に書き戻し

$ cd /usr/local
$ sudo chown -R root:root texlive
$ cd texlive/2021/bin/x86_64-linux/
$ sudo ./tlmgr path add

と /usr/local/bin/ 等パスの通ったディレクトリへシンボリック・リンクを張っておけば複数ユーザで共有できるようになる。アップグレード等で元に戻す場合は

$ sudo tlmgr path remove
$ cd /usr/local/
$ sudo chown -R username:username texlive
...

という感じに，いったんシンボリック・リンクを削除してから諸々の作業を行うといいだろう。

OpenPGP 公開鍵を取ってくる

TeX Live のサイトでは検証用に OpenPGP 公開鍵を公開している。これを取ってきて自分の鍵束にインポートしてしまおう。

$ gpg --fetch-key http://www.tug.org/texlive/files/texlive.asc
gpg: 鍵を'http://www.tug.org/texlive/files/texlive.asc'から要求
gpg: 鍵0D5E5D9106BAB6BC: 公開鍵"TeX Live Distribution <tex-live@tug.org>"をインポートしました
gpg: 処理数の合計: 1
gpg:               インポート: 1

$ gpg --list-keys 0D5E5D9106BAB6BC
pub   rsa2048 2016-03-19 [SC]
      C78B82D8C79512F79CC0D7C80D5E5D9106BAB6BC
uid           [  不明  ] TeX Live Distribution <tex-live@tug.org>
sub   rsa2048 2016-03-19 [E]
sub   rsa2048 2016-03-19 [S] [有効期限: 2022-07-27]

これはアレだな。 TeX Live がアップグレードされるたびに更新しろってことだな。

インストーラのダウンロードと検証

では続きを。

$ curl -L "https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz" -O
$ curl -L "https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz.sha512" -O
$ curl -L "https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz.sha512.asc" -O
$ gpg -d install-tl-unx.tar.gz.sha512.asc
gpg: 署名されたデータが'install-tl-unx.tar.gz.sha512'にあると想定します
gpg: 2021年09月08日 08時53分40秒 JSTに施された署名
gpg:                RSA鍵4CE1877E19438C70を使用
gpg: "TeX Live Distribution <tex-live@tug.org>"からの正しい署名 [不明の]
gpg: *警告*: この鍵は信用できる署名で証明されていません!
gpg:          この署名が所有者のものかどうかの検証手段がありません。
主鍵フィンガープリント: C78B 82D8 C795 12F7 9CC0  D7C8 0D5E 5D91 06BA B6BC
     副鍵フィンガープリント: D8F2 F860 57A8 57E4 2A88  106A 4CE1 877E 1943 8C70

$ sha512sum -c install-tl-unx.tar.gz.sha512
install-tl-unx.tar.gz: OK

なんちう回りくどい¹。普通にダウンロードファイルに署名すりゃいいぢゃん orz

ちなみに拙作の gnkf を使っても

$ gnkf hash -a SHA-512 -c install-tl-unx.tar.gz.sha512
install-tl-unx.tar.gz: OK

てな感じで検証できる。 sha512sum コマンドがない環境でどうぞ。宣伝でした（笑）

よーやくインストール開始

$ tar xvf install-tl-unx.tar.gz
$ cd install-tl-20210908/
$ ./install-tl

リポジトリを指定する必要はないみたい。適当に近場を探してくれてるようだ。

======================> TeX Live installation procedure <=====================

======>   Letters/digits in <angle brackets> indicate   <=======
======>   menu items for actions or customizations      <=======
= help>   https://tug.org/texlive/doc/install-tl.html   <=======

 Detected platform: GNU/Linux on x86_64
 
 <B> set binary platforms: 1 out of 16

 <S> set installation scheme: scheme-full

 <C> set installation collections:
     40 collections out of 41, disk space required: 7135 MB

 <D> set directories:
   TEXDIR (the main TeX directory):
     /usr/local/texlive/2021
   TEXMFLOCAL (directory for site-wide local files):
     /usr/local/texlive/texmf-local
   TEXMFSYSVAR (directory for variable and automatically generated data):
     /usr/local/texlive/2021/texmf-var
   TEXMFSYSCONFIG (directory for local config):
     /usr/local/texlive/2021/texmf-config
   TEXMFVAR (personal directory for variable and automatically generated data):
     ~/.texlive2021/texmf-var
   TEXMFCONFIG (personal directory for local config):
     ~/.texlive2021/texmf-config
   TEXMFHOME (directory for user-specific files):
     ~/texmf

 <O> options:
   [ ] use letter size instead of A4 by default
   [X] allow execution of restricted list of programs via \write18
   [X] create all format files
   [X] install macro/font doc tree
   [X] install macro/font source tree
   [ ] create symlinks to standard directories

 <V> set up for portable installation

Actions:
 <I> start installation to hard disk
 <P> save installation profile to 'texlive.profile' and exit
 <Q> quit

Enter command:

必要に応じて設定を変えて（既定のままでも無問題）問題なければ I を入力してインストールを開始する。私の環境では1時間近くかかった。お茶菓子を用意しておくか（笑）

環境変数については ~/.profile ファイルに

# Expand $PATH to include the directory where TeX Live applications go.
texlive_path="/usr/local/texlive/2021"
texlive_bin_path="${texlive_path}/bin/x86_64-linux"
if [ -d "$texlive_path" -a -n "${PATH##*${texlive_bin_path}}" -a -n "${PATH##*${texlive_bin_path}:*}" ]; then
  export PATH="$PATH:$texlive_bin_path"
fi
unset texlive_path texlive_bin_path

と追記しておけばいいかな。一応，動作確認しておく。

$ lualatex -v
This is LuaHBTeX, Version 1.13.2 (TeX Live 2021)

Execute  'luahbtex --credits'  for credits and version details.

There is NO warranty. Redistribution of this software is covered by
the terms of the GNU General Public License, version 2 or (at your option)
any later version. For more information about these matters, see the file
named COPYING and the LuaTeX source.

LuaTeX is Copyright 2021 Taco Hoekwater and the LuaTeX Team.

マニュアルに関しては texdoc コマンドを使って

$ texdoc luatex

などとすれば対応する PDF ファイルが開く。便利！

自動実行可能な外部コマンドの指定

とりあえず shell_escape_commands の値を変更しておく。インストール直後は

$ kpsewhich -var-value=shell_escape_commands
bibtex,bibtex8,extractbb,gregorio,kpsewhich,makeindex,repstopdf,texosquery-jre8,

となっているので /usr/ocal/texlive/texmf-local/web2c/texmf.cnf ファイルを作成し以下を記述する。

shell_escape_commands = \
bibtex,bibtex8,pbibtex,jbibtex,\
extractbb,\
gregorio,\
kpsewhich,\
makeindex,mendex,\
repstopdf,epspdf,\
texosquery-jre8,\

これで shell_escape_commands の値が上書きされて

$ kpsewhich -var-value=shell_escape_commands
bibtex,bibtex8,pbibtex,jbibtex,extractbb,gregorio,kpsewhich,makeindex,mendex,repstopdf,epspdf,texosquery-jre8,

となる。

設定を変更したら mktexlsr で状態を更新しておくこと。

$ mktexlsr
mktexlsr: Updating /usr/local/texlive/2021/texmf-config/ls-R... 
mktexlsr: Updating /usr/local/texlive/2021/texmf-dist/ls-R... 
mktexlsr: Updating /usr/local/texlive/2021/texmf-var/ls-R... 
mktexlsr: Updating /usr/local/texlive/texmf-local/ls-R... 
mktexlsr: Done.

LuaLaTeX でなんか出力してみる

そうだ。プログラムコードを出してみよう。

LuaLaTeX でコードを書いてみる

その前に listings パッケージで Go コードの syntax highlight が効くよう listings-golang を取ってくる。

$ cd /usr/local/texlive/texmf-local/tex/latex/
$ git clone git@github.com:julienc91/listings-golang.git
$ mktexlsr

そうそう。 $\mathrm{Lua\LaTeX}$ を使うならフォントキャッシュも念の為にアップデートしておくか。

$ luaotfload-tool -fu

用意したテキストはこんな感じ。

\documentclass{jlreq}
\usepackage[jis2004,deluxe]{luatexja-preset} % Japanese fonts
\setmonofont[AutoFakeSlant,BoldItalicFeatures={FakeSlant},Scale=MatchLowercase]{Inconsolatazi4} % use Inconsolata

\usepackage{graphicx,xcolor}
% \usepackage{listings}
\usepackage{listings-golang} % import this package after listings
\lstset{
    frame=single,
    basicstyle=\small\ttfamily,
    tabsize=4,
    commentstyle=\color{darkgray},
    keywordstyle=\color{brown}\bfseries,
    stringstyle=\color{blue},
    showstringspaces=false
}

\begin{document}

\section{Go 言語による Hello World}

\begin{lstlisting}[language=Golang]
package main

import "fmt"

func main() {
    for i := 0; i < 10; i++ {
        fmt.Println("Hello, world") //Hello, 世界
    }
}
\end{lstlisting}

\section{シェルスクリプト}

\begin{lstlisting}[language=sh]
#!/bin/sh
for i in `seq 100`; do
  j="$i"
  if [ `expr $i % 3` == 0 ]; then echo -n 'Fizz'; j=''; fi
  if [ `expr $i % 5` == 0 ]; then echo -n 'Buzz'; j=''; fi
  echo "$j"
done
\end{lstlisting}

\end{document}

へっへっへ。 jlreq ドキュメントクラスを使ってみたぜ。

これを処理した結果は以下の通り。

sample.pdf

うんうん。こんなもんだろう。

VS Code に LaTeX Workshop を導入する

『LaTeX2ε美文書作成入門』でも紹介されていた VS Code 用の LaTeX Workshop を導入してみた。

$ code --install-extension James-Yu.latex-workshop

たとえば，以下の内容で .latexmkrc ファイルを用意しておく。

#!/usr/bin/env perl

# LaTeX commands
$pdflatex            = 'lualatex %O -synctex=1 %S';
$latex               = 'uplatex %O -synctex=1 %S';
$latex_silent_switch = '-interaction=batchmode -c-style-errors';

# bibTeX commands
$bibtex    = 'upbibtex %O %B';
$biber     = 'biber %O --bblencoding=utf8 -u -U --output_safechars %B';
$makeindex = 'mendex %O -o %D %S';

# Device Driver
$dvipdf = 'dvipdfmx %O -z9 -V 7 -o %D %S';
$dvips = 'dvips %O -z -f %S | convbkmk -u > %D';
$ps2pdf = 'ps2pdf14 -dPDFA -dPDFACompatibilityPolicy=1 -sProcessColorModel=DeviceCMYK %O %S %D';

# Typeset mode (generate a PDF)
$pdf_mode = 1; # 0: do not generate a pdf , 1: using $pdflatex , 2: using $ps2pdf , 3: using $dvipdf

# Other configuration
$pvc_view_file_via_temporary = 0;
$max_repeat                  = 5;

したら $\mathrm{\LaTeX}$ テキストを保存するたびに上の設定でタイプセットが自動実行されて PDF まで作ってしまうわけですよ。めっさ便利。

ブックマーク

参考図書

[改訂第8版]LaTeX2ε美文書作成入門: 奥村晴彦 (著), 黒木裕介 (著); 技術評論社 2020-11-14; 大型本; 4297117126 (ASIN), 9784297117122 (EAN), 4297117126 (ISBN); 評価

2020年末に第8版が出てたのに気付かなかったよ。可能なら紙の本も買って常に側に置いておくのが吉。版元には PDF 版もある。

reviewed by Spiegel on 2021-09-05 (powered by PA-APIv5)

電子署名の検証で「*警告*: この鍵は信用できる署名で証明されていません!」と表示されているが，気にしなくてよい。その前の「"TeX Live Distribution <tex-live@tug.org>"からの正しい署名」が表示されていればOK。警告が出るのはインポートした公開鍵に自鍵で署名したり有効度を設定したりしてないからだが，直接手渡しされた鍵でもないのに安易に信用するのは危険であると言っておこう。もちろん何らかの手段で鍵と所有者が確定できるのであれば署名するなり有効度を設定するなりすればよい。 ↩︎

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); 評価

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)

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); 評価