Vložení audia a podcastů: Publikování s přepisem na prvním místě

Vložení audia je přehrávatelná nahrávka s názvem, shrnutím, délkou trvání, připsáním autorství, ovládacími prvky a úplným přepisem. Pokrývá vlastní audio a schválené podcastové přehrávače, ale přepis je kanonický indexovatelný artefakt a musí stránku učinit užitečnou, i když nikdo nestiskne tlačítko Přehrát.

Jak jsme ověřili migraci bez ztráty organické návštěvnosti 14minutový rozhovor s technickým vedoucím, upravený pro srozumitelnost a publikovaný s kapitolami označenými mluvčími. Přehrát epizodu · 14:06 · Přečíst přepis

Čtenář zná téma, formát, námahu a textovou alternativu před přehráváním. Produkce přidává nativní ovládací prvky nebo schváleného poskytovatele, přičemž název, shrnutí a přepis zůstávají v počátečním HTML.

Proč na tomto prvku záleží

Audio zachovává důraz, váhání, emoce, výslovnost a interakci mezi mluvčími. Díky tomu je užitečné tam, kde je podání součástí důkazu, a umožňuje čtenářům poslouchat při provádění jiného úkolu. Délka trvání jim dává poctivý odhad náročnosti ještě předtím, než se zavážou.

Audio je také lineární: posluchač nevidí celý argument najednou a může procházet minutami, aby našel jednu informaci. Zapečetěný přehrávač žádá o čas, aniž by nejprve prokázal hodnotu, zatímco automatické přehrávání upoutává pozornost. Použijte popisný úvod, délku trvání, kapitoly u delších nahrávek, ovládací prvky přehrávání a prohledávatelný přepis.

Strojová extrahovatelnost závisí na textu, ne na přehrávači. Crawlery a systémy pro AI vyhledávání nelze očekávat, že budou streamovat audio, rozpoznávat každého mluvčího nebo rozlišovat opravu od tvrzení, které opravuje. Publikujte úplný přepis jako serverově vykreslené HTML s jmény mluvčích, nadpisy, užitečnými časovými razítky a citacemi připojenými k tvrzením, která podporují. Metadata popisují nahrávku; nemohou nahradit její obsah.

Před výběrem této komponenty použijte pravidla pro psaní prvků . Jejich pravidlo priority je sémantické: pokud je účelem bloku umožnit čtenáři přehrávat a zkoumat smysluplné audio, použijte typový zvukový prvek, nikoli stylování odkazu nebo iframe tak, aby vypadal jako přehrávač. Naopak nepřidávejte zvukovou komponentu jen proto, že šablona stránky má prázdné mediální místo.

Kdy jej použít

Použijte vložení audia, když poslech nahrávky přidává důkaz, výslovnost, emoci nebo pohodlí, které próza sama o sobě nezachovává. Dobré použití zahrnuje epizodu podcastu, doložený rozhovor, ukázku orální historie, výpověď zákazníka, odpověď experta, zvukové srovnání produktů nebo objednanou zvukovou verzi dlouhého článku.

Nahrávka potřebuje stabilního vlastníka, povolení k publikaci, ověřený přepis a jasný vztah ke stránce. Pokud záleží pouze na 90 sekundách ze 40minutového rozhovoru, použijte úryvek nebo odkaz na kapitolu s časovým razítkem vedle tvrzení.

Blízké případy vyžadují jiné zacházení:

