BizKitHub

Směrování a URL adresy

Naposledy aktualizováno 2. srpna 2026postsroutingurlsseo

Každý příspěvek na veřejném webu má kanonickou URL — jedinou "oficiální" adresu, kterou indexují vyhledávače a čtenáři si ji ukládají do záložek. Vícejazyčné weby mají jednu kanonickou URL na jazykovou verzi (/cs/…, /en/…, /de/…), přičemž každá je odvozena z názvu článku v daném jazyce. Tento článek pojednává o tom, jak se tyto URL generují, jak je můžete přepsat, jak platforma udržuje překlady v synchronizaci se směrováním a jak se zotavit z nefunkčních nebo chybějících tras.

Pravidlo jedna-URL-na-jazykovou-verzi

Pro každý článek a každou jazykovou verzi, do které je přeložen, existuje jedna kanonická trasa. To znamená:
  • Organizace se třemi jazykovými verzemi a sto články má tři sta kanonických tras.
  • Organizace s jednou jazykovou verzí a sto články má sto kanonických tras.
  • Smazaný (soft-deleted) článek má stále své trasy na místě — pro anonymní čtenáře vracejí "nenalezeno", ale mohou být obnoveny při obnovení.
Kanonická znamená: URL, která se objeví v <link rel="canonical"> tagu na stránce článku, v sitemapě, v RSS zdroji, v OpenGraph metadatech a ve veřejné API odpovědi. Nekanonické trasy (přesměrování z přejmenovaných slugů, alternativní aliasy) mohou také existovat, ale každý článek má přesně jednu kanonickou trasu na jazykovou verzi.

Automatické generování slugů

Když poprvé uložíte překlad článku, platforma automaticky vygeneruje URL slug z názvu:
  • Převeďte název na malá písmena.
  • Odstraňte diakritiku (ě → e, ř → r, ý → y, ç → c).
  • Nahraďte mezery a interpunkci pomlčkami.
  • Sloučte více pomlček.
  • Odstraňte koncové nebo počáteční pomlčky.
Pro český článek s názvem Jak založit objednávku přes API se český slug stane jak-zalozit-objednavku-pres-api. Jeho anglický překlad How to create an order via the API se stane how-to-create-an-order-via-the-api. Každý slug je specifický pro jazykovou verzi — nikdy nesdílejte slug napříč jazyky.Vygenerovaný slug se poté zkombinuje s prefixem jazykové verze, aby vytvořil celou URL:
 /cs/jak-zalozit-objednavku-pres-api /en/how-to-create-an-order-via-the-api

Jedinečnost

Slugi musí být jedinečné pro (organizaci, jazykovou verzi). Pokud vygenerovaný slug koliduje s existujícím, platforma připojí číselnou příponu (-2, -3, …), dokud se nenajde volný slug. To je tiché — můžete skončit s how-to-create-an-order-via-the-api-2, i když jste to nezamýšleli. Zkontrolujte URL po uložení nového příspěvku a přepište, pokud se přípona zdá být chybná.

Ruční úprava slugu

Automaticky vygenerovaný slug můžete přepsat v detailu příspěvku → sekci Směrování (dostupné v některých šablonách webu) nebo pomocí nastavení slugu specifických pro kategorii. Ruční úpravy dodržují stejná pravidla jako automaticky generované slugi (malá písmena, oddělené pomlčkami, pouze ASCII), ale můžete si zvolit přesné znění.Důležité: změna slugu přepíše kanonickou URL. Kdokoli, kdo si starou URL uložil do záložek nebo na ni externě odkázal, se dostane na stránku "nenalezeno", pokud platforma nemá přesměrování z starého slugu na nový. Přesměrování se automaticky vytvářejí při přejmenování, ale pouze pokud se provádí přes administraci — hromadné úpravy pomocí Git workflow v současné době negenerují přesměrování pro změny slugů.Slugi přejmenovávejte zřídka a pouze tehdy, když přínos pro SEO nebo použitelnost převáží náklady na přesměrování.

Prefixy jazykových verzí

Veřejný web automaticky vkládá prefix jazykové verze (/cs/, /en/, …). Nezahrnujete jej do samotného slugu. Když sdílíte článek interně, vždy sdílejte celou URL s prefixem jazykové verze — vynechání prefixu způsobí, že web uhodne jazykovou verzi čtenáře, která nemusí odpovídat záměru sdílejícího.Pro zážitek čtenáře z prohlížení se web snaží zobrazit článek v jejich preferované jazykové verzi (z jejich relace nebo nastavení prohlížeče), s návratem na primární jazykovou verzi, pokud požadovaný překlad chybí.

Interakce s překladovým tokem

Kdykoli tok automatického překladu vytvoří nový překlad pro cílovou jazykovou verzi (viz Překlady), vytvoří také kanonickou trasu pro tuto jazykovou verzi, pokud neexistuje. Nemusíte nic dělat — obě operace probíhají současně.Dva režimy selhání, o kterých je dobré vědět:
  • Trasa bez překladu — osamocená trasa. Zůstává poté, co je překlad smazán z DB, ale trasa přežije. Neškodné samo o sobě, ale slug je nyní rezervován a nelze jej znovu použít pro nový příspěvek.
  • Překlad bez trasy — článek má překladovou řádku, ale kanonická trasa nebyla nikdy vytvořena (obvykle proto, že starší skript pro hromadný import zapsal obsah, ale přeskočil směrování, nebo se překladový běh zhroutil po uložení obsahu, ale před vytvořením trasy). Překlad není dostupný z veřejného webu.
