📘 Руководство по шаблонам SmartURLs (v1.4.0+)

Это руководство объясняет, как использовать функцию пользовательских шаблонов SmartURLs. Шаблоны пишутся в однострочном поле ввода, но могут производить многострочный вывод с помощью токена $nl.

SmartURLs намеренно легковесен. Он никогда не читает содержимое веб-страницы и работает только с URL и информацией о вкладке браузера.

1. Базовые токены

SmartURLs заменяет токены строго на основе метаданных вкладки и текущего URL.

Токен	Описание	Пример вывода
`$title`	Заголовок страницы во вкладке	`Why the Moon?`
`$title(html)`	Заголовок страницы с экранированием HTML (преобразует `&`, `<`, `>`, `"`, `'` в сущности). Безопасен для тегов/атрибутов HTML.	`Rock & Roll <Best Hits>` (для заголовка: “Rock & Roll <Best Hits>”)
`$url`	Полный URL	`https://www.youtube.com/watch?v=bmC-FwibsZg`
`$domain`	Только имя хоста	`www.youtube.com`
`$path`	Часть пути URL	`/watch`
`$basename`	Последний сегмент пути	`watch`
`$idx`	Индекс вкладки (с базой 1)	`3`
`$date`	Локальная дата (YYYY-MM-DD)	`2025-01-12`
`$time`	Локальное время (HH:MM:SS)	`14:03:55`
`$date(utc)`	Дата UTC	`2025-01-12`
`$time(utc)`	Время UTC	`05:03:55`
`$nl`	Вставляет перевод строки	(создает разрывы строк в выводе)

⚠️ Примечание о $nl: Поддерживается только в пользовательских шаблонах Копирование. Нельзя использовать в пользовательских шаблонах Открыть из текста. Если вы хотите повторно использовать один и тот же шаблон для Копирование и Открыть, избегайте $nl в шаблоне Открыть или используйте режим Интеллектуальный (автоопределение).

⚠️ Примечание о $title(html): Поддерживается только в пользовательских шаблонах Копирование. Пользовательские шаблоны Открыть из текста не обрабатывают этот токен. Для шаблонов Открыть используйте вместо этого $title.

Пример URL и заголовка, использованных выше

Чтобы показать, как токены расширяются, эти примеры используют:

📘 Заголовок

Why the Moon?

🔗 URL

https://www.youtube.com/watch?v=bmC-FwibsZg

Из этого URL:

$domain → www.youtube.com
$path → /watch
$basename → watch
$v (параметр запроса) → bmC-FwibsZg

Даты и времена являются примерами; фактический вывод зависит от системных часов.

2. Токены параметров запроса

SmartURLs может извлекать параметры запроса непосредственно из URL.

🔤 Синтаксис

$<param>

🔗 Пример URL

https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

Токен	Вывод
`$v`	`bmC-FwibsZg`
`$t`	`123`

Если параметр не существует, его значение становится пустой строкой.

⚠️ Примечание о токенах параметров запроса: Токены параметров запроса (например, $v, $id, $tag и т. д.) оцениваются только в пользовательских шаблонах Копирование. Они не оцениваются в пользовательских шаблонах Открыть из текста, поэтому не используйте их в шаблонах Открыть.

3. Условные блоки

Условные блоки позволяют шаблонам выводить определенный текст только если присутствуют определенные параметры запроса.

🔤 Синтаксис

🔹 Один параметр

{{q=v: ... }}

🔸 Несколько параметров (условие И)

{{q=v,t: ... }}

Внутри условного блока:

$v, $t и т. д. расширяются нормально
$nl, $title, $domain также работают
Вложенные блоки не разрешены
else недоступен

Если условия не выполняются, весь блок удаляется из вывода.

⚠️ Примечание об условных блоках: Условные блоки (например, ``) доступны только в пользовательских шаблонах Копирование. Они не работают в пользовательских шаблонах Открыть из текста. Если вам нужна гибкая фильтрация при открытии URL, используйте режим Интеллектуальный (автоопределение).

