From 17ecc60497582c4f9b66ae9ebbd835e7e3c94aee Mon Sep 17 00:00:00 2001 From: AnthonyAxenov Date: Sun, 4 Sep 2022 11:58:37 +0800 Subject: [PATCH] =?UTF-8?q?=D0=A3=D1=82=D0=BE=D1=87=D0=BD=D0=B5=D0=BD?= =?UTF-8?q?=D0=B8=D0=B5=20=D0=BF=D0=BE=20=D0=BA=D0=B0=D1=81=D1=82=D0=BE?= =?UTF-8?q?=D0=BC=D0=BD=D1=8B=D0=BC=20=D0=B1=D0=BB=D0=BE=D0=BA=D0=B0=D0=BC?= =?UTF-8?q?=20=D0=B2=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 25 ++++++++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) 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`, то макеты страниц компилируются однажды и потом переиспользуются. Изменённые макеты не будут перекомпилироваться пока не будет очищен кеш прежних.