diff --git a/README.md b/README.md index 646798d..96f1d6a 100644 --- a/README.md +++ b/README.md @@ -41,7 +41,7 @@ I'm too lazy to translate and support the whole project in ru and en, sorry, guy - [Формат playlists.ini](#iniformat) - [API](#api) - [Развёртывание проекта](#deploy) -- [Дополнительные инструменты](#tools) +- [Расширенные возможности](#tools) - [Как создать свой собственный плейлист](#howtomake) - [Использованный стек](#stack) - [Лицензия](#license) @@ -247,9 +247,28 @@ $ sudo systemctl restart apache2 -## Дополнительные инструменты +## Расширенные возможности -### Очистка кеша Twig +### Собственный код html/css/js + +В проекте есть директория `src/views/custom`. +Там можно размещать собственный код, который будет вставляться на каждой странице. + +Для этого, в первую очередь, нужно выполнить: + +``` +cp src/views/custom/custom.twig.example src/views/custom/custom.twig +``` + +Между тегами `{% block ... %} сюда {% endblock %}` следует вставить желаемый код или текст. +Можно создавать новые twig-файлы рядом и подключать их внутри `custom.twig`. +Git будет их игнорировать, хотя можно убрать директорию из `.gitignore` и добавлять эти файлы репозиторий. + +В общем случае, это можно выполнять на том сервере, на коем установлен и работает веб-сервис. + +После всех правок следует очистить кеш twig (см. далее). + +### Очистка кеша twig Если в файле `./src/.env` параметр `TWIG_CACHE=1`, то макеты страниц компилируются однажды и потом переиспользуются. Изменённые макеты не будут перекомпилироваться пока не будет очищен кеш прежних.