• Video se smysluplnými ukázkami: použijte vložení videa . Extrahování jeho zvuku zahazuje vizuální instrukce a vytváří neúplnou alternativu.
• Citace z nahraného rozhovoru: citujte schválenou pasáž v próze a uveďte nahrávku. Celý přehrávač je zbytečný, když redakčním úkolem je připsání jednoho výroku.
• Syntetický komentář krátké stránky: ponechte text. Opakování 300 slov přidává údržbu, aniž by zlepšilo dohledatelnost.
• Podkresová hudba nebo dekorativní zvuková kulisa: vynechejte ji z redakčního obsahu. Dekorace nesmí soutěžit s řečí, automaticky se přehrávat nebo vytvářet problém skrytého ovládání.
• Soubor ke stažení bez přehrávání na stránce: použijte odkaz na soubor s formátem a velikostí. Nazývat to vložením slibuje ovládací prvky, které neexistují.
• Živý stream: použijte vyhrazený vzor události se stavem, harmonogramem, časovým pásmem a záložní nahrávkou. Zvukový prvek s konečnou délkou nemůže poctivě popsat otevřené vysílání.
• Nerecenzovaný automatický přepis: nepublikujte jej jako úplný. Chyby ve jménech, negacích, číslech a změnách mluvčích mohou obrátit význam.

Kam jej umístit

Umístěte prvek za odstavec, který pojmenovává nahrávku, vysvětluje, proč patří na stránku, a uvádí, co se čtenáři dozví. Představte dotazovaného před ukázkou; uveďte výsledek případové studie před podpůrným audiem; udržujte písemnou dokumentaci autoritativní před volitelným komentářem.

Na stránce vedené podcastem může přehrávač následovat hero sekci, ale přepis a klíčová tvrzení zůstávají podstatou. Umístěte podpůrný úryvek za jeho tvrzení a před navazující analýzu; udržujte ukázku s časovým razítkem spolu s její pasáží přepisu.

Udržujte nadpis, shrnutí, přehrávač, délku trvání, připsání autorství, kapitoly, ovládání přepisu a záložní řešení v jedné označené oblasti. Přepis může následovat nebo použít přístupné zatahovací rozhraní, ale jeho úplné HTML musí být odesláno při počátečním načtení. Nikdy jej nepodmiňujte nebo nenačítejte až po přehrání.

Vložení nesmí být umístěno vedle jiného přehrávače, automaticky přehrávaného videa, znějící reklamy, leadového formuláře nebo výzvy k akci s vysokým důrazem. Nesmí oddělovat varování od jeho akce, přerušovat číslovaný krok nebo dělit citaci od jejího připsání. Ponechte dostatečný odstup, aby ovládací prvky zřetelně patřily k audiu.

Anatomie

Označený snímek obrazovky musí identifikovat:

1. Název: specificky pojmenovává epizodu nebo úryvek; neopakuje název stránky bez přidání vymezení.
2. Shrnutí: v jedné nebo dvou větách uvádí, kdo mluví, co je pokryto a proč je poslech užitečný.
3. Přehrávač: používá nativní nebo recenzované ovládací prvky pro přehrání, pauzu, přetáčení, hlasitost, uplynulý čas a délku trvání.
4. Délka trvání: je zobrazena jako text mimo ovládací prvek, aby bylo úsilí známo ještě před načtením přehrávače.
5. Připsání a datum: identifikují mluvčí, vydavatele, datum nahrání nebo publikace a relevantní kontext povolení.
6. Kapitoly: poskytují krátké štítky a časová razítka pro nahrávky delší než deset minut nebo obsahující odlišná témata.
7. Přístup k přepisu: zpřístupňuje úplný, upravený přepis s označením mluvčích, který je k dispozici bez přehrávání.
8. Záložní řešení: poskytuje kanonický HTTPS odkaz na epizodu nebo soubor, když vestavěný přehrávač selže.
9. Informace o stažení: pokud je stahování povoleno, uvádí formát a přibližnou velikost souboru před požadavkem.
10. Oznámení o poskytovateli: vysvětluje, když externí poskytovatel obdrží požadavek nebo nastavuje úložiště, a to ještě před tímto připojením tam, kde je vyžadován souhlas.

Příklady designu

Každá varianta zachovává název, shrnutí, délku trvání, připsání, úplný přepis a záložní řešení. Prezentace se může měnit; informační smlouva nikoli.

Nativní inline přehrávač — výchozí

