紙と墨、その意図
ドキュメント用テーマの多くは同じ既定値に手を伸ばします:白 #fff、グロテスク系サンセリフ、gray-800 のテキスト、OS 任せのダークモード。読めはします。そして、何の顔もしていません。このシステムは別の前提から出発します——長い技術文書とは、1 時間かけて読むものである。トークンはすべてそこから導かれています。
§1立場
1 時間の読書が求めるものは、印刷が何世紀も前に突き止めたものと同じです:眩しくない温かい地、線の太細に本物のコントラストを持つ本文書体、そしてクロームのピクセルではなく本文の em で測られたレイアウトのリズム。トークン層がこの語彙で書かれているのはそのためです:gray-50 から gray-200 ではなく、紙たち(纸=一枚の紙、页=ページ、素=無地の地、帛=絹)。primary/secondary/accent ではなく、画家の絵具箱から来た墨と顔料——朱のワイン、石のバーントオレンジ、赭のオーカー、黛のティール、紫のバイオレット。名前は飾りではありません:色に関する新しい決定を、毎回同じ物理的メタファーに繋ぎ止めておくためのものです。五つの異なる面がいまも一枚の紙として読めるのは、そのおかげです。
§2ページが二種類だから、地も二つ
wiki は二通りに読まれます。ノートを読む——一段組、1 時間、目は静けさを求めます:わずかに冷たい紙、中立の墨、リンクと番号のためのアクセント一色。書架を眺める——カードのグリッド、一瞥、選択:紙はもっと温かくてよく、タイトルはディスプレイ用セリフでよく、アクセントはリンクではなく印として読める深いワインでかまいません。この二つの状況にパレットを一つしか与えなければ、両方を損ないます。だから意味の層には文脈が二つ——読書カラム(--color-*)と書架(--wb-*)——あり、どちらも一つの絵具箱から汲まれ、ページは自分がどちらであるかを宣言します。出来上がるのは、一つの物でありながら二つの部屋を持つサイトです。
§3ダークは反転ではなく第二の版
アルゴリズム的なダークモードは明度を反転して仕事を終えたことにします。テキストは石板の上のチョークになり、色味のある面はことごとく泥に変わります。ここでのダークテーマは手作業で組んだ第二の版です:夕暮れの地と月白の墨をそれぞれ独立に選び、アクセントの顔料は、暗くなった紙の上で AA コントラストを保てるぶんだけ明るめに調色し直す。決定の組をもう一式払うことになります——それこそが眼目です。スイッチが従うのは読者の明示的な選択だけ(OS の設定には決して従いません)。読んでいる最中に勝手にテーマを裏返すページは、読者を驚かせるページだからです。
§4CJK は構造材
中国語とラテン文字の混在テキストは、たいていのテーマが静かに崩れる場所です:全角句点に接した強調が閉じない、漢字が 1.7 セル幅であるせいでコード内の図が斜めに裂ける。ここではどちらも、組版の趣味ではなく正しさのバグとして扱います——方言は CJK の強調を正しく解析し、コードフォントのサブセットは漢字をちょうど 2 セルに固定するので、罫線素片の図は翻訳を生き延びます。英語でしか成立しないテーマは、テーマの半分でしかありません。