Бумага и тушь — осознанно
Большинство тем для документации тянется к одним и тем же умолчаниям: белый #fff, гротеск, текст цвета gray-800, системный тёмный режим. Читается сносно и не выглядит никак. Эта система исходит из другой посылки — длинный технический документ читают час подряд — и токены следуют из неё.
§1Позиция
Часу чтения нужно то, что печать выяснила столетия назад: тёплый фон, который не слепит, текстовая гарнитура с настоящим контрастом штрихов и ритм вёрстки, отмеренный в em основного текста, а не в пикселях обвязки. Отсюда словарь, на котором написан слой токенов: бумаги (纸 — лист, 页 — страница, 素 — гладкий фон, 帛 — шёлк) вместо шкалы от gray-50 до gray-200; туши и пигменты из ящика художника — 朱 винный, 石 жжёный оранжевый, 赭 охра, 黛 бирюза, 紫 фиолет — вместо primary/secondary/accent. Имена — не украшение: они удерживают каждое новое цветовое решение на одной физической метафоре, и потому пять разных поверхностей всё равно читаются одним листом бумаги.
§2Два фона, потому что страницы двух родов
Вики читают двумя способами. Заметку читают: одна колонка, час времени, глазам нужен покой — чуть холодная бумага, нейтральная тушь, один акцент на ссылки и номера. Полку просматривают: сетка карточек, взгляд, выбор — бумага может быть теплее, заголовки — заголовочной антиквой, а акцент — глубоким винным, который читается знаком, а не ссылкой. Дать этим двум ситуациям одну палитру — значит ухудшить обе. Поэтому у семантического уровня два контекста — колонка чтения (--color-*) и полка навигации (--wb-*), — зачерпнутые из одного ящика пигментов, и страница сама объявляет, которая она. В итоге сайт ощущается одним предметом с двумя комнатами.
§3Тьма — второе издание, а не инверсия
Алгоритмический тёмный режим обращает светлоту и считает дело сделанным: текст превращается в мел по грифельной доске, а каждая тонированная поверхность — в грязь. Здесь тёмная тема — второе издание ручного набора: сумеречные фоны и лунно-белые туши выбраны сами по себе, а акцентные пигменты высветлены ровно настолько, чтобы удержать контраст AA на потемневшей бумаге. Это стоит второго комплекта решений — в том и смысл. Переключатель уважает только явный выбор читателя (и никогда — настройку ОС): страница, меняющая тему посреди чтения, — страница, которая пугает.
§4CJK — несущая конструкция
Смешанный китайско-латинский текст — то место, где большинство тем тихо разваливается: выделение, которое отказывается закрыться перед полношириной точкой; кодовые диаграммы, которые перекашивает, потому что иероглиф занимает 1.7 ячейки. Здесь и то и другое считается ошибкой корректности, а не вопросом типографского вкуса: диалект правильно разбирает выделение в CJK, а сабсет кодового шрифта прибивает иероглиф ровно к двум ячейкам, и псевдографика переживает перевод. Тема, которая работает только по-английски, — половина темы.