Блок кода не тем шрифтом: порядок каскада CSS и :where()

Введение

На русской половине этого сайта у блоков кода Python было сразу две проблемы. В одних блоках код рисовался шрифтом Calibri, и отступы по PEP 8 разъезжались. В других строки, обёрнутые в <code>, шли другим моноширинным шрифтом, чем строки без него. Разметка страниц тут ни при чём: обе проблемы решал каскад CSS.

В статье старая отрисовка показана рядом с исправленной, вживую на этой странице, разобрано, какое правило побеждало и почему, и показано исправление. Блоки «до» рисуют замороженные копии старых правил, классы legacy-*, о которых в конце.

Симптом

Статья про перенос длинной строки в Python приводит правила PEP 8 для переноса аргументов. В блоке нет строк <code>, текст лежит прямо в <p class="pycode p2">. До исправления он выглядел так:

До исправления, русские страницы (legacy-pycode legacy-p2):

# Правильно: # Выравнивание по открывающей скобке. foo = long_function_name(var_one, var_two, var_three, var_four) # Второй вариант так называемый "Подвешенный" отступ. foo = long_function_name( var_one, var_two, var_three, var_four)

После исправления (pycode p2):

# Правильно: # Выравнивание по открывающей скобке. foo = long_function_name(var_one, var_two, var_three, var_four) # Второй вариант так называемый "Подвешенный" отступ. foo = long_function_name( var_one, var_two, var_three, var_four)

В обоих блоках перед var_three одни и те же 25 пробелов. В Calibri пробел гораздо уже буквы, поэтому вторая строка не доходит до открывающей скобки, под которой должна стоять.

Причина 1: два правила одного веса

Каждая отдаваемая таблица стилей сайта склеена из двух файлов: сначала общее ядро, затем небольшой файл сайта. Русская таблица заканчивается файлом source/sites/devhops/site_specific.css. Шрифт одному и тому же элементу, <p class="pycode p2">, задавали два правила, в таком порядке:

/* ядро, source/_codeblocks.css: специфичность 0,1,0 */ .pycode { font-family: sfmono-regular, menlo, monaco, consolas, liberation mono, "Courier New", monospace; } /* ниже, source/sites/devhops/site_specific.css: специфичность 0,1,0, побеждает */ .p1,.p10,.p100,.p12,.p15,.p2,.p20,.p3,.p4,.p5,.p7,.p8{box-sizing:border-box;font-family:calibri,sans-serif}

Каждый селектор состоит из одного класса, значит специфичность у них одинаковая. При равном весе каскад сравнивает порядок в таблице, и побеждает правило, стоящее ниже. Файл сайта всегда идёт после ядра, поэтому Calibri перебивал шрифт кода на каждом элементе, у которого был и класс кода, и класс .p1–.p8.

В английском файле сайта правила шрифта для этих классов абзацев нет, поэтому на английских страницах блок оставался моноширинным.

Причина 2: строки code берут шрифт браузера

Большинство блоков кода оборачивают каждую строку в <code>: счётчик CSS на code рисует номера строк. Ни одно правило сайта не задавало шрифт для code, поэтому действовала таблица стилей самого браузера: code { font-family: monospace }, то есть моноширинный шрифт браузера и операционной системы по умолчанию. Текст вне <code> берёт набор шрифтов блока. На одной странице получалось два разных моноширинных шрифта.

До исправления, английские и русские страницы (legacy-pycode p2):

url = your_base_url + \ "/monitor-service/api/v1/components/744618a0-78c5-4e19-78f4-6d215bde64a5"

После исправления (pycode p2):

url = your_base_url + \ "/monitor-service/api/v1/components/744618a0-78c5-4e19-78f4-6d215bde64a5"

Какие шрифты на самом деле использовал Chrome в Linux: до исправления на живых страницах и после, на тех же страницах с исправленной таблицей стилей:

ТекстДоПосле
текст блока без <code>, русская страницаLiberation Sans (Calibri не установлен, поэтому sans-serif)Liberation Mono
текст блока без <code>, английская страницаLiberation MonoLiberation Mono
строки внутри <code>, обе страницыDejaVu Sans MonoLiberation Mono

В Windows моноширинный шрифт браузера по умолчанию обычно Consolas, который стоит и первым доступным в наборе блока, поэтому там два блока выше могут выглядеть одинаково. В Linux и macOS они различаются.

Исправление

1. Шрифт абзацев получает нулевую специфичность. В файлах русского сайта и testsetup список селекторов уходит внутрь :where():

/* было */ .p1,.p10,.p100,.p12,.p15,.p2,.p20,.p3,.p4,.p5,.p7,.p8{box-sizing:border-box;font-family:calibri,sans-serif} /* стало */ :where(.p1,.p10,.p100,.p12,.p15,.p2,.p20,.p3,.p4,.p5,.p7,.p8){box-sizing:border-box;font-family:calibri,sans-serif}