Použijte ovládací prvky prohlížeče pro schválená vlastní média. Toto je nejméně překvapivá možnost a vyhýbá se těžkému widgetu pro podcasty. Přidávejte kódování pouze tehdy, když to podpůrná data ospravedlňují, a vracejte správný typ média a chování byte-range.

Karta epizody podcastu

Použijte pro skutečnou epizodu s názvem série, názvem, datem, stabilním číslem epizody a kanonickým odkazem. Přidejte obrázek obalu pouze tehdy, když schválený asset existuje. Umístěte akce k odběru až za vstupní bod přepisu.

Kapitolový dlouhý přehrávač

Použijte nad deset minut nebo při změně témat. Kapitoly potřebují popisné štítky, nikoli „Část druhá." Každé časové razítko by mělo přetáčet přehrávač a stále identifikovat nadpis přepisu bez skriptování.

Úryvek s přepisem na prvním místě

Použijte, když krátká pasáž podporuje tvrzení. Zobrazte její přepis, uveďte úpravy interpunkce nebo délky a odkažte na plný kontext. Nikdy nespojujte samostatné věty dohromady, aby zněly souvisle, aniž byste označili úpravu.

Poskytovatel s podmíněným souhlasem

Použijte, když externí hostitel vyžaduje povolení. Uveďte jméno poskytovatele a důsledek, poté nabídněte přesnou akci, například „Povolit poskytovatele a načíst přehrávač." Odmítnutí ponechá shrnutí, přepis a kanonický odkaz použitelné.

Parametry

„Zdroj" znamená autorskou lokaci, ze které renderer získává hodnotu. Neznamená to vydavatele audia nebo zdroj důkazu.

Renderer musí mít na seznamu povolených poskytovatele a typy médií, odmítat skriptovatelné nebo libovolné HTML pro vkládání a escapovat autorské štítky. src identifikuje doručení média; nikdy nenahrazuje název, shrnutí nebo přepis. Tělo mapuje svůj první nadpis na title, svůj první odstavec na summary a označené sekce Mluvčí, Kapitoly a Přepis na strukturovaná pole.

Syntaxe a příklady kódu

Níže uvedené tři formy představují stejná kanonická pole. Jejich URL jsou ilustrativní specifikační hodnoty, nikoli assety, na které tato stránka odkazuje.

Přenosná Markdown direktiva

:::audio-embed{src="https://media.example.com/episodes/migration-validation.mp3" provider=native variant=chaptered duration=PT14M6S published=2026-08-27 media-type="audio/mpeg" download=false fallback-url="https://example.com/podcast/migration-validation/"}
## Jak jsme ověřili migraci

Technický vedoucí vysvětluje kontroly provedené před spuštěním a po něm, včetně prahu pro vrácení změn.

Mluvčí: Maya Chen, technická vedoucí; Leon Ward, moderátor

Kapitoly:
- 00:00 — Výchozí stav a kritéria spuštění
- 04:12 — Přesměrování a kanonické kontroly
- 09:40 — Práh pro vrácení změn

Přepis:
### Výchozí stav a kritéria spuštění
**Leon Ward:** Co jste zaznamenali před spuštěním?
**Maya Chen:** Exportovali jsme výchozí hodnoty kanonických URL, stavových kódů a organických vstupních stránek.
:::

Hugo shortcode

Hugo notace používá pouze pojmenované parametry. Dokumentuje zamýšlený adaptér a nevyvolává ani netvrdí, že lokální shortcode již existuje.

{{< audio-embed src="https://media.example.com/episodes/migration-validation.mp3" provider="native" variant="chaptered" duration="PT14M6S" published="2026-08-27" mediaType="audio/mpeg" download="false" fallbackUrl="https://example.com/podcast/migration-validation/" >}}
## Jak jsme ověřili migraci

Technický vedoucí vysvětluje kontroly provedené před spuštěním a po něm, včetně prahu pro vrácení změn.

Mluvčí: Maya Chen, technická vedoucí; Leon Ward, moderátor

