Format des liens
v8s-links.txt est la source de vérité humaine pour les liens. Chaque ligne non vide et non commentee est séparée par des pipes :
slug|target|state|title|description|tags|owner|expires_at|notes
| Champ | Requis | Description |
|---|---|---|
slug | oui | Chemin sans / initial |
target | oui | URL http ou https, ou hostname normalise vers https:// |
state | non | permanent, ephemeral, expired, disabled, maintenance, deactivated |
title | non | Titre pour le dashboard |
description | non | Usage humain du lien |
tags | non | Tags séparés par virgules |
owner | recommande | Étiquette de responsabilité |
expires_at | non | Date ou timestamp ISO |
notes | non | Notes internes |
Liens exacts
social/x|https://x.com/vanityURLs|permanent|X / Twitter|Profil social|social,x|v8s||
Le lien resout seulement /social/x.
Horaires inline
Les liens exacts peuvent inclure des directives @schedule indentées directement sous la ligne du lien :
office|https://example.com/closed|permanent|Office|Business hours|ops|team||
@schedule timezone=America/Toronto
@schedule rule=workdays days=mon,tue,wed,thu,fri from=09:00 to=17:00 target=https://example.com/open
La cible de la ligne reste la cible de repli. Les règles d’horaire choisissent seulement une autre cible pendant les fenêtres correspondantes.
Liens splat
Ajoutez /* au slug et incluez :splat dans la cible :
github/*|https://github.com/vanityURLs/:splat|permanent|GitHub|Namespace|git|v8s||
/github/website redirige vers https://github.com/vanityURLs/website.
États
| État | Comportement runtime |
|---|---|
permanent | 301 vers la cible |
ephemeral | 302 vers la cible |
expired | 302 vers /expired |
disabled | 302 vers /disabled |
maintenance | 302 vers /maintenance |
deactivated | vrai 404 |
Si expires_at est passe, l’état effectif devient expired.
Regles de slug
- Pas de slash initial ou final
- Pas de segment vide
- Pas de query string ou fragment
- Chaque segment commence par une lettre ou un chiffre
- Les caractères de segment sont en ASCII seulement : lettres, chiffres,
.,_,~et-
Les slugs réserves incluent admin, 404, expired, disabled, maintenance, deactivated, assets, et v8s.json.