:where() весит 0,0,0, что бы в нём ни стояло. Каскад сравнивает специфичность раньше порядка, поэтому любой класс, который сам задаёт шрифт тому же элементу, теперь побеждает, где бы он ни стоял в таблице. У простого <p class="p2"> другого правила шрифта нет, и он остаётся в Calibri.

2. Строки блока кода наследуют шрифт блока. Одно правило в source/_codeblocks.css, сразу после счётчика строк:

:is(.somecode, .phpcode, .pycode, .shellscript, .jsoncode, .course_skeleton, .rubycode, .asmcode, .cobolcode, .ccode, .cppcode, .dotnetcode, .elixircode, .haskellcode, .erlangcode, .fortrancode, .gocode, .groovycode, .javacode, .jscode, .rustcode, .typescriptcode, .htmlcode, .csscode, .perlcode, .thriftcode, .csharpcode, .zplcode, .powercode, .robocode, .yamlfile, .dockerfile, .markdown, .ini) code { font-family: inherit; }

В списке только классы блоков кода. Встроенный <code> внутри обычного абзаца намеренно сохраняет моноширинный шрифт браузера: в Calibri он перестал бы быть похож на код. Тест сверяет список с классами блоков кода, которые определены в файле, так что новый язык не выпадет из списка.

Затем пересобираются четыре отдаваемые таблицы. Из папки container репозитория:

css_pipeline/copy-prod-css.sh

Почему :where(), а не другой способ

СпособПочему нет
Удалить font-family из правила .p1–.p8Ни один предок этих абзацев не задаёт Calibri, и в проверке простые абзацы переключились на Times New Roman.
Повторить шрифт кода для всех 34 классов кода после правила абзацевРаботает, но список живёт в двух файлах сайтов и должен догонять каждый новый класс кода.
Поднять специфичность классов кода, например p.pycodeЗатрагивает 34 группы правил, общих для всех четырёх сайтов.
Убрать p2 из блоков кода в разметкеОколо 3470 файлов сочетают класс кода с классом абзаца.
code { font-family: inherit } для каждого элемента code767 встроенных <code> в абзацах .p2 стали бы рисоваться Calibri.

:where() и :is() работают во всех браузерах, вышедших с начала 2021 года, а минификатор сборки, lightningcss, оставляет оба как есть.

Побочный эффект: блоки-выноски

На русских страницах Calibri перебивал любой класс абзаца .p1–.p8, не только блоки кода. После исправления эти блоки получают собственные шрифты, те же, что всегда были на английских страницах:

КлассЭлементов на русских страницахШрифт после исправления
path842набор Palatino
action561моноширинный набор блоков кода
info365набор Consolas
email58набор Consolas
answer, question29, 16Verdana
command, cmdout, quo9, 6, 4моноширинные наборы

Блок из статьи о том, как прикрепить файл к запросу ИИ. До исправления, русские страницы (info legacy-p2):

Прикреплённый файл целиком уходит провайдеру модели. На бесплатной модели OpenCode это может означать тариф для участников, который учится на запросах. Никогда не прикрепляйте учётные данные, файлы .env, данные клиентов или логи доступа.

После исправления (info p2):

Прикреплённый файл целиком уходит провайдеру модели. На бесплатной модели OpenCode это может означать тариф для участников, который учится на запросах. Никогда не прикрепляйте учётные данные, файлы .env, данные клиентов или логи доступа.

Как проверить страницу

Объявленный шрифт и шрифт на экране — разные вещи: первое список, второе первый шрифт из списка, который есть в системе. Chrome DevTools показывает и то, и другое:

Таблицы выше получены в Chrome без окна: команда протокола DevTools CSS.getPlatformFontsForNode возвращает тот же список, что и Rendered Fonts.

Классы legacy на этой странице

После исправления обычные классы уже не рисуют по-старому, поэтому блоки «до» на этой странице используют замороженные копии старых правил. Они лежат в source/_legacy_codeblocks.css, последнем файле общего ядра, и повторяют старый порядок: сначала .p2 из ядра, потом .pycode, потом шрифт Calibri из файла сайта.

КлассКопия чегоЧто сохраняет
legacy-p2.p2 из ядра плюс шрифт Calibri из файла русского сайтаCalibri побеждает соседний класс
legacy-pycode.pycode на 18.11.2026строки <code> моноширинным шрифтом браузера: класса нет в списке :is()

<p class="legacy-pycode legacy-p2"> <!-- русские страницы до исправления --> <p class="legacy-pycode p2"> <!-- английские страницы до исправления --> <p class="info legacy-p2"> <!-- блок-выноска на русских страницах до исправления -->

Они нужны только для этого сравнения. Новые страницы используют обычные классы.

Автор статьи: Клавдия Кондакова