Munehiro Yamamoto munepi

name

japanese-tech-writing

description

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

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

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

整形

Compile with:

pdftex --translate-file ./texmas texmas.tex

技術文書の書き方

このメモは、私（@ymmt2005）が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。

科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。

しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の役に立つのではないかと考えて記します。

独自TeX Liveリポジトリを作ってみる話

これは「TeX ＆ LaTeX Advent Calendar 2021」の2日目の記事です。（1日目は zr_tex8r さん、3日目は CareleSmith9 さんです。）

この記事ではpTeXの開発版バイナリを独自リポジトリからTeX Live Managerを使用してインストールする方法を紹介します。

実際に作成したものは以下にあります。

h20y6m/tlptexbeta

マイコンと USB コネクタとの接続部分の設計

マイコンに ATMega32u4 を、USB コネクタに Type-C を使った左右分割型キーボードを設計するために必要となりそうな知識をメモ。

なお、ケースが金属製か否かで静電気対策が変わってくる（はず）。

電源部分

マイコンの電源は、マスター側の場合はUSB ケーブルで供給し、スレーブ側の場合は TRRS ケーブルで供給する。

	#!/usr/bin/osascript -l JavaScript

	ObjC.import("stdlib");
	ObjC.import("AppKit");
	ObjC.import("PDFKit");
	ObjC.import("Vision");

	const scriptName = $.NSProcessInfo.processInfo.arguments.objectAtIndex(3).lastPathComponent.js;

	console.error = (obj) => {

	#!/bin/bash
	SCRIPTNAME=$(basename "$0")

	function realpath () {
	f=$@;
	if [ -d "$f" ]; then
	base="";
	dir="$f";
	else
	base="/$(basename "$f")";

	\NeedsTeXFormat{LaTeX2e}
	\ProvidesPackage{countpdfpages}[2023/04/19 v0.1]
	\RequirePackage{iftex}

	\newcount\PDFPageCount
	\newif\if@countpdfpages@pagenumread

	\def\CountPDFPages#1{%
	\IfFileExists{#1}{%
	\ifluatex

	\ExplSyntaxOn
	%---------------------------------------
	%% \token_if_jachar:N <token>
	% Tests if <token> is a jachar token or not.
	\bool_lazy_or:nnTF
	{ \sys_if_engine_ptex_p: }
	{ \sys_if_engine_uptex_p: }
	{
	\use:x
	{

	# scsnowman-ol_HHKB_design_template2020-11-26.ai について

	Illustrator形式ファイル
	scsnowman-ol_HHKB_design_template2020-11-26.ai
	は、2021年4月24日現在に、遊舎工房さんの
	HHKBキーキャップ刻印サービス
	https://shop.yushakobo.jp/products/hhkb_keycaps_marking
	で公開されていたテンプレート
	HHKB_design_template2020-11-26.zip
	を元にしました。