Допоміжні скрипти
Всі скрипти знаходяться в .github/scripts/.
check-i18n-helper.sh
Перевіряє, чи сторінки локалізації містять необхідне поле default_lang_commit у front matter. Якщо сторінки не містять цього поля, скрипт виводить команду виправлення:
npm run fix:i18n:new
check-links-shard.sh
Виконує перевірку посилань для певного фрагмента, тимчасово змінюючи файл .htmltest.yml.
.github/scripts/check-links-shard.sh [-qk] <shard-id> <shard-regex>
| Прапорець | Опис |
|---|---|
-q | Тихий режим |
-k | Залишати змінений файл .htmltest.yml (стандартно: відновлювати після запуску) |
-h | Показати довідку |
Скрипт вставляє регулярний вираз фрагмента в конфігурацію IgnoreDirs, запускає npm run __check:links і відновлює оригінальний файл конфігурації, якщо не використовується -k.
check-refcache.sh
Порівнює специфічні для фрагмента файли refcache.json з основним static/refcache.json, щоб виявити невідповідності кешу після перевірки посилань.
.github/scripts/check-refcache.sh [directory]
Стандартна тека: tmp/check-refcache. Якщо виявлено відмінності, скрипт пропонує запустити npm run fix:refcache або додати коментар /fix:refcache до PR.
pr-approval-labels.sh
Керування мітками затвердження PR на основі стану рецензії та власності файлів. Викликається робочим процесом pr-approval-labels.
Як це працює:
- Завантажує дані PR (змінені файли, останні рецензії, поточні мітки) за допомогою
gh. - Визначає членів команди
docs-approversза допомогою API GitHub org. - Визначає необхідні команди SIG, зіставляючи змінені файли з
.github/component-owners.yml(аналізує YAML вручну, без залежності відyq). - Перевіряє, чи кожна необхідна група має схвальний відгук.
- Додає або видаляє мітки, використовуючи логіку трьох станів (
true/false/unknown), щоб уникнути зміни міток, коли членство в команді не може бути отримано.
Потрібні змінні: REPO, PR, GITHUB_TOKEN.
update-registry-versions.sh
Автоматично оновлює версії пакунків у файлі data/registry/*.yml, запитуючи дані з висхідних реєстрів. Підтримує: npm, Packagist, RubyGems, Go, NuGet, Hex, Maven.
- У CI (набір
GITHUB_ACTIONS): створює гілку та відкриває PR. - Локально: стандартно працює в режимі dry-run. Використовуйте
-f, щоб примусово зробити реальне виконання.
Дедуплікує PR, генеруючи тег SHA-1 із підсумку оновлення.