📘 Guide des modèles SmartURLs (v1.4.0+)

Ce guide explique comment utiliser la fonction de modèle personnalisé de SmartURLs. Les modèles sont écrits dans un champ de saisie d’une seule ligne, mais peuvent produire une sortie multiligne en utilisant le token $nl.

SmartURLs est intentionnellement léger. Il ne lit jamais le contenu des pages web et fonctionne uniquement avec l’URL et les informations de l’onglet du navigateur.

1. Tokens de base

SmartURLs remplace les tokens strictement basés sur les métadonnées de l’onglet et l’URL actuelle.

Token	Description	Exemple de sortie
`$title`	Titre de la page dans l’onglet	`Why the Moon?`
`$title(html)`	Titre de page échappé HTML (convertit `&`, `<`, `>`, `"`, `'` en entités). Sûr pour utilisation dans les balises/attributs HTML.	`Rock & Roll <Best Hits>` (pour titre : “Rock & Roll <Best Hits>”)
`$url`	URL complète	`https://www.youtube.com/watch?v=bmC-FwibsZg`
`$domain`	Nom d’hôte uniquement	`www.youtube.com`
`$path`	Partie chemin de l’URL	`/watch`
`$basename`	Dernier segment du chemin	`watch`
`$idx`	Index de l’onglet (base 1)	`3`
`$date`	Date locale (YYYY-MM-DD)	`2025-01-12`
`$time`	Heure locale (HH:MM:SS)	`14:03:55`
`$date(utc)`	Date UTC	`2025-01-12`
`$time(utc)`	Heure UTC	`05:03:55`
`$nl`	Insère un saut de ligne	(produit des sauts de ligne en sortie)

⚠️ Note sur $nl : Pris en charge uniquement dans les modèles personnalisés de Copie. Ne peut pas être utilisé dans les modèles personnalisés d’Ouvrir depuis le texte. Si vous souhaitez réutiliser le même modèle pour Copie et Ouvrir, évitez $nl dans le modèle d’ouverture ou utilisez le mode Intelligent (détection automatique) à la place.

⚠️ Note sur $title(html) : Pris en charge uniquement dans les modèles personnalisés de Copie. Les modèles personnalisés d’Ouvrir depuis le texte ne traitent pas ce token. Pour les modèles d’ouverture, utilisez plutôt $title.

Exemple d’URL et de titre utilisés ci-dessus

Pour montrer comment les tokens se développent, ces exemples utilisent :

📘 Titre

Why the Moon?

🔗 URL

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

De cette URL :

$domain → www.youtube.com
$path → /watch
$basename → watch
$v (paramètre de requête) → bmC-FwibsZg

Les dates et heures sont des exemples ; la sortie réelle dépend de l’horloge de votre système.

2. Tokens de paramètres de requête

SmartURLs peut extraire les paramètres de requête directement de l’URL.

🔤 Syntaxe

$<param>

🔗 Exemple d’URL

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

Token	Sortie
`$v`	`bmC-FwibsZg`
`$t`	`123`

Si un paramètre n’existe pas, sa valeur devient une chaîne vide.

⚠️ Note sur les tokens de paramètres de requête : Les tokens de paramètres de requête (par exemple $v, $id, $tag, etc.) sont évalués uniquement dans les modèles personnalisés de Copie. Ils ne sont pas évalués dans les modèles personnalisés d’Ouvrir depuis le texte, ne les utilisez donc pas dans les modèles d’ouverture.

3. Blocs conditionnels

Les blocs conditionnels permettent aux modèles de produire certains textes uniquement si des paramètres de requête spécifiques sont présents.

🔤 Syntaxe

🔹 Paramètre unique

{{q=v: ... }}

🔸 Paramètres multiples (condition ET)

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

À l’intérieur d’un bloc conditionnel :

$v, $t, etc. se développent normalement
$nl, $title, $domain fonctionnent également
Les blocs imbriqués ne sont pas autorisés
Aucun else n’est disponible

Si les conditions ne sont pas remplies, le bloc entier est supprimé de la sortie.

⚠️ Note sur les blocs conditionnels : Les blocs conditionnels (par exemple ``) sont disponibles uniquement dans les modèles personnalisés de Copie. Ils ne fonctionnent pas dans les modèles personnalisés d’Ouvrir depuis le texte. Si vous avez besoin d’un filtrage flexible lors de l’ouverture d’URL, utilisez le mode Intelligent (détection automatique) à la place.

4. Exemples de modèles et motifs

Les modèles sont écrits sur une ligne, mais peuvent produire plusieurs lignes via $nl.

Exemple d’URL et de titre utilisés dans cette section :

📘 Titre

Why the Moon?

🔗 URL

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

4.1 Markdown : Titre + URL

🛠 Modèle

$title$nl$url

💬 Sortie

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

4.2 Élément de liste Markdown

🛠 Modèle

- [$title]($url)

💬 Sortie

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

4.3 ID de vidéo YouTube (uniquement si présent)

🛠 Modèle

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

💬 Sortie

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

Si v= est absent :

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

4.4 Générer l’URL de vignette YouTube

Basé sur le modèle de vignette YouTube connu :

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

🛠 Modèle

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

💬 Sortie

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 Intégrer une vignette YouTube (Markdown)

🛠 Modèle

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

💬 Sortie

![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 Horodatage (si disponible)

🛠 Modèle

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

💬 Sortie

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

4.7 Conditionnel multi-paramètres

🛠 Modèle

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

💬 Sortie

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

4.8 Format de journal (domaine + chemin)

🛠 Modèle

[$domain] $path$nl$url

💬 Sortie

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

4.9 En-tête de style nom de fichier

🛠 Modèle

## $basename: $title$nl$url

💬 Sortie

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

4.10 Minimaliste

🛠 Modèle

$title — $url

💬 Sortie

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

4.11 Entrée de journal quotidien

🛠 Modèle

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

💬 Sortie

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

4.12 Multiligne avec séparateur

🛠 Modèle

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

💬 Sortie

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

5. Limitations

SmartURLs reste intentionnellement simple.

❌ SmartURLs ne fait PAS :

Analyser le contenu des pages web (SmartURLs n’a PAS la permission d’accéder ou de lire les pages HTML)
Lire les métadonnées ou les vignettes
Exécuter JavaScript sur la page
Extraire les balises OG, auteurs ou descriptions
Prendre en charge les conditionnels imbriqués ou else

✔️ SmartURLs utilise UNIQUEMENT :

Titre de l’onglet
Composants d’URL
Paramètres de requête
Remplacement simple de tokens
Blocs conditionnels optionnels

Cela garantit un comportement cohérent sur tous les sites web.

6. Compatibilité des versions

Ces fonctionnalités sont disponibles dans : SmartURLs v1.4.0 et ultérieur

7. Commentaires

Pour les demandes de fonctionnalités ou les questions, veuillez ouvrir un issue ici :

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