Creare un tag di scoperta per RSS, Atom o JSON Feed

Questo generatore riceve un tipo di feed e un URL assoluto, seleziona il tipo di media corretto, applica l’escape ai caratteri che potrebbero interrompere un attributo HTML e restituisce un elemento link rel alternate completo, pronto per head. Supporta RSS, Atom e JSON Feed e rifiuta formati sconosciuti o URL non web non validi.

Scelga il formato corrispondente al documento pubblicato

Un tag di rilevamento è utile solo se l’attributo type descrive con precisione la risorsa indicata dall’URL. Selezioni rss per un documento RSS in XML, atom per Atom in XML oppure json-feed per un documento JSON Feed. Il generatore associa queste scelte rispettivamente ad application/rss+xml, application/atom+xml e application/feed+json. Non esamina né scarica la destinazione, quindi il formato scelto deve corrispondere a ciò che il server restituisce davvero. Una dichiarazione corretta aiuta i lettori a capire se possono gestire la risorsa prima di recuperarla o analizzarla. Evita inoltre comuni errori di copia e incolla, come pubblicizzare un endpoint Atom con il tipo RSS o presentare JSON Feed come JSON generico. I nomi sconosciuti vengono rifiutati anziché interpretati, perché un tipo plausibile ma errato rende difficile diagnosticare il rilevamento. Se il sito offre più formati, esegua il generatore per ciascun endpoint e inserisca tutti gli elementi ottenuti in head. Ogni tag rappresenterà così una reale alternativa selezionabile da un client compatibile.

Fornisca l’URL pubblico canonico del feed

Inserisca un URL assoluto HTTP o HTTPS raggiungibile dal lettore di feed di un visitatore, per esempio https://example.com/feed.xml. Gli URL assoluti sono preferibili nei metadati di rilevamento perché pagine copiate, documenti nella cache e client con comportamenti diversi per l’URL di base continueranno a risolvere lo stesso endpoint. Il generatore rimuove gli spazi esterni, verifica che il valore sia interpretabile come URL e rifiuta schemi quali file, data o javascript. Conserva l’indirizzo web fornito invece di riscriverne silenziosamente percorso, query, frammento, escape o maiuscole. I caratteri speciali negli attributi HTML vengono codificati nel markup prodotto; una e commerciale nella query diventa quindi sicura senza modificare il campo url restituito. La convalida conferma forma e schema, non proprietà, disponibilità, tipo di contenuto, reindirizzamenti o TLS. Verifichi separatamente l’endpoint pubblicato e si assicuri che restituisca correttamente il feed previsto. Quando sposta un feed, aggiorni sia il reindirizzamento sia questo tag.

Inserisca e verifichi l’elemento generato

Copi il tag restituito nella sezione head della pagina HTML per cui desidera rendere rilevabile il feed. Il risultato usa rel="alternate", il tipo di media specifico del formato e l’URL con escape come href. Omette intenzionalmente title perché l’input contiene soltanto formato e URL; inventare una descrizione sarebbe meno utile che lasciare a Lei la scelta della lingua e del testo nel proprio template. Se il sito dispone di più feed, per esempio uno principale e altri tematici, crei un elemento per ogni URL e aggiunga titoli significativi nel codice dell’applicazione quando gli utenti devono distinguerli. Controlli il sorgente effettivamente distribuito dopo il deploy, perché un motore di template o uno strato di sicurezza può trasformare il markup. Provi poi il rilevamento con almeno un lettore ed esamini gli header di risposta dell’endpoint. Lo strumento nel browser e l’API eseguono la stessa funzione deterministica, quindi input uguali producono gli stessi campi e lo stesso tag. Le procedure automatiche possono chiamare l’API per $0.002 a richiesta; l’uso interattivo viene eseguito localmente nel browser.