Справка и источники

Схема конфигурации

JSON Schema для конфигурации проекта Lagune, дающая автодополнение и проверку в редакторе, следуя текущей версии Lagune или с закреплением конкретной версии.

.lagune/configs.json фиксирует категории, которые использует проект, и индексирует его собственные специализации. Его JSON Schema позволяет редактору автодополнять каждое поле и помечать опечатку или неизвестную категорию прямо во время правки файла.

Текущая схема​

Каждый раз, когда Lagune записывает файл и не находит в нем $schema, он указывает в файле текущую схему:

{
"$schema": "https://lagune.ai/schemas/configs.json",
"categories": ["owasp", "javascript"]
}

Этот адрес всегда следует за текущей версией Lagune. Файл, записанный до Lagune 0.16.0, получит его при следующем изменении, а до тех пор каждая фаза будет об этом напоминать.

Закрепление версии​

Каждый релиз Lagune начиная с 0.16.0 несет схему в том виде, в каком она была в этой версии, опубликованную в npm и раздаваемую через jsDelivr. Чтобы закрепить версию, укажите нужную версию после lagune@ в адресе $schema:

{
"$schema": "https://cdn.jsdelivr.net/npm/lagune@0.16.0/schemas/configs.json"
}

Версия принимает любой диапазон semver:

ВерсияСхема
0.16.0Схема из 0.16.0
0.16.x или 0.16Схема из последнего релиза 0.16
0.x или 0Схема из последнего релиза 0.x
latestСхема из последнего релиза

Частые вопросы

Нет. Схема помогает только редактору, а Lagune читает файл одинаково с $schema и без него.

Нет. Lagune записывает $schema, только если в файле его нет, и сохраняет любой адрес, который вы задали.

Когда проект работает с конкретной версией Lagune, чтобы редактор проверял файл по тому, что принимает эта версия.