yewton.net

Agent Client Protocol を理解する

Mon, 12 Jan 2026 00:20:00 +0900

はじめに
背景: なぜ ACP が必要なのか
主な特徴とコンセプト
実践: agent-shell.el での利用例
将来性
- GitHub Copilot CLI でのサポート
- ドラフト仕様の展望
まとめ

はじめに

Agent Client Protocol (ACP) は、AI エージェントとクライアント（エディタなど）が対話する際の標準を定義するプロトコルです。この記事では、ACP の概要と、その背景や具体的な利用例、そして将来性について、自身の理解を元に解説します。

公式ドキュメントはこちらにあります。

背景: なぜ ACP が必要なのか

2025年8月30日、 Zed から以下のように発表がありました:

This week, we announced ACP, an open-source protocol that standardizes communication between clients and coding agents, but we also released Zed v0.201! Let's dive into some of the highlights!https://t.co/dHIcUWRNUs
— Zed (@zeddotdev) August 29, 2025

同年10月7日には、 JetBrains から Zed と連携して ACP に取り組むことが発表されました:

JetBrains × Zed: Open Interoperability for AI Coding Agents in Your IDE | The JetBrains AI Blog

同年12月5日に発表された Bring your own AI agent to JetBrains IDEs | The JetBrains AI Blog で語られているところによると、JetBrains が自社エージェント統合用のプロトコルを公開しようとしたタイミングで Zed も同様の動きを見せていたため、規格の乱立を避けるべく協力することになった、というのが実情のようです。

当初から『業界標準』を目指して周到に計画されたものではなく、各社の実利的なニーズが合致した結果として生まれた、という経緯は興味深い点です。各ベンダーが「エージェントを効率よく統合したい」という現実的な課題を持っていたタイミングが重なったことが、結果として標準化を加速させたと言えるでしょう。

LSP (Language Server Protocol) がプログラミング言語ごとの開発体験の差異を吸収したように、ACP は乱立する AI エージェントとそのクライアント間の通信を標準化することを目指しています。

主な特徴とコンセプト

ACP は、タスクの実行、進捗の報告、対話的なデータ交換など、エージェントとのやり取りに必要な一連の機能を定義しています。

具体的な仕様は公式サイトを見れば分かりますが、ざっくり以下のような流れになっています:

Initialization
- 接続の確立や、ベンダーの認証処理
Session Setup
- 新規セッションを始めるか、既存セッションを復元する
Prompt Turn
- ここから実際のやりとりループが始まる

公式サイトの構成は Protocol 配下が全部並列で分かりづらいですが、まず Initialization, Session Setup, Prompt Turn が Overview で述べられている上記のメッセージフローに対応しています。

Schema はその通りスキーマ定義で、それ以外は個々のコンセプトの説明になっています。

実践: `agent-shell.el` での利用例

ACP の具体的な動作を理解するために、Emacs のクライアント実装である agent-shell.el を使って、実際の通信内容を見ていきます。

ここでは、エディタ上で範囲を指定して、その範囲の内容を日本語に翻訳し、挿入してもらう、という簡単なタスクをエージェントに依頼し、その際の ACP メッセージ（リクエストとレスポンス）をキャプチャして、プロトコルの使われ方を具体的に示します。

ログ出力の有無は agent-shell-toggle-logging で設定出来ます。日本語を含むプロンプトの場合は agent-shell-prompt-compose で専用のバッファを設けるのがよいでしょう。

エージェントには Gemini CLI を使います ( --experimental-acp )。

Initialization

agent-shell の場合、最初に何らかのプロンプトを送信すると、初期化フェーズが始まります。

{
 "jsonrpc": "2.0",
 "method": "initialize",
 "id": 1,
 "params": {
 "protocolVersion": 1,
 "clientCapabilities": {
 "fs": {
 "readTextFile": true,
 "writeTextFile": true
 }
 }
 }
}

ファイルの読み書きが出来ることを宣言していますね。

このリクエストを受けて、エージェント側から初期化のための応答が返ります。

{
 "jsonrpc": "2.0",
 "id": 1,
 "result": {
 "protocolVersion": 1,
 "authMethods": [
 {
 "id": "oauth-personal",
 "name": "Log in with Google",
 "description": null
 },
 {
 "id": "gemini-api-key",
 "name": "Use Gemini API key",
 "description": "Requires setting the `GEMINI_API_KEY` environment variable"
 },
 {
 "id": "vertex-ai",
 "name": "Vertex AI",
 "description": null
 }
 ],
 "agentCapabilities": {
 "loadSession": false,
 "promptCapabilities": {
 "image": true,
 "audio": true,
 "embeddedContext": true
 }
 }
 }
}

認証方法のリストに加えて、エージェント側の対応機能が返ってきています。

Gemini CLI は今のところセッションの永続化には対応していないようです。画像やオーディオをプロンプトとして埋め込むことが出来ることも分かります。

agent-shell の動きとしては現在のところ agent-shell-google-authentication に従って固定値を返すような実装になっており、応答内容は使っていません ( TODO になっています )。

{
 "jsonrpc": "2.0",
 "method": "authenticate",
 "id": 2,
 "params": {
 "methodId": "oauth-personal",
 "authMethod": {
 "id": "oauth-personal",
 "name": "Log in with Google",
 "description": ""
 }
 }
}

エージェントは成功を示すために以下のような空レスポンスを返します。

{
 "jsonrpc": "2.0",
 "id": 2,
 "result": null
}

他の操作でも、特に返すべきものが無い場合はこのような空レスポンスで成功を表現するようです。

Session Setup

初期化に成功したらセッションを開始します。

{
 "jsonrpc": "2.0",
 "method": "session/new",
 "id": 3,
 "params": {
 "cwd": "/path/to/cwd/",
 "mcpServers": []
 }
}

セッションというのは特定のディレクトリに関連づけられる、ということが分かりますね。

エージェントはリクエストを受けて、セッション ID を返します。

{
 "jsonrpc": "2.0",
 "id": 3,
 "result": {
 "sessionId": "36702bdd-86f6-4e87-b964-c2328216f375"
 }
}

以降のやりとりはこのセッション ID がキーとなります。

Prompt Turn

ここから、入力したプロンプトの処理が始まります。

選択範囲を作成した状態で agent-shell-prompt-compose を呼ぶと、該当箇所への参照をプロンプトに自動で含めてくれます。

{
 "jsonrpc": "2.0",
 "method": "session/prompt",
 "id": 5,
 "params": {
 "sessionId": "36702bdd-86f6-4e87-b964-c2328216f375",
 "prompt": [
 {
 "type": "text",
 "text": "以下を日本語に翻訳して:\n\ncontent-org/content-org/all-posts.org:1614-1614"
 }
 ]
 }
}

翻訳を頼んでみました。すると、以下のようにまずエージェントの思考が agent_thought_chunk として返ってきました。

{
 "jsonrpc": "2.0",
 "method": "session/update",
 "params": {
 "sessionId": "36702bdd-86f6-4e87-b964-c2328216f375",
 "update": {
 "sessionUpdate": "agent_thought_chunk",
 "content": {
 "type": "text",
 "text": "**Examining the File's Contents**\n\nI'm now reading the file around line 1614 to grasp the full context. This step is crucial for accurate translation and the subsequent `replace` operation. It allows me to pinpoint the text requiring translation and prepare the `old_string` for the `replace` tool.\n\n\n"
 }
 }
 }
}

該当の部分を読みたいぞ、となっているようです。その思考の結果、 agent_message_chunk として応答が返ってきました。

{
 "jsonrpc": "2.0",
 "method": "session/update",
 "params": {
 "sessionId": "36702bdd-86f6-4e87-b964-c2328216f375",
 "update": {
 "sessionUpdate": "agent_message_chunk",
 "content": {
 "type": "text",
 "text": "I will read the file `sample.txt` around line 10 to identify the text to translate."
 }
 }
 }
}

翻訳するために該当部分を読みます、という宣言です。

(何故か突然英語になってますが、これは Gemini の癖でしょう…)

この宣言のあと、ファイルを読むためのツール実行が始まります。

{
 "jsonrpc": "2.0",
 "method": "session/update",
 "params": {
 "sessionId": "36702bdd-86f6-4e87-b964-c2328216f375",
 "update": {
 "sessionUpdate": "tool_call",
 "toolCallId": "read_file-1767793979301",
 "status": "in_progress",
 "title": "content-org/all-posts.org",
 "content": [],
 "locations": [
 {
 "path": "/home/yewton/Projects/yewton.net/content-org/all-posts.org",
 "line": 1610
 }
 ],
 "kind": "read"
 }
 }
}

この時点では ACP の fs/read_text_file は使われないようです。つまり、エディタの機能ではなくエージェント自身のツールを実行しようとしています ( これは恐らく今回の Gemini の挙動はそうなっていた、というだけだと思います )。

ツールの実行後、翻訳対象の文章を特定出来たので、翻訳と編集を行う宣言が返ってきました。

{
 "jsonrpc": "2.0",
 "method": "session/update",
 "params": {
 "sessionId": "36702bdd-86f6-4e87-b964-c2328216f375",
 "update": {
 "sessionUpdate": "agent_message_chunk",
 "content": {
 "type": "text",
 "text": "「こんにちは、世界！」に翻訳して、次の段落に追加します。"
 }
 }
 }
}

fs/write_text_file には、行番号など書き込み範囲を特定する仕様が定義されておらず、対象のファイルパスと、上書き内容だけを指定出来るようです。

その為、書き込みの前にまず全文を読み込む必要があります。

{
 "jsonrpc": "2.0",
 "id": 4,
 "method": "fs/read_text_file",
 "params": {
 "path": "/home/yewton/Projects/yewton.net/content-org/all-posts.org",
 "sessionId": "36702bdd-86f6-4e87-b964-c2328216f375",
 "line": null,
 "limit": null
 }
}

書き込みに伴う読み込みには fs/read_text_file が使われる模様です。つまり、エディタ上で編集途中でもその内容は失われない、ということになるので合理的な選択でしょう ( 本来は翻訳対象の特定時も、同様にした方が良さそうですが… )。

実際に書き込む内容を確定させると、以下のように書き込みの許可を求めるリクエストがエージェントから送られます。

{
 "jsonrpc": "2.0",
 "id": 5,
 "method": "session/request_permission",
 "params": {
 "sessionId": "36702bdd-86f6-4e87-b964-c2328216f375",
 "options": [
 {
 "optionId": "proceed_always",
 "name": "Allow All Edits",
 "kind": "allow_always"
 },
 {
 "optionId": "proceed_once",
 "name": "Allow",
 "kind": "allow_once"
 },
 {
 "optionId": "cancel",
 "name": "Reject",
 "kind": "reject_once"
 }
 ],
 "toolCall": {
 "toolCallId": "replace-1767793984780",
 "status": "pending",
 "title": "content-org/all-posts.org: Hello, World! => Hello, World!",
 "content": [
 {
 "type": "diff",
 "path": "all-posts.org",
 "oldText": "...",
 "newText": "..."
 }
 ],
 "locations": [
 {
 "path": "/home/yewton/Projects/yewton.net/content-org/all-posts.org"
 }
 ],
 "kind": "edit"
 }
 }
}

この応答を受けると以下のような確認ダイアログが出てきます。

( 一度ダイアログを閉じてしまったので再度表示して試したい、という流れの応答だったので上記のような内容になっていますが気にしないでください 🙇 )

ここで View を選択すると、以下のように変更内容をプレビュー出来ます。

プロトコル上は diff 形式でやりとりされているわけではなく、更新前後の全文が送られているので、この表示はエディタ側で行うことが求められています。

ここで y を押して許可すると、以下のような応答がエージェントに返されます。

:direction outgoing
:kind response
:object
 jsonrpc 2.0
 id 5
 result
 outcome
 outcome selected
 optionId proceed_once

( クライアントからの応答の場合は生ログが出力されていなかったのでこのような形で…。 acp–response-sender で acp--log の呼び出しが漏れているだけだと思われます。 )

許可を得たので、改めて読み込むようです。

{
 "jsonrpc": "2.0",
 "id": 2,
 "method": "fs/read_text_file",
 "params": {
 "path": "/home/yewton/Projects/yewton.net/content-org/all-posts.org",
 "sessionId": "36702bdd-86f6-4e87-b964-c2328216f375",
 "line": null,
 "limit": null
 }
}

そして、 fs/write_text_file で書き込みます。

{
 "jsonrpc": "2.0",
 "id": 3,
 "method": "fs/write_text_file",
 "params": {
 "path": "/home/yewton/Projects/yewton.net/content-org/all-posts.org",
 "content": "...ファイルの中身全量...",
 "sessionId": "36702bdd-86f6-4e87-b964-c2328216f375"
 }
}

このように全量を一括書き込みするようなので、あまりにも大きいファイルだと注意が必要かもしれません ( エディタ上で開いて編集出来ている時点で、ほぼ問題無いとは思いますが )。

将来性

ACP は発表されたばかりの発展途上プロトコルであるとは思いますが、一過性のブームとはならず、今後の展望も明るいんではないかと考えています。

まずは先に述べたように、 JetBrains と Zed という、クライアント( エディタ ) 側の大きなプレイヤーが牽引しているということ。

Visual Studio Code にも以下 Issue が立てられており、盛り上がりを見せています。

Add support in vscode for Agent Client Protocol (ACP) #265496

そして、人間がエージェントの対面にいる限りは、人間のツールであるエディタを通じたやりとりを形式化・標準化することは今後も求められていくでしょう。

以下、具体的に将来起こりそうなことについてピックアップして取り上げます。

GitHub Copilot CLI でのサポート

GitHub Copilot CLI には、まだ公式ドキュメントやコマンドの help にも記載されていませんが、ACP を利用するための --acp オプションが実験的に追加されているようです( 2026年1月12日現在 )。

agent-shell では以下のように設定すると動かせます ( --acp フラグが肝 )。

(cl-defun agent-shell-gh-copilot-make-client (&key buffer)
 "Create an GitHub Copilot client using BUFFER as context."
 (unless buffer
 (error "Missing required argument: :buffer"))
 (agent-shell--make-acp-client
 :command "copilot"
 :command-params '("--acp")
 :environment-variables nil
 :context-buffer buffer))

(defun agent-shell-gh-copilot--welcome-message (config)
 "Return GitHub Copilot welcome message using `shell-maker' CONFIG."
 (let ((art (agent-shell--indent-string 4 (agent-shell-gh-copilot--ascii-art)))
 (message (string-trim-left (shell-maker-welcome-message config) "\n")))
 (concat "\n\n"
 art
 "\n\n"
 message)))

