Шаблон:Очищать кэш/doc: различия между версиями
Mansur700 (обсуждение | вклад) Нет описания правки |
Mansur700 (обсуждение | вклад) Нет описания правки |
||
| Строка 1: | Строка 1: | ||
{{docpage}} | {{docpage}} | ||
Шаблон призван помочь обойти ограничения, накладываемые [[ТП:Кэш|кэшированием]], в случаях, когда какой-то элемент страницы требует периодического обновления (например, счётчик времени в шаблоне {{tl|Запланированное событие}}, сегодняшний день на странице документации шаблона или шаблон, чей внешний вид зависит от количества элементов в категории). | |||
{{другие названия шаблона|autopurge}} | |||
{{TOC right}} | |||
{{ | == Использование == | ||
{| cellspacing="0" cellpadding="0" style="margin-top:-4.2px;" | |||
|- | |||
| class="nowrap" | | |||
* {{tc||ежедневно}} или {{tc}} | |||
* {{tc||ежечасно}} | |||
* {{tc||нулевой правкой}} | |||
| | |||
<ul style="list-style-type:none; list-style-image:none;"> | |||
<li>= {{tc|autopurge|daily}}</li> | |||
<li>= {{tc|autopurge|hourly}}</li> | |||
<li>= {{tc|autopurge|null edit}}</li> | |||
</ul> | |||
|} | |||
Ежедневная очистка кэша происходит в полночь по [[UTC]]. | |||
Очистка кэша [[ТП:НУЛЬ|нулевой правкой]] требуется, чтобы обновились страницы категорий и инструмента «Ссылки сюда». <!-- Этот вариант является менее универсальным, так как нулевую правку невозможно совершить на полностью защищённых страницах. --> | |||
Пожалуйста, во избежание излишних нагрузок на сервер, устанавливайте этот шаблон только на те страницы, где периодическое обновление кэша влияет на отображение страниц. Не злоупотребляйте механизмом шаблона в личном пространстве и на прочих служебных страницах, если автообновление вам нужно исключительно для функционирования элемента оформления. Не указывайте параметров там, где без более затратных действий можно обойтись. Не устанавливайте шаблон на страницы, которые и без того часто правятся или периодически обновляются ботом. Уделяйте этому особое внимание при использовании механизма в шаблонах: возможно, в некоторых пространствах имён или при некоторой комбинации параметров включение шаблона не имеет смысла. | |||
== Технические подробности == | |||
Шаблон добавляет страницу в [[:Категория:Тептар:Страницы с автоматически очищаемым кэшем|трекинговые категории]], с которыми в дальнейшем работает бот ([https://github.com/Facenapalm/NapalmBot/blob/master/scripts/autopurge.py его исходный код], [https://github.com/Facenapalm/NapalmBot/blob/master/crontab crontab]). | |||
Возможность ежечасно совершать нулевую правку не предусмотрена в силу её затратности, однако при необходимости можно установить два шаблона, чтобы заставить бота каждый час сбрасывать кэш, а раз в сутки дополнительно делать нулевую правку. В этом случае в полночь сначала будет совершена нулевая правка, а затем сброшен кэш. | |||
Шаблоны с ошибочно заполненным первым параметром добавляются в {{категорию|Тептар:Страницы c нераспознанным значением параметра шаблона «Очищать кэш»}}. | |||
== | == Статистика категорий == | ||
<categorytree depth="1" showcount="on">Категория:Тептар:Страницы с автоматически очищаемым кэшем</categorytree> | |||
== См. также == | == См. также == | ||
* {{tl| | * {{tl|очистить кэш}} — создаёт ссылку для ручной очистки кэша | ||
<includeonly> | <includeonly> | ||
[[Категория:Шаблоны: | [[Категория:Шаблоны:Для ботов]] | ||
[[Категория:Тептар:Механизмы, обрабатываемые NapalmBot]] | |||
</includeonly> | </includeonly> | ||
Текущая версия от 05:58, 19 июня 2020
 |
Шаблон призван помочь обойти ограничения, накладываемые кэшированием, в случаях, когда какой-то элемент страницы требует периодического обновления (например, счётчик времени в шаблоне {{Запланированное событие}}, сегодняшний день на странице документации шаблона или шаблон, чей внешний вид зависит от количества элементов в категории).
Другое название этого шаблона — {{autopurge}}.
Использование[править код]
|
|
Ежедневная очистка кэша происходит в полночь по UTC.
Очистка кэша нулевой правкой требуется, чтобы обновились страницы категорий и инструмента «Ссылки сюда».
Пожалуйста, во избежание излишних нагрузок на сервер, устанавливайте этот шаблон только на те страницы, где периодическое обновление кэша влияет на отображение страниц. Не злоупотребляйте механизмом шаблона в личном пространстве и на прочих служебных страницах, если автообновление вам нужно исключительно для функционирования элемента оформления. Не указывайте параметров там, где без более затратных действий можно обойтись. Не устанавливайте шаблон на страницы, которые и без того часто правятся или периодически обновляются ботом. Уделяйте этому особое внимание при использовании механизма в шаблонах: возможно, в некоторых пространствах имён или при некоторой комбинации параметров включение шаблона не имеет смысла.
Технические подробности[править код]
Шаблон добавляет страницу в трекинговые категории, с которыми в дальнейшем работает бот (его исходный код, crontab).
Возможность ежечасно совершать нулевую правку не предусмотрена в силу её затратности, однако при необходимости можно установить два шаблона, чтобы заставить бота каждый час сбрасывать кэш, а раз в сутки дополнительно делать нулевую правку. В этом случае в полночь сначала будет совершена нулевая правка, а затем сброшен кэш.
Шаблоны с ошибочно заполненным первым параметром добавляются в Категорию:Тептар:Страницы c нераспознанным значением параметра шаблона «Очищать кэш».
Статистика категорий[править код]
См. также[править код]
- {{очистить кэш}} — создаёт ссылку для ручной очистки кэша