Najważniejsze informacje
foura.ai działa teraz w sześciu językach. Cała witryna, interfejs Dashboard oraz dziewięć stron marketingowych zostały wyodrębnione, przetłumaczone i skonfigurowane tak, aby serwować właściwą wersję językową na podstawie URL. Po otwarciu sitemapy w przeglądarce zobaczysz ostylowaną tabelę zamiast surowego XML.
Co nowego
Witryna obsługuje sześć języków
Angielski, bułgarski, niemiecki, polski, wietnamski i chiński. Routing oparty na prefiksach URL oznacza, że każda wersja językowa ma własną ścieżkę: /de/, /pl/, /zh/ i tak dalej. Główna ścieżka serwuje język angielski, a /en/ przekierowuje na nią, dzięki czemu dla każdej angielskiej strony istnieje tylko jeden kanoniczny URL. Ikona globu w górnym menu pozwala na zmianę języka, a Twój wybór jest zapamiętywany między podstronami.
Server-side rendering wykonuje kluczową pracę pod kątem SEO. Każda strona ma teraz poprawny atrybut lang, pełny zestaw hreflang, metadane Open Graph dostosowane do lokalizacji oraz zlokalizowany <title> i <meta description>. Sitemap udostępnia każdy URL we wszystkich wersjach językowych. Wyszukiwarki preferujące konkretny język (Baidu wybiera chiński, polska wersja wyszukiwarki wybiera polski) trafiają teraz na właściwą stronę już przy pierwszym crawlowaniu.
Formy mnogie ICU działają dokładnie tak, jak powinny. "1 API key" pozostaje w liczbie pojedynczej, "2 API keys" przechodzi w mnogą, a reguły zmieniają się w zależności od języka. Język polski ma trzy formy mnogie, angielski dwie, a chiński jedną. Mechanizm rozwiązujący w runtime wykorzystuje Intl.PluralRules, wbudowane API przeglądarki, dzięki czemu do Twojego bundle nie trafił żaden dodatkowy kod.
Dla osób czytających po angielsku wizualnie nic się nie zmienia. Twoje adresy URL pozostają na swoim miejscu.
Zlokalizowany interfejs Playground
Około 80 ciągów znaków w narzędziu Playground (etykiety, podpowiedzi, placeholdery, tooltips) dostosowuje się teraz do wybranego języka. Treści techniczne celowo pozostają po angielsku: nazwy metod HTTP, przykłady kodu, klucze JSON, nazwy nagłówków, kody statusu oraz wartości wklejane do requestu wyglądają identycznie w każdej wersji językowej. Otaczający je interfejs mówi w Twoim języku, ale warstwa sieciowa pozostaje po angielsku.
To rozróżnienie ma kluczowe znaczenie. Każdy, kto debuguje request w zespole o różnych językach ojczystych, może skopiować treść requestu i porównać ją z dokumentacją bez rozbieżności wynikających z tłumaczenia.
Sitemap wyświetlana jako tabela
Wklej https://foura.ai/sitemap.xml do karty przeglądarki, a zobaczysz ostylowaną tabelę w ciemnym motywie FourA zamiast surowego XML. Dodaliśmy arkusz stylów XSLT, który obsługuje zarówno pojedyncze sitemapy, jak i sitemap index.
Powód był prosty: przeglądarki przestały renderować zlokalizowane sitemapy jako wbudowane drzewo stylów w momencie, gdy pojawiły się wpisy <xhtml:link> dla alternatywnych wersji językowych. Mieliśmy wybór: wdrożyć sitemapę bez wpisów alternatywnych (tracąc sygnał SEO łączący wersje językowe) albo przygotować własne stylowanie. Wybraliśmy drugą opcję. Crawlery ignorują arkusz stylów i parsują XML jak dotychczas, więc dla nich nic się nie zmienia.
Sitemap to pełnoprawna strona w działającym serwisie. Powinna tak wyglądać.
Pod maską
Tłumaczenia pochodzą ze zautomatyzowanego potoku CI/CD. Zatwierdzamy wyłącznie angielskie ciągi źródłowe; po scaleniu z gałęzią main potok generuje pozostałe wersje językowe i zatwierdza wynik. Poprawka tekstu trafia w jedno miejsce i propaguje się na sześć języków.
Warto wspomnieć o jednej poprawce błędu. Pierwsze wdrożenie ze wsparciem dla wielu języków na krótko wypchnęło na produkcję surowe placeholdery tłumaczeń (zamiast nagłówka widoczne było home.h1a), ponieważ na etapie budowania brakowało katalogu locales. Wdrożyliśmy poprawkę i wymusiliśmy odczyt katalogu locales przed wygenerowaniem paczki, więc problem się nie powtórzy.
Serwis działający w sześciu językach to pod względem struktury sześć różnych witryn. Wyszukiwarki, czytniki ekranowe i klient w Warszawie szukający w Google po polsku zyskują, gdy właściwa wersja językowa trafia pod właściwy URL z poprawnymi metadanymi. Warstwa przesyłu danych pozostaje bez zmian; interfejs dostosowuje się bezpośrednio do każdego odbiorcy.