Kapitoly:
- 00:00 — Výchozí stav a kritéria spuštění
- 04:12 — Přesměrování a kanonické kontroly
- 09:40 — Práh pro vrácení změn

Přepis:
### Výchozí stav a kritéria spuštění
**Leon Ward:** Co jste zaznamenali před spuštěním?
**Maya Chen:** Exportovali jsme výchozí hodnoty kanonických URL, stavových kódů a organických vstupních stránek.
{{< /audio-embed >}}

Adaptér by měl vykreslit <audio controls preload="metadata"> pro nativní média, přidat <source type="audio/mpeg"> a zahrnout záložní text a běžný odkaz uvnitř prvku audio. Externí poskytovatel by se měl načítat pouze podle deklarovaného chování souhlasu a nesmí přijímat libovolné autorem dodané atributy iframe.

WordPress blok

<!-- wp:amicited/audio-embed {"src":"https://media.example.com/episodes/migration-validation.mp3","provider":"native","variant":"chaptered","duration":"PT14M6S","published":"2026-08-27","mediaType":"audio/mpeg","download":false,"fallbackUrl":"https://example.com/podcast/migration-validation/"} -->
<h2>Jak jsme ověřili migraci</h2>
<p>Technický vedoucí vysvětluje kontroly provedené před spuštěním a po něm, včetně prahu pro vrácení změn.</p>
<p data-speakers>Maya Chen, technická vedoucí; Leon Ward, moderátor</p>
<ol data-chapters><li><time datetime="PT0S">00:00</time> — Výchozí stav a kritéria spuštění</li><li><time datetime="PT4M12S">04:12</time> — Přesměrování a kanonické kontroly</li><li><time datetime="PT9M40S">09:40</time> — Práh pro vrácení změn</li></ol>
<section data-transcript><h3>Výchozí stav a kritéria spuštění</h3><p><strong>Leon Ward:</strong> Co jste zaznamenali před spuštěním?</p><p><strong>Maya Chen:</strong> Exportovali jsme výchozí hodnoty kanonických URL, stavových kódů a organických vstupních stránek.</p></section>
<!-- /wp:amicited/audio-embed -->

Uložené atributy WordPressu a serverově vykreslený výstup musí zachovávat stejnou délku trvání, mluvčí, kapitoly a přepis. Editor může zobrazit náhled křivky, ale křivka není náhradou za popsaný ovládací prvek přetáčení nebo textovou navigaci.

Příklady

Dobře: nahrávka, která zůstává užitečná i bez zvuku

Proč tým nastavil 30minutové okno pro vrácení změn Priya Shah, vedoucí vydání, vysvětluje pozorovatelné podmínky, které by zastavily migraci. Délka: 2:18. Kapitoly: 00:00 — Kdo rozhoduje · 00:42 — Podmínky zastavení · 01:31 — Pořadí obnovy Ukázka přepisu: Priya Shah: „Čas sám o sobě nebyl spouštěčem. Migraci bychom vrátili, pokud by chyby při placení překročily dohodnutý práh a potvrdili bychom, že jejich příčinou je nová verze." Nahráno 21. srpna 2026 · Následuje úplný přepis

Toto je dobré, protože název uvádí rozhodnutí, role mluvčího zakládá relevanti, kapitoly činí krátkou ukázku procházející a přepis zachovává přesné upřesnění: uplynulý čas sám o sobě nebyl spouštěčem. Čtenář i crawler mohou porozumět důkazu bez načítání média. Prvek nevytváří statistiku ani neodděluje citaci od kontextu.

Špatně: neprůhledný propagační přehrávač

Poslouchejte nyní! ▶ Epizoda 47 Tajemství, které všechno mění.

Toto je špatné, protože název neslibuje nic ověřitelného, mluvčí a téma chybí a „Epizoda 47" má význam pouze pro stávajícího předplatitele. Chybí délka trvání, přepis, datum, připsání, navigace po kapitolách i cesta pro selhání. Pokud je externí widget blokován, stránka ztrácí veškerou svou podstatu. Přehnaný teaser také skrývá, zda je nahrávka důkazem, instrukcí, názorem nebo reklamou.

