Базовый транспайлинг из Pug в HTML

YDA использует HTML-препроцессор Pug 3 для работы с разметкой, при этом написание исходного кода на чистом HTML не поддерживается. Хотя со времён выхода версии 3 добавление новой функциональности не осуществляется, а владельцы репозитория на GitHub не сделали комментариев по поводу будущего препроцессора , аналога, сочетающего в себе предельно лаконичный синтаксис с богатой функциональностью включая возможность описания логики на JavaScript (обычно такое не приветствуется, но в определённых ситуациях крайне полезно) не разработано и не поддерживается. До тех под, пока ситуация не изменится, YDA продолжит специализироваться на данном препроцессоре. Кроме того, уязвимости версии 3 были быстро устранены, что указывает на наличие минимально необходимой поддержки проекта.

Минимальные настройки

Для того, чтобы настроить минимальную обработку Pug-файлов, необходимо определить в файле настроек YDA (обычно это yda.config.yaml) хотя бы одну группу точек входа в projectBuilding.markupProcessing.entryPointsGroups, а именно:

• Идентификатор группы точек входа
• Относительный путь с директории с входными файлами
• Зависящий от режима сборки проекта относительный путь с директории с выходными файлами

Пример

Начальный пример включает в себя обработку двух Pug-файлов: index.pug и about.pug. Так как пример близок к простейшему, то:

• Будет только один режим сборки — эксплуатационный («продакшен»)
• Автоматической пересборки проекта при внесении изменений в исходных код не будет.
• Готове HTML-файлы в браузере автоматически не откроются.

$projectBuilding:

  $commonSettings:

    $publicDirectoriesRelativePaths:

      $production: ProductionBuilding

  $markupProcessing:
  
    $entryPointsGroups:
  
      All:
        $sourceFilesTopDirectoryRelativePath: Source
        $buildingModeDependent:
          $production:
            $outputTopDirectoryRelativePath: ProductionBuilding