MATSUI Shinsuke (poppen) poppen

name

japanese-tech-writing

description

日本語の技術文書・書籍原稿の文章規範。整形（一文一行、引用ブロック、脚注、コラム記法）、段落と論証の構成（パラグラフライティング）、論証の厳密さ（ツッコミどころの除去）、読み手の負荷の管理、視点と語り、演出の抑制、LLM っぽい空句の禁止、冗長の排除を定める。日本語で技術書の章、草稿、記事、解説文を書くとき、または推敲・リライトするときに使用する。

日本語技術文書の文章規範

日本語で技術的な原稿（書籍の章、記事、解説文）を書く・推敲するときは、以下の規範に従う。

整形

I have corrected the original extension CSS To Tailwind to make it work again, but how long it will continue to work remains to be seen.

To install the modified extension, please follow these steps:

Download the .zip file css-to-tailwind-2.0.0.0-fixed.zip from this Gist.
Unzip the file and save it somewhere on your computer.
Remove the existing "official" version of the extension, which is not working anyway.
Open Google Chrome and go to the "Extensions" page. You can access the Extensions page by entering chrome://extensions in the address bar.
Enable "Developer mode" by toggling the switch in the top right corner of the page.
Click on the "Load Unpacked" button that appears in left area.

LinuxユーザーのためのWindowsのおすすめツール・アプリケーション+個人的なカスタマイズガイド

これはなに?

普段はLinux(Arch Linux + i3)を使っているsheeplaが、Windowsでいい感じの環境を作るためにもがいた記録です。「キーボード操作ですべてを完結させたい」「お気に入りのフォント・キーバインドを設定して生活したい」といったこだわりを捨てられない人におすすめです。逆に、「安定した環境を使いたい」「Windowsのデフォルトの設定を壊したくない」「細々としたカスタマイズに時間を掛けたくない」人や商用のリッチなソフトウェアを多用する人にはあまり役に立たないかもしれません。

ターミナル

VSCode Remote: Connect to WSL2 from another machine

Do you want to do remote development on your WSL2 container in Visual Studio Code? Read this.

Proxy jump method

On the host set up OpenSSH for Windows
Run wsl --update to make sure you are running the latest WSL
Open WSL and install another SSH server inside WSL with sudo apt-get install openssh-server
Now run sudo systemctl enable --now ssh to automatically start ssh when WSL starts.

Using Git Commit Message Templates to Write Better Commit Messages

The always enthusiastic and knowledgeable mr. @jasaltvik shared with our team an article on writing (good) Git commit messages: How to Write a Git Commit Message. This excellent article explains why good Git commit messages are important, and explains what constitutes a good commit message. I wholeheartedly agree with what @cbeams writes in his article. (Have you read it yet? If not, go read it now. I'll wait.) It's sensible stuff. So I decided to start following the

Re:VIEWチートシート

いつもいつもいつもRe:VIEWの記法に悩んでぐぐってしまう皆さんへ送るチートシートです。

基本

名称	ルール	概要・備考
段落	1行以上の空行をはさむと別の段落になる	HTMLでいうP
見出し	=ではじまる行	=の個数で、章・節・項・段という感じで増えます。HTMLで言うH1, H2, H3, H4, H5

Exporting your 2FA tokens from Authy to transfer them into another 2FA application

IMPORTANT - Update regarding deprecation of Authy desktop apps

Past August 2024, Authy stopped supported the desktop version of their apps:
See Authy is shutting down its desktop app | The 2FA app Authy will only be available on Android and iOS starting in August for details.

And indeed, after a while, Authy changed something in their backend which now prevents the old desktop app from logging in. If you are already logged in, then you are in luck, and you can follow the instructions below to export your tokens.

If you are not logged in anymore, but can find a backup of the necessary files, then restore those files, and re-install Authy 2.2.3 following the instructions below, and it should work as expected.

	! NEC Portable Internetwork Core Operating System Software
	! IX Series IX2105 (magellan-sec) Software, Version 10.1.14, RELEASE SOFTWARE
	! Compiled Mar 06-Wed-2019 14:03:05 JST #2
	! Current time Mar 26-Tue-2019 04:29:21 JST
	!
	timezone +09 00
	!
	logging buffered 204800
	!
	ntp server 133.243.238.163

	#!/usr/bin/env sh

	if [ $# -ne 1 ]; then
	echo "need epub file!" 1>&2
	echo "example:" 1>&2
	echo " $ $0 ebook.epub" 1>&2
	exit 1
	fi

	FILE=`basename "$1" .epub`

	local VK_SEMICOLON = 0x29
	local VK_ESC = 0x35
	local VK_RIGHT_BRACKET = 0x21
	local VK_J = 0x26

	-- Auto reload config
	function reloadConfig(files)
	doReload = false
	for _,file in pairs(files) do
	if file:sub(-4) == ".lua" then