Schema markup a přístupnost

Strukturovaná data popisují médium; nečiní audio indexovatelným. Použijte AudioObject pouze pro přehrávatelné audio s přesnými údaji name, description, URL, duration, uploadDate a podrobnostmi o kódování, pokud jsou známy. Použijte PodcastEpisode pouze pro skutečnou epizodu a propojte ji s její udržovanou sérií. Ukázka rozhovoru není epizoda. Obklopující stránka si ponechá svůj vhodný primární typ.

Nepřeměňujte názor mluvčího na recenzní hodnocení, výrok zákazníka na neověřený výsledek nebo datum publikace na datum nahrání. Připojte výzkumné reference v přepisu a použijte blok zdrojů namísto očekávání, že mediální metadata ustaví důvěryhodnost.

Přístupnost začíná ekvivalentním obsahem. Přepis musí zahrnovat všechna mluvená slova, která nesou význam, identifikovat mluvčí vždy, když změna hlasu není v textu zřejmá, a popisovat důležité nemluvní zvuky jako [alarm zní] nebo [dlouhá pauza], pokud ovlivňují interpretaci. Upravujte automatický přepis podle nahrávky. Zachovejte smysluplné rozpaky nebo nejistotu, ale odstraňujte vycpávky pouze na základě zveřejněné redakční politiky, která nemění význam.

Používejte nativní ovládací prvky tam, kde splňují požadavky podporovaného prohlížeče, nebo zajistěte, aby každý vlastní ovládací prvek byl ovladatelný klávesnicí, viditelně zaměřený, popsaný a odhaloval své jméno, roli, hodnotu a stav. Uživatelé potřebují přehrání a pauzu, přetáčení, uplynulý a celkový čas, hlasitost nebo ztlumení tam, kde je to relevantní, a způsob, jak audio okamžitě zastavit. Ovládání rychlosti přehrávání je doporučeno pro řeč delší než pět minut. Nespoléhejte se pouze na křivku: mnoha uživatelům nesděluje ani pozici, ani význam kapitoly.

Nikdy nespouštějte redakční audio automaticky. Nekrádejte fokus při inicializaci přehrávače a zachovejte fokus, pokud se fasáda souhlasu stane přehrávačem. Oznamujte chyby, aniž byste opakovaně oznamovali čas přehrávání. Externí iframe potřebují popisné názvy, rezervované rozměry a běžný záložní odkaz. Přepis, shrnutí a kapitoly musí fungovat při 200% přiblížení, s klávesnicovou navigací a bez JavaScriptu nebo úložiště třetích stran.

Pravidla psaní

Pište okolní text tak, aby se čtenář mohl rozhodnout, zda poslouchat, a získal podstatu nahrávky i bez poslechu.

