$stylesProcessing — Настройки обработки стилей

Обработка стилей может быть настроена в $projectBuilding.$stylesProcessing файла конфигурации (yda.config.yaml по умолчанию):

$projectBuilding:

  $stylesProcessing:

    # Задайте настройки обработки стилей здесь в соответствии с данным руководством

$common — общие настройки

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

$projectBuilding:

  $markupProcessing:

    $common:

      $staticPreview:

        # Определите здесь настройки для режима статического превью

      $localDevelopment:

        # Определите здесь настройки для режима локальной разработки

      $testing:

        # Определите здесь настройки для режима тестирования

      $staging:

        # Определите здесь настройки для режима инсценирования

      $production:

        # Определите здесь настройки для режима «продакшен»

Данная подкатегория включает в себя нижеследующие настройки.

$secondsBetweenFileUpdatingAndStartingOfRebuilding — секунд между сохранением файла стилей и началом пересборки

Определяет, сколько секунд должно пройти с момента сохранения исходного файла стилей (то есть Stylus-файла) до начала нового цикла обработки файлов стилей включая преобразование из Stylus в CSS. Актуально для инкрементальных режимов сборки (статическое превью, локальная разработка).

Даже если редактор кода или интегрированная среда разработки может сохранять несколько файлов [+Keyword--YDID разом], на самом деле они сохраняются не одновременно, а с разницей в несколько миллисекунд. Кроме того, обнаружение изменения статуса файлов соответствующими утилитами также происходит с небольшой, но задержкой. Ввиду этого, без специальных мер будет одна пересборка на каждый сохранённый файл, что будет давать всё большую нагрузку на аппаратное обеспечение по мере увеличения количества файлов, пока станет невозможно осуещствлять разработку в нормальном режиме. Чтобы это оптимизировать, необходимо подождать некоторое время после того, как один файл будет сохранён — возможно вслед за ним через несколько миллисекунд будет замечено сохранение последующих файлов.

В YDA на инкрементальных режимах сборки после сохранения одного Stylus-файла запускается таймер ожидания пересборки, который истекает через secondsBetweenFileUpdatingAndStartingOfRebuilding секунд. Если до истечения этого таймера не будет сохранено ни одного последующего Stylus-файла, то запустится новый цикл обработки Stylus-файлов. Если же до истечения этого таймера будет сохранён ещё один Stylus-файл, то таймер ожидания будет перезапущен, и так до тех пор, пока в течение secondsBetweenFileUpdatingAndStartingOfRebuilding не будет сохранено ни одного последующего Stylus-файла.

Значения по умолчанию достаточно для начальной, стадии разработки, когда обычно количество файлов невелико. Однако когда количество файлов станет порядка несколько десятков, может стать желательным увеличить значение secondsBetweenFileUpdatingAndStartingOfRebuilding. Поскольку по умолчанию обнаружение изменений в Stylus-файлах и начало обработки каждого Stylus-файла логируются, то Вы сможете заметить потребность в изменении значения secondsBetweenFileUpdatingAndStartingOfRebuilding.