Struchtúr agus Riachtanais RSS 2.0 le haghaidh Podchraoltaí
Is é an formáid RSS 2.0 an bunchloch teicniúil a úsáidtear chun podchraoltaí a dháileadh ar fud an idirlín. Chun go mbeidh fotha podchraolta bailí, ní mór dó cloí go docht le rialacha struchtúracha XML (Extensible Markup Language). Nuair a úsáidtear an Bailíochtóir RSS Podchraolta, déantar an doiciméad iomlán a pharsáil chun a chinntiú go bhfuil sé dea-fhoirmithe.
Ní mór do gach fotha podchraolta tosú le fréamh an doiciméid mar <rss>. Má tá aon eilimint eile mar fhréamh, taispeánfar an earráid "Ní mór go mbeadh fréamh an doiciméid <rss>.". Ina theannta sin, ní mór an tréith version den chlib <rss> a shocrú go "2.0". Mura bhfuil sé seo amhlaidh, beidh an earráid "Socraigh tréith version <rss> go 2.0." le feiceáil.
Ní mór go mbeadh díreach cainéal amháin (<channel>) mar fho-eilimint dhíreach ag an eilimint <rss>. Má aimsítear níos mó ná cainéal amháin nó mura bhfuil ceann ar bith ann, ginfidh an córas an earráid "Ní mór go mbeadh díreach <channel> ceann amháin ag RSS; aimsíodh ‹count›.". Chomh maith leis sin, má tá dearbhú DOCTYPE sa doiciméad XML, stopfar an seiceáil agus taispeánfar an earráid "Bain an ráiteas DOCTYPE sula seiceálann tú an fotha seo.". Má tá an XML míchumtha ar bhealach ar bith eile, cuirfear an teachtaireacht "Déan XML mícheart a shocrú, ansin bailíochtú arís." i láthair an úsáideora.
Riachtanais Speisialta Apple Podcasts
Chun go mbeidh podchraoladh inléite i gceart ar ardáin mhóra cosúil le Apple Podcasts, ní mór an t-ainmspás iTunes a dhearbhú ar an eilimint <rss>. Mura ndéantar an dearbhú seo, taispeánfar an earráid "Déan ainmspás Apple Podcasts a fhógairt ar <rss>: ‹namespace›".
Seiceálann an uirlis láithreacht na réimsí riachtanacha go léir don chainéal agus do na heipeasóidí aonair. Má tá réimse riachtanach ar iarraidh, cruthófar an earráid "Cuir an ‹field› riachtanach leis.". I measc na rialacha sonracha do Apple Podcasts, tá na cinn seo a leanas ríthábhachtach:
- Naisc agus Íomhánna: Ní mór do gach nasc a bheith ina URL iomlán HTTP nó HTTPS. Mura bhfuil, taispeánfar "Ní mór
‹field›a bheith ina URL iomlán HTTP nó HTTPS.". Maidir le híomhánna, mura bhfuil an tréithhrefbailí, taispeánfar "Socraigh href itunes:image go URL iomlán HTTP nó HTTPS.". - Catagóirí: Ní mór tréith téacs neamhfholamh a bheith ag an gcatagóir, nó seolfar an earráid "Cuir tréith text neamhfholamh le itunes:category.".
- Ábhar Soiléir: Ní mór an chlib
<itunes:explicit>a shocrú go "true" nó "false". Má tá luach ar bith eile ann, taispeánfar "Socraigh itunes:explicit go true nó false.". - Seónna Sraithe: Má tá an seó marcáilte mar shraith (serial), teastaíonn uimhir iomlán dhearfach do gach eipeasóid. Mura bhfuil sé seo comhlíonta, taispeánfar "Teastaíonn itunes:episode iomlán dearfach ó na seónna sraithe don gach eipeasóid.".
- Teorainn Eipeasóidí: Cé gur féidir go leor eipeasóidí a bheith i bhfotha, má tá níos mó ná 2,000 eipeasóid ann, taispeánfar an rabhadh "Tá
‹count›eipeasóidí ag an sruth seo; taispeánann Apple Podcasts ach na 2,000 is déanaí.".
Bailíochtú Clúdaigh Fuaime (Enclosures)
Is é an clúdach (``) an eilimint XML a nascann an comhad meán (fuaime nó físe) leis an eipeasóid. Ní mór go mbeadh díreach clúdach amháin ag gach eipeasóid. Má aimsítear níos mó ná ceann amháin, taispeánfar an earráid "Coinnigh díreach ceann amháin <enclosure> san eipeasóid seo; aimsíodh ‹count›.".
Déanann an uirlis grinnscrúdú ar thréithe uile an chláir fuaime:
| Tréith | Rialacha Bailíochtaithe | Teachtaireacht Earráide / Rabhaidh |
|---|---|---|
| url | Ní mór dó a bheith ina URL iomlán HTTP nó HTTPS. | "Socraigh tréith url <enclosure> go URL iomlán HTTP nó HTTPS." |
| length | Ní mór dó a bheith ina líon iomlán de bhartaí. Má tá sé socraithe go 0, taispeánfar rabhadh. | "Cuir líon iomlán na mbeart i dtréith length <enclosure>." nó "Is é 0 tréith length <enclosure>. Deimhnigh líon ceart na mbeart roimh fhoilsiú." |
| type | Ní mór cineál MIME bailí a úsáid (m.sh. audio/mpeg). | "Úsáid cineál MIME bailí ar nós audio/mpeg." |
Má tá an cineál MIME neamh-fhuaime, ginfear an rabhadh "Níl an <enclosure> seo marcáilte mar fhuaim. Deimhnigh gur eipeasóid físe nó doiciméid atá beartaithe.". Chomh maith leis sin, má tá easaontas idir iarmhír an chomhaid agus an cineál MIME, taispeánfar "Tá easaontas idir ainm chomhaid an mheáin agus cineál MIME (‹extension› vs ‹mime›).".
Chun fadhbanna athsheolta a sheachaint, seiceáiltear nach bhfuil URLanna clúdaigh dúblacha sa bhfotha. Má aimsítear dúblach, taispeánfar an earráid "Athráíonn an URL clúdach seo an luach ag líne ‹first›.". Ar an gcaoi chéanna, má tá an GUID (Global Unique Identifier) céanna ag níos mó ná eipeasóid amháin, taispeánfar "Athráíonn an GUID seo an luach ag líne ‹first›.".
Formáidiú Dátaí agus Criosanna Ama (RFC 2822)
Tá formáidiú ceart dátaí ríthábhachtach chun go mbeidh aipeanna podchraolta in ann eipeasóidí a ordú de réir dáta foilsithe. Mura bhfuil an chlib <pubDate> i láthair, taispeánfar an rabhadh "Cuir <pubDate> ionas gur féidir le aipeanna podchraoltaí an eipeasóid seo a ordú agus a fhoilsiú go iontaofa.".
Ní mór do gach dáta foilsithe cloí leis an gcaighdeán RFC 2822, ina bhfuil dáta cruinn féilire agus crios ama bailí. Mar shampla: Sat, 01 Apr 2023 19:00:00 +0000. Má tá an dáta neamhbhailí, taispeánfar an earráid "Úsáid dáta RFC 2822 le dáta cruinn féilire agus crios ama, mar shampla: Sat, 01 Apr 2023 19:00:00 +0000.".
Má úsáidtear crios ama ainmnithe (mar shampla, EST nó GMT) in ionad fritháireamh uimhriúil, glacfar leis ach ginfear an rabhadh seo a leanas: "Glactar leis an gcrios ama ainmnithe seo ach níl sé chomh comhoiriúnach; roghnaigh fritháireamh uimhriúil ar nós +0000.".
Conas Torthaí an Bhailíochtóra a Léamh
Nuair a chuirtear an fotha isteach sa bhosca ionchuir "Podchraoladh RSS XML", déanann an córas an anailís láithreach. Taispeánfar na torthaí faoin gceannteideal "Diagnóis beatha".
Má tá an fotha go hiomlán saor ó earráidí struchtúracha, feicfidh tú an teachtaireacht "Níor aimsíodh aon fhadhbanna struchtúracha.". Seachas sin, taispeánfar achoimre ar nós "‹errors› earráidí agus rabhaidh ‹warnings› aimsíodh." mar aon le líon na n-eipeasóidí a aimsíodh sa bhfotha ("‹count› eipeasóid").
Chun cabhrú leat an fhadhb a aimsiú go tapa sa chód XML, soláthraíonn an uirlis mionsonraí cruinne suímh:
- Suíomh: Taispeántar an líne agus an colún cruinn don tsaincheist, mar shampla: "Líne
‹line›, colún‹column›". - Cosán XML: Soláthraítear cosán de chineál XPath chun an eilimint a aithint: "Deisigh:
‹path›". - Nasc Díreach: Is féidir cliceáil ar an nasc "Téigh go dtí
‹path›ag líne‹line›" chun léim go díreach chuig an áit sa chód.
Má tá an liosta saincheisteanna an-fhada, d'fhéadfadh an córas é a chiorrú agus an teachtaireacht seo a thaispeáint: "Ag taispeáint an chéad ‹shown› de ‹total› cheisteanna.". Má theipeann ar an bparsáil XML ar fad, taispeánfar mionsonraí breise ón bparsóir faoin lipéad "Mionsonraí an pharsóra: ‹detail›".
Príobháideacht agus Próiseáil Sonraí
Nuair a úsáideann tú an uirlis seo, déantar gach seiceáil go díreach i do bhrabhsálaí gréasáin. Ní dhéantar aon chuid de do chód XML ná de do chuid sonraí podchraolta a uaslódáil chuig freastalaithe seachtracha, agus ní dhéantar aon rud a shábháil ag BroBroGo.
Tabhair faoi deara go bhfuil teorainn charachtar de 500,000 carachtar i bhfeidhm in aghaidh gach seiceála. Má sháraítear an teorainn seo, taispeánfar an teachtaireacht "Ghlacann an uirlis seo suas le ‹max› carachtar in aghaidh gach seiceála.". Má thógann an próiseas an-fhada, feicfidh tú "Thóg an bailíochtú ró-fhada. Bain triail as fotha níos lú.". I gcás teip ginearálta, taispeánfar "Níorbh fhéidir an bailíochtú a chríochnú.".
Ceisteanna Coitianta
Cad a sheiceálann an Bailíochtóir RSS Podchraolta seo?
Seiceálann sé an bhfuil RSS 2.0 XML dea-fhoirmithe, an bhfuil na réimsí riachtanacha RSS agus gnáthréimsí cainéil agus eipeasóide Apple Podcasts ann, chomh maith le tréithe <enclosure>, dúblaigh agus dátaí RFC 2822.
An ndéanann sé tástáil ar an gcomhad fuaime?
Seiceálann sé URL agus fad beart an <enclosure>, an cineál MIME, dúblaigh agus an bhfuil ainm am chomhaid ag teacht leis an gcineál. Ní íoslódálann ná ní dhíchódaíonn sé an fhuaim.
An nglacfar i ngach áit le fotha a éiríonn leis an tseiceáil?
Ní hea. Is féidir le apps podchraolta rialacha agus seiceálacha iargúlta a chur leis. Ciallaíonn pas a fháil gur chomhlíon an XML greamaithe na seiceálacha statacha a thaispeántar anseo, ní go nglacfaidh eolaire leis nó go bhfoilseoidh sé é.
Cad iad na teorainneacha atá ag an uirlis seo?
Is seiceáil statach struchtúir é seo. Ní iarrann sé an fotha ná URLanna saothar ealaíne nó meán; ní mór duit seiceáil infhaighteacht chianda, fad i mbearta, díchódú fuaime agus glacadh eolairí a dhéanamh ar leithligh. Glacann an uirlis seo suas le 500,000 carachtar in aghaidh gach seiceála.