Инструменты Digitable

Форк CorentinTh/it-tools — набора браузерных утилит для разработчика. Живой инстанс: tools.digitable.life.

Инструменты, их код и вся функциональность — работа апстрима. Digitable поменял оформление и айдентику инстанса и добавил русскую локаль.

Что изменено относительно апстрима

Область	Изменение
Тема	Палитры Digitable Focus (Carbon для тёмного режима, Paper для светлого) подключены в сборку через src/main.ts; расширение браузера не нужно
Айдентика	Заголовок вкладки, описание, favicon и иконки PWA, логотип в боковой панели, канонический URL, карточки для соцсетей
Ссылки	Кнопка репозитория ведёт на исходники этого инстанса, кнопка портала — на courses.digitable.life; в подвале указаны апстрим, лицензия и портал
Локализация	Добавлена locales/ru.yml, русский стал языком по умолчанию, английский — резервным

Изменённые файлы помечены комментарием с датой и указанием, кто их менял, как того требует §5 GPL-3.0. Диф относительно апстрима держится минимальным, чтобы обновляться за ним было дёшево.

Тема

Три палитры лежат в src/digitable/:

• digitable-focus-carbon.css — тёмный режим (html.dark), по умолчанию;
• digitable-focus-paper.css — светлый режим (html:not(.dark));
• digitable-focus-signal.css — альтернативный тёмный режим.

Carbon и Paper подключены одновременно: их селекторы не пересекаются, поэтому штатный переключатель солнце/луна продолжает работать. Чтобы взять Signal вместо Carbon, замените одну строку импорта в src/main.ts.

Файлы генерируются из палитры Digitable и правятся не вручную, а в генераторе тем Digitable Workbench (products/workbench/scripts/targets/it-tools.mjs в репозитории Digitable Courses) — он источник, здесь лежит его вывод. Правка прямо в этом дереве будет затёрта следующим прогоном генератора.

Единственное отличие здешних копий от вывода генератора — лицензионная шапка в начале каждого файла. Она обязательна: кому принадлежат эти три файла и почему они раздаются отсюда под GPL-3.0, а вне этого репозитория — на других условиях, объяснено в NOTICE.

Сборка

pnpm install
pnpm build

Требуется Node.js из .nvmrc (18.18.2; в CI выкатки стоит 20). На Node 24 шаг vue-tsc --noEmit не проходит, а pnpm exec vite build — проходит.

Остальные команды разработки не менялись — они описаны в README апстрима.

Лицензия

Проект остаётся под GNU GPLv3, как и апстрим. Файл LICENSE и авторские уведомления не менялись и меняться не должны.

Автор IT Tools — Corentin Thomasset. Форк не заменяет и не представляет его проект; это его код с нашим оформлением.

Полное изложение — что здесь чьё, какие обязательства GPL-3.0 из этого следуют и чем они закрыты — в NOTICE. Механически проверяемая часть этих обязательств сторожится скриптом:

node scripts/check-licensing.mjs

Он сверяет LICENSE с апстримом побайтово, требует SPDX-шапку в каждом файле темы, наличие NOTICE с атрибуцией автора апстрима и ссылку на исходники этого инстанса в самом приложении. Падает с перечислением того, чего не хватает. Сверка LICENSE требует remote upstream; без него этот пункт помечается как пропущенный, а не как пройденный.