• Udržujte název na 4–14 slovech a nechte jej identifikovat téma nebo rozhodnutí, nikoli pouze „Podcast" nebo „Poslouchejte nyní."
• Udržujte shrnutí na 20–50 slovech v nejvýše dvou větách. Uveďte mluvčího nebo formát, téma a hodnotu poslechu.
• Zobrazte délku trvání mimo přehrávač ve formátu m:ss pod jednou hodinou nebo h:mm:ss od jedné hodiny výše. Uložte strojovou hodnotu jako ISO 8601.
• Uveďte 1–12 mluvčích nebo použijte stabilní označení rolí jako „Moderátor" a „Volající", pokud soukromí nebo zdroj brání zveřejnění jména.
• Přidejte 2–20 kapitol, pokud nahrávka delší než deset minut mění téma. Udržujte štítky na 3–10 slovech a umístěte první kapitolu na 00:00.
• Publikujte úplný přepis pro redakční řeč. Shrnutí, vybrané citace, soubor s titulky nebo text vygenerovaný poskytovatelem dostupný až po přehrání nejsou dostačující.
• Používejte krátké odstavce přepisu, tučné štítky mluvčích, popisné nadpisy pro změny témat a časová razítka alespoň na každém předělu kapitoly.
• Ověřujte jména, značky, URL, čísla, jednotky, negace a odbornou terminologii podle nahrávky a zdrojového materiálu.
• Uvádějte, zda je úryvek zkrácen nebo přeuspořádán. Označujte vynechávky; nikdy nespojujte slova do věty, kterou mluvčí neřekl.
• Používejte neutrální, konkrétní úvod. Vyhýbejte se zvědavostním mezerám, falešné naléhavosti a tvrzením, že epizoda je „nezbytná" nebo „převratná."
• Nikdy neumísťujte reklamní ovládání v polovině nahrávky, e-mailovou bránu, vynucený účetní tok, skryté sledování, příznak automatického přehrávání, syrové HTML iframe nebo nesouvisející tlačítka k odběru dovnitř základního prvku.
• Nepublikujte soukromý rozhovor, nelicencovanou hudbu, důvěrné údaje zákazníků nebo nahrávku mluvčího bez dokumentovaného povolení a požadované recenze.

Typy příspěvků, které jej používají

Tato tabulka je řízena registrovaným seznamem postTypes v front matter.

Kontrolní seznam QA

• Poslech nahrávky přidává důkaz, kontext, výslovnost, emoci nebo pohodlí při poslechu, které ospravedlňují zvukový prvek.
• Název, shrnutí, délka trvání, mluvčí, datum a vztah ke stránce jsou jasné před přehráváním.
• Úplný, upravený přepis je přítomen v počátečním serverově vykresleném HTML a nevyžaduje přehrávání, souhlas, přihlášení ani JavaScript.
• Přepis odpovídá finální publikované úpravě a správně zachovává jména, čísla, negace, nejistotu a změny mluvčích.
• Úryvky zveřejňují vynechávky nebo přeuspořádání a nespojují samostatné výroky do zavádějící citace.
• Nahrávky nad deset minut s více tématy mají popisné, přesné kapitoly mapované na nadpisy přepisu.
• Chování přehrání, pauzy, zastavení, přetáčení, času, hlasitosti, fokusu a rychlosti přehrávání funguje s klávesnicí a asistenční technologií tam, kde je to relevantní.
• Audio se nikdy nespouští automaticky a aktivace nebo nahrazení fasády souhlasu neztrácí fokus.
• Blokovaný poskytovatel nebo neúspěšný mediální požadavek ponechá shrnutí, přepis, připsání, délku trvání a kanonický záložní odkaz použitelné.
• Požadavky externího poskytovatele se řídí zásadami souhlasu webu a informace o poskytovateli je uvedena před odesláním dat tam, kde je to vyžadováno.
• Nativní zdroje vracejí deklarovaný typ média, podporují očekávané chování přetáčení a nevynucují stažení, pokud si uživatel nevybere.
• Odkazy ke stažení uvádějí formát a přibližnou velikost; neschválený nebo neexistující obrázek obalu není odkazován.
• Data AudioObject nebo PodcastEpisode, pokud jsou přítomna, popisují přesnou přehrávatelnou nahrávku a odpovídají viditelným faktům.
• Prvek nemá vedle sebe žádný konkurenční přehrávač, znějící reklamu, leadový formulář nebo výzvu k akci s vysokým důrazem.
• Mobilní rozvržení nepřetéká; ovládací prvky zůstávají použitelné při 200% přiblížení a s velkým textem.
• Povolení k publikaci, licencování hudby, recenze soukromí a faktická recenze jsou zdokumentovány tam, kde to obsah vyžaduje.

FAQ

Výše uvedené otázky se zabývají úplností přepisu, automatickým přehráváním, chováním souhlasu, volbou schématu a selháním poskytovatele. Jejich odpovědi jsou registrovány v front matter, aby je šablona Akademie mohla konzistentně vykreslovat, zatímco toto tělo zůstává implementační specifikací.