Блок кода не тем шрифтом: порядок каскада 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 Mono | Liberation Mono |
| строки внутри <code>, обе страницы | DejaVu Sans Mono | Liberation 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 } для каждого элемента code | 767 встроенных <code> в абзацах .p2 стали бы рисоваться Calibri. |
:where() и :is() работают во всех браузерах, вышедших с начала 2021 года, а минификатор сборки, lightningcss, оставляет оба как есть.
Побочный эффект: блоки-выноски
На русских страницах Calibri перебивал любой класс абзаца .p1–.p8, не только блоки кода. После исправления эти блоки получают собственные шрифты, те же, что всегда были на английских страницах:
| Класс | Элементов на русских страницах | Шрифт после исправления |
|---|---|---|
| path | 842 | набор Palatino |
| action | 561 | моноширинный набор блоков кода |
| info | 365 | набор Consolas |
| 58 | набор Consolas | |
| answer, question | 29, 16 | Verdana |
| command, cmdout, quo | 9, 6, 4 | моноширинные наборы |
Блок из статьи о том, как прикрепить файл к запросу ИИ. До исправления, русские страницы (info legacy-p2):
Прикреплённый файл целиком уходит провайдеру модели. На бесплатной модели OpenCode это может означать тариф для участников, который учится на запросах. Никогда не прикрепляйте учётные данные, файлы .env, данные клиентов или логи доступа.
После исправления (info p2):
Прикреплённый файл целиком уходит провайдеру модели. На бесплатной модели OpenCode это может означать тариф для участников, который учится на запросах. Никогда не прикрепляйте учётные данные, файлы .env, данные клиентов или логи доступа.
Как проверить страницу
Объявленный шрифт и шрифт на экране — разные вещи: первое список, второе первый шрифт из списка, который есть в системе. Chrome DevTools показывает и то, и другое:
- Щёлкните блок правой кнопкой и выберите Inspect («Посмотреть код»).
- На вкладке Computed свойство font-family показывает набор, победивший в каскаде; раскройте его, чтобы увидеть правило и файл, откуда он взят.
- Внизу той же вкладки раздел Rendered Fonts перечисляет шрифты, которыми текст нарисован на самом деле, с числом глифов.
- Выделите строку <code> внутри блока и сравните: до исправления её набор был просто monospace.
Таблицы выше получены в 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"> <!-- блок-выноска на русских страницах до исправления -->
Они нужны только для этого сравнения. Новые страницы используют обычные классы.
Автор статьи: Клавдия Кондакова