Docusaurus belgelerini başka bir dile çevirin; MDX ve kodlara dokunulmaz
docs klasörünüzü zipleyip yükleyin; dosyalarınızı doğrudan i18n/<locale>/docusaurus-plugin-content-docs/current içine aktarılmaya hazır, çevrilmiş olarak geri alın. Import satırları, Tabs ve diğer bileşenler, admonition işaretçileri, kod blokları ve bağlantılar olduğu gibi kalır; başlıklar, kenar çubuğu etiketleri, açıklamalar ve düz metinler çevrilir. Hesap açmadan ilk bölüm ücretsiz; 1,000,000 karaktere kadar metin $5 tek seferlik ödeme.
- import ve export satırları ile JSX bileşen satırları aynen kopyalanır
- Uyarı işaretçileri (:::note, :::tip) korunur; aralarındaki metin çevrilir
- Front matter: title, description ve sidebar_label çevrilir; id, slug ve sidebar_position korunur
- Bağlantıların çalışmaya devam etmesi için {#install} gibi başlık çıpaları korunur
- .zip olarak aynı klasör yollarıyla geri gelir; görseller değiştirilmeden kopyalanır
Kopyala-yapıştır yapmadan Docusaurus i18n
Docusaurus, her belgenin aynı dosya adlarıyla çevrilmiş bir kopyasının yerel ayar (locale) klasöründe bulunmasını bekler. Bunu elle ya da bir yapay zekâ sohbet asistanında dosya dosya yapmak hem yavaştır hem de MDX yüzünden hataların bedeli ağır olur: Yanlışlıkla çevrilen bir import adı veya değiştirilen bir prop, derleme sürecini bozar. Bu araç yalnızca okuyucuların gördüğü kısımları çevirir ve geri kalan her şeyi dosyalarınızdan olduğu gibi kopyalar.
Satır içi kodlar, bağlantı hedefleri, görsel yolları ve MDX {ifadeleri} çeviriden önce özel işaretçilerle değiştirilir ve ardından geri yerleştirilir; böylece model bunları hiç görmez. <Tabs> veya <TabItem value="mac"> gibi yalnızca JSX içeren satırlar atlanır. Yorum satırları da dahil olmak üzere kod blokları tamamen atlanır.
İndirdikten sonra
- ZIP'i açın ve docs-<locale> klasörünün içeriğini i18n/<locale>/docusaurus-plugin-content-docs/current dizinine kopyalayın
- JSON içinde yer alan tema etiketleri ve kenar çubuğu kategori adları için docusaurus write-translations komutunu çalıştırın
- Siteyi --locale <locale> parametresiyle başlatın ve sayfaları kontrol edin
- Varsa, uyarı dosyasında (warnings) listelenen paragrafları düzeltin
Kapsam dışındakiler
Kenar çubuğu kategori etiketleri, gezinti çubuğu (navbar) ve altbilgi (footer) metinleri, write-translations tarafından oluşturulan JSON dosyalarında tutulur; bunları Yerelleştirme Dosyası Çevirisi aracıyla çevirebilirsiniz. Blog yazıları da docs ile aynı şekilde çalışır: blog klasörünü zipleyip ikinci bir iş olarak veya docs ile birlikte tek bir .zip içinde yükleyin.
Aracın nasıl çalıştığı, ne kadar tuttuğu ve dosyalarınızın nasıl işlendiği Markdown Dokümantasyon Çevirisi sayfasında; tüm araçların fiyatları fiyatlar sayfasında.
Son güncelleme:
Sorular ve yanıtlar
Derleme (build) hatasız tamamlanacak mı?
MDX derlemelerinin genellikle bozulduğu yerler olan import'lar, bileşenler, prop'lar, kodlar ve bağlantı hedefleri doğrudan dosyalarınızdan kopyalanır. Kopyaladıktan sonra derlemeyi bir kez çalıştırın ve uyarı dosyasını kontrol edin.
Uyarı blokları (admonition) çevriliyor mu?
:::note ve ::: satırları aynen korunur; aralarındaki metin çevrilir.
Bir iş ne kadar içerik alabilir?
$5 karşılığında 1,000,000 karaktere kadar metin (yaklaşık 300 sayfa). Kodlar ve front matter anahtarları bu sınıra dahil değildir.
Önce birkaç dosyayı deneyebilir miyim?
Evet. İlk bölüm ücretsiz çevrilerek ekranda gösterilir; 40 paragrafa kadar olan işler ise tamamen ücretsizdir.