JavaScript

Herhangi bir web sitesini düz JavaScript ile çevirin: bir komut dosyası etiketi ekleyin ve çevirmek istediğiniz metni işaretleyin. Bu, düz HTML, sunucu tarafından oluşturulmuş sayfalar, WordPress ve diğer CMS'ler ve herhangi bir çerçeveyle oluşturulmuş uygulamalarla çalışır.

Komut dosyası etiketi ile kurulum

Sayfanıza Magic Translate komut dosyasını ekleyin:

<script
  src="https://cdn.jsdelivr.net/npm/@magic-translate/js@1/dist/magic-translate.min.js"
  data-api-key="<your-api-key>"
  data-language="de"
  defer
></script>

Henüz bir API anahtarınız yoksa, bir tane almak için Magic Translate 'a kaydolun. Anahtar sayfanızın bir parçası olduğundan, izin verilen alan adları altındaki kendi etki alanlarınızla sınırlayın.

Ardından çevirmek istediğiniz metni bir <t> öğesine koyun:

<h1><t>Please translate me!</t></h1>

İşte bu kadar. Web siteniz artık 70'den fazla dile çevrilebilir.

Ziyaretçinin tarayıcısının diline çevirmek için data-language 'ı bırakın.

npm ile kurulum

JavaScript'inizi paketlerseniz, istemciyi bunun yerine npm'den yükleyin:

# using npm
npm i @magic-translate/js

# using yarn
yarn add @magic-translate/js

import { createMagicTranslate, Language } from '@magic-translate/js';

const magicTranslate = createMagicTranslate({
  apiKey: '<your-api-key>',
  language: Language.DE // any supported language
});

createMagicTranslate sayfayı hemen çevirmeye başlar.

Yapılandırma

Komut dosyası etiketi şu özellikleri kabul eder:

Öznitelik	Açıklama
`data-api-key`	Gerekli. Magic Translate API anahtarınız.
`data-language`	İçeriğinizin çevrildiği dil, örneğin `de`. Tarayıcının dilini varsayılan olarak ayarlar.
`data-source-language`	Sayfanızın yazıldığı dil. Otomatik olarak algılanır, bu nedenle yalnızca algılama yanlış sonuçlar verirse ayarlayın.
`data-formality`	`formal` veya `informal`. Tüm diller için desteklenmez.
`data-debug`	İstekleri konsola kaydeder.

createMagicTranslate ilgili seçenekleri kabul eder: apiKey, language, sourceLanguage, formality ve debug. Ayrıca çeviriyi belirli bir öğeye sınırlamak için root 'ı da kabul eder. Varsayılan olarak, tüm belgeyi çevirir.

Dilleri değiştirme

Sayfayı başka bir dile çevirmek için setLanguage 'ı arayın. Komut dosyası etiketi ile örnek window.magicTranslate olarak kullanılabilir:

<select onchange="magicTranslate.setLanguage(this.value)">
  <option value="en">English</option>
  <option value="de">Deutsch</option>
  <option value="fr">Français</option>
</select>

Komut dosyası etiketini kullandığınızda, ziyaretçinin dil seçimi bir sonraki sayfa yüklemesi için kaydedilir.

Örnek proje

GitHub 'da örnek bir proje bulabilir ve canlı olarak görebilirsiniz.