Przetłumacz dokumentację Docusaurus na inny język bez naruszania MDX i kodu
Spakuj folder dokumentacji do formatu ZIP, prześlij go i odbierz przetłumaczone pliki gotowe do wklejenia do i18n/<locale>/docusaurus-plugin-content-docs/current. Importy, Tabs i inne komponenty, znaczniki alertów, bloki kodu i linki pozostają nienaruszone; tytuły, etykiety paska bocznego, opisy i tekst właściwy zostają przetłumaczone. Pierwsza część jest za darmo i bez rejestracji; do 1,000,000 znaków tekstu to $5 (jednorazowa płatność).
- Linie import, export oraz komponenty JSX zachowane w oryginalnej postaci
- Znaczniki alertów (:::note, :::tip) nienaruszone; treść wewnątrz przetłumaczona
- Front matter: pola title, description i sidebar_label przetłumaczone; id, slug i sidebar_position bez zmian
- Kotwice nagłówków (np. {#install}) zachowane, by linki nadal działały
- Taki sam układ folderów w archiwum .zip; obrazy skopiowane bez zmian
Wielojęzyczność (i18n) w Docusaurus bez ręcznego kopiowania
Docusaurus wymaga przetłumaczonej kopii każdego dokumentu w folderze danej wersji językowej, z zachowaniem tych samych nazw plików. Ręczne tłumaczenie lub wklejanie plik po pliku do chatbota jest powolne, a przy MDX błędy kosztują wiele czasu: przetłumaczona nazwa importu czy zmieniony prop wyłożą cały proces budowania. To narzędzie tłumaczy wyłącznie treści widoczne dla czytelnika, a całą resztę kopiuje z Twoich plików bez zmian.
Kod w tekście (inline), cele linków, ścieżki do obrazów i wyrażenia MDX {expressions} przed tłumaczeniem są zastępowane znacznikami i przywracane po nim, więc model w ogóle ich nie modyfikuje. Linie zawierające wyłącznie JSX, takie jak <Tabs> czy <TabItem value="mac">, są pomijane. Bloki kodu zostają pominięte w całości, łącznie z komentarzami.
Po pobraniu
- Rozpakuj archiwum i skopiuj zawartość folderu docs-<locale> do i18n/<locale>/docusaurus-plugin-content-docs/current
- Uruchom docusaurus write-translations dla etykiet szablonu i nazw kategorii paska bocznego (znajdujących się w plikach JSON)
- Uruchom stronę z flagą --locale <locale> i przeklikaj treść
- Popraw ewentualne akapity wymienione w pliku z ostrzeżeniami (jeśli został wygenerowany)
Czego narzędzie nie obejmuje
Etykiety kategorii paska bocznego, teksty nawigacji i stopki znajdują się w plikach JSON generowanych przez polecenie write-translations – możesz je przetłumaczyć za pomocą narzędzia do plików lokalizacyjnych. Wpisy na blogu działają tak samo jak dokumentacja: spakuj folder bloga do ZIP i prześlij go jako drugie zlecenie lub połącz z dokumentacją w jednym archiwum .zip.
Jak działa narzędzie, ile kosztuje i jak traktujemy Twoje pliki, znajdziesz na stronie narzędzia: Tłumacz dokumentacji Markdown. Ceny wszystkich narzędzi znajdziesz w dziale cennik.
Ostatnia aktualizacja:
Pytania i odpowiedzi
Czy projekt poprawnie się zbuduje?
Importy, komponenty, parametry (props), kod i cele linków są precyzyjnie kopiowane z Twoich plików – a to one najczęściej powodują błędy podczas budowania MDX. Po skopiowaniu plików uruchom build i sprawdź plik z ostrzeżeniami.
Czy alerty (admonitions) są tłumaczone?
Linie :::note i ::: pozostają w nienaruszonej formie; tekst pomiędzy nimi zostaje przetłumaczony.
Ile mieści jedno zlecenie?
Do 1,000,000 znaków tekstu, czyli około 300 stron, za $5. Kod oraz klucze front matter nie wliczają się do limitu.
Czy mogę najpierw przetestować kilka plików?
Tak. Pierwsza część jest tłumaczona za darmo i wyświetlana na ekranie; zlecenie do 40 akapitów jest w całości darmowe.