Команды

Список команд

notepub index
notepub serve
notepub build
notepub validate
notepub template check
notepub template update --apply
notepub help
notepub version

Приоритет путей

Разрешение пути config:

1. --config
2. CONFIG_PATH
3. config.yaml

Разрешение пути rules:

1. --rules
2. RULES_PATH
3. rules_path из config
4. rules.yaml рядом с config или в текущей директории

index

notepub index --config ./config.yaml --rules ./rules.yaml

• валидирует rules
• сканирует контент-источник
• обновляет snapshot и artifacts
• завершает работу с ошибкой при нарушениях контракта

serve

notepub serve --config ./config.yaml --rules ./rules.yaml --addr :8081

• загружает тему и resolve store
• отдает маршруты, assets, media, search endpoints
• поддерживает graceful shutdown по SIGINT/SIGTERM

build

notepub build --config ./config.yaml --rules ./rules.yaml --dist ./dist

Флаги:

• --dist — директория output
• --artifacts — директория артефактов
• --no-index — не запускать auto-index при отсутствии resolve
• --generate-search — сгенерировать search.json, если он отсутствует

validate

notepub validate --config ./config.yaml --rules ./rules.yaml --links

Флаги:

• --resolve — явный путь к resolve-файлу
• --links — валидация связей (нужен resolve.json)
• --markdown — markdown-диагностика
• --markdown-strict — падение команды при markdown-warning
• --markdown-format text|json — формат вывода диагностики
• --output <path> — запись markdown-диагностики в файл

Примеры:

notepub validate --config ./config.yaml --rules ./rules.yaml --resolve ./artifacts/resolve.json --markdown
notepub validate --config ./config.yaml --rules ./rules.yaml --resolve ./artifacts/resolve.json --markdown --markdown-strict

template check / template update

notepub template check
notepub template update
notepub template update --apply

• template check: статус инфраструктуры шаблона + manual findings.
• template update: dry-run по умолчанию.
• template update --apply: обновляет распознанные инфраструктурные файлы (build/workflow/config wiring), не трогая контент.

Коды выхода

• 0 — успех
• 1 — runtime/config/content ошибки
• 2 — ошибки использования/флагов