Элементы, из которых собран pismenny.ru: как они выглядят, что делают и где уже используются.
Это источник принятых UI/UX-правил сайта. Примеры используют действующие стили; сложные сценарии открываются на настоящих страницах. Точные значения цветов и шрифтов задаёт tokens.css. Брендбук офисных документов не задаёт правила интерфейса сайта.
01 / подход
Принципы
Содержание первым
Заголовок, материал и основное действие появляются без декоративного вступления. Навигация помогает дойти до содержания, а не задерживает перед ним.
Типографика, воздух и разделители группируют материал. Подложка или рамка появляются там, где действительно обозначают действие, состояние или границу.
Цвет обозначает роль, а не украшает блок. Здесь показаны используемые сайтом токены; значения берутся из тех же стилей, что и на остальных страницах.
Бумага--bgОбщий фон
Чернила--inkЗаголовки и контраст
Текст--body-textДлинное чтение
Ссылка--linkПереход в тексте
Акцент--accent-textМетки и навигация
Линия--borderГраницы и разделители
Заголовки / IBM Plex Mono
Смысл виден сразу.
Метки, навигация, короткие действия и заголовки.
Текст / Public Sans
Материал читается спокойно: короткие строки для пояснений, удобная колонка для длинного текста и достаточно воздуха между смысловыми частями.
Абзацы, описания, формы и подписи.
Презентация LLM Gateway
Локальное решение для этой презентации, принято 12 ноября 2026: один гротеск Golos Text в заголовках, схемах, таблице и служебных строках. Цветные иконки пользователей 🧑💻 сохранены по последующему уточнению Данила; один номер на маршрут; цвет выделяет маршрут и долю, а не весь текст. На основном слайде — четыре колонки, подробные примеры и альтернативы доступны в раскрываемой справке под показом. Это исключение не меняет типографику остальных страниц.
Принято Данилом 17 октября 2026 года для страниц общего шелла. При первом визите тема следует настройке устройства. Одна кнопка-иконка рядом с «Картой сайта» внизу меню переключает тему: солнце включает светлую, луна — тёмную. На свёрнутой рейке доступна та же кнопка. Подсказка и доступное имя называют действие; ручной выбор сохраняется между страницами и после перезагрузки.
Проверить на страницах
Тёмная тема использует графитовый фон и мягкий светлый текст. Фотографии, скриншоты и редакционные иллюстрации сохраняют исходные цвета. При печати используется светлая палитра.
На широком экране статья начинается близко к верхней строке бокового меню, без высокого пустого поля. Над заголовком одна строка: слева возврат к публикациям, справа статус черновика, если он нужен, и иконка книги для лаконичного режима. Тип материала и «Из практики» не создают дополнительных строк над заголовком. В обычном виде дата и время чтения идут под ним; имя автора — в конце текста.
По решению Данила от 14 октября 2026 года разделы «Источники» и «Термины» в конце статьи свёрнуты: заголовок с § остаётся видимым и в оглавлении, список раскрывается по клику на заголовок, состояние показывает стрелка ↓/↑. Компонент details.article-appendix в articles/article.css; первый образец — черновик «Малые партии кода».
Лаконичный режим «Книга»
Выбран Данилом 20 октября 2026 года для ссылок после выступлений. Иконка книги на любой статье включает ?view=book: тёплый фон, Source Serif 4, одна колонка до 700 px, межстрочный интервал 1,7, умеренные выделения 600 и тонкий прогресс чтения. Сайдбар, коммерческий CTA и обсуждение скрыты. В конце — кнопка «Поделиться» и до трёх похожих статей из существующей подборки, без карточек и картинок; ссылки сохраняют книжный вид. Липкая шапка содержит круглую аватарку, имя автора со ссылкой на главную и рядом раздел материала. «Рабочая среда» ведёт в каталог с выбранным фильтром /articles/#workspace, сразу к подборке похожих статей. Справа находятся копирование ссылки, общий переключатель дня/ночи с сохранением выбора и возврат к обычному виду. На широком экране справа от текста оглавление с разделами и подразделами; на узком оно сворачивается под шапкой. Шапка без тени и размытия; тонкая нижняя линия появляется только при прокрутке. При переходе по якорю заголовок встаёт на 12 px ниже шапки. Над правым оглавлением нет заголовка и горизонтальной линии; на узком экране остаётся управление раскрытием. Книжный вид появляется после подготовки раскладки и шрифтов, без промежуточного обычного вида. Только для статьи Company OS добавлена ссылка «🔥 ИИ МОДУЛЬ MBA СКОЛКОВО 2026» на it-park.tech. В «Книге» она стоит в одной строке с именем автора и разделом; отдельная строка и горизонтальная черта убраны. На телефоне подпись переносится в пределах блока автора. В обычном виде короткая подпись остаётся над заголовком. Нижняя строка авторства показана без слов «Автор» и «Дата». Ссылки внутри материала сохраняются. У заголовков есть ссылки-якоря: они сохраняют режим чтения и позволяют делиться конкретным разделом; на телефоне значок виден постоянно, на компьютере — при наведении или фокусе. Источники и термины независимы и свёрнуты по умолчанию; раскрываются по клику или прямому якорю. Копирование сохраняет полный URL, крестик возвращает обычный вид без потери остальных параметров и якоря.
Авторство и «Поделиться» собраны под одним разделителем: подпись слева, действие справа. На телефоне кнопка идёт сразу под подписью. Ниже — до трёх похожих статей: целая строка служит ссылкой, стрелка показывает переход, тонкие линии разделяют соседние строки. Карточки, картинки и большие пустые промежутки здесь не нужны. Ссылки сохраняют режим «Книга», а подтверждение копирования не сдвигает список.
По решению Данила от 15 октября 2026 года у переводной статьи строка в конце текста начинается с «Перевод:», а не «Автор:»; имя и ссылка на страницу «Обо мне» остаются, машинные поля автора не меняются. Правило действует для всех переводов. Пример: перевод статьи об INVEST.
В статье «Выращивание промпта» по решению Данила от 11 октября после заголовка нет большой иллюстрации в тексте. Правая липкая иллюстрация сохраняется; исходное изображение обложки используется в социальном превью og:image. Это исключение относится только к данной статье.
Подсказка к термину
Первое содержательное употребление специального слова получает краткое русское объяснение. На широком экране наведите мышь или поставьте фокус клавишей на подчёркнутый термин: тёмная плашка появляется только тогда. Стрелку, постоянную подсветку и отдельный бейдж не добавляем. Текст должен быть понятен и без всплывающей подсказки.
Если действия всегда одинаковые, я пишу обычный скрипт — небольшую программу из последовательности команд.
Если есть статья в глоссарии, термин становится ссылкой на неё с той же подсказкой.
Запрос агенту
Промпт, который читатель отправляет агенту, показываем как сообщение в чате: синее облачко справа, обычный шрифт текста и перенос строк без горизонтальной прокрутки. Подстановки в квадратных скобках выделены только курсивом с лёгкой прозрачностью, без отдельного цвета. Под облачком кнопка «Скопировать» с иконкой; после нажатия иконка становится галочкой. Команду терминала так не оформляем. Если в статье несколько промптов, первый показываем внутри экрана агента .terminal-preview: читатель видит, куда вводится запрос. Дальше промпты идут облачками.
Сделай [задачу] и используй FPF для принятия аргументированного решения.
Команда в терминале
Команду, которую читатель вводит в оболочке, показываем окном терминала. Знак $ рисует CSS, поэтому он не попадает в копию. В заголовке окна указана оболочка. Длинная команда переносится под себя, без прокрутки внутри окна. Если читателю нужно сверить результат, ответ программы идёт приглушённо и без $. Обычный светлый блок кода для команд не используем.
pass insert project/personal-api-tokenEnter password for project/personal-api-token:Retype password for project/personal-api-token:
Файл и короткая команда
Содержимое файла показываем светлым блоком: имя файла в шапке, иконка копирования в правом нижнем углу. После нажатия иконка на мгновение становится галочкой. Та же светлая плашка в одну строку, без шапки и с иконкой справа, подходит для короткой команды в плотном списке, например для установки каждой программы в обзоре. В пошаговой инструкции команда остаётся окном терминала.
Дерево директорий и файлов показываем светлым блоком pre.file-tree: один путь на строку, вложенность — отступом в два пробела, директория заканчивается на /. Пояснение к строке — комментарий после #: он выровнен в одну колонку и приглушён, чтобы не спорить с именами файлов. На телефоне комментарий переносится под свою строку и не уезжает за край. Кнопки копирования нет: структуру читают, а не вставляют. Содержимое файла показываем компонентом «Файл и короткая команда». В исходнике статьи блок помечается языком tree.
Письмо, карточка месяца и страница дайджеста компактны. Страница выпуска собирает все ссылки по темам, а длинные объяснения и большие изображения остаются в самих статьях. Допустим компактный фотоблок; в сентябрьском выпуске это два мотоцикла рядом, каждый снимок не шире 160 px. В сентябрьском выпуске две текстовые колонки; фотографии находятся внутри личного кейса. Скриншот Markless, отдельная третья колонка и обрезка до двух прямоугольников отклонены Данилом. Реестр кейсов расположен в тематическом разделе, а не в шапке выпуска. После уточнения Данила справа стоит стандартная липкая иллюстрационная панель класса «Справка». На узком экране и при печати она скрыта. Четыре выбранных материала выделены полужирным и небольшим 🔥. Между тематическими группами — 16 px, переход к реестру — второстепенный. Фотографии выровнены в кадры 4:3 с сохранением обоих мотоциклов; статус черновика расположен в компактном бейдже рядом с месяцем. В дайджесте панель появляется от 1280 px, чтобы не сжимать текст. Проверять компактность веб-страницы, читаемый шрифт и отсутствие горизонтальной прокрутки на разных экранах. A4 и PDF не являются критериями этой страницы.
Логотип, статус, название и короткое объяснение образуют одну строку-ссылку. Декоративная карточка и лишние рамки не окружают каждый продукт; состояние указано текстом и не конкурирует с названием.
По решению Данила от 20 октября 2026 года каждый из 37 пунктов диагностики промпта и контекста предлагает четыре ответа в порядке «не знаю», «знаю», «практикую», «могу объяснить». «Не знаю» — явный ответ: он сохраняется, учитывается в числе отвеченных пунктов и отдельно показывается в сводке. У пункта без ответа ни одна кнопка не выбрана. Повторное нажатие снимает выбор. На узком экране кнопки переносятся, не расширяя страницу. Правило относится к этой диагностике.
Карточка нужна там, где читатель выбирает путь по своей ситуации. Её площадь целиком является ссылкой; внутри нет второй ссылки. На главной четыре карточки стоят сеткой 2×2 и ведут в разделы публикаций: над заголовком — название раздела, в заголовке — ситуация читателя в кавычках, ниже — одна строка о содержании. Три карточки в ряд и одна под ними не допускаются.
Карточка формата отвечает на вопросы руководителя в одном порядке: цена со сроком и условиями, «Подходит, если» — ситуация читателя без кавычек, чтобы её не приняли за отзыв, результат, состав работы, границы, затем действия. Доказательство ставим одной ссылкой «Пример результата» и только там, где есть настоящий кейс.
Под заголовком — три строки о том, как я работаю, затем одна строка доказательства с огоньком и ссылкой на кейс, затем два шага: сначала бесплатный созвон, формат выбираем на нём. Самодиагностика — необязательная подготовка, отдельной строкой. На широком экране поверх иллюстрации — панель форматов с ценами и кнопкой созвона; формат на экране в ней подсвечен.
По решению Данила от 16 октября 2026 года статьи серии об организационной и агентской памяти сопровождает нативная HTML/SVG-анимация. Она показывает переход опыта в следующее действие, развилку или обратную проверку. Подпись различает механизм работы и авторский пример.
Обычный цикл длится 14 секунд; круглая кнопка с иконкой паузы останавливает текущий шаг, а с иконкой воспроизведения — продолжает цикл. По решению Данила от 17 октября 2026 года действие показано иконкой; текст остаётся в подсказке и доступном имени кнопки. При запросе уменьшенного движения показывается вся статичная схема, вне экрана или на скрытой вкладке цикл не работает. Условия переходов остаются подписаны на стрелках, в том числе при печати и чтении скринридером. Фон прозрачный, цвета и шрифты берутся из общих токенов.
В статье от 1400 px тот же экземпляр схемы находится в правой липкой колонке, ниже доступно оглавление. На меньшей ширине схема возвращается после вводного абзаца и прокручивается с текстом. При недостатке высоты правая колонка прокручивается внутри; элементы не накладываются друг на друга.
В обзоре state/context/memory та же липкая колонка показывает отдельные пути продолжения задачи и сохранения опыта. Подпись отмечает упрощённую авторскую архитектуру.
В схеме проверки результата раскрыты сверка прогноза, проверка цели и четыре альтернативных исхода с условиями на стрелках. Отбор опыта показан отдельной веткой. Далее поиск случаев ведёт к проверке применимости: подходящий способ включается в новый план, иначе нужны новые свидетельства. Новый план возвращает к прогнозу. Для этой расширенной схемы сохранён ритм по две секунды на шаг: десять шагов занимают 20 секунд. В печати она уменьшается до ширины 18rem. Исходы показаны как альтернативы.
Механизм и условный примерОт ошибки к следующей попыткеЧто меняется после неудачной проверки функции дат?
Вся схема
Связи и обратные переходы
Стрелки показывают, откуда берётся следующий шаг. Условия и ограничения разобраны в статье.
Записи для проекта, человека и компании
В авторском примере обзорной статьи ветви от одного события параллельны. Карточка записи постоянно показывает источник, статус и область применения; условие принятия правила остаётся на стрелке. Новая задача входит в проверку отдельно. Доступ проверяют до передачи контекста, применимость — для уже доступной записи.
Подробные карточки используют тот же компонент схемы и увеличенный размер узлов. Подписи остаются читаемыми в активном состоянии, при уменьшенном движении и печати. В широкой статье сохраняются компактная таблица содержимого и подсветка требований.
Авторский условный примерОдно событие — разные записиЧто можно перенести из события в новую задачу?Три ветви параллельны. Правило требует принятия владельцем. Схема не задаёт число хранилищ.
Вся схема
Общий источник, разные основания
До передачи контекста проверяют доступ; затем — применимость. Изменённое основание требует пересмотра затронутой записи и производных.
Схема тематической подборки
По решению Данила от 17 октября 2026 года сама подборка «Организационная и агентская память» получает отдельную анимированную схему. Пометка «Авторская схема темы» и пояснение отличают обзорную рамку от конкретных механизмов в статьях.
От 1400 px схема находится в правой липкой колонке рядом со списком материалов; при коротком окне колонка прокручивается внутри. На меньшей ширине и при печати тот же экземпляр стоит после вводного абзаца. Без JavaScript остаётся статичная схема в тексте. Управление, reduced motion и остановка вне экрана наследуются от общего компонента.
Авторская схема темыОт опыта к следующему действиюКак прошлый опыт помогает решить новую задачу?Общая рамка для чтения. Способы хранения, проверки и обновления различаются.
Вся схема
Связи и обратная проверка
Память помогает выбрать действие. Проверка результата может дать основание пересмотреть запись.
Снимок в статье
Снимок работающей программы занимает ширину содержания. Снимки экрана всегда показываются целиком в исходных пропорциях: запрещены обрезка ради заполнения контейнера, деформация и скругление углов, скрывающее части изображения. Это правило действует и для превью со слайдами. Сайт не добавляет белую подложку, рамку или вложенную карточку. Подпись объясняет, что видно; увеличение открывает исходное изображение. В обзоре интерфейсов несколько снимков одного инструмента собирают в карусель, сохраняя читаемый размер каждого кадра.
Рабочее окно superfile: справа виден предпросмотр PDF. Увеличить снимок.
Фотографии в микро-кейсах
На странице /micro-cases/ доказательный кадр ставим после заголовка, перед результатом и его границей. Каждая фотография сама ведёт к подробной истории; текстовая ссылка повторяет переход. На странице истории каждый кадр открывает полный размер. Это правило относится к подборке микро-кейсов и их подробным историям; для остальных материалов действуют их собственные компоненты. До публичного выпуска проверяем происхождение, приватность и подпись каждого кадра.
Сохраняем активное окно вместе с его родной тенью на прозрачном фоне. Видимый контур занимает всю ширину содержания, а тень выходит за её края. Цветные кнопки в заголовке проверяем после съёмки; кадр с бесцветными кнопками переснимаем. Сайт не добавляет рамку или подложку.
Новые статьи об агентной разработке — без лишних писем.
04 / поведение
Составные паттерны
Паттерн задаёт порядок и поведение нескольких элементов. Его важно смотреть и целиком, и внутри настоящего материала.
Концовка статьи
После текста может появиться один CTA: «Работать со мной» и вторичная ссылка на Telegram-канал. Если у статьи есть подтверждённый маршрут обсуждения, следом идёт блок «Обсуждение». Затем статья предлагает три связанные статьи, каждая целиком кликабельна, и спокойный выход в каталог. Форму подписки статья не повторяет: она находится в каталоге.
Частота CTA. Чтобы блок не примелькался, он показывается не на каждой статье. Счётчик общий для всех страниц с блоком: показ на 1-м и 2-м просмотре, дальше паузы растут на один просмотр до предела «1 из 10» (1, 2, 4, 7, 11, 16, 22, 29, 37, 46, 56, 66…). Повторное открытие той же статьи не считается. После клика по ссылке в блоке читатель сразу переходит на предел; после 90 дней без просмотров отсчёт начинается заново. Без JS или хранилища блок виден всегда. В пропущенный раз на месте блока ничего нет.
Блок нужен, когда в Telegram-канале вышел анонс со ссылкой на эту страницу и подтверждён адрес его обсуждения. Длина и формат материала на сайте не определяют показ. Сейчас компонент подключён к шаблону статей и стоит после текста и возможного CTA, перед связанным чтением; для страницы другого типа его нужно добавить в её шаблон. Без подтверждённого маршрута в реестре, на закрытой от индексации странице или без JavaScript блок не появляется.
Оглавление статьи на широком экране начинается на уровне заголовка. При прокрутке оно остаётся ниже полосы чтения и, если разделов много, прокручивается внутри доступной высоты экрана. В статье с иллюстрацией справа смещается только оглавление, а не сама иллюстрация.
Мини-карта материалов на карте сайта
Только на `/map/` дерево разделов остаётся основной структурой: под «Публикациями» оно ведёт к полной карте материалов, а справа его сопровождает компактная карта пяти тематических групп. Выбор узла показывает короткий маршрут и переход к материалу. На узком экране мини-карта стоит после заголовка, перед деревом.
Карта сайтаГлавнаяРаботать со мнойПриёмы работы с агентомПубликации → Карта материалов
СВЯЗИ МАТЕРИАЛОВОт темы к практике
ПромптАгентная разработкаЗадачиИнциденты
Выбранная тема → материал
Карта материалов как рабочий экран
Карта занимает окно без сайдбара. Заголовок, фильтры, масштаб и крестик возврата плавают поверх поля. На широком экране все фильтры видны в одной строке без внутренней прокрутки; при нехватке места они переходят под заголовок. Карточки можно перемещать, всю карту — сдвигать и масштабировать; материалы раздела объединяет полупрозрачная папка с язычком. При выборе карточки панель даёт краткий конспект и ссылку на полный материал.
Выбранный материалКраткий конспект и переход к полному тексту →
− 100% +
Выбор встречи
Сначала посетитель выбирает цель и длительность, затем дату и время. Календарь показывает полные недели с понедельника по воскресенье: недоступные дни остаются на месте, а текущий день имеет отдельную рамку независимо от доступности. Часовой пояс посетителя виден рядом со временем; недоступное действие не выглядит активным.
Свободные окна — мягкие зелёные. «Забронировать» появляется при наведении и клавиатурном фокусе, на сенсорном экране видна постоянно. Выбранное окно — синее. Между окнами — полупрозрачное диагональное «ЗАНЯТО»: время недоступно для записи, в том числе из-за буферов и правил расписания.
Схема состояний · свободное время и часовой пояс показывает рабочая форма
У лонгрида после заголовка появляется закреплённая полоса с названием и прогрессом. Если боковое оглавление видно рядом с текстом, кнопка «Разделы» его не дублирует; когда оглавление скрыто, кнопка открывает список разделов. На телефоне полоса находится под шапкой сайта.
Внутри обзора
Если читатель выбирает программу по виду интерфейса, после короткого вступления показываем снимки. Для каждого инструмента рядом держим название, снимки, оценку и практические сведения; не разрываем объяснение на две несвязанные части до и после галереи.
Текст сохраняет удобную меру чтения. Снимок, схема или таблица могут занять всю доступную ширину; широкая таблица прокручивается внутри себя. Поля и прокрутка не должны закрывать подписи или текст.
Один и тот же переход не ставим рядом дважды. Просмотры и авторство не занимают место перед первым абзацем: данные об авторе располагаются после текста, перед следующим действием.
В микро-кейсах номер стоит в одной строке с заголовком без отдельной левой колонки. Затем идут связанные с материалом фотографии или скриншот, после них — результат и его граница. Каждое изображение открывает историю кейса либо публичный источник.
Общий левый край и верхняя линия связывают разные страницы. Отступ сверху и слева задаёт общий шелл; обёртки страниц не центрируют колонку и не добавляют второй верхний отступ. Выбор колонок зависит от содержимого: тексту нужна мера чтения, схеме — ширина, рабочему экрану — всё окно. Схемы ниже показывают состав, а ссылки ведут на настоящие страницы.
На странице «Обо мне» короткое вступление ведёт к двум биографическим разделам: 🚀 Сейчас и 📚 В прошлом. Эмодзи здесь сохранены как часть авторской страницы. Отдельного блока «Связь» в её содержании нет: ссылка на контакты уже есть в общем меню.
Контакты. На этой короткой странице иллюстрация «Автор и сотрудничество» занимает правую панель широкого экрана. Фото находится после ссылок на документы: миниатюра открывает сам JPG в браузере, а отдельная ссылка скачивает его. Это решение относится к странице контактов →
Ширина таблицы по содержимому. Для компактной справочной таблицы .table-scroll--auto убирает растягивание на всю колонку и минимальную ширину: браузер подбирает ширину таблицы и столбцов по тексту. На узком экране текст переносится, при необходимости прокручивается только контейнер. По решению Данила от 16 октября 2026 года применяется к таблице «Содержимое памяти» в обзоре агентной памяти.
Подсветка строки и колонки. В четырёхколоночной таблице требований памяти класс .table-crosshair подсвечивает строку и колонку наведённой ячейки, включая заголовок. После ухода указателя подсветка исчезает; на сенсорном устройстве она не включается. Это решение Данила от 16 октября 2026 года для таблицы трёх контуров памяти →
Требование
Разработка ПО
Персональная AI-ОС
AI-ОС компании
Объект памяти
Проект
Человек
Совместная работа
Основание
Код и проверка
Слова человека
Принятое решение
Широкое сравнение с правым оглавлением. В обзоре desktop-агентов текст сохраняет меру чтения, а таблицы занимают всю ширину основной колонки и прокручиваются внутри себя. Перед таблицами можно выбрать до четырёх программ; выбор действует во всех трёх таблицах, пустой выбор показывает все программы. Начиная с широкого десктопа оглавление стоит в отдельной прозрачной колонке у правого края и не перекрывает текст. На более узком экране разделы доступны из закреплённой полосы чтения. Заголовки колонок сочетают логотипы с текстовыми названиями программ. Вся ячейка оценки залита приглушённым цветом, поверх показан белый значок; легенда перед таблицами раскрывает их смысл, а каждая оценка сохраняет пояснение и ссылку на источник. Это правило относится к обзору desktop-агентов →.
Сравнить выбранные программы☑ goose☑ Hermes□ ClaudeВыбор действует во всех таблицах
✓Да◐С оговоркой×Нет?Не подтверждено
Строка выступления
Только на странице выступлений: обложка занимает меньшую часть строки, название и описание остаются рядом. Логотип события виден на обложке; по нажатию видео открывается крупнее. Строка без общей подложки и скруглённой рамки отделяется тонкой нижней линией. Превью показывается целиком в исходных пропорциях, без обрезки и скругления углов; оно не растягивается под высоту текста. Стандартные внешние отступы заголовков и абзацев внутри строки сброшены. Правая хронология содержит все записи в порядке карточек. На узком экране строка складывается в одну колонку.
2016 · 15×4, Чебоксары15 минут о том, как мозг учится
Как обучение меняет мозг: нейропластичность и освоение навыков.
Хабы не собираются из обязательных блоков
Общий шелл, левый край и типографика связывают их между собой. Состав основного содержания следует задаче раздела: шапка, маршруты, иллюстрация и подвал появляются там, где помогают читателю.
Компонент называется «липкая иллюстрационная панель справа». На длинных страницах она занимает правый край окна и остаётся на месте при чтении. Текст сохраняет свою ширину и левое выравнивание. На узком экране панель скрывается; у порога её появления кадр сужается, а не сжимает текст.
Лонгрид получает липкую иллюстрацию по умолчанию. По решению Данила от 17 октября 2026 года она обязательна для новых и обновляемых статей: отдельного напоминания не требуется. Hero в начале и обычное оглавление её не заменяют. Для обычной статьи используется композиция её класса с читаемым оглавлением; для серии памяти — содержательная HTML/SVG-схема, которая на узком экране возвращается в текст. Перед выпуском проверяют липкость при прокрутке и адаптацию. Прямое исключение Данила фиксируется отдельно с областью действия. Пример: state, context и memory →
Автор и сотрудничествоКадр держится за правый край · Обо мне →ПроверкаКадр держится за левый край · Диагностика →Комплект: инцидентыОдна иллюстрация на все материалы · Правила →Комплект: промпт и контекстОбщая панель для хаба и документов · Хаб →Справочные материалыЛипкая панель справа, скрыта на узком экране · Обзор файловых менеджеров →
Выбор изображения
У страниц вне комплекта композиция соответствует задаче читателя. У комплекта своё изображение: его не назначают другому комплекту или обычной странице.
Кадрирование
Для каждой композиции выбирают закреплённый край. Проверяют не только полный кадр, но и выразительность узкого видимого фрагмента.
Проверка
Новую иллюстрацию смотрят на пяти ширинах от скрытой панели до 2000 px, прокручивают страницу и проверяют чтение, обрезку и отсутствие горизонтального скролла.
Правая самопроверка может располагаться поверх иллюстрации на полупрозрачной подложке, а широкая таблица прокручивается внутри своей области: самопроверка →процесс →
В черновой статье «Агенты и большой код» по решению Данила используется панель класса «Справка»: с 1400 px оглавление читается поверх иллюстрации, а таблицы реестра сохраняют прокрутку внутри текстовой колонки. Это назначение относится к данной статье.
В черновике «Paperless в привычных папках» по решению Данила используется панель класса «Справка»: с 1400 px оглавление находится поверх липкой иллюстрации. На меньшей ширине остаётся обычное оглавление; примеры файловых деревьев читаются в основной колонке.
В сентябрьском дайджесте по уточнению Данила используется правая липкая панель класса «Справка». Две текстовые колонки сохраняются; на узком экране и при печати панель скрыта.
07 / глобальная навигация
Меню в сайдбаре
Меню этой страницы — образец общего сайдбара. Вариант от 11 октября подготовлен к просмотру: сверху «С чего начать» и «Обо мне», затем три группы — «Материалы», «Проекты», «Сотрудничество». Дайджесты находятся после публикаций в «Материалах»; open-source инструменты и продукты — в «Проектах». Отдельная ссылка «Дайджест на почту» ведёт к форме в архиве выпусков. Тематические разделы доступны из каталога публикаций. Этот пересмотр структуры ещё не принят как постоянное правило.
Кнопка с лупой рядом с «Материалами» раскрывает поиск по всему сайту; отдельной ссылки «Поиск» в списке нет. Если страница или её раздел представлены в меню, соответствующий пункт отмечается. Социальные ссылки и карта сайта находятся внизу. Сам гид пока не входит в навигацию сайта.
Общий сайдбар
Десктопный сайдбар закреплён слева. При первом посещении он открыт, затем сохраняет выбранное состояние между страницами и после перезагрузки: свёрнутое меню остаётся свёрнутым, пока читатель его не раскроет. Кнопка на правой границе сворачивает меню в рейку шириной 68 px с аватаром и кнопкой «Меню». Это управление одинаково на всех страницах с общим сайдбаром, включая этот гид; состав ссылок страница не копирует в свой HTML.
Кнопка в сайдбаре раскрывает компактное поле и переводит в него фокус; Escape закрывает поле, сохраняя открытым мобильное меню. Без JavaScript поле остаётся доступным. Страница результатов поиска — отдельный экран без сайдбара, биографии и правой иллюстрации (вариант 01, принят 4 ноября 2026). Колонка выдачи расположена по центру. Над формой остаётся только «Назад»: обычный клик возвращает на предыдущую страницу этого сайта; при прямом входе, открытии в новой вкладке или без JavaScript ссылка ведёт к публикациям. Форма точно повторяет форму на странице «Публикации»: видимая подпись «Поиск по всему сайту» обычным шрифтом над полем, поле и кнопка «Найти» в одном ряду; максимальная ширина формы 44rem. Отдельного крупного заголовка «Поиск» сбоку нет. Семантический h1 сохранён для скринридера, но визуально скрыт. Это прямое уточнение Данила по скриншоту формы от 4 ноября 2026. Типографика поля и кнопки не меняется. Счётчик и результаты начинаются сразу под шапкой. После обычного входа черновики включаются в выдачу автоматически. Форма на странице «Публикации» ведёт к тому же поиску по всему сайту. Тип, название и описание результата образуют одну ссылку. Ниже видны до двух фрагментов из полного текста с названием раздела и отдельной ссылкой к нему; ещё до трёх раскрываются через «Ещё фрагменты». Совпавшие слова, целые фразы и русские словоформы выделяются жёлтым фоном в заголовке, описании и фрагментах. Раскрытие остаётся отдельным управлением, вне ссылки. Семантический результат без буквального совпадения отмечается «По смыслу» и показывает исходный текст без подсветки. Это правило относится к выдаче поиска, а не к обычному тексту статей. Неопубликованные материалы помечены и доступны только владельцу.
Первые 15 секунд в десктопном режиме кнопка сворачивания видна постоянно. Затем она появляется при наведении на сайдбар или саму кнопку и при фокусе внутри сайдбара или на кнопке. Появление и исчезновение занимают 250 мс. На сенсорном устройстве с десктопной шириной кнопка остаётся видимой; при предпочтении уменьшенного движения анимации нет. В мобильном режиме этот таймер не отсчитывается.
До 900 px верхняя строка с именем и кнопкой «Меню» остаётся под рукой. Кнопка открывает полноэкранную навигацию; Escape и выбор ссылки закрывают её. Мобильное меню не меняет сохранённый режим сайдбара; при возврате к десктопной ширине прежний выбор восстанавливается.
Карта материалов — отдельный полноэкранный рабочий экран →: вместо сайдбара у неё один крестик возврата к публикациям.
08 / связанный материал
Комплекты и их меню
Комплект соединяет хаб, статью, правила, процесс, шаблоны и справку одной темой. Хаб помогает выбрать маршрут; внутри материалов верхняя полоса показывает состав раздела и текущее место. В публичном тексте она называется меню раздела.
Действующий компонент меню / пример инцидентного раздела
Меню идёт первым, без пустой полосы над ним. На широкой странице оно занимает область до иллюстрации, а название документа начинается на линии текста.
При прокрутке
Полоса остаётся сверху. На телефоне пункты прокручиваются внутри неё по горизонтали; весь документ горизонтально не едет.
Конец материала
Подвал ведёт к следующему материалу и ко всему разделу. Те же ссылки не повторяются рядом ещё одним списком.
Иллюстрация комплекта общая для его хаба и материалов. Рабочая панель, например самопроверка приёмов →, может располагаться поверх иллюстрации с полупрозрачной подложкой. В черновом комплекте метка «Черновик» стоит в строке названия комплекта на каждой странице и не повторяется над заголовком документа.
09 / сентябрь–октябрь
Что закрепили недавно
Эти решения прошли через обсуждение и проверяются на действующих страницах. Эксперименты, от которых отказались, здесь не показаны как правила.
Общий шелл и одна линия начала. Сайдбар, первый элемент и левый край согласованы между типами страниц.Пример →
Навигация длинного чтения. Полоса прогресса появляется после заголовка; кнопка разделов не повторяет видимое оглавление.Пример →
Термин в тексте. Краткое определение появляется в тёмной подсказке при наведении или фокусе, без постоянно горящей стрелки.Образец →
Комплекты без дублей. Хаб показывает маршруты, документ начинается с меню раздела, подвал ведёт дальше.Пример →
Липкая иллюстрационная панель. Изображения назначены по классу страницы; широкие рабочие объекты сохраняют место для чтения.Пример →
Каталог без лишних маршрутов. Выделенные статьи, тематический фильтр и компактный список комплектов помогают выбрать материал.Пример →
Снимок без обвязки. Скриншот занимает ширину содержания, а подпись остаётся рядом с ним; лишний белый бокс не добавляется.Образец →
Прежнее управление сайдбаром статьи — заменено 11.10. Отдельные элементы сворачивания и закрепления уступили общему управлению с кнопкой на границе сайдбара.Действующее правило →
Подписка в одном месте. Форма остаётся в каталоге; статья заканчивается CTA и связанным чтением.Пример →
Карта как рабочий экран. Граф занимает окно, фильтры и выход плавают поверх него, комплекты собраны полупрозрачными папками.Пример →
Одинаковое «Что читать дальше». Три целиком кликабельные строки и ссылка на каталог завершают обычную статью.Пример →
Структура файлов. Дерево директорий — светлый блок, пояснения после # приглушены и на телефоне переносятся под строку.Образец →
Промпт как сообщение. Запрос агенту — синее облачко с кнопкой копирования; подстановки выделены курсивом.Образец →
Команды и файлы. Команда в оболочке — окно терминала, при необходимости с ответом программы; файл и короткая команда в списке — светлый блок с иконкой копирования внизу справа.Образец →
Разделы и путь к услуге. Публикации делятся на четыре раздела по ситуации читателя; главная ведёт в них карточками 2×2, услуги начинаются с доказательства и созвона.Образец →
Сайдбар с кнопкой на границе. Данил выбрал расположение из второго прототипа и поведение третьего: 15 секунд постоянной видимости, затем появление по наведению на сайдбар или фокусу, переходы за 250 мс. Принято для всех страниц с общим сайдбаром; предыдущее решение того же дня об отключении сворачивания отменено. Последующее уточнение Данила: выбранный режим сохраняется между страницами и после перезагрузки. Сенсорный десктоп сохраняет видимую кнопку; мобильное меню не перезаписывает выбранный режим.Пример →
Светлая и тёмная темы. Принята палитра для общего шелла: начальная тема следует настройке устройства, одна кнопка солнце/луна переключает её и сохраняет ручной выбор. Изображения сохраняют исходные цвета, печать — светлую палитру.Правило и образец →
10 / источник правил
Как менять гид
Правила выше — принятые решения для интерфейса сайта. Обсуждения, память агента и работающие страницы помогают установить их происхождение и проверить реализацию; частое повторение варианта само по себе не делает его правилом.
Принять решение
Сверить прямое решение Данила, действующие инструкции агенту, историю обсуждения и реальные страницы. Проверить более поздние исправления и отказ от варианта. Спорный вариант не выдавать за канон до разрешения расхождения.
Показать и записать
Повторяемое правило сопровождают явной инструкцией, видимым образцом и ссылкой на действующую страницу. При изменении компонента обновляют их вместе с HTML, CSS или JavaScript. Техническая карта в docs/design-registry.md показывает файлы и исключения.
Сохранить границы
Значения палитры и шрифтов менять в tokens.css; URL и статус материала — в контентных контрактах. История эксперимента не становится новым правилом без принятого решения.
Общие ограничения
Один шелл и один компонент. Страницы используют общий шелл; повторяющийся элемент определяется в общем CSS-слое. Секционный CSS добавляет уникальное, не переписывая общие стили.
Одна система действий. Кнопки используют .btn и варианты --primary, --ghost. Кнопки бронирования и CTA статьи повторяют значения из-за действующих скриптов; Telegram-кнопка статьи — отдельное цветовое исключение.
Прямая геометрия. Контейнеры, кнопки, чипы и таблицы без скруглений. Скруглены только изображения в статье, аватар и всплывающая подсказка.
Два масштаба заголовка. Обычная страница и документ используют общий h1; плакатный размер принадлежит шапке хаба и hero услуги.
Токены вместо новых цветов. Повторяемая палитра и типографика живут в tokens.css. Локальный цвет допустим лишь у изолированного внешнего бренда или одноразовой визуализации с объяснением и проверенным контрастом.
Без второго слоя оформления. Страницы не используют инлайн-стили или CSS-фреймворк с CDN; служебные архивы отдельно отмечаются как исключения.
11 / качество
Как проверять интерфейс
Содержание и навигация
Название ссылки обещает то, что откроется. Повторные пути не заставляют выбирать между одинаковыми действиями.
Клавиатура и контраст
До каждого действия можно дойти клавишей Tab; видимый фокус и текст сохраняют читаемость на своих подложках.
Шесть ширин
Проверять весь экран и всю страницу на 360, 390, 820, 1024, 1440 и 1800 px. Длинная строка, таблица или схема не сдвигает страницу горизонтально.
Учебная программа / локальный образец
Три уровня одной темы
По решению Данила от 22 октября 2026 года раздел «Практика внедрения баз знаний» имеет уровни «Понять», «Применить», «Спроектировать». Уровни открываются независимо и имеют прямые ссылки; без JavaScript весь материал доступен последовательно. Отметка прохождения — самооценка, сохраняемая в браузере. Правило относится к этой программе.
После ревью на лаконичность главная использует один список тем: выбор роли отмечает рекомендации в нём, поиск расположен над ним. Прогресс появляется рядом с «Продолжить» после начала обучения. Общие пояснения об источниках и адаптации находятся в библиографии; у уровня остаётся ссылка на них.
По уточнению Данила роли показаны видимыми метками с одиночным выбором: «Все роли», «Внедренец», «Эксперт», «Редактор», «Разработчик». Выбранная метка выделена фоном и нижней линией, с клавиатуры доступны Tab и стрелки. На телефоне метки переносятся. Пояснение глубины озаглавлено «В каждой теме — три уровня»; перед подвалом главной остаётся один разделитель.