keiichiro shikano k16shikano

name

cognitive-rhythm-writing

description

説明的な文章に緩急を設計するための規範。緩急を装飾ではなく認知モードの切替（観察→逡巡→断定→再観察）と未回収の緊張の管理として扱い、文の拍、段落の密度波形、節の入り方、緩みと駄文の判別、執筆後の機械的な点検手順を定める。読み物として読ませたい章・記事・解説文を生成するとき、または「密度はあるが平坦でおもしろくない」文章を診断・修正するときに使用する。

認知リズムを生むための日本語ライティング規範

密度の高い文章が退屈になるのは、情報が多いからではなく、全文が同じ認知モードで書かれているからである。この規範は、読者の認知モード（観察する、迷う、確信する、確かめ直す）を意図的に切り替え、常に「続きを読む理由」を維持することで、読み進める推進力を作る。

name

japanese-tech-writing

description

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

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

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

整形

Keybase proof

I hereby claim:

I am k16shikano on github.
I am golden_lucky (https://keybase.io/golden_lucky) on keybase.
I have a public key whose fingerprint is 0B62 758B 42D9 9036 1D2A F704 6886 CAB0 1633 950A

To claim this, I am signing this object:

記事の書き方

記事の執筆には、Markdown形式を利用してください。 Markdownにはさまざまな流派がありますが、GitHub Flavored Markdown（https://github.github.com/gfm/ ）をベースとした書式を採用します。

書籍を執筆するための形式として考えると、Markdownには不足している機能が多々あります。しかし、次のような利点があるので、Markdownを採用することにします。

最低限の構造しかないので、見た目でごまかせる余地が少ない
原稿を著者自身が再利用してもらいやすくしたい

OSインストールとか

mini.isoをUSBメモリに入れて、USBブートする。 amd64向けのISOイメージは、USBメモリに直接cpするだけでブート可能なものができる。

$ curl http://ftp.jp.debian.org/dists/stable/main/installer-arch/current/images/netboot/mini.iso > mini.iso
$ cp mini.iso /dev/sda
$ sync

	This is free and unencumbered software released into the public domain.

	Anyone is free to copy, modify, publish, use, compile, sell, or
	distribute this software, either in source code form or as a compiled
	binary, for any purpose, commercial or non-commercial, and by any
	means.

	In jurisdictions that recognize copyright laws, the author or authors
	of this software dedicate any and all copyright interest in the
	software to the public domain. We make this dedication for the benefit

	\documentclass{article}
	\usepackage{luacode}
	\usepackage{luatexbase}
	\newattribute\inlineattr
	\newcommand{\inlinestart}{\kern0pt\setattribute{\inlineattr}{100}\kern0pt}
	\newcommand{\inlineend}{\kern0pt\setattribute{\inlineattr}{101}\kern0pt}
	\newcommand{\myinlinecmd}[1]{\inlinestart#1\inlineend}

	\begin{luacode*}
	local inlineattr = luatexbase.attributes['inlineattr']

	% Product Sansにはリガチャでロゴ全体のグリフ「も」ある
	\documentclass{standalone}
	\usepackage{fontspec}
	\setmonofont{ProductSans-Regular.ttf}[
	RawFeature=+calt % Contextual ligatures
	]
	\begin{document}
	\verb\|google_logo\|
	\end{document}

	\documentclass[a4paper,11pt,twocolumn]{ltjsarticle}

	\usepackage{luacode,luatexbase}
	\usepackage[no-math,deluxe,expert,haranoaji]{luatexja-preset}

	\usepackage{nodetree}
	\NodetreeRegisterCallback{:post_linebreak_filter:}

	\newcommand{\luline}[1]{\bgroup\attribute100=100 #1\egroup}

	\documentclass[uplatex,dvipdfmx]{jlreq}
	\usepackage{tikz}
	\usetikzlibrary {decorations.text}
	\def\mycommand#1{\rotatebox{-90}{#1}\relax}
	\newlength{\ripplelength}
	\newlength{\ripplewidth}
	\newcommand{\ripple}[2]{
	\settowidth{\ripplelength}{#1}
	\setlength\ripplewidth{\dimexpr\ripplelength/3}
	\begin{tikzpicture}[remember picture, overlay]