(defun agent-shell-gh-copilot--ascii-art ()
 "GitHub Copilot ASCII art."
 (let* ((is-dark (eq (frame-parameter nil 'background-mode) 'dark))
 (text (string-trim "
┌── ──┐
│ ▄██████▄ │
 Welcome to GitHub ▄█▀▀▀▀▀██▀▀▀▀▀█▄
 █████┐ █████┐ █████┐ ██┐██┐ █████┐ ██████┐ ▐█ ▐▌ █▌
 ██┌───┘██┌──██┐██┌─██┐██│██│ ██┌──██┐└─██┌─┘ ▐█▄ ▄██▄ ▄█▌
 ██│ ██│ ██│█████┌┘██│██│ ██│ ██│ ██│ ▄▄███████▀▀███████▄▄
 ██│ ██│ ██│██┌──┘ ██│██│ ██│ ██│ ██│ ████ ▄ ▄ ████
 └█████┐└█████┌┘██│ ██│██████┐└█████┌┘ ██│ ████ █ █ ████
 └────┘ └────┘ └─┘ └─┘└─────┘ └────┘ └─┘ ▀███▄ ▄███▀
│ ▀▀████████████▀▀ │
└── ──┘
" "\n")))
 (propertize text 'font-lock-face (if is-dark
 '(:foreground "#4a9eff" :inherit fixed-pitch)
 '(:foreground "#2563eb" :inherit fixed-pitch)))))

(setq agent-shell-agent-configs
 (list (agent-shell-opencode-make-agent-config)
 (agent-shell-google-make-gemini-config)
 (agent-shell-make-agent-config
 :mode-line-name "GitHub Copilot"
 :buffer-name "GitHub Copilot"
 :shell-prompt "copilot> "
 :shell-prompt-regexp "copilot> "
 :welcome-function #'agent-shell-gh-copilot--welcome-message
 :client-maker (lambda (buffer)
 (agent-shell-gh-copilot-make-client :buffer buffer))
 :install-instructions "See TBW for installation.")))

Note

なお、 Gemini CLI もそうですが GitHub Copilot も session/set_model ( agent-shell 的には default-model-id )には現時点で対応していません。

Claude Code など一部のエージェントは対応しており、半分デファクトスタンダードのようですが、プロトコル上はまだ未定義であり UNSTABLE とされています。

将来的には Copilot も ACP 準拠のエージェントとして、様々なクライアントから統一的に利用できるようになる可能性があります。

Support for ACP (Agent Client Protocol) #222 をウォッチしましょう。

ドラフト仕様の展望

現在議論されているドラフト仕様の中でも、特に以下の 2 つはエージェントの能力を最大限に引き出すことに寄与しそうです。

Forking of existing sessions: 既存のセッションを複製し、異なるコンテキストでタスクを並行実行させる機能。
Agent Extensions via ACP Proxies: クライアントとエージェント間に新たに設けられるプロキシによる柔軟な機能拡張の仕組み。

これらの機能は、Agent Skills のような外部スキルセットとの連携や、特定のタスクに特化したサブエージェントの活用といった、より高度なエージェントアーキテクチャの規範を定義するものになると思います。

特定のベンダーにロックインされない AI エージェントの利活用に必須のものになっていくのではないでしょうか。もし仮に利用が必須でなくとも、その概念を理解することは有用なはずです。

まとめ

Agent Client Protocol は、AI エージェントを利用した開発の未来を具体化するプロトコルです。 AI エージェントとは何か、何が出来る必要があるのか、また今後何が出来るようになることを求められていくのかをキャッチアップする為に、ウォッチしていく価値のあるものだと考えています。

完全爆弾解除マニュアルのマニュアルPDFをいい感じに印刷する、または Ubuntu で小冊子印刷をする方法

Thu, 11 Dec 2025 22:00:00 +0900

TL;DR

Ubuntu 24.04 (Noble) で PDF を小冊子 (Booklet) 印刷用に加工するには、 pdfbook2 が便利。

# pdfbook2 は texlive-extra-utils に含まれる
# ディスク容量に注意（後述）
sudo apt install texlive-extra-utils

# 変換
pdfbook2 KeepTalkingAndNobodyExplodes-BombDefusalManual-v1-ja.pdf
# -> KeepTalkingAndNobodyExplodes-BombDefusalManual-v1-ja-book.pdf が生成される

これで生成された PDF を「長辺とじ」で両面印刷すれば、中綴じ可能な小冊子として印刷されます。

背景

息子が誕生日に完全爆弾解除マニュアル:Keep Talking and Nobody Explodes を欲しがりました。このゲームは、爆弾処理担当とマニュアル担当に分かれて協力するゲームで、マニュアル担当には紙のマニュアルが必要不可欠です（雰囲気を出すためにも）。

せっかくなので、それらしく、かつコンパクトにする為に小冊子印刷 (ブックレット印刷) をすることにしました。

試行錯誤の記録

「Ubuntu 小冊子」などで検索すると、いくつかの方法が見つかりましたが、簡単にはいきませんでした。

標準のプリンタ設定

公式ヘルプには、「ページ番号を 4, 1, 2, 3 の順に入力して……」といった気の遠くなるような手動指定方法が記載されていました。ページ数が多いマニュアルでこれをやるのは現実的ではありません。

既存ツール (失敗)

mkbookpdf: Rust 製のツール。試してみましたが、以下のようなエラーで panic して動きませんでした。

thread 'main' panicked at library/core/src/panicking.rs:225:5:
attempted to leave type `linked_hash_map::Node<alloc::vec::Vec<u8>, object::Object>` uninitialized, which is invalid

boomaga: 仮想プリンタツール。手順通り PPA を追加しようとしましたが、Ubuntu 24.04 (Noble) 向けのリリースが見つからず 404 エラーとなりました。

解決策: pdfbook2

最終的に動くことを確認出来たのは pdfbook2 でした。これ自体は Python スクリプトですが、Ubuntu では texlive-extra-utils パッケージの一部として提供されています。

apt-cache search pdfbook2

texlive-extra-utils - TeX Live: TeX auxiliary programs

インストール

sudo apt install texlive-extra-utils

TexLive 関連の依存パッケージが大量にインストールされるため、環境によっては時間がかかります（手元では 2 分弱でした）。また、ディスク容量も消費します（手元の環境では /usr/share/texlive 全体で約 2.8GB ありました）。ストレージ残量には十分注意してください。

使い方

pdfbook2 KeepTalkingAndNobodyExplodes-BombDefusalManual-v1-ja.pdf

これを実行すると、 KeepTalkingAndNobodyExplodes-BombDefusalManual-v1-ja-book.pdf というファイルが生成されます。

このファイルを PDF ビューワで開き、プリンタの設定で 「両面印刷（長辺とじ: Long-edge binding）」 を指定して印刷します( 参考 LinuxでPDFファイルを冊子印刷する )。

終わりに

印刷されたプリントを折り畳んでホチキスで留め、黒いビニールテープで保護してやると、冒頭の画像のような仕上がりになります ( 実際の写真を元に生成しています )。

若干字が小さいですが、コンパクトで場所もとらず、それらしい感じになりました。子どものテンションも少しだけ上がったかもしれません。

ゲーム自体も楽しめるのでおすすめです。お試しあれ。

Elastic Common Schema と OpenTelemetry Semantic Convention を通して Structured Logging について学んだ

Wed, 08 Jan 2025 23:35:00 +0900

背景
Structured logging とは
Spring Boot での Elastic Common Schema 利用
Spring Boot での OpenTelemetry 利用
終わりに

背景

Structured logging in Spring Boot 3.4 で、 Structured logging のサポートが発表されていた。

Spring Boot として提供される機能は分かったが、そもそもの Structured logging、構造化ロギングについて理解出来ていなかったので、調べることにした。

とっかかりとして、 Spring Boot がサポートする Structured logging フォーマットとしていの一番に挙げられている Elastic Common Schema (ECS) を通して調べたことをまとめる。

Structured logging とは

Getting Started | Elastic Common Schema (ECS) Reference [8.16] | Elastic には以下のようにある:

ECS enables and encourages users to normalize event data in order to better analyze, visualize, and correlate their events. Collected events can be normalized at ingest time, consistently searched across indices, and visualized predictably.

Note that when adopting an Elastic solution, such as Observability or Security, all events will map to ECS out of the box. Elastic provides an extensive set of integrations to simplify ingesting your data sources.

特に後半は特定の Elastic ソリューションとの連携について語られているので、一見すると Spring Boot が Elastic 製品特化の機能をサポートしたかのように思えてしまうかもしれない。

しかし、イベントデータの標準化によって Observability 等で一貫性の恩恵を得られるのは、何も Elastic 製品利用時に限ったことではないはず。

Elastic スタックと共に語られる事の多い Grafana の分散トレーシングソリューションである Tempo のドキュメントには、vendor-agnositc な Observability フレームワークである OpenTelemetry が提供する OpenTelemetry Semantic Conventions 1.29.0 | OpenTelemetry について言及されている。

OpenTelemetry Semantic Conventions に従うことの恩恵は以下のように述べられている:

The benefit to using Semantic Conventions is in following a common naming scheme that can be standardized across a codebase, libraries, and platforms. This allows easier correlation and consumption of data.

異なるシステム間のデータでも共通の規約に従ってさえいれば、突合などし易いし便利だよね、というのは、 ECS と同様に見える。

目指すものは同じということで、実際 ECS と OTel SemConv は統合していく ことが発表されている。

Elastic Common Schema と OpenTelemetry Semantic Convention の統合

両者の関係は oteps/text/0199-support-elastic-common-schema-in-opentelemetry.md at main · open-telemetry/oteps の図を見ると分かり易い。

提供価値被ってるし、統合した方がよいよね、ということで Elastic と OpenTelemetry からそれぞれ以下のアナウンスがあった:

以下のように、 ECS への追加は OTel SemConv からのバックポートとして行うようなことが案内されていたり、

https://github.com/elastic/ecs/blob/main/CONTRIBUTING.md#ecs-donation-to-opentelemetry

OpenTelemetry Project Roadmap | OpenTelemetry には Further Stabilizing Semantic Conventions が most important major initiatives として挙げられているので、統合に向けて確実に進んでいるようではあるが、現在のところは安定して利用出来る具体的な成果物はまだ無いようだ。

どちらかがいつか使えなくなるような破壊的な統合というわけではなさそうなので、今のところはこの両者があり、相反するものではなくいずれ統合される予定、ということを認識しておくだけで問題無さそうである。

Spring Boot での Elastic Common Schema 利用

先に挙げた Structured logging in Spring Boot 3.4 に拠れば、 logging.structured.format.console=ecs と設定するだけで以下のようなログが出力されるようになる:

{
 "@timestamp": "2024-07-30T08:41:10.561295200Z",
 "log.level": "INFO",
 "process.pid": 67455,
 "process.thread.name": "main",
 "service.name": "structured-logging-demo",
 "log.logger": "com.example.structured_logging_demo.StructuredLoggingDemoApplication",
 "message": "Started StructuredLoggingDemoApplication in 0.329 seconds (process running for 0.486)",
 "ecs.version": "8.11"
}

これらのフィールドは以下のように ECS で定義されている:

実は Elastic 提供の elastic/ecs-logging-java at v1.6.0 というものもあるのだが、 Spring Boot はこれを使っているわけ ではない 。独自に実装している。

ecs-logging-java の方には process.* のフィールドは含まれないなど、出力項目にも違いがある模様。

ただし、いずれもフィールド名は ECS に則っている。

Note

ecs-logging-java の Logback 版には、以下の issue が報告されている: Support structured logging with Logback · Issue #49 · elastic/ecs-logging-java

この対応は Spring Boot の実装版には入っているようす。

他にも、依存している Logback のバージョンが ecs-logging-java は UNMAINTAINED な 1.2 系だったりもするので、 Spring Boot を使うならば、 ecs-logging-java ではなく、組込みの機能を使っておいた方がよさそうだ。

Spring Boot での OpenTelemetry 利用

ECS と OTel SemConv 統合作業は今まさに進行中という感じで、ログに関しても open-telemetry/community: OpenTelemetry community content から辿れる OpenTelemetry Log SIG - Google ドキュメントにて、 Logs/Events guidance on what to put to attributes vs body · Issue #1651 · open-telemetry/semantic-conventions が挙げられていた事からも、活発に議論がされているようす。

いずれ ECS と OTel SemConv は同等になっていくと思われるので、目下は ECS を利用しておけば問題はなさそうだが、統合先となる OTel SemConv を今から使っていく、ということは出来るのだろうか。

以下の議論を見る限り、 OTel SemConv への対応は消極的？

Micrometer Tracing with OTEL Bridge does not honour Semantic Conventions · Issue #34132 · spring-projects/spring-boot Implement OTel HTTP semantic conventions · Issue #929 · micrometer-metrics/tracing

Java の artifact がまだ alpha 状態であることが理由だそう。確かに、 stable な spec に対する artifact でも 1.29.0-alpha のようなバージョニングになっている。

ただし、上記はメトリクスの命名規約の文脈なので、 ECS 対応のように独自実装で対応されることはあるのかもしれない。

現状でも、 OpenTelemetry の Appender を利用することは可能。 https://docs.spring.io/spring-boot/reference/actuator/loggers.html#actuator.loggers.opentelemetry

これは OpenTelemetry Protocol (OTLP) に従って、 gRPC や HTTP などで OpenTelemetry Specification に則ったデータを送信する機能で、 OTel SemConv のような標準規格というよりは OpenTelemetry という実装に特化した機能。

これで利用される Logs Data Model は OTel SemConv に則って定義されていたりするので、無関係というわけではない。

実際に先程のような Spring Boot 起動ログを OTLP で送信した内容を JSON で表現すると以下のようになる:

{
 "body": "Started PetclinicApplicationKt in 4.534 seconds (process running for 4.958)",
 "severity": "INFO",
 "attributes": {
 "code.filepath": "StartupInfoLogger.java",
 "code.function": "logStarted",
 "code.lineno": 59,
 "code.namespace": "org.springframework.boot.StartupInfoLogger",
 "process.pid": "388042",
 "thread.name": "restartedMain"
 },
 "resources": {
 "service.name": "petclinic-fullstack",
 "telemetry.sdk.language": "java",
 "telemetry.sdk.name": "opentelemetry",
 "telemetry.sdk.version": "1.43.0"
 },
 "instrumentation_scope": {
 "name": "net.yewton.petclinic.PetclinicApplicationKt"
 }
}

構造が入れ子になっていたりするが、末端のフィールド名は OTel SemConv に準拠している。

https://github.com/yewton/petclinic/tree/otlp に確認に利用したプロジェクトがある。

Note

以下で述べられているように、このように適切に構造化してデータ連携する場合は OTLP で直接送信するのがお手軽だが、この方式はアプリケーションプロセスから通信処理をする為、オーバーヘッドがある。

ファイルや標準出力に吐いたログを別プロセスで収集する方が当然パフォーマンスメリットはあるが、その為にいい感じに構造化・シリアライズしてログ出力し、それを OTLP で送信するような機構は提供されていない。

https://opentelemetry.io/docs/languages/java/instrumentation/#log-instrumentation

実際には Fluent Bit などのログ収集ソリューションと併用することになりそう。

https://docs.fluentbit.io/manual/pipeline/outputs/opentelemetry

Note

2025年1月8日現在は、 appender 群も alpha バージョンであることにも注意。

参考までに、上記の JSON は OTLP で収集したデータを加工したもので、実際は以下のようなデータが送信されている:

ResourceLog #0
Resource SchemaURL:
Resource attributes:
 -> service.name: Str(petclinic-fullstack)
 -> telemetry.sdk.language: Str(java)
 -> telemetry.sdk.name: Str(opentelemetry)
 -> telemetry.sdk.version: Str(1.43.0)
ScopeLogs #3
ScopeLogs SchemaURL:
InstrumentationScope net.yewton.petclinic.PetclinicApplicationKt
LogRecord #0
ObservedTimestamp: 2025-01-04 13:41:59.821289163 +0000 UTC
Timestamp: 2025-01-04 13:41:59.820892799 +0000 UTC
SeverityText: INFO
SeverityNumber: Info(9)
Body: Str(Started PetclinicApplicationKt in 4.534 seconds (process running for 4.958))
Attributes:
 -> code.filepath: Str(StartupInfoLogger.java)
 -> code.function: Str(logStarted)
 -> code.lineno: Int(59)
 -> code.namespace: Str(org.springframework.boot.StartupInfoLogger)
 -> process.pid: Str(388042)
 -> thread.name: Str(restartedMain)
Trace ID:
Span ID:
Flags: 0

終わりに

ECS や OTel SemConv といった標準的なスキーマが定まっていく動きはとてもありがたい。

長期的には OTel SemConv がデファクトスタンダードになっていきそうな勢いではあるが、現在の状況はかなり流動的な為、実装としては Spring Boot でもサポートされる ECS を採用しておけば問題なさそう。

規約に則ってさえいれば、可観測性やセキュリティといった非機能要件はこうしておけば OK! …というような知見が今後貯まっていくはずなので期待。

Dell Latitude 3420 の SSD をより大容量の SSD に Clonezilla でクローンし換装する

Mon, 06 Jan 2025 01:05:00 +0900

はじめに
Clonezilla による SSD クローン
SSD の換装
メモリの換装
動作確認

はじめに

以前の記事では Dell Latitude 3420 にメモリを増設したが、今回は SSD を換装した。

Docker イメージやら IDE やら何やらで 256 GiB でも心許なくなってきた為、 1 TiB の SSD に換装した。

せっかくなので、ついでにメモリも追加で購入し、 8 GiB + 16 GiB の 24 GiB から 16 GiB × 2 で 32 GiB に。

今回購入した SSD は、キオクシア ( KIOXIA ) の EXCERIA PRO NVMe™ M.2 Type 2280-S2-M SSD 1TB 。 Dell Latitude 3420 Notebook Teardown removal guide for customer replaceable units (CRUS) | Dell US に M.2 SSD 2280 card slot の記載があるので問題ないハズ。

この SSD をロジテック ( Logitec ) の SSD ケース LGB-PNV02UC にセットして、データのクローンを行った。

メモリは Crucial 16GB DDR4-3200 SODIMM D4N3200CM-16GQ を購入。

Clonezilla による SSD クローン

クローンには Clonezilla を利用した。

まずは Clonezilla Live on USB に従って Live USB を作成する。

今回はたまたま余っていたエレコム外付けポータブルSSD ESD-ED0120GBK 120GB を利用したが、 500 MiB あれば何でもよいハズ。

手順に従い、 FAT でフォーマットした後に unzip で配置して完成。

この Live USB と、クローン先の SSD を収めたケースを接続した上で、 Latitude 3420 サービスマニュアル | Dell 日本に従い、起動後 Dell のロゴが表示されたときに <F12> を押してブートメニューに入り、 Clonezilla の Live USB を選択する。

その後は Clonezilla Live Doc の Disk to disk clone のページに従っていけばよい。

図1: Start Clonezilla を選択する

図2: device-device を選択する

元々単一のパーティションにしていたので、今回は Clonezilla - Advanced Mode に従いパーティションも含めてよしなに拡張するオプションを有効化する為、 Expert を選択する。

図3: Expert を選択する

図4: disk_to_local_disk を選択する

図5: クローン元のディスクを選択する

図6: クローン先のディスクを選択する(元のデータは全消去される)

図7: advanced extra parameters はデフォルトのまま

図8: ファイルシステムのチェックはスキップ(デフォルト)

図9: ここで -k1 Create partition table proportionally を選択する

図10: 終了後の挙動はその時に選択することにして、進める

図11: とても熱心に確認してくれるので、覚悟を決めて y する

10 分程で完了するので、ここで電源オフ。

続けて、クローンした SSD に換装する。

SSD の換装

以前の記事同様にサービスモードに入り、ベースカバーを外して作業していく ( 今回気づいた点は以前の記事側に注記を入れた )。

元々は M.2 type2242 が使われていた為、以下の部分でネジ止めされていた。

図12: 元々ネジ止めされていた部分

換装するのは M.2 type2280 の為、この部品自体を移動する必要があった。

図13: ネジを外して固定金具自体を移動する

この後、 SSD を接続して金具に固定し、 SSD の換装は完了。

メモリの換装

ついでの作業だが記録として。

取り付けは以前の記事同様だが、今回は元々入っていた 8 GiB メモリと交換する必要がある為、まず取り外す必要がある。

以下の固定金具部分を外側に押し広げるような感じにすると、バインッと外れた。

図14: 固定金具。右側は隠れてしまっているが同じ箇所にある。

外したあとは、以前の記事同様に新しいメモリをセットして完了。

図15: 追加分。こちら側は向きを逆にする必要があった。

動作確認

SSD、メモリのセットが完了したので、ベースカバーを閉じて通電、起動を確認する。

今回は以前と異なり、電源投入後に数分間無反応でヒヤヒヤしたが、その後問題無く起動し、追加のストレージ・RAM も問題無く認識された 🎉

図16: Memory: 31.10 GiB 、 Disk (/): 907.06 GiB となっている

Rust で GBA 開発のとっかかり

Sun, 12 May 2024 00:02:00 +0900

背景
GBA 開発について
agb での開発
成果物
終わりに

背景

新しい言語を学ぶキッカケとして、 2015 年頃にほんの少しだけ触っていた GameBoy Advance の開発を Rust で出来ないかと検討していた。

当時 libgba を利用してつくったものは以下。これらを Rust で書き直すことが目標。

jumpingdroid

図1: ドロイド君が跳ねたり銀の林檎に乗ったりする

単純な背景と、複数スプライトの配置を試してみたもの。

キャラクターを動かして何かに乗せる ( ように見せる ) 、というだけのことをやってみた。

jumpingdroid2

図2: ドロイド君が右へ右へと進んでいく。ボタン押下で色も変わる。

1 画面に収まらないステージを横にスクロールしながら進んでいくだけのもの。

画面外で次々に進行方向の背景を描画していくことで、キャラクターが進んでいるように見せる、ということをやってみた。

GBA 開発について

GBA の開発は普通のコンピュータ上で行なうようなものとは大分様相が異なる。

OS なんてものはなく、「見渡す限りビットだらけ」である。

There is no operating system, no messing with drivers and hardware incompatibilities; it’s bits as far as the eye can see.

– Tonc: GBA Hardware

メモリの番地 0x06000000 からが背景画像のデータ領域で、 0x06010000 からはキャラクターのスプライト用のデータ、個々のスプライトは 0x07000000 から始まる領域で管理される、というように、 ある特定のメモリ領域のビットを操作したらそれが画面に反映される というのが基本的な仕組み。

図3: ドロイド君の左下部分の画像が 0x06010040 にある様子

jumpingdroid では BG (背景画像)とスプライトの基本的な機能を利用している。

BG

GBA では最大 4 枚の背景画像を利用でき、256×256 ピクセルや 256×512 ピクセルなどのサイズに設定出来る。

図4: 256×256 ピクセルの BG

GBA の画面は 240×160 ピクセルなので、上記の内実際に表示されるのは中央部分のみ。スクロール表示の実現の為には、この非表示部分と表示オフセットを上手く利用することが必要になる。

スプライト

スプライトは小さな画像オブジェクトで、個別に移動させたり反転させたりといった操作が可能。 GBA では 8×8 から 64×64 ピクセルで、最大 128 個のスプライトを扱える。

図5: 0x07000000 に格納されているドロイド君のスプライトデータ。参照先タイルは 0x06010180 にある。

高速紙芝居

無限ループの中で 各ループ内で画面がどういう状態になるかをひたすら更新していく 、というのが基本的なイメージ。

各オブジェクトの状態とプレイヤーによるボタン入力の状態に応じて高速で画面を書き換えていくと動いているように見えるという、単純な仕組み。

単純ゆえに、例えばただキャラクターを動かすといったことでも、全てゼロから定義する必要がある。

移動や拡大・回転といった基本的な機能は提供されているが、それらをどう利用するかは完全に開発者次第。

agb での開発

今回利用する agb というライブラリでは、 GBA でのゲーム開発に必要な機能をかなり抽象化して扱い易くしてくれている。

スプライトは Aseprite というピクセルアート・アニメーション作成ツールのフォーマットをそのまま利用出来る ( Aseprite は購入するか、自身でビルドする必要がある )。

図6: Aseprite の編集画面

const GRAPHICS: &Graphics = agb::include_aseprite!("gfx/sprites.aseprite");
const TAG_MAP: &TagMap = GRAPHICS.tags();

const IDLE: &Tag = TAG_MAP.get("Idle");
const WALKING: &Tag = TAG_MAP.get("Walking");
const JUMPING: &Tag = TAG_MAP.get("Jumping");

ソースコード 1: コードからのスプライト用データ利用イメージ

BG データは png 等もそのまま扱える。

agb::include_background_gfx!(tiles,
 "ff00ff", // 透過色
 bg => "gfx/bg.png");

ソースコード 2: コードからのBGデータ利用イメージ

これらはコンパイル時に GBA での利用に適した形に変換されているらしい。

プログラム全体の構造をざっくり書くと以下のようになる:

#[agb::entry]
fn main(mut gba: agb::Gba) -> ! {
 // 初期化
 let object = gba.display.object.get_managed();
 let mut droid_object = object.object_sprite(IDLE.sprite(0));
 let mut bg0 = gfx.background(
 Priority::P0,
 RegularBackgroundSize::Background32x32,
 TileFormat::FourBpp
 );
 // ...
 loop {
 // フレーム毎に色々計算
 // ...
 // BG のオフセット更新
 bg0.set_scroll_pos((bg_offset, 0));
 // BG のタイル状態更新
 bg0.set_tile(vram, (bgx, bgy), tileset, tiles::bg.tile_settings[tile_id]);
 bg0.commit(&mut vram);
 droid_object
 // スプライトの位置更新
 .set_position((dx, dy))
 // スプライト画像更新
 .set_sprite(object.sprite(sprite_for_char(ch)));;
 object.commit();
 }
}

ソースコード 3: agb を使った GBA プログラムの概要

実際のコードは以下:

成果物

mGBA で jumpingdroidr2 を実行している様子が以下。

BG1 のオフセットとタイルが更新される様子を併せて収録している。ドロイド君の進行方向にステージを書き足していっている様子が観察出来る。

終わりに

普段の開発とは全く異なる考え方が必要になるため面白い。

今回は GBA ソフトの移植を目的とした為に、Rust 自体の学習は必要最低限しかやらなかった。

とっかかりは出来たので、今後細く長くやっていきたい。

agb のリポジトリには例も豊富に提供されており、とても参考になる。

https://github.com/agbrs/agb/tree/master/agb/examples
https://github.com/agbrs/agb/tree/master/examples

その他 GBA 開発関連の情報は Home | gbadev にまとまっている。

Org Mode でリンク種別に応じたプレフィクスを表示する

Sat, 01 Apr 2023 22:47:00 +0900

TL;DR

https://github.com/yewton/.emacs.d/blob/86b2642b1210f1c43489aa6b1e12d1c70856f8df/lisp/toncs-config-org.org#org-link

上記のような設定で、上の画像のような表示になる。

背景

org-roam で色々な情報を集約している時に、リンク先が org-mode のノートなのか、それとも外部リンクなのか、等が org-link-descriptive が有効な場合( デフォルト )に一見して分からない。

org-toggle-link-display を使って一時的に全体を表示させたり、 org-appear でカーソルを合わせた時に全体を表示させたり、 help-at-pt-display-when-idle を有効にして、カーソルを合わせた時にエコーエリアにリンク先を表示させたり、等々の一手間を掛ければ対処出来るが、その一手間が惜しかった。

解決策

org-link-set-parameters を使い、 org-link-parameters に登録されている全てのリンク種別 ( org-link-types で取得する ) に対し、リンク種別を先頭にオーバーレイ表示する :activate-func を登録する。

:activate-func は、リンクがリンクとして判定され、有効になる際に実行される関数。これを使うと、リンクの開始・終了位置を元にした任意の処理を実行出来る。

この仕組みを使って、リンクの位置全体に対してオーバーレイを設定する。 before-string オーバーレイプロパティに任意の文字列を設定すれば、簡単に prefix 表示が実現出来る。

ただ、これだけでは若干問題があり、リンクの近辺で編集を行うと、その度に :activate-fun が実行され、 何重にもオーバーレイが表示される ことになってしまう。

その為、 :activate-fun 実行時に既存のオーバーレイを削除する必要がある。適当なオーバーレイプロパティ ( org-link-prefix 等 ) に値 t を設定し、オーバーレイ作成処理の前に remove-overlays を実行、前述のプロパティを条件に削除を行うようにする。

これで、リンク近辺の編集によってオーバーレイが無限増殖する自体は避けられるが、まだ問題がある。

リンクの開始位置を変更するような編集 ( リンクの前にスペースを入力する等 ) を行うと、 元の位置に対して設定されたオーバーレイが消されず ( 新しいリンク位置の範囲外になる為 )、 いつまでも残り続けてしまう 。

この対策には、 insert-in-front-hooks オーバーレイプロパティを使う。このプロパティには、オーバーレイの開始位置での編集に対して作用する関数群を登録出来る。引数にはオーバーレイオブジェクトが渡される為、 delete-overlay で削除すればよい。

最後に、 evaporate プロパティに t を設定すれば、オーバーレイ範囲が空になった際に自動で削除されるようになる。

以上の設定により、リンク近辺の編集にも支障を来さずに、リンク種別のプレフィクスを表示することが出来る。

おわりに

リンクのプレフィクスとして設定する文字列は何でも良いが、上部画像のように絵文字を設定しておくと見た目にも楽しくて良い。

この設定等を参考にすると、絵文字に対応したフォントセット設定が可能。

Spring Boot でプロファイルに応じて読み込む設定ファイルの設定値をテストする

Thu, 29 Dec 2022 23:53:00 +0900

参考

本文

公式リファレンスドキュメントに記載されているように、 Spring Boot での外部設定ファイル読み込み方法は色々ある。

application.(yml|properties) と、 Profile 毎に application-production.(yml|properties) などを配置してプロファイル固有の設定を記述するのを基本として、 spring.config.import で追加の設定ファイルを読み込んだり、 YAML のマルチドキュメントと spring.config.activate.on-profile などを使って特定の条件で Property を有効化したり、 Profile Groups でプロファイルをグループ化したり、等々。

色々なやり方がある故に、例えば本番環境用など特定のプロファイルでベースの設定をオーバーライドしたい、というような場合に、ちょっと手の込んだ記述をしていたりすると、本当に意図した通りに値が設定されているか不安になることがある。

実際にそのプロファイルで動かしてみるまで分からないのでは困るので、 test で確認出来るようにしてみる。

実際のテストコードはこちら( ProductionConfigTest.kt )。 Kotest での記述になっているが、 Kotest 固有の部分は無い。

全容は以下の通り。

@ContextConfiguration(initializers = [ConfigDataApplicationContextInitializer::class])
@ActiveProfiles("production")
class ProductionConfigTest(env: ConfigurableEnvironment) : FunSpec({
 test("R2DBC設定") {
 env.getProperty("spring.r2dbc.url") shouldContain "prod.yewton.net:5432"
 }
 test("Redis設定") {
 env.getProperty("spring.data.redis.host") shouldContain "prod.yewton.net"
 }
})

@ContextConfiguration(initializers = [ConfigDataApplicationContextInitializer::class])

@ContextConfiguration に org.springframework.boot.test.context.ConfigDataApplicationContextInitializer を指定することで、 application.properties 等の設定ファイルをロードするよう指定出来るのは、冒頭の参考リンクにある通り。

@ActiveProfiles("production")

@ActiveProfiles でテストしたいプロファイルを指定する。

class ProductionConfigTest(env: ConfigurableEnvironment) : FunSpec({

設定値は ConfigurableEnvironment を autowire して取得する。

Note

ConfigurableEnvironment は、内部的に複数の PropertySource を保持しており、これらを使ってプロパティの値を解決する。

試しにデバッガで見てみると、読み込まれているファイル群を確認出来る:

ちなみに各 PropertySource#source に、 Map として設定値が格納されている:

これを利用して、設定キーの一覧を作成したりすることも可能。

env.getProperty("spring.r2dbc.url") shouldContain "prod.yewton.net:5432"

PropertyResolver#getProperty メソッドで、特定のプロパティの値を取得出来る。

この値を利用してどういったテストを書くかは、状況に応じて。

タスクランナー Task の紹介スライドを書いた

Thu, 24 Nov 2022 22:04:00 +0900

Spring Microservices in Action, Second Edition の独習用に、 https://github.com/yewton/my-smia というリポジトリで、実際に AWS に Terraform で環境構築してデプロイするところまでをやっている。

その際に利用したタスクランナー Task が、丁度いい感じに使えて良かった為、紹介するためのスライドを作った:

external-link-alt タスクランナー Task の紹介

スライドにも書いたが、以下の点が特に気に入っている:

環境変数の設定・切り替えが簡単
Go Template が使える
タスクの構造化が簡単・直感的
無駄な実行を防ぐのが簡単
JSON スキーマが公開されており入力支援が効く

その他のツールとして YAML テンプレーティングツール ytt も便利だった。こちらについてもその内紹介したい。

Ubuntu で Bluetooth マウスが使えない時にやるといいかもしれないこと

Sun, 29 May 2022 23:28:00 +0900

以前購入した Dell Latitude 3420 ( Xubuntu 入り )をクラムシェルで使うときに、マウスが入り用になった。

元々ロジクール M337 を持っていたので、これを使えばいいと思っていたのだけれど、何故か検出されない。具体的には blueman-manager から、マウスが見えない。

検索してみると [SOLVED] Bluetooth Mouse Won’t Connect after Reboot - Ubuntu 18.04 LTS が見つかった。

理屈は分からないのだけれど、 BlueZ の bluetoothctl を使わないと接続出来ない機器があるらしい。

bluetoothctl

で、対話モードになる。この状態で

scan on

を実行すると、 Bluetooth Mouse M336/M337/M535 として検出された ( この時点で blueman-manager の方でも表示されるようになっていた )。

そして、デバイスの MAC アドレスを指定して、

pair XX:XX:XX:XX:XX:XX
connect XX:XX:XX:XX:XX:XX
trust XX:XX:XX:XX:XX:XX

と実行すれば、ペアリングと接続が完了し、次回以降はマウス側から再接続も出来るようになった。

Dell Latitude 3420 にメモリを増設する

Sat, 19 Feb 2022 21:51:00 +0900

以前の記事で書いた Dell Latitude 3420 だが、普段使いに支障は無いものの、本格的に開発作業をしようと思うといささかメモリが心許ない( 8GiB )為、メモリを増設することにした。

今回購入したのは、 Crucial 16GB DDR4-3200 SODIMM CT16G4SFRA32A 。 Crucial のページに Latitude 3420 との互換性が謳われていたのできっと安心。

Dell の公式ページに、分解方法の解説がある為、これに従い分解していく。

まずはサービスモードに入る必要がある。

公式ページ記載の通りに、 B キーを押しながら電源投入でいい…のだが、ずっと押しっぱなしにしていると連打している扱いになるらしく、確認画面などをすっ飛ばして直ぐ様ビープ音を鳴らしつつサービスモードに入ってしまう。

特に問題は無いと思うのだけれど、知らないとビックリするので注意。

B を押しながら電源を入れ、3〜5 秒程度で離すと、上手くいくと以下のように OWNER TAG という文字列が表示される。

Note

2025-01-06 追記: 次へ進むにはキーボードの任意のキーを押す必要がある。

更に AC アダプタの接続有無に関わらず、以下のような注意文言が表示され…

Please Remove AC Adapter

Press Any Key To Continue…

最後に以下のような説明が出力され、「カッカッ」とドキッとするようなビープ音が3回流れて電源が落ちる。

System Ready For Service After 3 Short Beeps (OR Wait 2 Seconds).

After The Service Is Completed, Plug In AC And Press And Hold The Power Button For 2 Seconds To Resume Normal Operations.

Press Any Key To Continue…

この後、公式ページ記載の通りに底面のベースカバーのネジを外す。

そしてベースカバーを外せばいい…のだが、すんなりとはいかなかった。どうやったら外せたのかよく分かっていないのだが、おそらくヒンジ側中央部分の引っかかりをうまいこと外せれば、あとは持ち上げるだけで外せる…ハズ。

Note

2025-01-06 追記: 左右のヒンジ部分を押し込むような感じに力を入れると外し易い。

上手く外せたら、以下の部分にメモリを差し込む。元々 8GiB のが差さっているので、その反対側になる。

メモリーの増設方法 | IODATA アイ・オー・データ機器等を参考に、斜め 35 度くらいに差し込み、奥までいったら下に押し込む。

カチッとハマッたら、再びベースカバーをネジ止めして、AC アダプタに接続する。

Note

2025-01-06 追記: ヒンジ側を先にしっかり嵌め込んでネジ止めし、その後に残りをネジ止めするとやり易い。

サービスモードに入るときの説明では、 AC アダプタ接続後に電源ボタンを押す的なことが書いてあったが、自分の場合は接続後すぐに起動した。

起動後は以下のような画面が表示される。

Alert! The amount of system memory has changed.

Dell のサポート技術文書によれば、無視して構わないとのこと。

メモリを増設または取り外した場合、このメッセージは単なる通知として無視して構いません

以上で無事、既存の 8 GiB + 16 GiB で 24 GiB に RAM を増強出来た 🎉

consult-ripgrep と migemo を組み合わせて ripgrep でもローマ字日本語検索

Mon, 07 Feb 2022 23:29:00 +0900

consult-ripgrep と migemo を組み合わせて ripgrep でもローマ字日本語検索の派生。

TL;DR

;; -*- lexical-binding: t -*-

(defun consult--migemo-regexp-compiler (input type)
 (setq input (mapcar #'migemo-get-pattern (consult--split-escaped input)))
 (cons (mapcar (lambda (x) (consult--convert-regexp x type)) input)
 (when-let (regexps (seq-filter #'consult--valid-regexp-p input))
 (lambda (str)
 (consult--highlight-regexps regexps str)))))
(setq migemo-options '("--quiet" "--nonewline" "--emacs"))
(setq consult--regexp-compiler #'consult--migemo-regexp-compiler)

Warning

Lexical Binding が有効でないとエラーになります。

`cosult-ripgrep` の仕組み

consult-ripgrep で指定する文字列は、こちらにあるように構造化されている。

特に #first#second といった指定の場合に、デフォルトでは区切り文字の前半(例の first の部分)は基本的にそのまま rg に渡され、後半(例の second の部分)は rg の結果について更に Emacs 上で絞り込む、といった挙動になる ( 基本的に、と書いたのは Emacs の正規表現から rg に渡せる正規表現に変換してくれるという counsel-rg と同じ似たような機構が備わっているから。この辺 )。

後者については completion-styles の指定通りの補完スタイルが適用される為、 consultをmigemoizeしたい (未完→だいたいできた) - ワタタツの日記!(2021-06-15) の記事にあるように completion-styles を設定していれば migemo が使用されるが、前者については consult-ripgrep 独自の仕組みなので completion-styles には影響されない。

`consult--regexp-compiler`

consult-grep の DOCSTRING に以下の記載がある:

In order to disable transformations of the grep input, adjust `consult–regexp-compiler’ accordingly.

デフォルトの実装はこんな感じ:

(defun consult--default-regexp-compiler (input type)
 "Compile the INPUT string to a list of regular expressions.
The function should return a pair, the list of regular expressions and a
highlight function. The highlight function should take a single argument, the
string to highlight given the INPUT. TYPE is the desired type of regular
expression, which can be `basic', `extended', `emacs' or `pcre'."
 (setq input (consult--split-escaped input))
 (cons (mapcar (lambda (x) (consult--convert-regexp x type)) input)
 (when-let (regexps (seq-filter #'consult--valid-regexp-p input))
 (lambda (str)
 (consult--highlight-regexps regexps str)))))

入力文字列から最終的に rg に渡される文字列を組み立てているここに、介入余地がある。

ということで、冒頭のような設定を行い、 migemo 対応版の consult--regexp-compiler を指定してやればよい。

Warning

consult--regexp-compiler はその命名からも分かる通り、あくまで内部変数のようである。その為、今後の更新によって使えなくなる可能性も十分にある。

Dell Latitude 3420 - Build Your Own で Ubuntu プリインストールなノート PC を楽しむ

Mon, 11 Oct 2021 23:44:00 +0900

経緯

過去には、 MacBook Pro (Retina, 15-inch, Mid 2012) で macOS と Xubuntu 19.10 Eoan Ermine をデュアルブートするや、中古で12,800円の激安ノートPC(Jumper Ezbook 2)にXubuntu 20.04 LTS (Focal Fossa)を入れて幸せになる、 Chromebook Acer Spin 311 に Emacs を入れて幸せになるに於いて、手元の型落ち品や安価な PC を調達しての Ubuntu ノート PC 化を行なってきたが、それなりのスペックで、 GNU/Linux 搭載前提の PC を調達したい欲が高まっていた。

そんな折、 Dell からなら Ubuntu プリインストールなノート PC を調達出来ることを Linuxノートパソコンが買える DELL製9機種 2021/09/25更新 - 全部楽しもうで知ったので、購入を決めた。

調達

構成

今回購入したのは、14 インチの Latitude 3420 。

OS を Ubuntu Linux 20.04 にし、 CPU は Core i5-1135G7 に変更、メモリは 8 GB (1 X 8 GB) 3200MHz DDR4 非-ECC 、電源ユニットを 65W Type-C アダプター に変更、また、 電源ボタンを指紋リーダー付き に、キーボードを US 配列(バックライト付き) にそれぞれ変更した。

なお、バックライト付きキーボードは US 配列でないと選択出来ない。 US 配列使いでよかったと思う瞬間である。

さらに奮発すると、 タッチディスプレイにも出来る ようだったが、今回はそこまではやらなかった。

注文時点(2021年8月2日)では上記の構成で税抜き140,500円、クーポン適用で23,183円引きの119,426円となり、最終的に 税込131,368円 となった。

特段、お安いワケではない。

なお重量は 1.52 kg 前後 。

MacBook Air(M1, 2020) が 1.29 kg、 13 インチ MacBook Pro(M1, 2020) が 1.4 kg、 16 インチ MacBook Pro が 2.0 kg ということなので、いいセン行っているのではなかろうか。

配送期間

2021年8月2日に購入し、その時点では出荷予定日11月1日、到着予定が11月12日とあったが、実際には9月8日に出荷され、9月22日に到着した。

昨今の情勢影響もあろうが、 注文から到着まで 2ヶ月弱 かかっていたことになる。元々の予定では3ヶ月以上待つことになっていたので、大分短縮されて有り難いことではある。

セットアップ

今回のポイントは 指紋認証を有効にする 部分である。

それ以外は普通に Ubuntu をセットアップをすればのだが、いつもは最初から Xubuntu を入れていたところ、今回は 後から Xubuntu 化 する、というのが異なる点。

Xubuntu 化

まずは、パッケージを最新化:

sudo apt update -y && sudo apt upgrade -y

次に、 Xubuntu を入れる。

sudo apt install -y --auto-remove xubuntu-desktop xserver-xorg-input-synaptics- light-locker-

Display manager は lightdm を選択した。

libinput と競合して、ウインドウによってナチュラルスクロールが効かくなるといった弊害があるので、 synaptics は最初から入れないようにする。

また、 xfce4-screensaver と light-locker も競合するので、light-locker の方を除外する。

xfce4-screensaver のロック画面の方が、指紋認証後直ちにロック解除されるのに対し、 light-locker の方は認証後に Unlock ボタンを押下する必要がある(lightdm-gtk-greeter と同じ挙動)という、細かい挙動の違いがある模様。

続いて、タッチパッドのオプション設定を行う:

sudo mkdir /etc/X11/xorg.conf.d/
sudo tee /etc/X11/xorg.conf.d/30-touchpad.conf <<EOF
Section "InputClass"
 Identifier "libinput touchpad catchall"
 MatchIsTouchpad "on"
 MatchDevicePath "/dev/input/event*"
 Driver "libinput"
 Option "Tapping" "on"
 Option "TappingDrag" "on"
 Option "TappingDragLock" "on"
 Option "NaturalScrolling" "on"
 Option "DisableWhileTyping" "on"
 Option "ClickMethod" "clickfinger"
EndSection
EOF

オプション詳細は libinput の man(4) を参照。

続いて、キーボード設定を行う:

sudo localectl --no-convert set-x11-keymap us pc105 '' ctrl:nocaps

オプション詳細は keyboard の man(5) を参照。

ここまでで一旦再起動する。再起動後には Xubuntu 化されている。

sudo reboot

指紋認証の設定

本 PC に搭載されている指紋リーダーは以下の Goodix 製のもの:

lsusb | grep -i goodix

Bus 003 Device 002: ID 27c6:639c Shenzhen Goodix Technology Co.,Ltd. Goodix USB2.0 MISC

これは、比較的最近の 2020年12月にリリースされた libfprint v1.90.7 で対応されたばかり。

Focal Fossa (20.04) 向けリリースでの最新は 1.90.2 だったので、そのままでは使えない。

Hirsute Hippo (21.04) 向けリリースに丁度 1.90.7 が上がっていたので、これをダウンロードして使ってしまう:

cd /tmp
wget http://launchpadlibrarian.net/530881082/libfprint-2-2_1.90.7+git20210222+tod1-0ubuntu2_amd64.deb
sudo apt install ./libfprint-2-2_1.90.7+git20210222+tod1-0ubuntu2_amd64.deb

インストール後、 fprintd-enroll を実行し、指紋を登録する。

https://askubuntu.com/a/1040609 を参考に、 pam-auth-update を実行し、 /etc/pam.d/common-auth を変更する。

このファイルは以下を実行すると分かる通り、共通設定になっている:

rg -l '@include common-auth' /etc/pam.d/ | column

/etc/pam.d/su /etc/pam.d/sudo
/etc/pam.d/gnome-screensaver /etc/pam.d/login
/etc/pam.d/xfce4-screensaver /etc/pam.d/ppp
/etc/pam.d/chsh /etc/pam.d/polkit-1
/etc/pam.d/other /etc/pam.d/lightdm
/etc/pam.d/cups /etc/pam.d/chfn
/etc/pam.d/cron /etc/pam.d/gdm-password

こんな画面が表示されたら、 Fingerprint authentication にチェックを入れて(スペースキー押下)、 <Ok> する( TAB で項目移動出来る )。

この操作により、以下のような記述が追加されることになる:

grep fprint -C 1 /etc/pam.d/common-auth

# here are the per-package modules (the "Primary" block)
auth [success=2 default=ignore] pam_fprintd.so max_tries=1 timeout=10 # debug
auth [success=1 default=ignore] pam_unix.so nullok try_first_pass

以上で、ログイン時や sudo する時など、大概の場面で指紋認証を使えるようになる。

注意点として、まず前述の通り起動後ログイン画面(greeter)では、 認証成功後に Unlock ボタンを押下する必要がある 。

そして、その「認証成功」のフィードバックが分かり辛い。パスワード入力フィールドが無くなって、 Unlock 出来そうな雰囲気になったことを察知するしかない。

次に、 キーリングのロック解除には相変わらずパスワードが必要になる 。

これは、 After login in with Fingerprint reader on Lenovo Thinkpad prompted to enter password for unlocking the Keyring (#613) · Issues · GNOME / gdm · GitLab で議論されている通り、基本的にはセキュリティ上意図された挙動な模様。起動直後の一度きりの入力で済む話ではあるので、当座は受け入れている。

また、 指紋認証待ちである事のアピールが結構弱い ので、タイムアウトしがちである。

例えば、 sudo 時は標準出力に Place your finger on the fingerprint reader と控えめに出力されるだけだし、 Emacs で TRAMP を使い root 権限でファイルを開くときに至っては、何も出力されない。

以上のような多少の不都合はあるものの、目を瞑れる程度ではないかと思う。

その他のセットアップ

以降は、特に本機だから行うというワケではないが、記録の為に残しておく。

まず何よりも先に、キーテーマを Emacs に設定する:

xfconf-query --channel xsettings --property /Gtk/KeyThemeName --set Emacs

最低限のキーボードショートカットを設定する:

xfconf-query --channel xfce4-keyboard-shortcuts --property '/commands/custom/<Primary>minus' --create --type string --set 'xfce4-terminal --drop-down --hide-menubar --hide-toolbar --hide-scrollbar'
xfconf-query --channel xfce4-keyboard-shortcuts --property '/commands/custom/<Primary><Alt>space' --create --type string --set 'xfce4-appfinder'
xfconf-query --channel xfce4-keyboard-shortcuts --property '/commands/custom/<Primary><Shift><Alt>dollar' --create --type string --set 'xfce4-screenshooter --clipboard --region'

キーリピート設定を変更する:

xfconf-query --channel keyboards --property '/Default/KeyRepeat/Delay' --create --type int --set 350
xfconf-query --channel keyboards --property '/Default/KeyRepeat/Rate' --create --type int --set 20

主に Emacs とコマンドライン系ツールの導入用に、 Guix を導入していく:

sudo apt install nscd -y
sudo su -
cd /tmp/
wget https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh
chmod +x guix-install.sh && ./guix-install.sh

初回はめちゃくちゃ時間かかるので、進捗確認しやすくする為にプレゼンテーションモード(自動画面オフやロックをしない)にしておく:

xfconf-query --channel xfce4-power-manager --property /xfce4-power-manager/presentation-mode --create --type bool --set true

初回アップデート & 設定:

guix pull && \
 systemctl daemon-reload && \
 systemctl restart guix-daemon.service && \
 guix archive --authorize < /root/.config/guix/current/share/guix/bordeaux.guix.gnu.org.pub && \
 guix package -u && \
 guix install glibc-locales && \
 service lightdm restart

ここからは通常ユーザーでの作業。

引き続き Guix のアップデートと初期設定:

guix pull && guix package -u
guix install glibc-locales nss-certs curl
. ~/.guix-profile/etc/profile

コマンドラインツール群を導入:

guix install zsh git git:credential-libsecret rcm ripgrep fzf fasd tmux xclip direnv
. ~/.guix-profile/etc/profile
sudo apt install powerline -y
wget https://raw.githubusercontent.com/junegunn/fzf/master/shell/key-bindings.zsh -O ${HOME}/.fzf.zsh
git clone https://github.com/yewton/.dotfiles.git
cd .dotfiles/
RCRC=~/.dotfiles/rcrc rcup
rcup -t ubuntu
echo $(which zsh) | sudo tee -a /etc/shells
chsh -s $(which zsh)

ここで一旦ログアウト:

xfce4-session-logout --logout

ログイン後、Git の設定を行う:

git config --file ~/.gitconfig.local user.name yewton
git config --file ~/.gitconfig.local user.email yewton@gmail.com
git config --file ~/.gitconfig.local credential.helper = ${HOME}/.guix-profile/bin/git-credential-libsecret

Emacs のインストール & 設定:

guix install coreutils findutils texinfo emacs
. ~/.guix-profile/etc/profile
sudo apt install cmigemo -y
mkdir ~/.local/share/fonts
(export VER=2.5.1 && wget https://github.com/yuru7/HackGen/releases/download/v${VER}/HackGenNerd_v${VER}.zip &&
 unzip HackGenNerd_v${VER}.zip &&
 mv ./HackGenNerd_v${VER}/*.ttf ~/.local/share/fonts/ &&
 rm -fr ./HackGenNerd_v${VER}* &&
 fc-cache -fv)
git clone https://github.com/yewton/.emacs.d.git

Get the 1Password for Linux app に従い、 1Password のインストール:

curl -sS https://downloads.1password.com/linux/keys/1password.asc | sudo gpg --dearmor --output /usr/share/keyrings/1password-archive-keyring.gpg
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/1password-archive-keyring.gpg] https://downloads.1password.com/linux/debian/amd64 stable main' | sudo tee /etc/apt/sources.list.d/1password.list
sudo mkdir -p /etc/debsig/policies/AC2D62742012EA22/
curl -sS https://downloads.1password.com/linux/debian/debsig/1password.pol | sudo tee /etc/debsig/policies/AC2D62742012EA22/1password.pol
sudo mkdir -p /usr/share/debsig/keyrings/AC2D62742012EA22
curl -sS https://downloads.1password.com/linux/keys/1password.asc | sudo gpg --dearmor --output /usr/share/debsig/keyrings/AC2D62742012EA22/debsig.gpg
sudo apt update && sudo apt install 1password -y

asdf のインストール:

guix install gcc-toolchain readline zlib openssl libyaml
. ~/.guix-profile/etc/profile
git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.8.1
. $HOME/.asdf/asdf.sh
for i in ruby nodejs golang; do asdf plugin-add $i; done
asdf plugin-add hugo https://github.com/beardix/asdf-hugo.git
asdf install

テーマを Numix に:

sudo add-apt-repository ppa:numix/ppa
sudo apt install numix-blue-gtk-theme numix-icon-theme-circle -y
xfconf-query --channel xsettings --property /Net/ThemeName --set 'NumixBlue'
xfconf-query --channel xsettings --property /Net/IconThemeName --set 'Numix-Circle'
xfconf-query --channel xfwm4 --property /general/theme --set 'NumixBlue'

Mozc 導入:

sudo apt install fcitx-mozc -y
im-config -n fcitx
sudo reboot

xfce4-clipman-plugin 導入:

sudo apt intall xfce4-clipman-plugin -y

終わりに

ガッツリ作業にも使えるメイン Xubuntu 機を調達出来て満足。

今回の経験で問題無く使いものになることは分かったので、次回調達の機会があれば、さらにスペックを上げたり、タッチディスプレイにすることにも検討したい。

スーパーマリオ64 Behind Camera Anywhere とは

Mon, 07 Jun 2021 00:30:00 +0900

背景

pannenkoek2012 氏( メインチャンネル , セカンダリチャンネル ) の上げているマリオ 64 動画 ( 極力 A ボタンを押さないプレイ、いわゆる A Button Challenge, ABC の方 )が好きで、ちょくちょく動画を拝見している。

さる 2021 年 5 月 3 日に新たな動画が投稿されており、何やら新たなテクニックを活用されているようだった:

説明文から参照されている先を見ると、 Behind Camera Anywhere というモノらしい:

ABC の新たな展開に備え、このテクニックを理解しようと考えた。

背景
前提知識
Behind Camera Anywhere
終わりに
リンク集

前提知識

Behind Camera Anywhere は、 HOLP 固定手法の一つである。

HOLP についてはスーパーマリオ64学入門【アドベントカレンダー2018　32日目】 | 東京工業大学デジタル創作同好会traP が詳しい。

簡単に説明しておくと、まず HOLP とは Held Object’s Last Place 、つまりマリオが手に持ったオブジェクトの最終位置のこと。

通常はマリオの移動と共に更新され続けるが、何らかの理由でマリオがレンダリングされていない場合等には HOLP が更新されずに以前の値のままになるという性質があり、この性質を利用することを HOLP 固定 と呼ぶ。

pannenkoek2012 氏による以下の動画でも解説されている:

また、 HOLP はワールドをまたいでもリセットされない という性質もある。

この性質と、オブジェクトの消滅と保持をほぼ同時に発生させることで、ワールド中にロードされるほぼ任意のオブジェクト(のクローン)をマリオに持たせられる技、いわゆる 無を取得 との合わせ技が ABC ではよく使われる。

例えば、ポールから降りる際の A ボタン入力を回避する為に、降りたい地点に敵オブジェクトを配置することでヒットバックを発生させ、無理矢理降りる、等である。

Behind Camera Anywhere

マリオを画面外に追いやることでレンダリングを回避し、結果 HOLP を固定出来ること自体は先程の動画の公開時点(2016 年)で発見されていたものの、その条件である「マリオを画面外に追いやる」手法が確立されていなかった。

今回発見された Behind Camera Anywhere ではその名の通り、どこでもカメラの後ろに回れる、つまり (ほぼ)任意の場所でマリオを画面外に追いやれる ようになったのである。

これまでの HOLP 固定は、先程の動画でも紹介されているポーズバッファリングを用いたヒットスタン (Pause Buffered Hitstun, PBH) を利用する方法が主流だった。

PBH を簡単に説明すると、被弾時の点滅状態に於いて、ゲーム内タイマーの値が偶数の場合のみマリオがレンダリングされること、及びポーズ中でも該当タイマーの値は進み続けることを利用し、適当な間隔でポーズを連打することで、被弾無敵時間が持続する限り一切のレンダリングを避け、結果として HOLP を固定する、という技である。

PBH を利用するには必ず被弾する為の敵が必要になるが、一方で今回の Behind Camera Anywhere ではそれが不要になる。

とはいえ発見元の動画説明文にもある通り、画面外を維持したまま出来る操作というのは限られており、必ずしも PBH の代替手段とはならないのだそう。

この手法にもそれなりの制限があるということではあるが、新たな HOLP 固定手法として今後活用される機会は増えていくかもしれない。

終わりに

筆者自身はプレイするでも、解析するでもなく、氏の解説動画を観て分かった気になっているだけである。

その為、本記事の内容には誤りがある可能性もある。

是非、各位自身の目で、氏による懇切丁寧な解説動画を確認し、奥深いスーパーマリオ 64 A ボタンチャレンジの世界に飛び込んで頂きたい。

リンク集

Wowchemy 5.0.0 から 5.2.0 へのアップデート記録

Wed, 02 Jun 2021 00:44:00 +0900

背景

2021年5月4日に 5.1.0 が、同年5月26日に 5.2.0 が、それぞれ発表された。

前回で Hugo Modules への対応が済んでいるので、サクッとアップデート出来るようになった。

多少、後方互換性の無い変更があるので、対応の記録を残す。

アップデート手順

まず、 Hugo 自体を、対応最新バージョンである v0.83.1 に上げる ( リリースノートによると、 Hugo Extended v0.81.0-v0.83.1 に対応している模様 )。

netlify.toml の変更も忘れずに。

その後、リリースノートに記載の通り以下を実行する:

hugo mod get github.com/wowchemy/wowchemy-hugo-modules/wowchemy@89d079b
hugo mod get github.com/wowchemy/wowchemy-hugo-modules/wowchemy-cms@89d079b

これだけだと、 go.sum にゴミが残るので、更に hugo mod tidy しておくとよい。

Wowchemy v5.1.0 の Apply Breaking Changes に従い、以下を行う:

assets/images/ を assets/media/ にリネーム
デフォルトソーシャルシェア用画像の名前を assets/media/sharing.* に設定し、 sharing_image の設定を config.yaml から削除
static/media/ 以下のメディアファイルを、 Hugo のメディア処理システムの対象になるように assets/media/ に移動する

以上で、アップデートは完了となる。簡単!

Academic 4.8.0 から Wowchemy 5.0.0 へのアップデート記録

Sun, 28 Feb 2021 00:37:00 +0900

背景
アップデート手順
(おまけ)Chromebook でローカルサーバーにアクセス出来ないとき
終わりに

背景

2021年2月25日に Wowchemy (旧 Academic) の 5.0.0 正式版が発表された。 4.8 が2020年3月だったので、実に1年ぶりのアップデートとなる。

Academic から Wowchemy にリブランディングされただけではなく、後方互換性の無い大幅な変更が行われている。

アップデート手順

公式には Beta 0、Beta 1、Beta 2、Beta 3 を順に辿るとよい、とあるものの、実際のところ先の変更が後で無意味になったりしたので、改めてまとめる。

まず、最大の変更点である Hugo Modules への対応。

1.13 以上の go をインストールした後に、 Wowchemy が対応しているバージョンの Hugo を入れる。

これがパッと分からなかったのだけれど、 Beta 3 のリリースノートから Hugo 0.80.0 が最新動作確認版であることが分かり、また git 上で 5.0.0 と Beta 3 の指す先が同じであることから、 5.0.0 でも Hugo 0.80.0 が使えることが分かった。

例によって extended 版が必要なので、もし arm 版が欲しい場合は https://github.com/gohugoio/hugo/tree/v0.80.0 から zip をダウンロードしたのちに自身でビルドする必要がある:

go build --tags extended

用意が出来たら、従来のテーマを削除する:

git submodule deinit themes/academic
git rm themes

そして、 config/_default/config.toml から theme = "academic" の記述を削除し、以下を最下部に追加する:

[module]
 [[module.imports]]
 path = "github.com/wowchemy/wowchemy-hugo-modules/wowchemy-cms"
 [[module.imports]]
 path = "github.com/wowchemy/wowchemy-hugo-modules/wowchemy"

その後に、モジュールを初期化する:

hugo mod init github.com/yewton/yewton.net

これだと開発版が入ってしまうため、特定バージョンを入れ直す。

Wowchemy のドキュメントにはコミットハッシュ指定で入れるように書いてあるので、何でバージョン指定出来ないんだろう、と思い調べてみたところ、どうやらバージョン指定で入れられるようなモジュール設定になっていないらしかった (参考: Goメモ-35 (モジュールのメジャーバージョンを２以降にした場合の取り扱い方について) - いろいろ備忘録日記 )。

というわけで 5.0.0 のコミットを指定して入れる…と、ここで罠があって、 コメント機能を使っている場合、以下の不具合の為にエラーになる :

fix: comment provider never found by arhohuttunen · Pull Request #2165 · wowchemy/wowchemy-hugo-modules

そのため、この修正が取り込まれたコミットを指定してやる:

hugo mod clean
hugo mod get github.com/wowchemy/wowchemy-hugo-modules/wowchemy@3cf9f6c
hugo mod get github.com/wowchemy/wowchemy-hugo-modules/wowchemy-cms@3cf9f6c
hugo mod tidy

画像置き場が /static/img/ /static/media/ に変わるので、合わせてリネーム+置換を行う。自分は rg.el の wgrep でシュッとやってしまった。

以降、細かい非互換変更への対応。

content/authors/admin/_index.md の name を title に置換する。

config/_default/params.toml に以下を追加する:

# Content Management System
[cms]
 # Enable the admin panel. See https://wowchemy.com/docs/install/
 branch = "master"
 local_backend = false

# Icon Pack Extensions
[icon.pack]
 ai = true # Enable the Academicons icon pack https://jpswalsh.github.io/academicons/

また、 search, comments, map の設定キー engine が provider に変わり、また設定値が数値から文字列に変わっている。これもそれぞれ変更が必要。

記事中での alert ショートコードが非推奨になるので、 callout に一括置換。

以上で移行は完了した。

(おまけ)Chromebook でローカルサーバーにアクセス出来ないとき

Chromebookでローカルサーバーを立てる | Chromebook情報ポータル「chromebooker」にある通り、 localhost でアクセス出来るときもあるのだけれど、出来なくなる場合もある (たぶん初回だけアクセス出来る？)。

そんな時は昔ながらの http://penguin.linux.test:1313/ でアクセスすれば良いのだけれど、デフォルトでは hugo server は 127.0.0.1 にバインドしているのでそのままでは拒否される。

以下のように全アクセスを許可してやれば良い(信頼出来るネットワークなら):

hugo server -DF --bind 0.0.0.0

終わりに

終わってみれば、大した手間もかからずに移行出来た。

とはいえ、公式ドキュメントだけだと若干引っ掛かる部分もあったので、この記録が誰かの役に立てば幸い。

Chromebook Acer Spin 311 に Emacs を入れて幸せになる

Sun, 21 Feb 2021 23:24:00 +0900

Emacs のインストール
(おまけ)git の credential helper を設定する
(おまけ)スクリーンショットの利用
(おまけ)arm 版 hugo-extended を作る
終わりに

Chromebook Acer Spin 311 を半ば衝動買いした。

当初の目的としては、電子書籍を Moon+ Reader Pro で読みつつ、 Orgzly でメモを取り、それを Syncthing で共有する、というような Android でのユースケースを、キーボード付きのデバイスでやりたいな、というくらいだった。

実際購入してみたところ、 Linux (Debian) をシュッと立ち上げて使えるということだったので、それならばと Emacs を使えるようにしよう、と相成った。

この Linux は本当に Debian なので、実は Chromebook 特有の何かというのはあまりなかったのだけれど、備忘録として作業内容を記録しておく。

Emacs のインストール

Linux コンテナを立ち上げたらまずは更新をかける:

sudo apt update
sudo apt upgrade

日本語ロケールが設定されていないので、設定しておく:

sudo dpkg-reconfigure locales

Emacs や開発系のツールは新し目のを使いたいので、 nix で導入する。

こういう場合に snap や flatpak 等で入れると、 Emacs 内からリンクを開く際に既存のブラウザインスタンスが使われなかったり等の変な挙動をするので、 nix を使うようにしている (参考: Opening urls from emacs in firefox : r/emacs)。

そして、現状の ChromeOS 特有の問題として、 nix のインストールに失敗する、という物がある(参考: can’t install nix-2.3.7 on ChromeOS linux container: operation not permitted mounting /proc · Issue #4107 · NixOS/nix)。ここに記載の通りワークアラウンドとして以下を実行する:

sudo umount /proc/{cpuinfo,diskstats,meminfo,stat,uptime}

これで nix のインストールが出来るようになる:

curl -L https://nixos.org/nix/install | sh

Emacs のインストールは以下の通り:

nix-env -i emacs-27.1

インストールしたアプリを ChromeOS 側から見えるように、以下のように設定する(参考: Installing Nix on Crostini - NixOS Wiki):

mkdir -p ~/.config/systemd/user/cros-garcon.service.d/
cat > ~/.config/systemd/user/cros-garcon.service.d/override.conf <<EOF
[Service]
Environment="PATH=%h/.nix-profile/bin:/usr/local/sbin:/usr/local/bin:/usr/local/games:/usr/sbin:/usr/bin:/usr/games:/sbin:/bin"
Environment="XDG_DATA_DIRS=%h/.nix-profile/share:%h/.local/share:/usr/local/share:/usr/share"
EOF

これで一度再起動すれば、もう普通に使えるようになってしまう。

(おまけ)git の credential helper を設定する

GitHub のプライベートリポジトリを利用する場合等には、パーソナルアクセストークンによる認証が必要になる。

Chromebook でも gnome-keyring を入れれば libsecret による認証ヘルパーを利用出来る。

sudo apt install gnome-keyring -y
(cd ~/.nix-profile/share/git/contrib/credential/libsecret/ && sudo make)
git config --file ~/.gitconfig.local credential.helper ~/.nix-profile/share/git/contrib/credential/libsecret/git-credential-libsecret

これで、認証が必要なリポジトリをクローンしようとすると、以下のようなダイアログが出てくるようになる:

(おまけ)スクリーンショットの利用

上記のようなスクリーンショットは Chromebook 側で撮影したあとにクリップボードに送信することで、 Linux 側からも xclip 等で普通に使えるようになる。

(おまけ)arm 版 hugo-extended を作る

せっかく Emacs が使えるようになったので、ブログも Chromebook で書いてしまおうと思い、 Hugo をインストールしようとした所で引っ掛かってしまった。

現在利用しているテーマ( Wowchemy )では、 Hugo の Extended 版が必要なのだが、 Spin 311 の CPU は arm であり、また Hugo 公式では arm 用の Extended バイナリを配布していない (参考: Extended Version for ARM - support - HUGO)。

そこで、 Install Update Hugo Extended for ARM in Ubuntu | Apoorv Blog を参考にしつつ (と言っても、 arm 版 go を入れて go build --tags extended しましょう、というだけだが…)、ソースからビルドすることで対応した。

なお、 go 自体のインストールは asdf の Go プラグインを利用した。

終わりに

Moon+ Reader で電子書籍を読みつつ、 Emacs でメモを取り、 Android の Syncthing で同期する、という面白い環境が出来上がった。

ついでにブログ執筆環境も整えることが出来た。サクサク、というわけには行かないが、それほどストレスなく利用出来るし、キーボードも案外打ち易い。この記事自体も Chromebook で書いている。

なかなか良い買い物だったと思う。

中古で12,800円の激安ノートPC(Jumper Ezbook 2)にXubuntu 20.04 LTS (Focal Fossa)を入れて幸せになる

Thu, 18 Jun 2020 06:18:00 +0900

経緯
インストール用 SSD の外付け
Xubuntu インストール
Ezbook 用の Tweak
Xubuntu の初期設定

経緯

先日近所のブックオフでこんなものを見つけた。

値札によると、 Jumper の Ezbook というものらしい。多分こちらで紹介されてるもの。

珍しく英語配列キーボードで、 Windows 10 もついて Windows 10 単体より安い。ということで購入を決めた。

実際 FINAL FANTASY VII INTERNATIONAL for PC が快適に動かせる程度のスペックはあった。

とはいえ Windows は普段遣いするモノではない(≒ Emacs を快適に使えない)ので、 Xubuntu を入れることにした。

優秀なスペックとは言えないので快適というワケにはいかないが、このブログ記事を Emacs で書きながら hugo を立ち上げ、 Gimp で画像編集をしつつ記事をプレビューする、くらいのことは普通に出来ている。

ただキーボードの反応が悪いのはいかんともしがたい。 Ctrl(Caps Lock)とスペースをよく押し損じる。真ん中のところを押すように意識すればいいので、慣れてくれば、まあ使えないこともない…。

珍しく 14 インチで、そこそこ軽いというのもあり、雑に持ち歩けるエディタ環境という点では一定の価値があるかなー、という感じ。

以下、使えるようにするまでの道程を紹介する。

インストール用 SSD の外付け

せっかく Windows 10 が入ってるので、それは活かしておきたい。

ということで、昔使っていたノート PC に入っていた TOSHIBA の SSD を、玄人志向 HDDケースで外付けドライブ化して使うことにした。

相当不恰好にはなるが、適当な面ファスナーで背面に貼り付けている。

USB 3.0 ポートを使っているからか、それほどパフォーマンスの問題は感じない。元々、期待するようなスペックではないというのが大きいが…。

ちなみに最初は、 SSD なら何でも良かろうと思ってコンパクトなエレコムの外付けSSD で試したが、こちらは速度が遅くて使いものにならなかった。 Xubuntu のインストールに丸一日かかるレベル。

Xubuntu インストール

起動用の USB ドライブの作り方は以前の記事と同様。

作成した USB ドライブから起動出来るようにするには BIOS の設定を変える必要がある。

起動直後の以下の画面で ESC を押す。

すると BIOS 設定画面が開くので、 → キーで Boot タブを開く。

Boot Option Priorities というのが起動順を指定する設定。 #1 を選択して USB ドライブを指定する。

後は、普通にインストール。パーティション指定は面倒だったので、外付けドライブ全てを / にした。これでも特に問題は無さそう。

Ezbook 用の Tweak

Ezbook は実はトラックパッドに特殊なキー操作が割り当たっていて、意図せず暴発するのでこれを無効にする。具体的には上端から下へスワイプすると Super+Down が押下されたことになる。これがデフォルトでは Tile window to the bottom に割り当たっているので、 xfwm4-settings を立ち上げてショートカットを削除する。

ちなみに、右端から左へのスワイプは Super+A に、下端から上へスワイプは Super+B に、左端から右へスワイプは Super+TAB にそれぞれ割り当てられている。これらのキーはデフォルトでは特にアサインされていなさそう。

次に、 xmodmap - ArchWiki を参考にキーマップを修正する。

Ezbook に限らず、 Caps Lock は Ctrl に割り当てたいので以下を ~/.Xmodmap に設定する:

clear lock
clear control
keycode 66 = Control_L
add control = Control_L Control_R

即反映するには xmodmap ~/.Xmodmap する。

また、 Ezbook では MacBook で / があるところに Delete があり、 MacBook で option があるところに \ があり使い辛くてしょうがないので、 Delete を / にする設定をする:

keycode 119 = backslash bar backslash bar

最後に、トラックパッドのスクロール方向が直感に反するので、 xfce4-mouse-settings を立ち上げ、 Reverse scroll direction にチェックを入れる。

Xubuntu の初期設定

まずはターミナルから Emacs キーバインドを有効にする:

xfconf-query --channel xsettings --property /Gtk/KeyThemeName --set Emacs

キーボードショートカットでいつでもターミナルを出せるようにしておく:

xfconf-query --channel xfce4-keyboard-shortcuts --property '/commands/custom/<Primary>minus' --create --type string --set 'xfce4-terminal --drop-down --hide-menubar --hide-toolbar --hide-scrollbar'

簡易 Spotlight 的な:

xfconf-query --channel xfce4-keyboard-shortcuts --property '/commands/custom/<Primary><Alt>space' --create --type string --set 'xfce4-appfinder -c'

キーリピート設定をする:

xfconf-query --channel keyboards --property '/Default/KeyRepeat/Delay' --create --type int --set 350
xfconf-query --channel keyboards --property '/Default/KeyRepeat/Rate' --create --type int --set 20

numlockx の設定をする:

echo NUMLOCK=off | sudo tee /etc/default/numlockx

Linuxbrew を入れる:

sudo add-apt-repository ppa:git-core/ppa -y
sudo apt update
sudo apt install curl git -y

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
sudo apt-get install build-essential -y
echo 'eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv)' >> ${HOME}/.profile
eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv)
brew install gcc

zsh を入れる:

brew install zsh

Git の認証ヘルパー等の設定をする:

sudo apt-get install libsecret-1-0 libsecret-1-dev -y
(cd /usr/share/doc/git/contrib/credential/libsecret/ && sudo make)
git config --file ~/.gitconfig.local user.name yewton
git config --file ~/.gitconfig.local user.email yewton@gmail.com
git config --file ~/.gitconfig.local credential.helper /usr/share/doc/git/contrib/credential/libsecret/git-credential-libsecret

ターミナル環境の必需品(zplug, rcm , fzf , fasd , tmux , powerline , xclip, direnv) を入れる:

wget -qO - https://apt.thoughtbot.com/thoughtbot.gpg.key | sudo apt-key add -
echo "deb https://apt.thoughtbot.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/thoughtbot.list
sudo apt-get update

sudo apt install rcm fzf fasd tmux powerline xclip direnv -y
curl -sL --proto-redir -all,https https://raw.githubusercontent.com/zplug/installer/master/installer.zsh | zsh

echo 'source /usr/share/doc/fzf/examples/key-bindings.zsh' >> ${HOME}/.fzf.zsh
echo 'source /usr/share/doc/fzf/examples/completion.zsh' >> ${HOME}/.fzf.zsh

プログラミング用日本語等幅フォント Cica(シカ) をインストール:

wget https://github.com/miiton/Cica/releases/download/v5.0.1/Cica_v5.0.1_with_emoji.zip
unzip Cica_v5.0.1_with_emoji.zip
sudo mv *.ttf /usr/local/share/fonts/
sudo fc-cache -fv

.dotfiles を入れ、シェルを変更し、一度ログアウトする:

git clone https://github.com/yewton/.dotfiles.git
RCRC=~/.dotfiles/rcrc rcup
rcup -t ubuntu

echo $(which zsh) | sudo tee -a /etc/shells
chsh -s $(which zsh)

Orgzly のノートを Syncthing で同期しているので、 Syncthing をインストールする。 syncthing-gtk を入れると自動起動の設定が楽:

curl -s https://syncthing.net/release-key.txt | sudo apt-key add -
echo "deb https://apt.syncthing.net/ syncthing stable" | sudo tee /etc/apt/sources.list.d/syncthing.list
sudo apt update
sudo apt install syncthing syncthing-gtk -y

1Password CLI をインストール:

wget https://cache.agilebits.com/dist/1P/op/pkg/v1.1.0/op_linux_amd64_v1.1.0.zip
unzip op_linux_amd64_v1.1.0.zip
mv op ~/bin/
eval $(op signin my)

1Password CLI の JSON を扱うのに便利な Blacksmoke16/oq を入れる:

snap oq

Firefox アカウントを取得するにはこんな感じ:

op get item 'Firefox Account' | oq -r '.details.fields[]|select(.name=="username")|.value' | tr -d '\n' | pbcopy
op get item 'Firefox Account' | oq -r '.details.fields[]|select(.name=="password")|.value' | tr -d '\n' | pbcopy
op get totp 'Firefox Account' | pbcopy

GNU Emacs と関連パッケージをインストール:

sudo apt install build-essential texinfo aspell ripgrep cmigemo sqlite3 -y
sudo add-apt-repository ppa:kelleyk/emacs -y
sudo apt update
sudo apt install emacs26 -y

.emacs.d や個人設定をインストールする:

git clone https://github.com/yewton/.emacs.d.git
echo -e "(setq custom-file \"~/.emacs.local/init.el\")\n(load custom-file)" > ~/.emacs.d/custom.el

Emacs 外での日本語入力のため Mozc をインストールして設定:

sudo apt install -y fcitx-mozc
im-config -n fcitx

sudo reboot # 一度再起動する

fcitx-config-gtk3 # 設定 GUI が立ち上がる

asdf vm 本体とプラグインをインストール:

brew install asdf
asdf plugin add ruby
asdf plugin add python
asdf plugin add nodejs
asdf plugin add golang
asdf plugin add hugo https://github.com/beardix/asdf-hugo
bash -c '${ASDF_DATA_DIR:=$HOME/.asdf}/plugins/nodejs/bin/import-release-team-keyring'
asdf install

素敵なアイコンテーマ numix-icon-theme-circle をインストール:

sudo apt install numix-icon-theme-circle

アイコンテーマ以外も含めて、全部 Numix にするとよろしい:

xfce4-appearance-settings
xfwm4-settings
sudo lightdm-gtk-greeter-settings

dylanaraps/neofetch をインストール:

sudo apt install neofetch -y

avy で migemo る (avy-migemo を使わずに)

Sun, 31 May 2020 05:31:00 +0900

TL;DR

(require 'avy)
(require 'migemo)

(defun avy-goto-migemo-timer (&optional arg)
 (interactive "P")
 (let ((avy-all-windows (if arg
 (not avy-all-windows)
 avy-all-windows)))
 (avy-with avy-goto-migemo-timer
 (setq avy--old-cands (avy--read-candidates #'migemo-get-pattern))
 (avy-process avy--old-cands))))
(add-to-list 'avy-styles-alist '(avy-goto-migemo-timer . pre))
(global-set-key (kbd "C-M-'") 'avy-goto-migemo-timer)

背景

以前の記事を書いた時点では avy を使っていなかったが、改めて調べると超絶便利だったので使うことにした。

そして当然の帰結として、 Migemo に対応させたくなった。

avy-migemo の存在は以前から知っていたけれど、色々な機能が提供されていてよく分からなかったのと、自分がやりたいユースケースだけ考えると複雑な仕組みは要らなさそうに思えたので、改めて avy の仕組みを調べて設定しようと考えた。

やりたき事

avy には色々な使い方がある。

1文字だけで候補を表示したり、2文字まで入力出来るようにしたり。一定時間以内に入力された文字を候補とする、というような機能もある。

migemo との組み合わせを考えると、固定の文字数よりは任意の文字数入力出来るのが望ましい。

上記を踏まえると、 一定時間以内に入力された文字を migemo に食わせて得られた正規表現にマッチする物を候補とする ような動きが実現出来るとよさそうだった。

`avy-goto-char-timer`

avy に組込まれている「一定時間以内に入力された文字を候補とする」関数定義を見てみる:

(defun avy-goto-char-timer (&optional arg)
 "Read one or many consecutive chars and jump to the first one.
The window scope is determined by `avy-all-windows' (ARG negates it)."
 (interactive "P")
 (let ((avy-all-windows (if arg
 (not avy-all-windows)
 avy-all-windows)))
 (avy-with avy-goto-char-timer
 (setq avy--old-cands (avy--read-candidates))
 (avy-process avy--old-cands))))

案外短い。

キモは avy--read-candidates で、こいつはオプショナルで文字列から正規表現を作る関数を指定出来る。ここで migemo-get-pattern を食わせてやればいい。

migemo を使って候補を表示する独自関数

というわけで冒頭の独自関数を定義する:

(defun avy-goto-migemo-timer (&optional arg)
 (interactive "P")
 (let ((avy-all-windows (if arg
 (not avy-all-windows)
 avy-all-windows)))
 (avy-with avy-goto-migemo-timer
 (setq avy--old-cands (avy--read-candidates #'migemo-get-pattern))
 (avy-process avy--old-cands))))

avy-goto-char-timer をほんの一部書き換えただけ。

デフォルトだと候補のキーは文字に重ねて表示されるが、 migemo で引っ掛けたいような文字は入力した文字とは異なる場合が多い。そのため重ねずに前方に表示するようにしたいため、明示的にスタイルを設定しておく:

(add-to-list 'avy-styles-alist '(avy-goto-migemo-timer . pre))

counsel-rg と migemo を組み合わせて ripgrep でもローマ字検索

Mon, 25 May 2020 06:51:00 +0900

Ivy (Swiper) で雑に migemo を使うの続編。併せて参照のコト。

TL;DR

(setq migemo-options '("--quiet" "--nonewline" "--emacs"))
(setq ivy-re-builders-alist '((t . ivy--regex-plus)
 (counsel-rg . ytn-ivy-migemo-re-builder)
 (swiper . ytn-ivy-migemo-re-builder)))

counsel-rg の仕組み

Emacs で使える正規表現と rg に渡せる正規表現は異なるのに、そもそも一体どうやって counsel-rg が実現されているかを確認した。

すると、 counsel--elisp-to-pcre という関数で、 Emacs 式正規表現を PCRE (Perl Compatible Regular Expressions) にベストエフォートで変換してくれている。

migemo(cmigemo) が出力する正規表現と、 PCRE 非互換の問題

デフォルトでは以下のような正規表現が出力される:

$ cmigemo -d '/usr/local/Cellar/cmigemo/20110227/share/migemo/utf-8/migemo-dict' --quiet --emacs --word wagahai
\(ﾜ\s-*ｶ\s-*ﾞ\s-*ﾊ\s-*ｲ\|ワ\s-*ガ\s-*ハ\s-*イ\|吾\s-*\(輩\|が\s-*輩\)\|我\s-*\(輩\|が\s-*輩\)\|わ\s-*が\s-*は\s-*い\|ｗ\s-*ａ\s-*ｇ\s-*ａ\s-*ｈ\s-*ａ\s-*ｉ\|w\s-*a\s-*g\s-*a\s-*h\s-*a\s-*i\)

これは、空白や改行を挟んでいてもマッチするようにするため。

この \s- というのは Emacs 独自のもので、シンタックステーブルを利用したマッチの仕組み:

‘\sCODE’
 matches any character whose syntax is CODE. Here CODE is a
 character that represents a syntax code: thus, ‘w’ for word
 constituent, ‘-’ for whitespace, ‘(’ for open parenthesis, etc. To
 represent whitespace syntax, use either ‘-’ or a space character.
 *Note Syntax Class Table::, for a list of syntax codes and the
 characters that stand for them.

\s- は構文上ホワイトスペース扱いされる文字にマッチする。

これは当然、他の正規表現エンジンでは使えない。

PCRE では \s がホワイトスペースにマッチするので(参考: pcrepattern specification)、 \s- を \s で置換する、という手もあるけれど、そもそも ripgrep や Swiper を使うときに、ホワイトスペースが間に挟まる場合を考慮したくなるということは少ないと思うので、複数行を考慮させないようにするという方向で調整したい。

migemo(cmigemo) で複数行に渡る文字列を考慮しないようにする

そのものズバリなオプションが用意されている:

-n --nonewline Don't use newline match.

このオプションを指定すると、出力される正規表現は以下のようになる:

cmigemo -d '/usr/local/Cellar/cmigemo/20110227/share/migemo/utf-8/migemo-dict' --quiet --emasc --nonewline --word wagahai
(ﾜｶﾞﾊｲ|ワガハイ|吾(輩|が輩)|我(輩|が輩)|わがはい|ｗａｇａｈａｉ|wagahai)

あとは、このオプションを migemo-options に指定すればよい:

(setq migemo-options '("--quiet" "--nonewline" "--emacs"))

なお、すでに migemo-init している場合は反映されないので、その場合は一度 migemo-kill する必要がある。

Ivy (Swiper) で雑に migemo を使う

Thu, 21 May 2020 04:50:00 +0900

27, 2021 最終更新

Note

counsel-rg と migemo を組み合わせて ripgrep でもローマ字検索も併せて参照。

TL;DR

(reqiure 'dash)
(require 's)

(defun ytn-ivy-migemo-re-builder (str)
 (let* ((sep " \\|\\^\\|\\.\\|\\*")
 (splitted (--map (s-join "" it)
 (--partition-by (s-matches-p " \\|\\^\\|\\.\\|\\*" it)
 (s-split "" str t)))))
 (s-join "" (--map (cond ((s-equals? it " ") ".*?")
 ((s-matches? sep it) it)
 (t (migemo-get-pattern it)))
 splitted))))

(setq ivy-re-builders-alist '((t . ivy--regex-plus)
 (swiper . ytn-ivy-migemo-re-builder)))

背景

Swiper で migemo を使おうと思ってググると avy-migemo での設定例しか出てこない。

個人的には avy を使っていない(使えていない)のと、 Swiper を使いたいのに avy が絡んでくるっていうのがよく分からなかったので利用するのが憚られた。

そこで、 ivy の仕組みをちゃんと理解してやってみようと思った。

migemo の仕組み

migemo 自体の仕組みは超単純で、 Migemo: ローマ字のまま日本語をインクリメンタル検索で解説されている通り:

利用者が 1文字入力するたびに、ローマ字列から正規表現を生成して、それで検索するという力技な方法です。

この正規表現を取得するには migemo-get-pattern を使う:

ELISP> (migemo-get-pattern "ebihurai")
"\\(ｴ\\s-*ﾋ\\s-*ﾞ\\s-*ﾌ\\s-*ﾗ\\s-*ｲ\\|エ\\s-*ビ\\s-*フ\\s-*ラ\\s-*イ\\|海\\s-*老\\s-*フ\\s-*ラ\\s-*イ\\|え\\s-*び\\s-*ふ\\s-*ら\\s-*い\\|ｅ\\s-*ｂ\\s-*ｉ\\s-*ｈ\\s-*ｕ\\s-*ｒ\\s-*ａ\\s-*ｉ\\|e\\s-*b\\s-*i\\s-*h\\s-*u\\s-*r\\s-*a\\s-*i\\)"

ivy の仕組み

ivy-read という関数が、入力からいい感じの正規表現を使って検索してくれるフロントエンド。

そこで使われる正規表現は、 ivy-alist-setting を通して ivy-re-builders-alist から取得される。

Swiper の場合はこんな感じ:

(ivy-read
 "Swiper: "
 candidates
 :initial-input initial-input
 :keymap swiper-map
 :preselect preselect
 :require-match t
 :update-fn #'swiper--update-input-ivy
 :unwind #'swiper--cleanup
 :action #'swiper--action
 :re-builder #'swiper--re-builder
 :history 'swiper-history
 :caller 'swiper)

migemo を使いたいのは今のところ Swiper だけなので、 'swiper をキーにして独自関数を設定すればいい。

(setq ivy-re-builders-alist '((t . ivy--regex-plus)
 (swiper . ytn-ivy-migemo-re-builder)))

migemo を使って検索する独自関数

Swiper はスペースで区切って雑に絞り込んでいけるというのが最大の(個人的な)メリットなので、最低限それを実現出来ればよかった。

実は ! で exclude を実現出来たり色々他にも気の効いた機能があるみたいだけれど、自分は使っていない(そこまで使いこなせてない)。

なので、空白や正規表現っぽい入力は as-is にして、それ以外の入力を migemo に食わせてやり、最後に空白を .*? に変換して結合した文字列を最終的な正規表現とする。

というのを実現しようとするとこんな感じになる:

(defun ytn-ivy-migemo-re-builder (str)
 (let* ((sep " \\|\\^\\|\\.\\|\\*")
 (splitted (--map (s-join "" it)
 (--partition-by (s-matches-p " \\|\\^\\|\\.\\|\\*" it)
 (s-split "" str t)))))
 (s-join "" (--map (cond ((s-equals? it " ") ".*?")
 ((s-matches? sep it) it)
 (t (migemo-get-pattern it)))
 splitted))))

MacBook Pro (Retina, 15-inch, Mid 2012) で macOS と Xubuntu 19.10 Eoan Ermine をデュアルブートする

Thu, 13 Feb 2020 07:01:00 +0900

前提
パーティションの分割
起動用USBドライブの作成
Xubuntu インストール
Xubuntu 初期設定
参考にしたリンク集

前提

MacBook Pro の種類は 15インチMacBook Pro Retinaディスプレイモデル：2.6GHz
- OS は OS X El Capitan
Xubuntu は Xubuntu 19.10 Eoan Ermine
- 目玉は improved HiDPI support

パーティションの分割

まず FileVault が有効な状態ではパーティション操作が出来ない ので、システム設定から解除する。解除するだけで数時間かかるので気長に待つ。

FileVault の無効化が済んだら、 Mac 用ディスクユーティリティを使って Xubuntu インストール用のパーティションを用意する。

初期状態だとパーティション作成メニューが選択出来ないので、 No partition scheme option when erasing a USB disk in MacOS High Sierra? - Ask Different を参考に全てのデバイスを表示し、 ボリュームではなくディスクを選択 する。

今回は単純に半分を mac に、もう半分を Xubuntu で使うように二等分した。パーティション追加時の初期状態のまま。

このパーティション分割も数時間かかるので気長に待つ。

起動用USBドライブの作成

xubuntu-19.10-desktop-amd64.iso を Xubuntu 公式サイトからダウンロードする。

Create a bootable USB stick on macOS | Ubuntu を参考に、 Etcher で上記の OS イメージを焼く。

用意したのは容量 2GB という骨董品レベルの USB スティックドライブだったが、問題なく動いた。

Xubuntu インストール

Startup Manager を起動し、上記の起動USBドライブを挿入する。

すると下の画像のように黄色い EFI Boot という名前のドライブが出現するので、これを選択する。

何故か二つ出現することがあるのだが、どちらを選んでも大丈夫そうだった。

初期状態では Wi-Fi が使えない はずなので、 Rankie の有線LAN アダプタなどドライバのインストール不要な適当な USB イーサネットアダプタを用意しておく必要がある。

インストール時に グラフィックスとWi-Fiハードウェアと追加のメディアフォーマットのサードパーティ製ソフトウェアをインストールする をチェックしておくと、初回起動時から Wi-Fi が使えるようになる模様。

いずれにしても有線環境は必要。

SwapFaq - Community Help Wiki を参考に以下のように swap パーティションだけ用意したが、別に要らなかったかもしれない。あとから SwapFile を追加することも出来るようだし。

ブートローダをインストールするデバイス は Xubuntu のルートパーティションを選択した。

インストール完了後はデフォルトで Xubuntu が起動するようになる。

変えたくなったら再び Startup Manager を起動すればよい。

Xubuntu 初期設定

キーテーマをEmacs風(macOS風)にする

xfconf-query -c xsettings -p /Gtk/KeyThemeName -s Emacs

タッチパッドの設定(ナチュラルスクロール、水平スクロール)

以下のようなシェルスクリプトを作成し、 セッションと起動 メニューからログイン時に実行するように設定する。

#!/usr/bin/env bash

synclient VertScrollDelta=-$(synclient | grep VertScrollDelta | awk '{print $3}')
synclient HorizTwoFingerScroll=1
synclient HorizScrollDelta=-$(synclient | grep HorizScrollDelta | awk '{print $3}')

ソースコード 1: fix_scroll.sh

キーボードの設定(ファンクションキーの有効化)

echo 'options hid_apple fnmode=2' | sudo tee -a /etc/modprobe.d/hid_apple.conf

macOS Dock 風のランチャ(Plank)

シンプルな Dock 風のランチャ Plank をインストールし、 セッションと起動 メニューからログイン時に実行するように設定する。

sudo apt install plank

Alfred, Spotlight 風のランチャ(Albert)

Alfred や Spotlight のような使い心地のランチャ Albert をインストールし、 セッションと起動 メニューからログイン時に実行するように設定する。

curl https://build.opensuse.org/projects/home:manuelschneid3r/public_key | sudo apt-key add -
echo 'deb http://download.opensuse.org/repositories/home:/manuelschneid3r/xUbuntu_19.10/ /' | sudo tee /etc/apt/sources.list.d/home:manuelschneid3r.list
apt update
apt install albert

Cica フォントの追加

miiton/Cica: プログラミング用日本語等幅フォント Cica(シカ) をインストールする。

wget https://github.com/miiton/Cica/releases/download/v5.0.1/Cica_v5.0.1_with_emoji.zip
unzip Cica_v5.0.1_with_emoji.zip
sudo mv *.ttf /usr/local/share/fonts/
sudo fc-cache -fv

asdf のインストールと設定

asdf をインストールし、プラグインに必要なパッケージをインストールする。

sudo apt install \
 automake autoconf libreadline-dev \
 libncurses-dev libssl-dev libyaml-dev \
 libxslt-dev libffi-dev libtool unixodbc-dev \
 unzip curl \
 libbz2-dev libreadline-dev libsqlite3-dev -y

Emacs のインストールと設定

GNU Emacs をインスールし、利用するパッケージをインストールする。

sudo apt install build-essential texinfo aspell ripgrep cmigemo -y
sudo snap install emacs --classic

ターミナル関連の設定

wget -qO - https://apt.thoughtbot.com/thoughtbot.gpg.key | sudo apt-key add -
echo "deb https://apt.thoughtbot.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/thoughtbot.list
sudo apt-get update
sudo apt install rcm curl fzf fasd tmux powerline -y
curl -sL --proto-redir -all,https https://raw.githubusercontent.com/zplug/installer/master/installer.zsh | zsh

fzf は /usr/share/doc/fzf/README.Debian にある指示に従う。

git の認証ヘルパ設定

sudo apt-get install libsecret-1-0 libsecret-1-dev
(cd /usr/share/doc/git/contrib/credential/libsecret/ && sudo make)
echo -e "\n[credential]\n helper = /usr/share/doc/git/contrib/credential/libsecret/git-credential-libsecret\n" >> ~/.gitconfig.local

HiDPI への対応

全般

外観 メニューで 設定 タブの ウィンドウ拡大縮小 を 2倍 に設定する。

/etc/environment に以下を追記する。

GDK_SCALE=2
QT_AUTO_SCREEN_SCALE_FACTOR=0
QT_SCALE_FACTOR=2

Emacs

フォントサイズが小さいままなので、サイズ指定を倍にすることで暫定対応。

ただ、画像やモードラインの高さなどが小さいままなので、対応検討中。

GIMP

テーマ設定でフォントを大きくするしかない。

cp -r /usr/share/gimp/2.0/themes/Dark ~/.config/GIMP/2.10/themes/MyDark

等で元になるテーマをコピーし、以下のような指定を追記(コメントアウトを解除)する。

gtk-font-name = "Noto Sans Regular 18"
font_name = "Noto Sans Regular 18"

参考にしたリンク集

Hugo Academic でダーク・ライト両モードに対応した Chroma によるシンタックスハイライト

Fri, 24 Jan 2020 08:37:00 +0900

前提
Academic 標準のコードハイライトを無効にする
Hugo のコードハイライトを有効にする
ダークモード用とライトモード用の Chroma スタイルを決める
- light スタイル
- dark スタイル
Chroma 用の CSS を生成する
Academic のテーマと競合しないようにする

前提

Academic テーマのデフォルト設定はドキュメントにもある通り highlight.js を使ったもので、この仕組みに乗っておけば基本的には問題ありません。

ただし highlight.js には一つ問題があって… EmacsLisp に対応していません (Lisp には対応)。具体的には with-eval-after-load のような独自のマクロや、 DocString 中のクオテーションといった EmacsLisp 方言には対応出来ません。

一方、 Hugo 標準の Syntax Highlighting は Chroma を使ったもので、こちらは EmacsLisp に対応しています 。

(ox-hugo の作者さんが過去に Issue に挙げてくれていた模様…感謝 🙏)

CodePen と Chroma Playground とでそれぞれの出力結果を比べてみるとよく分かります:

(defvar hoge "fuga"
 "Doc String 中の `QUOTE' はどうなるかな？")

(with-eval-after-load 'foo
 (unless (eq t nil) "EmacsLisp 独自キーワードはどうなるかな？")

ソースコード 1: 元のコード

図1: highlight.js w/ GitHub style

図2: Chroma w/ GitHub style

そこで、 Academic を使いつつ、 Hugo 標準のハイライトの仕組みを使いたい というのが動機となります。

Academic 標準のコードハイライトを無効にする

ドキュメントに書かれている通り、 config.toml で params.highlight オプションを無効にする必要があります。

Academic Kickstart をベースにしている場合、 params.toml で以下のように設定します:

# Enable source code highlighting? true/false
# Documentation: https://sourcethemes.com/academic/docs/writing-markdown-latex/#highlighting-options
highlight = false

ソースコード 2: params.toml

Hugo のコードハイライトを有効にする

Academic Kickstart をベースにしている場合、 config.toml で以下のように Hugo のコードハイライトが無効にされていると思います:

[markup.highlight]
 codeFences = false # Disable Hugo's code highlighter as it conflicts with Academic's highligher.

これを以下のように変更します:

[markup.highlight]
 codeFences = true
 noClasses = false

noClasses = false としているのは、 ダーク・ライトの両方のモードに対応させるため です。 noClasses が true の場合、スタイル指定が HTML 中に埋め込まれます。これだとモードの変更に追従して動的にスタイルを変更するということが出来ないため、 CSS クラスだけを HTML に埋め込んでもらうようにします。

ダークモード用とライトモード用の Chroma スタイルを決める

Chroma Style Gallery ギャラリーを参考に、 ダークモード時に使うスタイルとライトモード時に使うスタイルをそれぞれ決めます 。モードの切り替わりに応じて、シンタックスハイライトのスタイル自体を変更してしまいます。

選定の際の注意事項として、 スタイルによって細かいクラス指定に対応していない場合があります 。

具体的には、 EmacsLisp の defvar などは NameBuiltin としてパースされ、 .nb というクラスが指定されるのですが、これが含まれていないスタイルがいくつかあります。

参考までに、調査した結果を以下に列挙します:

light スタイル

`NameBuiltin` が含まれるもの

`NameBuiltin` が含まれないもの

dark スタイル

`NameBuiltin` が含まれるもの

`NameBuiltin` が含まれないもの

Chroma 用の CSS を生成する

スタイルを決めたら以下のように CSS を生成します。生成された CSS は標準出力に吐き出されるため、適当なファイルにリダイレクトするか、 pbcopy 等にパイプしてクリップボードに格納しましょう:

hugo gen chromastyles --style=pygments
hugo gen chromastyles --style=native

この後多少手を加える必要があるので、やりやすいように CSS 2 SASS/SCSS CONVERTER 等で SCSS に変換しておくとよいです。

Academic のテーマと競合しないようにする

生成した CSS(SCSS) は Academic のドキュメントに従い custom.css に追加します。

ただし、Academic には標準のハイライトのためのスタイル指定があるため、 Chroma が生成したスタイル指定をそのまま組込むと若干コンフリクトします。

そこで、多少手を加えてやります。

まずライトモード時のスタイルについては、 background-color や color が指定されていない場合があるため( pygments 等)、 Chroma Playground の出力結果を参考にしてスタイル指定を追加します。

また、 Academic 組込みの code へのスタイル指定より優先度が高くなるように、セレクタを pre.chroma, .chroma code とします。

最終的に以下のようになります:

pre.chroma, .chroma code {

 background-color: #f5f5f5;
 color: #4a4a4a;

次にダークモード時のスタイルについては、基本的に background-color や color も指定されていると思うので、セレクタのみ .dark pre.chroma, .dark .chroma code としてあげます。

以上で、 Hugo Academic を使いつつ、 Chroma でシンタックスハイライト が実現出来ました。

GitHub Pages + Cloudflare から Netlify に移行した

Mon, 13 Jan 2020 00:00:00 +0000

この記事にあるとおり、当初このサイトは GitHub Pages でホストされ、 Cloudflare CDN を利用して配信していた。

だが先日テーマを変えたときに、既に使われていないリソースがそのまま残ってしまっていることに気がついた。単純に /public 以下を git add -a しているだけなので、明示的に消さなければ反映されなくて当然だった。

デプロイスクリプトを見直してもよかったが、 Hugo 自体が Netlify でホストされているし、 Netlify でホストするときの公式ドキュメントも用意されているし、アセットの最適化機能とかもついてくるし、何より無料だし、ということで、移行することを決めた。

デプロイ手順
ドメイン移行手順
GitHub Pages で提供していたその他のリポジトリのリダイレクト設定手順
その後

デプロイ手順

公式ドキュメントを超ざっくり要約すると、

Netlify でアカウント作成
netlify.toml をドキュメントを参考に配置
連携する GitHub リポジトリを選択
Deploy site ボタンをポチる

以上。

これだけで hoge.netlify.com でアクセス出来るようになる。いい時代になった。

ドメイン移行手順

ただドメインも移行する場合はもう一手間必要で、Netlify の公式ドキュメントに従って DNS レコードの設定をする必要がある。

Cloudflare の場合は、以下のように Cloudflare のダッシュボードで、各ドメインが Netlify への CNAME となるように設定する。

このとき、 Proxy status が DNS only となるように (雲のアイコンがオレンジではなくグレーになるように) 設定する必要がある。

さもないと、 Cloudflare の CDN 機能が間に挟まってしまい、 Netlify 側から認識されない。

なお、 DNS only にした時点で Cloudflare が発行した SSL 証明書は無効になる 。そのため、ここからなるべく早く Netlify 側の SSL 証明書の設定をした方がいい。

当サイトの場合は設定してから1時間もしない内に SSL 証明書が有効になっていた。

GitHub Pages で提供していたその他のリポジトリのリダイレクト設定手順

サイトだけなら以上で万事完了なのだけれど、 GitHub Pages を利用していた場合の注意点として、 github.io リポジトリで CNAME を設定していた場合、それ以外で Pages 機能を利用しているリポジトリも同様のドメインでアクセスされるようになっている。つまり、 github.io を Netlify へ向けた時点で、 それ以外のリポジトリが全てリンク切れとなる。

そのため、適切にリダイレクトするようにしなければならない。

Netlify の公式ドキュメントに従ってやればいい…と思ったのだけれど、原因は不明だが netlify.toml で設定しようとしても反映されなかった 。

最終的な _redirects ファイルの内容は以下のようになった:

https://yewton-net.netlify.com/* https://www.yewton.net/:splat 301!

/swagger-top-down-playground/* https://yewton.github.io/swagger-top-down-playground/:splat 301!
/dockerfiles/* https://yewton.github.io/dockerfiles/:splat 301!
/kafka-doc-ja/* https://yewton.github.io/kafka-doc-ja/:splat 301!

その後

移行ついでに How to Configure Better Web Site Security with Cloudflare and Netlify | Okta Developer を参考に Security Headers や SSL Server Test で高評価になるように設定を見直したりなどした。

ただこれはあんまり理解しないで書かれてる通りやっただけなところがあるので、いつか改めて記事にしたい。

無料でいい感じのバナー用背景素材をダウンロード出来るフリー画像サービス 3 選

Mon, 13 Jan 2020 00:00:00 +0000

記事のバナー、アイキャッチ画像(Academic 的には Featured image)があると書く時のテンションが上がるので、出来るだけ設定するようにしたい。

でも出来るだけ手間はかけたくない…、そんな時に使っているサービスを順不同で挙げる。

なお、いずれのサービスにおいても、 geometric (幾何学模様)や abstract (抽象的)、あるいは network や programming といったワードで検索すると、いわゆる いい感じ な画像がヒットする。

Unsplash

Notion のカバーイメージ選択欄にあったので存在を知った。

Image by Ash Edmonds

License | Unsplash

FAQ ページより引用:

The photos on Unsplash are free to use and can be used for most commercial, personal projects, and for editorial use.

Pexels

Photo by by Webb from Pexels

License of our free stock photos - Pexels

FAQ ページより引用:

Yes, all photos and videos are free for commercial use. You can use them on your commercial website, blog, product or anywhere else.

すべての写真や動画は、商業コンテンツの一部として無料で利用できます。商業用のWebサイト、ブログ、製品、その他どんな場所にでも利用可能です。

Pixabay

Image by Gerd Altmann from Pixabay

Pixabay License

FAQ ページより引用:

You can copy, modify, distribute, and use the images, even for commercial purposes, all without asking for permission or giving credits to the artist. However, depicted content may still be protected by trademarks, publicity or privacy rights.

これらの画像は、商用、非商用を問わず、コピー、改変、再配布することができます。利用に関する許諾や使用料の支払いは必要ありません。しかし、画像の中には商標やパブリシティ権、プライバシー権などに基づき保護されているものが含まれます。

Lenovo Tab M8 が案外良かった

Sat, 11 Jan 2020 00:00:00 +0000

27, 2021 最終更新

さすがにもう Nexus 7 2012 でやっていくのはしんどくなってきたので、手軽なタブレットを探していたら、 2019 年の 11 月に Lenovo から Lenovo Tab M8 (ZA5G0084JP) が発売されていたのを知った。

2 万を切る価格で、 Android 9 、クアッドコアでメモリは 2 GB 、ディスプレイは 8.0 型ワイド IPS パネル (1280x800ドット)と、そこそこ使えそうなスペック。

ただストレージは 16GB と心許ないので、 microSD による拡張は必須(最大128GBまで)。自分はたまたま持ってた SanDisk 製の microSDXC カードを使っている。アプリ最適化対応じゃないので少々もっさりはするけれど、使えない程ではない。

電子書籍が読めればいいやというくらいの気持ちで購入したのだけれど、意外なことに 音がいい 。

確かに公式サイトには以下のようにあるけれども、正直期待していなかった。

鮮やかでシームレスな映像表示を実現する狭額縁による高画面占有率83％のマルチタッチ対応の8.0型ワイドIPSパネル、ドルビーオーディオ対応のオーディオ機能を搭載。鮮明な映像と臨場感のあるサウンドで、お気に入りのビデオのストリーミングやモバイルゲームを楽しめます。

Sony WH-XB900N を Bluetooth 接続で聴いているが、手持ちの Pixel 3 XL に繋いだ場合と比較すると結構違う。そんなに大した耳を持ってるわけじゃないけど、低音がすごく心地良く響く感じ。

イコライザは以下のように設定している:

図1: Dolby Audio のイコライザ設定

意外と音が良いので色々やりたくなってしまい、年末にセールしていた FINAL FANTASY TACTICS 獅子戦争を買ってしまった。割と快適に動くので読書よりもゲームをやってしまう…。

図2: いつまでもゼクラス砂漠から出られない一行

そんなわけで案外良かった Lenovo Tab M8 だがおかしな挙動もあり、まず 再起動すると必ず「SDカードが見つからない」旨の通知が表示される 。

そして、 スクリーンショットの動作が安定しない 。上記の現象もスクリーンショットが保存できなかった。

一番うっとうしいのが、 横画面になる度に Lenovo Launcher が停止する こと。停止する度にダイアログが出るので邪魔。とはいえ「アプリを閉じる」を選択してしまえば以降差し支えなく使用は可能。

図3: 横画面になる度に表示されるうっとうしいダイアログ

Note

2020年1月20日に配信されたアップデートを適用したところ、少なくとも Lenovo Launcher が停止しました のダイアログは出なくなっていた。

Featured image background by Esther Jiao

org-mode に Chrome で開いてるページへのリンクを貼りたい

Fri, 10 Jan 2020 00:00:00 +0000

org-mode のリンクマークアップはちょっと特殊で、エスケープの仕様も独特です。

また、 2019年の12月にリリースされたバージョン 9.3 で後方互換性の無い仕様変更が入るということも有りました。

Version 9.3

Incompatible changes

Change bracket link escaping syntax Org used to percent-encode sensitive characters in the URI part of the bracket links.

Now, escaping mechanism uses the usual backslash character, according to the following rules, applied in order:

(defun org-link-unescape (link)
 "Remove escaping backslash characters from string LINK."
 (replace-regexp-in-string
 (rx (group (one-or-more "\\")) (or string-end (any "[]")))
 (lambda (_)
 (concat (make-string (/ (- (match-end 1) (match-beginning 1)) 2) ?\\)))
 link nil t 1))

ソースコード 1: (参考) org-mode 9.3 でのエスケープ実装

こういう背景もあり、 org-mode の外で工夫して org-mode 形式のリンクを生成するよりは、 org-mode 自体に任せてしまうのが安心です。

org-cliplink というパッケージもありますが、これだとログインが必要なページへのリンクは (Basic 認証を設定していなければ)生成出来ません。

もっと手軽に、 Chrome で見ているページへのリンクを挿入する手段として、 CreateLink という Chrome 拡張機能を使う方法があります。

以下のように改行区切りでコピーするような設定を追加します:

%text%%newline%%url%

CreateLink の %text% は改行をスペースに変換する仕様になっているので、区切り文字として改行を利用するのは安全なハズです。

そして、以下のような独自関数を定義します:

(require 's)

(defun ytn-org-insert-weblink ()
 (interactive)
 (let* ((pair (s-split "\n" (with-temp-buffer (clipboard-yank) (buffer-string))))
 (desc (first pair))
 (link (second pair)))
 (insert (org-make-link-string link desc))))

単純に改行で区切って org-make-link-string に渡すだけです。

これを、個人的には M-L にアサインしています(use-package の bind-key を利用しています):

(bind-key "M-L" #'ytn-org-insert-weblink org-mode-map)

以上、ちょっとした小ネタでした。

#MadeWithAcademic

Mon, 06 Jan 2020 00:00:00 +0000

Icarus がメンテされておらず Hugo 0.55.0 以降で正しく動かなくなっていたので、自力で Icarus にパッチを充てるか、別のテーマに乗り換えるかという選択を迫られていた。

せっかくなのでランディングページとブログを別にしたかったので、そういう柔軟性を備えている Academic というテーマを使うことにした。

テーマの変更にあたって様々な知見が得られたので、そのうち記事にしたい。

以下その候補:

Page Bundles への移行
ox-hugo と Academic が如何に相性がよいか
- auto weight あたりが最高
- lastmod の自動更新や Front-matter Extra は Academic じゃなても最高の体験
カスタムウィジェットの作り方
ダークテーマ対応のシンタックスハイライトのやりかた
conf-toml-mode を Front-matter Extra で使う方法

久々の更新

Thu, 02 Jan 2020 00:00:00 +0000

最近仕事用のmacを新調して環境を作り直す機会があったことと、 2020 年が始まるということもあり、久々にサイトを更新することにした。

オープン職務経歴書を書きたかった、というのもある。

更新にあたっていくつか困難があった。

まず、このサイトのソースが最近の Hugo では動かせなくなっていた。

このサイトのテーマには Icarus を使わせていただいているのだが、最終更新が 2017 年となっており、 Hugo 0.55.0 以降で動かなくなってしまっていたり、 Deprecated Warning が出るようになっていた。

PRは出されているのだけれど、マージされる様子が無い。

そもそも、当時のバージョンに対してカスタマイズしたレイアウトを作ってしまったので、単純なテーマの更新だけでは追随できない。

どのバージョンなら動くのか突き止めるのも骨が折れた。 asdf-gohugo を入れて、少しずつバージョンを上げながら確認していった。

asdf plugin add hugo https://bitbucket.org/mgladdish/asdf-gohugo

そして、そもそも Hugo の使い方を忘れていた。

Hugo 導入記事や Hugo 用 Emacs ライブラリを書いておいてなんだが、当時から3年も経ってほとんど忘れてしまっていた。

そこで改めて調べてみると、イマドキは org-mode で書くことも出来るらしい。

この3年ですっかり org-mode 無しでは生きられない体になってしまっていたし、せっかくなので本記事からは ox-hugo を使って書くことにする。

使い始めるにあたって色々調べたり考えたりすることも多かったので、そのうち記事にしようと思う。結論としては、org-mode と Hugo の組み合わせは最高だし、その橋渡しをしてくれる ox-hugo は本当にグッジョブだということ。

…

そんなこんなで色々対応していたものの、デプロイする仕組みなどは当時と変わりなく動いたのでその点は助かった。

org-mode で書けるようになったことだし、少しは記事を書いていきたい所だが、まずは Hugo の最新版に追従する作業が待っている…。

Nexus 7 2012 (grouper) に Beanstalk と ParrotMod を入れて蘇生する

Sun, 09 Apr 2017 21:55:31 +0900

最近はじめて Fire タブレットをキャンペーンで購入して、こういう本読むだけとか書い物するだけとかの単機能なタブレットも結構いいな、と思った。そして、うちに使ってない Nexus 7 があることを思い出した。

この Nexus 7 、どうして使っていなかったかというと、 Lollipop にアップデートしてしまったから。 Nexus 7 2012 は Lollipop にアップデートしてしまうと、動作が重過ぎて使い物にならなくなる。

どうせ使いものにならないなら、ということで SlimKat や PureNexus を焼いて使ってみたりもしたが、前者は軽いけど見た目や使用感がちょっと微妙( 4.4 ベースだし…)で、後者は使っていくうちにやっぱり重くなっていって駄目だった。

今回 Fire を買ってあらためて 7 インチの Android タブレットが欲しくなってしまったので、もう一度蘇生を試みることにした。

そして Reddit のこのスレを満つけ、そこから Speed up the Nexus 7 with F2FS and SlimKat という記事に辿り着いた。

元々は SlimKat と F2FS の記事だったようだが、2017 年に更新があり、 Beanstalk 6.0.1 と ParrotMod が勧められていた(執筆者自身は試していないようだったが)。

Beanstalk

CyanogenMod 13 (Marshmallow) をベースに作られたカスタム Rom 。フォーラムの記述によると、

Smoother than Butter
Friendly Battery
Tons of Features
DirtyUnicorns Features
Always Up-to-date
100% Build from Source

…らしい。

ParrotMod

Nexus 7 2012 をすげーいい感じにしてくれるやつ。

FLASH MEMORY SPEED INCREASE! up to 4x better performance WITHOUT F2FS OR DYNAMIC FSYNC

という速度の向上を筆頭に、様々な最適化を行って快適にしてくれるようだ。

結果

Amazon Kindle , YouTube 、Feedly , 1Password あたりを主に動かしているが、アプリ起動時にたまに固まることがあるものの、大抵一度タスクキルして起動し直せば問題なく動作している。娯楽用途としては十分な性能になった。

もし、使わなくなった Nexus 7 2012 がご家庭に眠っているのなら、 Beanstalk と ParrotMod を試してみる価値はアリだと思う。

Atlassian から無料でTシャツをもらう方法、あるいはドラゴンの倒し方

Sat, 03 Sep 2016 15:34:07 +0900

仕事で Atlassian 製品を使っていて、個人的にも便利なタスク・ドキュメント管理に欲しいな、と思い、を読んでいた。

すると気になるフレーズが目に入った。 「ドラゴンズレアとは何ですか？」 ──

6 つのスターターライセンスの統合スイートをセットアップすると素晴らしい結果になりますが、セットアップ手順は複雑で時間がかかります。アトラシアンでは、アトラシアンアプリケーションスイートを統合するため方法をドラゴンズレアという説明書にまとめました。また、この困難だけれども素晴らしい旅を完了された方全員向けに、限定版アトラシアンドラゴンスレイヤー T シャツを提供しています。今すぐ冒険を始めましょう! 勇気がある方はドラゴンに立ち向かいましょう!

せっかくもらえるもんなら、とドラゴン退治をすることにした。

Note

2017/1/20 時点の注意

どうやら現在、 Tシャツを要求するためのページが 404 になってしまっている ようす ( ) 。

せっかくやってもTシャツはもらえないかもしれないので注意。

Note

2017/2/5 時点の情報

どうやらサイトが復旧したようす

環境要件

ドキュメントには「最低 3 GB の RAM と 500 MB のアプリケーションファイル用の空き容量」とある。

しかし、実際にやってみたところ 3 GB では全てのアプリケーションを立ち上げることが出来なかった。最終的に 6 つのアプリケーションを稼動させることになるのだが、 5 つが限界だった。 最低 RAM は 4 GB は必要 だと思う。

またディスク容量に関しては、まっさらな環境に諸々構築したあとの総使用量が 6 GB 程だった。こちらも 最低ストレージは 10 GB は必要 だと思う。

自分はを利用して構築した。 Google Compute Engine の vCPU x 1 (メモリ 3.75 GB)の標準インスタンスを使ったが、前述の通りメモリが足りなくなってしまったので、 vCPU x 2 (メモリ 7.5 GB)のインスタンスを使う方がよいと思う。

OS は Debian GNU/Linux 8 (jessie) を使用した。

Here Be Dragons

それではに従って冒険を始めよう。

基本的には書かれてある通りにやればいいだけなのだが、いくつか自分が躓いたポイントがあるので紹介していきたい。

Step 1. Install Java

まず Java を用意しなければならないのだが、なんと Oracle JDK 1.7.x でなければならない。のだが、このクエストではこのバージョンしか想定していないようなので、大人しく従っておく。

wget --header "Cookie: oraclelicense=accept-securebackup-cookie" http://download.oracle.com/otn-pub/java/jdk/7u79-b15/jdk-7u79-linux-x64.tar.gz

Debian で Oracle Java を利用するにはにあるような作業が必要になる。

sudo sed -i 's/deb http:\/\/httpredir.debian.org\/debian\/ jessie main/deb http:\/\/httpredir.debian.org\/debian\/jessie main contrib/' /etc/apt/sources.list
sudo apt-get update -y && sudo apt-get install -y libgl1-mesa-glx libfontconfig1 libxslt1.1 libxtst6 libxxf86vm1 libgtk2.0-0 java-package
make-jpkg jdk-7u79-linux-x64.tar.gz
sudo dpkg -i oracle-java7-jdk_7u79_amd64.deb

Step 2. Install your PostgreSQL Database Server

こちらも 8.4.x. というバージョン指定がある。 Java と同様に既にしているため、 Debian のリポジトリでは配布されていない。そのため、リポジトリを追加してからインストールする必要がある。

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt-get update -y && sudo apt-get upgrade -y && sudo apt-get install -y postgresql-8.4

Step 3. Create your JIRA Database in PostgreSQL

Atlassian 製品はデータベースとして MySQL や PostgreSQL を利用出来る。ただ、日本語や絵文字などマルチバイト文字を扱う場合は PostgresSQL を使うのが無難なようだ( )。

個人的にあまり馴染みがないのだけれど、このドラゴンズレアでも PostgreSQL が指定されているので従っておく。

sudo -u postgres createuser -S -d -r -P -E jirauser
# パスワード入力
sudo -u postgres createdb --owner jirauser --encoding utf8 jira

Step 4. Install JIRA

JIRA のバージョンも指定されている。 6.3.15 を使う必要がある。

wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-6.3.15-x64.bin
chmod a+x atlassian-jira-6.3.15-x64.bin
sudo ./atlassian-jira-6.3.15-x64.bin

JIRA にはインストーラーがついているので簡単。

Step 5. Set Up JIRA, Step 6. Set up a Project and Create your JIRA Dashboard

あとはドキュメントに従って Web UI 上で操作を行えばよい。

もしかすると、以下のようなよく分からないエラーに遭遇するかもしれない。

let.ServletException: javax.servlet.jsp.JspTagException: Soy rendering failed for template '%s'.
説明 The server encountered an internal error that prevented it from fulfilling this request.
例外
org.apache.jasper.JasperException: javax.servlet.ServletException: javax.servlet.jsp.JspTagException: Soy rendering failed for template '%s'.

環境依存なのか、言語を日本語にしていた影響なのか分からないが、エラーが発生したらブラウザをリロードすれば大体直っていた。

ドキュメントに従うだけで特に問題はないが、 Capture for JIRA を動かそうとしたときに以下のエラーが出ていた。

Your Bonfire license has expired. Please visit My Atlassian to renew

ボンファイアとはなんのこったい、と思ったのだが、どうやら Capture for JIRA のことらしい。インストール後のアクティベーションが正常に終わっていなかったようだった。改めて管理画面から評価用ラインセンスを払い出してことなきを得た。

Step 1. Create your Confluence Database in PostgreSQL

JIRA のときと同様に行う。

sudo -u postgres createuser -S -d -r -P -E confuser
sudo -u postgres createdb --owner confuser --encoding utf8 confluence

Step 2. Install Confluence

インストールまでは以下の通り:

wget https://www.atlassian.com/software/confluence/downloads/binary/atlassian-confluence-5.7.1-x64.bin
chmod a+x atlassian-confluence-5.7.1-x64.bin
sudo ./atlassian-confluence-5.7.1-x64.bin

この後、

Because Confluence will be running on the same machine as JIRA (already installed), you need to ensure that the URL paths are different for Confluence and JIRA.

という理由で設定ファイルを一部いじる必要がある。以下のように一旦 Confluence を停止、設定を修正して再起動する:

sudo /opt/atlassian/confluence/bin/stop-confluence.sh
sudo sed -i 's/<Context path=""/<Context path="\/confluence"/' /opt/atlassian/confluence/conf/server.xml
sudo /opt/atlassian/confluence/bin/start-confluence.sh

Step 3 以降

ドキュメントに従って進めれば問題ないはず。

ドキュメントに従って Web UI を操作すれば 👌 。

Step 1. Install Mercurial

sudo apt-get -y install mercurial

Step 2. Create your FishEye Database in PostgreSQL

これまでと同様に行う:

sudo -u postgres createuser -S -d -r -P -E fishuser
sudo -u postgres createdb --owner fishuser --encoding utf8 fisheye

Step 3. Install FishEye and Crucible

インストーラーが無いので若干手順が複雑になる。

まず必要なファイルをダウンロードして展開する:

wget https://www.atlassian.com/software/fisheye/downloads/binary/fisheye-3.7.0.zip
sudo unzip -d /opt/atlassian/ fisheye-3.7.0.zip

アプリケーションのデータディレクトリを作成する。他のアプリケーションに合わせて /var/atlassian/application-data/fecru にする:

sudo mkdir /var/atlassian/application-data/fecru

FISHEYE_INST という環境変数が上記のデータディレクトリを指すようにする:

sudo sh -c 'echo "export FISHEYE_INST=/var/atlassian/application-data/fecru" > /etc/profile.d/fecru.sh'
source /etc/profile.d/fecru.sh

設定ファイルを一部修正しつつ配置する:

sudo cp /opt/atlassian/fecru-3.7.0/config.xml /var/atlassian/application-data/fecru/
sudo sed -i 's/<web-server>/<web-server context="\/fisheye">/' /var/atlassian/application-data/fecru/config.xml

Fecru サービスを稼動させるためのユーザーを作成する:

sudo useradd -m -c 'Atlassian FishEye/Crucible' fecru

権限を適切に修正し、サービスを立ち上げる:

sudo chown fecru -R /opt/atlassian/fecru-3.7.0/
sudo chown fecru -R /var/atlassian/application-data/fecru/
nohup sudo -u fecru /opt/atlassian/fecru-3.7.0/bin/run.sh &

本来は systemd とかでちゃんとサービス化した方がいいと思う 😟

Step 4 以降

ドキュメントに従えば 👌

にあるように、恐らく FishEye の Site URL を設定してからでないと JIRA リンクが上手く動かないので、まず FishEye 上で Administration -> Global Settings -> Server から Site URL を設定しておく。

あとはドキュメントの手順通り設定を行えばよい。

ドキュメントの通りで 🆗

Step 1. Create your Bamboo Database in PostgreSQL

これまでと同様:

sudo -u postgres createuser -S -d -r -P -E bamuser
sudo -u postgres createdb --owner bamuser --encoding utf8 bamboo

Step 2. Install Bamboo

Fecru と同様にこちらもインストーラーが無いので複雑な手順が必要になる:

sudo -u postgres createuser -S -d -r -P -E bamuser
sudo -u postgres createdb --owner bamuser --encoding utf8 bamboo
wget https://www.atlassian.com/software/bamboo/downloads/binary/atlassian-bamboo-5.3.tar.gz
sudo useradd -m -c 'Atlassian Bamboo' bamboo
sudo tar -C /opt/atlassian -zxvf atlassian-bamboo-5.3.tar.gz
sudo chown bamboo -R /opt/atlassian/atlassian-bamboo-5.3
sudo sh -c 'echo "bamboo.home=/home/bamboo" > /opt/atlassian/atlassian-bamboo-5.3/atlassian-bamboo/WEB-INF/classes/bamboo-init.properties'
sudo sed -i 's/<Context path=""/<Context path="\/bamboo"/' /opt/atlassian/atlassian-bamboo-5.3/conf/server.xml
sudo -u bamboo /opt/atlassian/atlassian-bamboo-5.3/bin/start-bamboo.sh

Step 3. Set Up Bamboo

まず Maven 3 の環境を整える必要がある。ドキュメントの指示通りをインストールする:

sudo sh -c 'echo "deb https://sdkrepo.atlassian.com/debian/ stable contrib" > /etc/apt/sources.list.d/atlassian.list'
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys B07804338C015B73
sudo apt-get install -y apt-transport-https
sudo apt-get -y update
sudo apt-get install -y atlassian-plugin-sdk

あとはドキュメント通りに進めればよいが、 Maven Executable のパスを指定する箇所は /usr/share/atlassian-plugin-sdk-6.2.9/apache-maven-3.2.1 のように指定しなければならない(ドキュメントには /usr/local/Atlassian/atlassian-plugin-sdk/apache-maven とあるがそこには無い)。

ドキュメントの指示通り JIRA に Bamboo ガジェットを追加すれば完了。

The Battle is Won, the Dragon is Slain!

Tシャツを要求する

ページの指示通りやると、クーポンコードがもらえるので、それを使って注文すればいい。

自分の注文情報はこんな感じ:

注文してから 1〜2 週間で届くらしい。

三ヶ月以上ぶりに何かを書く

Mon, 29 Aug 2016 22:29:35 +0900

前回の更新から三ヶ月以上経ってしまった。月日が経つのは早いものだ。

まとめたいことがいくつかあるので、まとめておく。

Atlassian からTシャツをタダでもらう方法

Atlassian の製品のセットアップを公式ドキュメントに従って行うとTシャツが貰える。

実際もらえたのでやり方をまとめたい。

無料のプライベート Wiki は Google Sites が最強な気がする

Atlassian の構築はそもそも個人的に家庭で Confluence 的なのを使いたかったので手を出したものだった。

とはいえ金がかかるのでいい方法は無いかと探していたら、 Google Sites に辿りついた。

`org-publish` で気軽に Web サイトを作る

無料のプライベート Wiki を探している過程で org-publish にも手を出した。

プライベートにするのが面倒だったので諦めたけれど、 org-mode で書いた内容を、見た目もほぼそのまま公開出来るというのは便利かもしれないのでまとめたい。

helm から ivy に移行したい

helm が活発過ぎて周辺エコシステムが付いていけないとか、 ivy の方が軽量でよいとかいう話を聞くので、 ivy に移行してみたい。

ヘビーに helm 使ってるわけでないので、さくっと乗り換えたい気持ち。

IFTTT Do Button で定型文を Slack に投稿する

普通に使ってると、IFTTT はひとつの Slack Team としか連携出来ないので、 MAKE をアクションにして Web Hook でどうにかした話をまとめたい。

Spacemacs から helm と persp-mode の設定をパクろうと思ったけど難しかった

Wed, 04 May 2016 19:45:26 +0900

この辺を参考にせよ、と persp-mode 公式に書いてあったので、パクれそうかやってみた。

結論としては、出来なかった。なので、併せて記載されていたこっちの設定を使う状態のまま。

Spacemacs の設定は、 Spacemacs 独自のステートの概念(Vimmer が喜ぶやつ)と密接に関連しているようで、素の Emacs に組込むのは骨が折れそうだった。

そもそも何で Spacemacs の設定をパクろうとしていたかというと、後者の設定だと、 C-x b したときに前のバッファが選択されずに現在のバッファが選択された状態になるのが違和感があったから、だった。素の Emacs では単に C-x b RET としたときは、前のバッファに戻るという挙動になる。もしかしたら Spacemacs では元の挙動を再現した実装になっているのかもしれない、と思って見てみたが、前述の通り失敗に終わった。

persp-mode では、直前のバッファが現在のパースペクティブに含まれているとは限らないから、仕方ないのかな…。

『いけにえと雪のセツナ』感想

Wed, 04 May 2016 16:10:11 +0900

この間 Amazon で『いけにえと雪のセツナ』が 2,000 円だったので買ってみた。

曰く、「あの頃、みんなRPGに夢中だった。当時遊んだ数多のRPGは、今もぼくたちの記憶に強く残っている。パーティ編成、街での買い物、ダンジョン攻略、ギリギリで倒した強敵たち。そして、エンディングで流した涙－。名作たちが与えてくれた感動は、今もなお色褪せない。とりもどそう、ぼくたちのRPG。」

…凄い売り文句だ。

バトルシステムはあのクロノ・トリガーをベースにしているらしい。否が応にも期待値が高まる謳い文句だ。高まりすぎて不安になる。

ネットのレビューを見てみると、やっぱりその期待値とのギャップに落胆している人が多いように見受けられた。個人的には、単体のゲームとしてみればすごく楽しかったし、確かに荒削りな部分もあったけれど、今後に大いに期待したくなる内容だったと思う。

Tokyo RPG Factory は、こういう意欲的な作品を今後も是非リリースしていって欲しい。いちユーザーとしてそう強く願う。

個人的にプレイしていて色々と思うところがあったので、まとめておきたくなったのでまとめる。ネタバレ全開。

(開発者の)制限プレイ

なんといっても本作、雪国しか出てこない。

本当にずーっと雪景色で、たまに古代遺跡の石畳を見るくらい。プレイ時間の大部分は白い画面と向きあうことになる。

さらに、音楽はピアノオンリーである。さすがにバトルシーンでは多少パーカッションやベースが入ったりもするが、ピアノが常にメインとなる。ピアノフォルテの面目躍如といったところ。

こういう制限のなかで、いかに面白く見せられるか、というところに挑戦する姿勢が、ファミコン時代の同時発色数4色、音は3音+ノイズだけだったころと通じるものを感じた。やっぱり、日本人は限られたリソースの中で工夫してよいものを作るっていうのが、得意とするところなんじゃないかなぁ、などと日本人観に思いを馳せてみたりもした。舞台が雪国っていう中で、火属性無双にならないようにとか、魔物のデザインとか、すごく苦労したんじゃないかと思う。

この制限が、結果としてよい方向にいったわけでは必ずしもないと思うけれども、自分はこの挑戦する姿勢がすごく好きだった。

次は南国+ウクレレ縛りプレイとかに挑戦してもらいたい。

装備+法石システム

本作の装備品は、武器と法器の2種類しかない。この点が残念だという人もいるらしい。個人的には、兜盾鎧小手みたいに分かれている意味って、雰囲気作り以上の意味はないように思えるので、特に気にならなかった。単純な攻撃力や防御力だけではなく、サポート効果も加味して装備を整えるという本質的な部分は、法石システムによって実現されている。

今後のことを考えて昇華率アップ系の法器にするか、それともいま、このバトルを乗り切るための法器にするか、みたいなことに頭を悩ますのも楽しかった。

ただ、魔法は法石じゃないほうが、嬉しかったかな…。連携技もすごい豊富でワクワクするのに、セットする法石に制限があるので、「とりあえず見るだけ見てみたい」みたいなのをやりたくても出来ない。クロノ・トリガーだったら、キャラの組み合わせを変えるだけでよかったので、本作では法石の組み合わせも変えないといけないのが、単に手間にしか思えなかった…。

バトル全般

〈グラーティア〉 + 〈久遠の剣閃〉とか、そういうものすごく相性のよい魔法の組合せに気付いてしまってからは、一気にバトルが大味になってくる。

でもまあ、こういうのが運用出来るようになるのがそもそも終盤だし、俺つえー出来るための組合せを探すのもそれはそれで楽しいので、あんまり気になっていない。自分がヌルゲーマーだからかもしれない…。〈ガグンラーズ〉があればMP補給無用で雑魚はサクサク片づくのとか、非常に助かったし。〈叫ぶ〉+〈パーマネンス〉+ 〈ユグドラシル〉 + 〈アルティメット〉でエンド無双になるのとか快感だったし。クロノ・トリガーも終盤シャイニングだけ唱えてればだいたいなんとかなったし、そんなもん。中盤は中盤で、エンドの〈回転斬り〉無双だった気もするが…。まあそれはそれで「お、大体回転斬りでいけるやん!」って気づく過程が楽しかった。

全体的に、MP温存せずに雑魚にもガンガン使っていく感じで進められるのが快適だった。

キャラ毎の個性もハッキリしていてよかったけれど、結局エンド+クオン+(セツナ or キール)最強だなーということで、あんまり他のメンバーを使わなくなってしまった。ディノタウルス系用にブロウビート要因のヨミを使うことはあったけど、それくらい。まあ、クロノ・トリガーでも魔王やカエルは趣味枠だった気がする…。

法石に蝕まれた魔物

隠し中ボスみたいなのが攻略ルート上に普通に出現する。気付かずにバトルを仕掛けると普通に全滅して普通にゲームオーバーになる。

この理不尽さも、懐しいかも…。

まあ本作では100％逃走可能なアイテムがあるので、実際はそこまで脅威ではない。とはいえ、こういうのに出くわすまではそもそも逃げることなんてなかったので、逃走用アイテムがあることも忘れていたりするのだけれど。

こういう微妙にプレイヤーを突き放した感じも、なんだか懐しい。

ストーリー

エンドやセツナに感情移入出来ないとか、選択肢の意味がほとんど無いとか、そういう評判をネット上ではよく見かけた。

個人的には、そこはそんなに気にならなかった。選択肢しだいで、クオンがちょっとエンドのこと見直してくれたり、エンドが謎にチームリーダーとして慕われてたりとか、素直に嬉しかったし、にこにこしながら見ることが出来た。

セーブポイントが伏線になってたりとか、そういうところも好き。昔からたまにある設定だから目新しさはないけど。

どんどんみんなの絆が深まっていくのに、旅の目的はセツナが無事に死ぬこと、っていう矛盾に悶々と出来たのはよかった。

ただ、エンドやキトが何者なのか？とか、絶海群島の何のイベントも起きない人々は何なのか？とか、もう少し知りたかった。もやもやする。想像の余地を残されたのだろうか。うーん、困る。

Vita 版

せっかくゲームはいい出来なのに、処理落ちがホントにひどい。一番最初に使える連携技の時点で処理落ちする。パーティメンバーを全員表示するたびに処理落ちする。最終的に慣れてしまったけれど…。

最悪なのは、エンディングイベント中にアプリケーションエラーで落ちたこと。一番落ちてはならぬところだぞ…。

これは Tokyo RPG Factory を恨めばいいのか、 Unity を恨めばいいのか、 Sony を恨めばいいのか、どれなんだ。教えてくれ。

ロード時間も長めだけれど、 PS 時代もこんなもんだったなーくらいの感覚でそこまで気にはならなかった。

総評

ゲームとしては値段分の価値が十分あるし、これからもこういう作品をどんどん出してほしいと思える内容だった。

ただ、 Vita 版はゲーム性以外の部分がかなり残念…。

もし次回作を出すならフルプライスで買うから、変なハード間差異だけは出さないでほしい…。

三ヶ月ぶりに更新再開した日

Tue, 03 May 2016 23:27:26 +0900

前回の更新から平気で3ヶ月経っていた。光陰矢のごとしである。

一個多少マトモな記事を上げたら何か燃え尽きてしまったのと、仕事が妙に重圧になっていて気持ちがアガらなかったのと、色々あって全然更新しなかった。

スクラム入門の翻訳も全然やってない。

いやはや。

やったことといえば、 .emacs.d の大幅リニューアルくらい。結果物はこちら。 .emacs.d 弄りは無限に時間取られるな…。

まあ、その甲斐あって、以前よりさらに快適な作業環境が整った、ハズ。かっこいいモードラインとか、いいよね。僕はニワカイーマクサーなので、そういうところを頑張ってしまう。

あと、記事の元になる Hugo ファイルを BitBucket のプライベートリポジトリに移した。これで気兼ねなく、プライベートな内容も記録出来るようになった。

この連休中に、 persp-mode の設定を spacemacs を参考に変更するのと、 Scala 製 Slack ボットのデプロイ方法を考えるのと、いくつか追加でボットを作成するのをやっておきたい。

WordPressをHTTP/2+HHVMで動かす環境をdocker-composeで構築してみた

Sun, 21 Feb 2016 22:49:52 +0900

TL;DR

このリポジトリを clone して docker-compose up -d して下さい (要バージョン 1.6.0 以上)。その後 open "https://$(docker-machine ip default)" すると、ブラウザでWordPressが立ち上がります。

動機

WordPressをHHVMで動かしたら超速くなった!やったぜ!!という記事はをよく見るのだけれど、具体的にどうやって構築しているのか解説している記事があんまり無かったので、実際にやってみることにしました。

ついでに、HTTP/2で提供出来るとイケてる気がしたので、併せて対応してみることにします。

HHVM

HHVMは、Facebookがオープンソースとして開発している仮想実行環境で、 PHPとHackを動かすための環境らしいです。

まぁ、個人的にはHackもHHVMも すごいPHP ぐらいの認識しかありませんが…。 Hackは言語的にすごくて、HHVMは実行環境がすごい。今回用があるのはHHVMだけです。

HTTP/2

HTTP/2は… すごいHTTP です。

HTTP/1.xとの互換性を保ちつつ、効率化したもののようです。ヘッダの圧縮とか、リクエストの多重化とか。 RFC7540 日本語訳や日本語のFAQもあります。自分は全然見てないけれど…必要になったら読みます。

とにかく、このプロトコルで配信するだけでより効率的でより早くなる、ということです。

HTTP/2 の実装

nginxの1.9.5からHTTP/2をサポートしているようです¹。公式Dockerリポジトリで配信されている最新イメージでもちゃんとサポートされていました。

他にもApache HTTP Server 2.4.17+や DeNAのH2Oなど色々あるようです。

今回はApacheよりは速かろうというのと、WordPress稼動の実例も多いことから、nginxを選択しました。適当。

構成

リライトルールとか複雑なリクエスト制御が不要なら、 HHVMに組込みのWebサーバーがあるのでそれを使うのが簡単だし、速度面でも問題なさそうです。

ただ、WordPressでパーマリンクを利用する場合はURLのリライトが必須です。

HHVMでもバーチャルホスト切ってリライトの設定するとか出来るみたいですが、 iniファイルに設定書いていくのは何だかしんどそうです。

他にもSSLとか静的ファイルの配信とか諸々考えると、餅は餅屋ということでリバースプロキシを立てた方がよさそうですね。

というわけで、リバースプロキシとして nginx を立てて、HHVMをFastCGIモードで起動してバックエンドとします。

今回はとにかくお手軽に手元で動かしてみたかったので、諸々Dockerで動かすことにしました。雑に図解すると以下のような感じです:

FrontとかBackはDockerのユーザー定義ネットワークです。 Docker 1.10.0で link に代わるものとして導入されたような気がします。 /etc/hosts じゃなくてDNSで名前解決出来るようになってて最高にハッピーですね。

FastCGIはUnixソケットで通信した方が速いと思うんですが、今回は nginx と HHVM を別々のコンテナで動かすので、TCPで通信するようにしました。同一システム上にFastCGIサーバとプロセスが稼動するって、実環境でもあんまり無いような気がするけど、どうなんだろう？

コンテナひとつひとつ立てていくのは辛いので、常套手段の docker-compose を使って作ります。

動かす

このリポジトリに実際に稼動するものが置いてあります。 clone して docker-compose up -d すれば、HTTP/2でWordPressが動いている様子が確認出来ます。

nginxやHHVMの設定はほぼデフォルトのままいじってないので、本気で動かすなら細かいチューニングは必要です。が、全体の構成は実環境でもこのようになると思います。

終わりに

以上で、お手軽に手元でHTTP/2+HHVMなWordPressを試すことが出来るようになりました。

あとは実環境へのデプロイだけなんですが、さてどうしたものか。 docker-compose.yml からいい感じにデプロイしてくれるような何か、ありませんかねぇ。

HTTP/2 Supported with NGINX Open Source 1.9.5 | NGINX ↩︎

VM関連ファイルを外部ストレージに保存して空き容量を確保する

Fri, 19 Feb 2016 00:00:00 +0900

何かと容量を食うVM関連ファイル

DockerやらVagrantやらで作業していると、いつのまにかディスク容量が逼迫していることがありますよね。

自分も128GB SSDのMacBook Proを使っているので、結構いっぱいいっぱいでした。

そこで拡張ストレージを用意して、容量を食いがちなVM関連のファイルを移動することにしました。

(参考)Mac用の拡張ストレージ

USBで外付けするようなのだと持ち運びに不便なので、のような本体のSDカードスロットに差せるようなタイプを個人的には使っています。 iSliceの場合はただのアダプタなので別途128GBのmicroSDカードを調達する必要がありますが、ストレージと一体になっているモノよりは若干割安です。

Vagrant

Vagrant用のBoxファイルとVMイメージの保存場所を変える際には、以下の記事が参考になります:

上記の記事を参考に諸々のファイルの移動、VB上の設定を済ませたら、以下のようなコマンドを .bashrc やら .zshenv やらに書いておけば大丈夫です:

export VAGRANT_HOME=/Volumes/data/.vagrant.d

Docker Machine

Docker Machine用のファイルもデカいので移動させたいです。

Docker Machineでは MACHINE_STORAGE_PATH という環境変数を参照しています。デフォルトは ~/.docker/machine です。

Vagrantの場合と同じように既存のファイルを新しい場所に移動し、 VB上で除去→追加の手順を踏みます。そして以下のようなコマンドで環境変数をセットします:

export MACHINE_STORAGE_PATH=/Volumes/data/.docker/machine

これも .bashrc やらに書いておきましょう。

注意: 外部ストレージのフォーマット

自分の場合、SDカードが元々フォーマットされていて、差すだけで既に利用できたので、フォーマットについては特に気にせず移行作業をしてしまいました。

ところが、移行後に 'docker-machine が謎のエラーで使えなくなってしまいました。

-D を付けてデバッグ情報を表示したとろ、以下のようなエラーが出ていました:

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: UNPROTECTED PRIVATE KEY FILE! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0777 for '/Volumes/data/.docker/machine/machines/default/id_rsa' are too open.
It is required that your private key files are NOT accessible by others.
This private key will be ignored.
Load key "/Volumes/data/.docker/machine/machines/default/id_rsa": bad permissions
debug2: we did not send a packet, disable method
debug1: No more authentication methods to try.
Permission denied (publickey,password,keyboard-interactive).

実は、 SDカードがexFATでフォーマットされていたため、permissionが777になってしまっていた ことが原因でした。 exFATの場合、 chmod することも出来ないので、フォーマットを変更する必要があります。

Mac OS X用拡張ストレージは、 〈OS X 拡張 (ジャーナリング)〉でフォーマット しましょう。また、この際に 〈大文字／小文字を区別する〉は不要 です。 OS Xのメインストレージでは区別されませんし、 Adobeなど一部の製品は大文字小文字を区別するファイルシステムをサポートしていません¹。無用なトラブルを避けるためにも、注意しましょう。

↩︎

早朝ランニングしたりカナヘイカフェに行ってきた日

Tue, 16 Feb 2016 23:00:00 +0900

ランニング

昨日おとといと、春が来たのかと思うくらい暖かったので、何となく意識が高まって「よし明日からランニングを始めるぞ」という気持ちになっていた。

せっかくだから一番いいランニングをしようと思って調べると、朝食前に20分以上走るのが痩せるには最も効果があるという情報を得た。時間を気にしながら走るのは辛そうだったので、とにかく目標地点まで行って帰ってくることにし、スカイツリーくらいまで走ると距離的にちょうどよさそうだったのでそこを目標地点とした。

そんな調査を前日に行なっていざ、走ろうと外に出ると 滅茶苦茶寒い 。いや、昨日おとといと比較すると寒くなるというのは知っていたけれど、走ってるうちに体あったまるだろくらいに考えていた。ところが、走れども走れども一向に体は暖まらず、手はかじかみ、寒さに震えながら走ることになった。

後で調べたらその時の気温が3度とかだったので、そりゃ、寒いワケだ、と。

寒さを舐めてはいけない。次はもっと防寒するか、もっと暖かい日にしよう、という学びを得た。

カナヘイのゆるっとカフェ

仕事終わりに、カナヘイのゆるっとカフェに行ってきた (カフェ公式ページは無くて、イベントページの1コンテンツという感じだったので、カナヘイさんのブログ記事にリンク)。

こんな感じでパルコ入口で待ち構えている。

7階に辿り着くと、巨大うさぎ&ピスケがお出迎え。これ、多分カナヘイの個展でも使われてた奴らが着替えただけだ。

その他の最高に可愛い写真はこちらに置いてあるのでどうぞご自由にご利用下さい。

もう、本当に最高にゆるっとして可愛くて可笑しくて、また行くことが確定した。グッズ込みで1万超の出費だったけど何も痛くないね!!

カナヘイさんもっとイベントやってください。

Google Drive の画像を Web ページに埋め込む

カナヘイカフェの記事を書こうとして、どうにか写真を埋め込めないか色々調べたら、どうも写真の単体ページ(こういうの)を開いて、〈アイテムを埋め込む〉というのが真っ当な手段ぽかった。

直リンクする方法もあるみたいだけど、いつ Google 様に殺されるか分からなかったので止めておく。

Hugoの記事をようやく書き上げた日

Sun, 14 Feb 2016 00:26:33 +0900

たまには人類に少しでも役に立つような記事も書こうと思い、 Hugoの記事を書いていた。

自分が通しでやったことだし、すぐ書き上がるだろーと高をくくっていたら、なんだかんだ書き始めてから2週間くらい経ってしまった(もちろん、そればかりやってたワケじゃないけど)。自分の遅筆さに呆れるばかりである。

普段から余り人様に見せられるような文章を書いていない、というのが露呈した気がした。そういえば普段の会話もあまり賢いものとは言えない…。時を経るごとに、喋るのも下手になっていると感じる。

やばいなー。やばいヤバイ。

人とコミュニケーションとらずに生きていくのにそろそろ限界を感じているので、意図して真っ当な会話をし、文章を書けるように心がけていこうと思う。そういえば最近まともに読書もしていないし…。社会生活を営む人間として真っ当に生きていく為の読書くらいは、しよう。

業務外のアレコレ

最近(ほぼ)趣味で、 AWS上にシンプルに構築されたWordPressブログを、 HTTPSにしてついでにHTTP/2対応してHHVMで稼動させようぜ、というような試みをしている。

AWSは最近ようやく触りはじめたばかりなので、どういったことが出来るのか、から調べつつやっている。

ベースがAmazonLinuxなので、HHVMは公式にサポートされていない。なので Docker を利用したいところなのだけれど、 WordPress がダイナミックに自分自身を更新するという話を聞いて、うーん、となった。 HHVMだけをECSで動かしてもしょうがないから、やるならWordPressもコンテナに詰めるのだけど、コンテナ内で稼動しているWordPressを更新してもしょうがない、というかコンテナ再起動したら消えちゃうしなー、という。それとも、ECSで使うEC2インスタンスにWordPressを普通に入れちゃえばいいのかな？

などなど、色々試行錯誤の日々である。今日はHugoの記事書き上げるのとドメイン移行でいっぱいいっぱいだったので、明日には何らかの成果を出したい…。

Hugo + GitHub Pages でお手軽にブログを始めよう

Tue, 02 Feb 2016 18:44:21 +0900

13, 2020 最終更新

Note

2020年1月現在は、。

はじめに

この記事は「いい感じのブログを無料で手軽に作れないかなー」、と思っている人が主な対象です。

〈いい感じ〉というのが抽象的ですが、以下のような欲求をイメージしています:

にあるような静的サイトジェネレータがいい
サイト生成は速ければ速いほどいい
モダンでレスポンシブルなのがいい
記事を書いたら即確認出来るのがいい
GitHub Pagesに簡単にデプロイ出来るのがいい
独自ドメインは使いたい
ブログにありがちなコメント機能とかアクセス解析とかが出来るといい
HTTPSなのがいい
HTTP/2なのがいい

サイトの方式を考える

手軽に始めたいので、準備はなるべく少ない方が嬉しいですね。

WordPress みたいな動的な方式はサーバを用意しないといけないので手間ですし、場合によっては金もかかります。

一方の静的サイト配信であれば、必要なのは HTML を配信出来る場所だけです。 GitHub Pages や類似のサービスを使えば無料で利用できますね。

静的サイトジェネレータを選ぶ

というわけで静的サイトを作成するためのジェネレータを選びます。

の中から適当に選びましょう。

やはメジャーっぽいですが検索してみると、何だか遅いみたいです(使ったことない)。

はドキュメントを書くのには向いています(自分も利用しています)。ですがブログを書くためのものではありません。

かあたりがよさそうです。これら二つはコンセプトもよく似ているし、最早好みの世界ですね。自分は何となく Hugo を使っています。

Hugo

は超高速でシンプルかつ柔軟な静的サイトジェネレータだそうです。 Go言語で書かれていて、インストールはとってもカンタン。すぐに使えます。

使い方もとってもカンタン…というワケではないかもしれません。といっても、それは Hugo が殊更難しいというワケではなく、そもそも静的サイトジェネレーターというモノを理解している必要がある、ということだと思います。

ブログを書く、ということだけに目的を絞れば、覚える必要がある用語は Content, Themes, Taxonomies の3つだけです。

Content

ブログで言えば記事のことです。

Content がどのように表示されるかは使用しているテーマによりますが、ブログ用テーマのほとんどは post ディレクトリ以下にあるファイルを記事として扱うようです。

Themes

そのまま、サイトに適用するテーマです。

Hugoの場合、テーマはそのサイトの構成まで決めてしまいます。独自にテンプレートを書くことでカスタマイズ出来るとはいえ、目的に沿ったテーマを選択するのが無難です。

テーマ選択の方法については後述します。

Taxonomies

やけに難しい単語ですが、分類方法のことです。ブログなら カテゴリ やタグといった類のものです。

幸い、カテゴリとタグによる基本的な分類であればデフォルトで対応しているため、あまり意識する必要はありません。カテゴリやタグのことを Taxonomies と呼ぶことだけ押さえておけばOKです。

サイトを作る

早速サイトを作っていきましょう。

に従えば基本的に迷うことは無いと思います。ここでは、適当にサイトを作って、ひとつ記事を書いてみて、それがブラウザで確認出来るようになれば大丈夫です。

ただし、 日本語に対応させる設定は追加で必要 です。

日本語対応

ありがたいことに、Hugoは日本語や中国語の為の特別な設定を用意してくれています。設定ファイルに hasCJKLanguage = true という行を追加しましょう。

これをやらないと、一覧用に記事を自動で切り詰めてくれる機能や、読み終えるまでの予想時間の計算が滅茶苦茶になってしまいます。

テーマを決める

次はサイトに適用するテーマを選択しましょう。

で実際の例を見ながらテーマを選ぶことが出来ます。ブログ用のテーマのみに絞って見たい場合はからどうぞ。

注意点として、Hugoには記事を読み終えるまでの時間やおおよその文字数を表示する機能が組込まれているのですが、テーマがサポートしていない場合は表示されません。このような機能を使いたい場合は、テーマでサポートされているかを確認しましょう。

このサイトはを使っています。ショーケースの中では使える機能が一番多いと思うので、どういうことが出来るのか知るには丁度よいテーマだと思います。

favicon を置こう

デフォルトでは Hugo の favicon が表示されてしまうので、カスタマイズしましょう。などを使うとよいです。

生成した .ico ファイルを static 直下に配置すればOKです。

記事を書く

記事はMarkdownで書きます。

ここで困るのは、Markdownにもいくつか方言があることです。何を参考に書けばいいか迷ってしまいますね。

HugoではMarkdownの処理にを使っています。 Blackfriday特有の書式(脚注など)もある為、こちらを参照しながら書くとよいでしょう。

記事のファイル名について

日記や思い付きで即興で記事を書く場合、いちいち被らないようにファイル名を考えるのは面倒ですよね。

Hugoの場合ファイル名は管理上の問題でしかないので、適当に日付やタイムスタンプでも入れておけばよいです。デフォルトではファイル名がURLに使われますが、記事毎の設定で slug = "hogehoge" のように設定しておけば、実際のURLは /post/hogehoge のようになります。

また、以下のように設定ファイルに書いておけば、年月日がURLのプレフィクスに付くので被る心配もありません:

[permalinks]
post = "/:year/:month/:day/:slug"

コメント対応

なんとなくコメント欄があるとオープンな感じでいいですよね？ということでコメントにも対応させてみましょう。

Hugo自身がので、を使いましょう。ただし、Disqusによるコメント対応も、テーマによってはサポートされていない場合があるので要注意です。

何よりもまず Disqus への登録です。を見ながら行いましょう。設定は特に必要ありませんので登録だけ済ませれば一旦OKです。後から言語設定を日本語にしたりすることも出来ます。

登録が完了したら、登録時に入力した shortname (unique Disqus URL) を以下のように設定に追記しましょう:

disqusShortname = "sitename"

これだけでHugoの設定は完了です。(テーマが対応していれば)個別の記事ページにコメント欄が出現します。

デプロイ

生成したブログは GitHub Pages でホスティングします。

gh-pages ではなく、ユーザや Organization のページとして公開する場合は、に何も考えずに従えばOKです。例示されているスクリプトもそのままコピペで使えます。

実際にこのブログで使われているモノは全てにあるので参考にしてください。

独自ドメイン対応

github.com ドメインでホスティングするだけでよければ、ここから先の作業は不要です。おめでとうございます。

以降はHugoとは関係ない話が続きます。

既に独自ドメインを持っていて、それをブログでも使いたい場合は、の設定をGitHub上で行う必要があります。を作ってあげて、 DNSレジストラ側で CNAME とか ANAME の設定を行ないます。

サブドメイン vs ルートドメイン

CNAME の設定をするか ANAME の設定をするかは、サブドメインを使うかルートドメインを使うかの違いです。 GitHubのヘルプによると、そうです。

サブドメインを推奨する理由は以下のようです:

GitHubのCDNの恩恵を受けられる
GitHub自体のIPアドレス変更に影響を受けない
DoS対策がより効率的になるのでページロードが高速になる

というわけで、特別な事情がない限りはサブドメインを利用するのがよいでしょう¹。

HTTPS化

ここまででブログとしての体裁は整いました。ですが、折角つくったサイトですからHTTPSで配信したいですよね？しましょう。

これにはを利用出来ます。が非常に参考になります。

設定が反映されるまでは最長1日程度かかりますので、ゆっくりと待ちましょう。

なおCloudFlareを利用すると、ついでに HTTP/2 も有効になります。他にもJSの軽量化などの各種高速化の設定を利用出来ますので、設定項目を見てみるのもよいでしょう。

注意

注意点として、この際に Flexible SSL を用いる場合は、あくまでユーザとCloudFlare間の通信が暗号化されるだけで、 CloudFlareとGitHub Pages間の通信は暗号化されていません 。後者の間の通信は改竄されうる状態で、かつ、ユーザはそれを知る術が無いという状態に…。

に詳しく書かれていますが、一応そういう状態であるということは認識しておきましょう。

終わりに

いい感じのブログを無料で手軽に作る方法についてまとめました。改めてまとめてみるとそれなりにボリュームがあってちょっと大変でした…。

これからブログを始めるぞーと思っている誰かの役に立てばいいなーと思います。

こう書いている自分も、最初は特に気にせずにルートドメインで登録してしまっていました。この記事を書きながら気づいて、慌てて www サブドメインに移行しました。 ↩︎

スクラム入門を翻訳する日々

Sun, 31 Jan 2016 23:18:29 +0900

最近、スクラム入門の翻訳を細々とやっている。

元々はScrum Primer - Short Introduction to Scrumで配布されているPDFで、認定スクラムマスター研修でも参照される真っ当な文献(のはす)。

日本語版があるにはある¹んだけれど、古いし翻訳の質が怪しいので、自分の理解を進めるという意味も含めて独力で翻訳してみることにした。

進捗としては、1週間の空いた時間をほぼそればっかりに費してようやっと 1/5 くらい進んだ。さすがに他のこともやりたいので、完成までは2ヶ月くらいかかってしまうかもしれない…。 3月中には終わるように頑張ろう。

すくすくスクラムが翻訳した版がある。あるはずなのだけれど公式に配布している所が見当たらない。 ↩︎

hugo.elを書いた

Tue, 26 Jan 2016 23:25:40 +0900

#とは

hugo.elは、Hugoでサイト作成する際に便利な関数群を定義したパッケージ。 marmalade-repoで公開されているので、パッケージの設定をすれば簡単にインストール出来るハズ。

作った動機

何か〈物を書く〉という作業をする時、自分はEmacsを使っていて、可能な限りEmacsの中から出たくない。 HugoはCLIのインタフェースなので、ターミナルとEmacsを行き来することになってしまうのは辛い。

あと色んなテーマを試したい時に、いちいちテーマ名をコピペする必要があり、辛かった。一覧の中からhelmで選択したかった。

…というように、Emacsの中で色々作業が完結するようにしたかった。

作ってみて

正直テーマのインストール補助機能はHugoを初めて触って、色々試してみたいフェーズでしか使わないので、ほとんどの場合大した価値じゃないかもしれない。

個人的には、 hugo-new-content と、 hugo-start-server, hugo-open-browser が中々便利だなーと思って使っている。適当に記事を書き始められるし、プレビューするためにターミナルで確認したアドレスをブラウザに打ち込むとかやらなくてよいので。

書き終えたあとに hugo-deploy でひょいっと公開出来るのも地味に便利。ただ、デプロイスクリプトを呼び出してるだけなんだけどね…。

普段Emacsで物書きをするひとで、Hugoでブログ書こうと思う人は是非便利に使ってもらいたい。そんな人あんまりいなさそうだけど…。

TODO

hugo-open-browser で今開いているcontentを直接開けたらより便利かもしれない
hugo-deploy が同期処理になってて固まるので、非同期にする
テスト全然書いてないので、テストを書いてバッジをつけて喜ぶ

JIRA Agile用のuserscriptを作ったりした日

Sat, 23 Jan 2016 23:47:43 +0900

趣味の政策物

弊チームではバックログとしてJIRAを使っている。

ここ最近しつこく「管理者権限が欲しいなァ〜(ﾁﾗｯ」としていたらめでたく権限を付与してもらえたので、ここぞとばかりにJIRAをカスタムして使いやすいようにしていた。

ワークフローを単純にしたり、使わないフィールドを非表示にしたり、これまで説明文用のテンプレからコピペしたりしていたのを、それぞれ専用のフィールドを設けたり。

色々準備はしたもの、やはり始まってみると色々不便なところが出てきて、しかもJIRAの設定じゃどうしようもない部分もあったりする。

たかがツール、されどツールで、ツールに使われているようじゃ到底円滑にスプリントを回すことなんて出来ない。

そこで、スクラムマスターがセレモニーを進めやすいように支援するためのuserscriptを書いた。ソースはyewton/userscripts。

Component-labels for JIRA Scrum

コンポーネントをエピックのようにスクラムボード上で分かりやすいく表示する。

ラベリングをしたいが為だけにエピックを使ってしまうという事態は結構そこかしこで起こっているみたいだった。本来はコンポーネントでやるべきもので、エピックはエピックとして使えるのが健全な状態だと思うので、作った。

実装は滅茶苦茶単純で、DOMに変更がある度に全課題を舐めて、未設定だったらAPIで該当する課題のコンポーネントを取得している。なので、バックログに積まれている課題数分、ページを開いた瞬間にリクエストが走ることになる。リクエストの仕方を何か工夫しないと使いものにならないかなーと思っていたのだけれど、案外数百リクエスト飛ばすぐらいだとビクともしなかったので、愚直な実装のまま。

Detail Pop-up for JRIA Scrum

各課題に詳細画面をポップアップで開くためのボタンを追加する。

アジャイルボードではカスタムフィールドが表示されないので、確認するためには編集ポップアップを開くか、詳細画面に飛ぶしかなかった。しかも、アクティブなスプリント中はクローズされている課題が編集出来ないので、前者の方法はスプリントレビュー時には使えない。

画面遷移せずに詳細画面が開ければ用は足りると考え、 SimpleModalという、その名の通りシンプルなモーダル機能を実装するためのライブラリを使って、 iframe で詳細画面を開くだけの機能を追加した。

第3回実践的ドメイン駆動設計ワークショップ - connpass

参加してきた。

エンジニアチームとして、業務と技術両面でどういう風に学んでいけばいいかっていう話と、実際にやってみたら、コードの雰囲気はこんな感じだぜ、っていう話。

ドメイン層のクラスが1,000個とかあって、個々のクラスは 30 〜 60 行が大半を占めるそう。目指すべき方向はそこだっていうのはわかってはいるけど、実際に稼動してるプロダクトの数字っていうのは説得力がある。

ドメイン駆動設計を実践するなら、ドメインエキスパートとか、企画者との協調が必須だと思うのだけれど、それをどうプロセスとして制御可能な形で行えばいいか、あまり掴めてない。

会話を重視しつつ、かつダラダラやらずに予測可能な状態で、モデルに関する会話をする場を、開発プロセスのどこで行えばいいんだろう。

増田さんに上手いやり方無いっすか、と相談してみたけれど、いい方法っていうのはなくて、エンジニアチームが実績を積み重ねて信頼を得ていって、協力体制を築くしかないね、ということだった。それでも駄目なら、職場を変えよ、とも。

色々仰々しいプロセスやツールを導入せずとも、いつか阿吽の呼吸で、エンジニアチームと企画陣が協調して最高の仕事が出来るようになったときが、アジャイルでドメイン駆動な状態なんだろう、たぶん。適当。

markdown-modeでSKKの変換確定するためにRETするとカーソルが行頭に飛ぶ問題の回避策

Wed, 20 Jan 2016 22:40:16 +0900

markdown-mode 2.1 で SKK 15.2 使ってると、確定しようと思って <return> すると、確定後にカーソルが行頭に飛んでしまうという問題に遭遇した。 C-j で確定する場合は起こらない。

TL;DR

以下を init.el 相当のファイルに書けば回避出来る。

(defun my--markdown-entery-key-ad (this-func &rest args)
 "markdown-modeでskk-henkan-mode中にエンターすると行頭にカーソルが飛んでしまう問題の対応"
 (if skk-henkan-mode (skk-kakutei)
 (apply this-func args)))
(advice-add #'markdown-enter-key :around #'my--markdown-entery-key-ad)

原因解明に至るまで

<return> = <C-m> では起こり、C-j では起こらないので、まずはキーバインドを確認したところ、前者は markdown-enter-key という関数が割り当てられていた。

実装は至ってシンプルだった:

(defun markdown-enter-key ()
 "Handle RET according to to the value of `markdown-indent-on-enter'."
 (interactive)
 (newline)
 (when markdown-indent-on-enter
 (markdown-indent-line)))

次に trace-function で markdown-enter-key と skk-kakutei をトレースしたところ、以下のような出力が得られた:

1 -> (markdown-enter-key)
| 2 -> (skk-kakutei)
| 2 <- skk-kakutei: nil
1 <- markdown-enter-key: nil

markdown-enter-key が発動して (newline) が評価された結果、 skk-kakutei が発動して変換確定、その後に markdown-indent-line が呼ばれているのがどうも悪いらしい。

回避方法

これは markdown-enter-key が呼ばれた時に skk-henkan-mode 中だったら、 本来の挙動ではなく skk-kakutei だけを行なうようにする ことで回避出来そうだ。

こういう部分的な挙動の修正には advice を使うといい。というわけで前述の挙動をそのまま定義すると、冒頭のようなコードになる。

雪が振ったので一日中家に引き込もっていた日の次の日

Tue, 19 Jan 2016 23:00:00 +0900

昨日は都内も大雪(いうほどか？)で出社がダルそうだったので、終日リモートワークしていた。本当に一歩も家から出ずに、パジャマから着替えもせずに、もくもくとPC作業。

個人のタスク管理

最近認定スクラムマスターも取ったし、一日中スクラムのことばかり考えて悶々とするような続いている。

そんな中で、個人的な、業務とかまったく関係ない趣味のタスク管理もなんとかしたいなぁと思いはじめた。

趣味なのでそんなガッツリ管理するわけじゃないのでゆるいので何かないかなーと探したら、 Trello というのがいい感じにゆるゆると使えそうな感じだった。

見積もりとか検証とかは出来なさそうだけど、とりあえず何もしないよりはいいだろーっていう想いで、使うことにした。

ボードによると、目下最優先のタスクは、 markdwon-mode で skk-mode の確定キーバインドが想定通り機能しない件の対応である。やるぞ。

HTTPSに対応してついでにHTTP/2対応された日

Mon, 18 Jan 2016 00:06:20 +0900

HTTPS + HTTP/2 対応

世の中的にHTTPS対応してないといかんような気がしたので、このサイトもHTTPSで配信するように対応した。

GitHub Pagesに設定しているカスタムドメインをHTTPS対応させる - 1000ch.netを大いに参考にさせていただいた。もう本当に書いてある通りにすればいい。 CloudFlare 様々である。

敢えて付け加えるとしたら、(CloudFlareのサイト上に注記されてはいるけども)Flexible SSLが実際に動くようになるまでは結構時間がかかること。自分の場合は、都合7〜8時間程度かかった。この間、ステータスは AUTHORIZING CERTIFICATES から ISSUING CERTIFICATES になり、最終的に ACTIVE CERTIFICATE になった。

この方法でサイトをHTTPS対応するのは簡単だけども懸念もあるらしい¹ので、また今度この辺が実際どういう仕組みで動いてるのか調べてまとめたいと思う。

なお、CloudFlareを利用することで副次的に HTTP/2 にも対応することになった。 Chromeで HTTP/2 and SPDY indicator を入れてアクセスしたりすると分かる。

DDD

開発チームビルディングの一環で、ドメイン駆動設計について改めて色々調べたりしている。

図やドキュメントに本質はないとはいえ、ユビキタス言語のサポートとして用語集を作ったり、深いモデルの洞察のために図が役に立ったりするので、そのへんのサポートツールが欲しくなる。

色々探してたらエヴァンス先生がマイクロサービスとの関わりについて講習してる動画があった。境界づけられたコンテキストはサービスじゃないから、別に実サービスと一対一対応する必要はない。例えば、複数のコンテキストにまたがってやりとりされるようなあるコンテキストのメッセージがあるなら、それは Interchange Context (日本語で言うと相互連結コンテキスト？)のように別のコンテキストとして定義すればいいよね、みたいな話があった。

せっかく内製開発してて、スクラムやってて、物理的にステークホルダー達とも近い距離にいるのだから、その恩恵を最大限に活かせるようにしたい。そのためにDDDって実践的に役立つと思うので、もっと勉強しなければ。

勉強の一環として今度DDD Alliance! ドメイン駆動設計のためのオブジェクト指向入門に行ってみる。日本でDDDのコミュニティってここくらい？な気がするので、勉強会の内容というよりはコミュニティの様子が気になるので。

GitHub Pages Now (Sorta) Supports HTTPS, So Use It ↩︎

忙し過ぎてお弁当も食べられなかった日

Fri, 15 Jan 2016 23:00:00 +0900

最近チームが新体制に移行するという時期で色々バタバタしていて、立ち上げに伴う開発フローの整備とか、JIRA(プロジェクト管理ツール)の設定とか、ワーキングアグリーメントの検討とかで、頓に忙しい。

別に、自分の役割はスクラムマスターではなく、いちメンバーに過ぎないのだけれど、認定スクラムマスターを取得した身としては色々手を焼かずにはいられず、色んな雑務を買って出ているという状況。

それもこれも、スプリント中は〈全力疾走〉するのがスクラムである、というスクラムのあるべき姿を目指して、自分が全力で開発に打ち込めるようにするため。

…と思ってたけど、最近は チームのパフォーマンスを引き出す っていうことに全力になっていて、それはそれで楽しくなってきたので、スクラムマスターもいいかなー、なんて思い始めた。

サイト改修

今日もサイトいじりに勤しんだ。

いじるときはEmacsを使うんだけれど、自分は適当なのでHTML中にJavaScriptを埋め込んだりする。するとhtml-modeだとシンタックハイライトとかが無くて辛いことになるので、 web-modeを使ってる。

HTMLファイルはCSSファイルは、始めから関連付けておくといいと思う。

gravatar対応

静的画像だけでなく、gravatarのアイコンを使えるようにした。

ついでに、画像を丸く表示するようにした。

gravatarに対応している他のテーマ(greyshade)と、 How to Round Gravatar Images in WordPressを参考にした。

記念日対応

最初はHatena::Countingとか類似のサービスを利用しようと思ったんだけど、あんまりシンプルなのが無かったので自作した。

自作といったって、Moment.jsというとても便利なライブラリがあったので、それを使って適当にJavaScriptを埋め込んだだけ。

template - The Go Programming Languageとか Hugo - Go Template Primerあたりも参考にした。

BettorTouchToolが無料じゃなくなると分かったりした日

Wed, 13 Jan 2016 23:00:00 +0900

BetterTouchTool will switch from free to a “Pay what you want” model early next year. – BetterTouchTool, BTT Remote, BetterSnapTool and more

BetterTouchToolが1月末を目処に無料じゃなくなるらしい。

FAQによると、ライセンスは買い切りで(当面)更新の必要は無く、過去に寄付してたりといった一定の条件を満たす人は無料でライセンスを取得する手段が提供されるらしい。

なお、古いのを使い続けるといったことは出来ず、そのうち使えなくなってしまうもよう。

買うしかないなー。

割と本気で家庭用Slack Botを作ってみた - 八発白中

うちの嫁はSlack使ってくれないから無理ぽ。。自分もカナヘイスタンプ超気に入ってるから、LINE辞めるのは無理だな。

記事中でHatena::Countingについての言及があった。ちょうどこういうサービス探してたのでありがたい。他に世界的にデファクトスタンダードなやつがあるのかとか、調べてみたい。 Create a Countdown Clock | CountingDownTo.comとかが、それらしい感じがする。

エンジニアにお勧めしたいメモアプリ5選 | geechs magazine

org-modeでだいたい間に合ってるけど、やっぱ同期と多デバイス対応が欲しいよなー。

MobileOrg : What is MobileOrg?はちょっと使ってみて微妙だった。。

そこだけ何とかなれば。。。

雑感

markdown-modeとskkの相性悪いんかな、変換確定しようとすると行頭にカーソルが行ってしまってストレスフルだ。。
シンタックスハイライトとかEmojiとか使えんのかな。調べよう。

はじめに

Mon, 11 Jan 2016 11:11:11 +0900

はじめに

今年30歳になる節目の年なので、ブログを書いてみることにした。

何もこういう試みは初めてではなく、これまでも、はてなダイアリーだったり、 Qiitaだったりに断続的に記事を書いたりメモしたりしていた。

それより以前も、個人でサイト作成したり、既存のブログサービスを使っていたこともあった。

いずれも、1年と経たずに辞めてしまった。自分の凝り性でかつ飽きっぽい性質のためだと思う。

今回また性懲りもなく始めたのは、何かをアウトプットしたいというよりも、 Hugoというものを何かのキッカケで知って、 Golangの静的サイト生成ツールだと知り、イマドキは静的サイト生成だよねーという巷の声を聞いた結果、使ってみたくなった、というのが大きい。

飽きたらその内また辞めるだろうけれど、今のところ調整したりカスタマイズしたりしたい部分が多々あるので、当面存在はするだろう。これらの試みを記事にしたりするかもしれない。

何を書くか

外部サービスに依存しないので(ホスティングはGitHub使ってるケド)自由奔放に書いていけたらと思っている。

技術的な話から、日常の駄文、過去の思い出を振り返ってみたり、あとはペットの話も書くかもしれない。時にはポエムも書くだろう。

当分人の目に触れぬはずの所なので、好き勝手にやってみよう。

yewton.net

Agent Client Protocol を理解する

はじめに

背景: なぜ ACP が必要なのか

主な特徴とコンセプト

実践: agent-shell.el での利用例

Initialization

Session Setup

Prompt Turn

将来性

GitHub Copilot CLI でのサポート

ドラフト仕様の展望

まとめ

完全爆弾解除マニュアルのマニュアルPDFをいい感じに印刷する、または Ubuntu で小冊子印刷をする方法

TL;DR

背景

試行錯誤の記録

標準のプリンタ設定

既存ツール (失敗)

解決策: pdfbook2

インストール

使い方

終わりに

Elastic Common Schema と OpenTelemetry Semantic Convention を通して Structured Logging について学んだ

背景

Structured logging とは

Elastic Common Schema と OpenTelemetry Semantic Convention の統合

Spring Boot での Elastic Common Schema 利用

Spring Boot での OpenTelemetry 利用

終わりに

Dell Latitude 3420 の SSD をより大容量の SSD に Clonezilla でクローンし換装する

はじめに

Clonezilla による SSD クローン

SSD の換装

メモリの換装

動作確認

Rust で GBA 開発のとっかかり

背景

jumpingdroid

jumpingdroid2

GBA 開発について

BG

スプライト

高速紙芝居

agb での開発

成果物

終わりに

Org Mode でリンク種別に応じたプレフィクスを表示する

TL;DR

背景

解決策

おわりに

Spring Boot でプロファイルに応じて読み込む設定ファイルの設定値をテストする

参考

本文

タスクランナー Task の紹介スライドを書いた

Ubuntu で Bluetooth マウスが使えない時にやるといいかもしれないこと

Dell Latitude 3420 にメモリを増設する

consult-ripgrep と migemo を組み合わせて ripgrep でもローマ字日本語検索

TL;DR

cosult-ripgrep の仕組み

consult--regexp-compiler

Dell Latitude 3420 - Build Your Own で Ubuntu プリインストールなノート PC を楽しむ

経緯

調達

構成

配送期間

セットアップ

Xubuntu 化

指紋認証の設定

その他のセットアップ

終わりに

スーパーマリオ64 Behind Camera Anywhere とは

背景

前提知識

Behind Camera Anywhere

終わりに

リンク集

Wowchemy 5.0.0 から 5.2.0 へのアップデート記録

背景

実践: `agent-shell.el` での利用例

`cosult-ripgrep` の仕組み

`consult--regexp-compiler`

`avy-goto-char-timer`

`NameBuiltin` が含まれるもの

`NameBuiltin` が含まれないもの

`NameBuiltin` が含まれるもの

`NameBuiltin` が含まれないもの