4. Примеры и паттерны шаблонов

Шаблоны пишутся как одна строка, но могут выводить несколько строк через $nl.

Пример URL и заголовка, использованных в этом разделе:

📘 Заголовок

Why the Moon?

🔗 URL

https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.1 Markdown: Заголовок + URL

🛠 Шаблон

$title$nl$url

💬 Вывод

Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.2 Элемент списка Markdown

🛠 Шаблон

- [$title]($url)

💬 Вывод

- [Why the Moon?](https://www.youtube.com/watch?v=bmC-FwibsZg&t=123)

4.3 ID видео YouTube (только если присутствует)

🛠 Шаблон

{{q=v:Video ID: $v$nl}}$title$nl$url

💬 Вывод

Video ID: bmC-FwibsZg
Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

Если v= отсутствует:

Why the Moon?
https://example.com/page

4.4 Сгенерировать URL миниатюры YouTube

На основе известного шаблона миниатюр YouTube:

https://img.youtube.com/vi/VIDEO_ID/maxresdefault.jpg

🛠 Шаблон

{{q=v:Thumbnail: https://img.youtube.com/vi/$v/maxresdefault.jpg$nl}}$title$nl$url

💬 Вывод

Thumbnail: https://img.youtube.com/vi/bmC-FwibsZg/maxresdefault.jpg
Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.5 Встроить миниатюру YouTube (Markdown)

🛠 Шаблон

{{q=v:![thumb](https://img.youtube.com/vi/$v/mqdefault.jpg)$nl}}[$title]($url)

💬 Вывод

![thumb](https://img.youtube.com/vi/bmC-FwibsZg/mqdefault.jpg)
[Why the Moon?](https://www.youtube.com/watch?v=bmC-FwibsZg&t=123)

4.6 Временная метка (если доступна)

🛠 Шаблон

{{q=t:Timestamp: $t sec$nl}}$title$nl$url

💬 Вывод

Timestamp: 123 sec
Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.7 Многопараметровое условие

🛠 Шаблон

{{q=v,t:Video: $v ($t sec)$nl}}$url

💬 Вывод

Video: bmC-FwibsZg (123 sec)
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.8 Формат журнала (домен + путь)

🛠 Шаблон

[$domain] $path$nl$url

💬 Вывод

[www.youtube.com] /watch
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.9 Заголовок в стиле имени файла

🛠 Шаблон

## $basename: $title$nl$url

💬 Вывод

## watch: Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.10 Минималистичный

🛠 Шаблон

$title — $url

💬 Вывод

Why the Moon? — https://www.youtube.com/watch?v=bmC-FwibsZg&t=123

4.11 Ежедневная запись журнала

🛠 Шаблон

- [$title]($url) — $date $time

💬 Вывод

- [Why the Moon?](https://www.youtube.com/watch?v=bmC-FwibsZg&t=123) — 2025-01-12 14:03:55

4.12 Многострочный с разделителем

🛠 Шаблон

$title$nl$url$nl---$nl$domain

💬 Вывод

Why the Moon?
https://www.youtube.com/watch?v=bmC-FwibsZg&t=123
---
www.youtube.com

5. Ограничения

SmartURLs намеренно остается простым.

❌ SmartURLs НЕ:

Анализирует содержимое веб-страниц (SmartURLs НЕ имеет разрешения на доступ или чтение HTML-страниц)
Читает метаданные или миниатюры
Выполняет JavaScript на странице
Извлекает теги OG, авторов или описания
Поддерживает вложенные условия или else

✔️ SmartURLs использует ТОЛЬКО:

Заголовок вкладки
Компоненты URL
Параметры запроса
Простую замену токенов
Опциональные условные блоки

Это обеспечивает согласованное поведение на всех веб-сайтах.

6. Совместимость версий

Эти функции доступны в: SmartURLs v1.4.0 и более поздних версиях

7. Обратная связь

Для запросов функций или вопросов, пожалуйста, откройте issue здесь:

https://github.com/isshiki/SmartURLs/issues