Karta Překlady na /post zobrazuje oba případy v tabulce pro jednotlivé jazykové verze: Trasy ukazuje, kolik kanonických tras existuje pro danou jazykovou verzi; Osamocené trasy zvýrazňuje počet tras bez odpovídajícího překladu.

Akce fix-routes

Pro opravu poškozených tras pro existující překlady použijte tlačítko Opravit trasy na kartě Překlady, nebo spusťte post fix-routes v administrátorském terminálu.Příkaz:
  1. Prohledá každý příspěvek v organizaci.
  2. Pro každý existující překlad, který nemá kanonickou trasu, vygeneruje slug z názvu tohoto překladu a vytvoří trasu.
  3. Přeskočí články, kde každý existující překlad již má trasu (idempotentní).
  4. Nahlásí, co vytvořil, v souhrnné tabulce.
Levná operace — žádné volání AI, čistě průchod metadat — bezpečné spustit kdykoli, když máte podezření na posun tras. Viz Překlady pro úplný model terminálového příkazu.

Kategorie v URL

Kategorie jsou řešeny odděleně od článků. URL kategorie je /{locale}/category/{category-slug} — například /cs/category/sales. Články NEZAHRNUJÍ svou kategorii do URL — URL článku je /{locale}/{article-slug} s kategorií sloužící čistě jako metadata taxonomie.Přesunutí článku mezi kategoriemi nemění jeho URL. Pokud přejmenujete kategorii, změní se pouze URL stránky kategorie, nikoli URL článků jejích členů.Viz Kategorie příspěvků pro životní cyklus URL kategorie.

RSS a sitemap

Každá kanonická trasa je zahrnuta v:
  • XML sitemap na /sitemap.xml — jeden záznam na kombinaci (příspěvek, jazyková verze). Vyhledávače toto používají k objevování článků. Automaticky regenerováno při každém uložení.
  • RSS kanál na /rss nebo /{locale}/rss — položky seřazené podle data publikace, s ohledem na viditelnost (soukromé, neuvedené a pouze pro předplatitele příspěvky jsou vyloučeny).
  • RSS specifické pro kategorii na /{locale}/category/{slug}/rss — stejný tvar jako RSS celého webu, ale filtrované na jednu kategorii.
Nekanonické URL (přesměrování, aliasy) nejsou zahrnuty v ani jednom — vyhledávače sledují přesměrování a indexují kanonické.

Úvahy ohledně SEO

URL je důležitá pro SEO. Několik pokynů:
  • Udržujte slugi krátké. 40–70 znaků je zdravý rozsah. Velmi dlouhé slugi (the-comprehensive-and-detailed-guide-to-what-you-should-know-about-…) jsou ořezány vyhledávači ve výsledcích.
  • Zahrňte primární klíčové slovo. Slug je jedním z mnoha signálů pro hodnocení; uvedení hlavního tématu článku do něj pomáhá.
  • Vyhněte se stop slovům, když nepřidávají žádný význam. article-about-x je lepší jako x.
  • NEPŘEJMENOVÁVEJTE slugi po publikaci, pokud přínos pro SEO není zřejmý. Přesměrování zachovává sílu odkazu, ale vždy dochází k nějaké ztrátě, když se URL změní.

Co je vystaveno integrátorům

Veřejné API vrací:
  • code u příspěvku — část URL slugu (bez prefixu jazykové verze). Použijte toto při vytváření URL na straně klienta.
  • canonicalUrl v detailu příspěvku — plně kvalifikovaná URL, jak se objevuje na veřejném webu, včetně prefixu jazykové verze.
  • routes v detailu příspěvku — celá tabulka tras pro jednotlivé jazykové verze, takže integrátor vytvářející přepínač jazyků může odkazovat na ekvivalentní článek v každé jazykové verzi.
Viz Integrace API.

Tipy

  • Pozor na tiché číselné přípony. Po vytvoření nového příspěvku s běžným názvem otevřete stránku článku nebo API, abyste potvrdili, že URL je to, co jste očekávali. -2, -3, -4 v slugu znamená, že starší článek si nárokoval jednoduchý slug.
  • Nezahrnujte jazykovou verzi do svého slugu — platforma ji přidává. Slug jako en-how-to-do-x vytvoří dvojitě předponovanou URL /en/en-how-to-do-x.
  • Řetězce přesměrování ničí SEO. Pokud přejmenujete slug a poté jej přejmenujete znovu, druhé přejmenování vytvoří řetězec (old-1 → old-2 → current). Vyhledávače ochotně sledují jeden skok a dva skoky neochotně. Pokud můžete, zploštěte ručně — přesměrujte starší přesměrování přímo na aktuální slug.
  • Oprava tras je idempotentní — spuštění post fix-routes, když nic není rozbité, je no-op. Neváhejte jej spustit po jakékoli hromadné operaci (import z Gitu, spuštění překladu, restrukturalizace kategorie) jako hygienickou kontrolu.

Související

Související články