Настройка сборника «Чертоги Фрилансера» 4

На этой странице описаны настройки сборника «Чертоги Фрилансера» 4 (Далее ЧФ4).

ЧФ4 построена так, чтобы как можно больше возможностей можно было настроить под пользовательские потребности.

Для того чтобы настроить сборку, открываем файл template.config.js в папке проекта.

Список настроек:

• lang — Настройка языка сообщений ЧФ4 в терминале и консоли: ru/en
• vscode — Настройка редактора VS Code
  • settings — Автоматическая настройка псевдонимов для проекта (плагин Path Autocomplete )
  • snippets — Автоматическое добавление снипетов ЧФ4 в проект
• devcomponents — Настройка страницы разработки компонентов
  • включить — Переключатель: true/false
  • filename — имя файла страницы
• git — Настройка загрузки на GitHub
  • repo — Путь репозитория
  • филиал — Филиал
• navpanel — Настройка навигационной панели
  • dev – в режиме разработчика. Включатель: true/false
  • build – в режиме продакшена. Включатель: true/false
  • position — Вывод панели: left/right
  • color — Цвет текста и ссылок
  • background — Цвет фона
  • transition — скорость анимации открытия в миллисекундах
• statistics — Управление сбором и выводом статистики проекта
  • enable – разрешить сбор статистики. Включатель: true/false
  • showonbuild – автоматический вывод статистики в режиме продакшн. Включатель: true/false
• server — Настройка локального сервера
  • path — Настройка путей к файлам: ./ — относительный, / — абсолютный
  • isassets — Добавляет возможность собирать проект таким образом, чтобы файлы JS и CSS были размещены в папке dist/assets. Включатель: true/false
  • buildforlocal – добавляет возможность собирать проект таким образом, чтобы его можно было открывать в файловом проводнике (без сервера). Внимание! При использовании все JS и CSS файлы будут принудительно собраны в файл. Включатель: true/false
  • copyfiles – Копирование файлов из папки src/files в dist/files в режиме продакшн. Включатель: true/false
  • version – добавление уникальной версии к конечным CSS/JS файлам. Включатель: true/false
  • hostname — название сервера
  • порт — порт сервера
• html — Настройка обработки HTML-файлов
  • beautify — форматирование в режиме продакшн
    • включить — Переключатель: true/false
    • indent — Настройка типа отступов
• styles — Настройка работы со стилями и отделкой SCSS/CSS-файлов
  • tailwindcss – Подключить Tailwindcss. Включатель: true/false
  • pxtorem – переводить PX в REM в режиме продакшн. Включатель: true/false
  • critical – создать и добавить в HTML-файлы критические CSS-стили. Включатель: true/false
  • codesplit – разделять CSS-фалы на отдельные и подключать соответствующим HTML-страницам в режиме продакшн. Включатель: true/false
  • devfiles – создание несжатых копий файлов в режиме продакшн. Включатель: true/false
• fonts — Настройка обработки шрифтов
  • iconsfont – создание шрифта из SVG иконок (иконочного шрифта) и подключение его в проект. Включатель: true/false
  • download — Загружать и делать локальными шрифты подключенные удаленно (например с Google Fonts). Включатель: true/false
• images — Настройка обработки изображений
  • svgsprite – создание спрайта из SVG-иконок и подключение его в проект. Включатель: true/false
  • optimize — Настройка оптимизации изображений в режиме продакшн
    • enable – Включатель: true/false. Если оптимизация отключена изображения просто копируются без конвертации и оптимизации
    • edithtml – вносить изменения в HTML-файлы. Если включено, то HTML-файлы будут изменены в соответствии с настройками конвертации и создания дополнительных размеров изображений
    • sizes – размеры файлов, которые будут дополнительно созданы
    • dpi — Множители для создания дополнительных файлов
    • attrignore — Атрибут тега IMG при наличии какого-либо изображения не будет обработано
    • modernformat — Настройка конвертации в современные форматы
      • включить — Переключатель: true/false
      • type — Формат изображения в который необходимо конвертировать: webp/avif
      • only – оставлять только файлы в современном формате после конвертации. Включатель: true/false
      • quality — качество изображения
    • jpeg — Настройка оптимизации изображений
      • quality — качество изображения,
    • png — Настройка оптимизации изображений
      • quality — качество изображения
• js — Настройка обработки JavaScript-файлов
  • hotmodules — «Горячее» подключение компонентов. Включатель: true/false
  • devfiles – создание несжатых копий файлов в режиме продакшн. Включатель: true/false
  • bundle — Настройка формирования конечного файла в режиме продакшн
    • enable – Система собирает весь код в один JS и один CSS файлы независимо от настройки styles -> codesplit. Включатель: true/false
• react – включает обработку React. Включатель: true/false
• vue – включает обработку Vue. Включатель: true/false
• php — Настройка PHP-сервера
  • включить — Переключатель: true/false
  • base — Путь к папке где находятся файлы PHP
  • hostname — Имя хоста
  • port — Порт
  • binary — Путь к папке где установлен интерпретатор PHP
  • ini — Путь к файлу настроек php.ini
• pug — Настройка препроцессора PUG
  • включить — Переключатель: true/false
• ftp – настройка отправки конечных файлов (из папки dist) на сервер (хостинг) по FTP в режиме продакшена
  • host — Имя FTP хоста
  • port — FTP Порт
  • remoteDir — Удаленная папка на сервере
  • user — Имя пользователя FTP
  • password — Пароль пользователя FTP
• logger — логи работы модулей и компонентов сборки
  • Terminal – логи работы модулей в терминале. Включатель: true/false
  • console — логи работы компонентов в консоли
    • включить — Переключатель: true/false
    • removeonbuild – убирает логи в режиме продакшн. Включатель: true/false
• projectpage – создание страницы проекта в режиме продакшн. Страница будет содержать ссылку на все HTML-файлы проекта для удобной демонстрации заказчику
  • включить — Переключатель: true/false
  • projectname – название проекта, которое выводится на странице вместо %projectname%. Если пусто, замените название папки проекта
  • template — Путь к шаблону страницы проекта
  • outfilename – имя файла. Если пусто, то создастся HTML-файл с названием папки проекта
• aliases — Настройка псевдонимов
• coffee — Настройка сообщения о перерыве
  • включить — Переключатель: true/false
  • text — текст сообщения
  • interval – Интервал вывода сообщения в минутах
• novaposhta — Настройка компонента Новая Почта
  • включить — Переключатель: true/false
  • key — личный ключ