Уточнение по кастомным блокам в README

master
Anthony Axenov 2022-09-04 11:58:37 +08:00
parent d2bc1678f5
commit 17ecc60497
Signed by: anthony
GPG Key ID: EA9EC32FF7CCD4EC
1 changed files with 22 additions and 3 deletions

View File

@ -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
<a id="tools"></a>
## Дополнительные инструменты
## Расширенные возможности
### Очистка кеша 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`, то макеты страниц компилируются однажды и потом переиспользуются.
Изменённые макеты не будут перекомпилироваться пока не будет очищен кеш прежних.