Internacionalizácia

Tiptapify podporuje viac ako 35 jazykov hneď po inštalácii. Preklady sa spravujú cez vue-i18n.

Nastavenie predvolenej lokalizácie

Vytvorte inštanciu vue-i18n a odovzdajte ju pri registrácii pluginu:

// main.ts
import { createI18n } from 'vue-i18n'
import TiptapifyPlugin from 'tiptapify'
import 'tiptapify/style.css'

const i18n = createI18n({
  legacy: false,
  locale: 'en',
})

app.use(i18n)
app.use(TiptapifyPlugin, { i18n })

Zmena lokalizácie za behu

Tiptapify používa vašu inštanciu vue-i18n — lokalizáciu zmeníte cez useI18n():

<script setup lang="ts">
import { useI18n } from 'vue-i18n'

const { locale } = useI18n()

const languages = [
  { code: 'en', label: 'English' },
  { code: 'de', label: 'Deutsch' },
  { code: 'fr', label: 'Français' },
  { code: 'es', label: 'Español' },
  { code: 'ru', label: 'Русский' },
]
</script>

<template>
  <div>
    <v-select
      v-model="locale"
      :items="languages"
      item-title="label"
      item-value="code"
      label="Language"
    />

    <Tiptapify placeholder="Start writing..." />
  </div>
</template>

Dostupné lokalizácie

Momentálne sú podporované nasledujúce jazyky:

Code	Jazyk
en	Angličtina
ar	Arabčina
bg	Bulharčina
ch	Čínština
cz	Čeština
de	Nemčina
el	Gréčtina
es	Španielčina
et	Estónčina
fi	Fínčina
fr	Francúzština
he	Hebrejčina
hi	Hindčina
hr	Chorvátčina
hu	Maďarčina
id	Indonézština
it	Taliančina
ja	Japončina
ko	Kórejčina
la	Lotyština
lt	Litovčina
nl	Holandčina
no	Nórčina
pl	Poľština
pt	Portugalčina
pt-BR	Portugalčina (brazílska)
ro	Rumunčina
ru	Ruština
se	Švédčina
sk	Slovenčina
sl	Slovinčina
sr	Srbčina
th	Thajčina
tr	Turečtina
uk	Ukrajinčina
vi	Vietnamčina

Preklady vytvorené pomocou AI

Väčšina prekladov je vytvorená pomocou AI a môže obsahovať chyby. Ak nájdete nesprávny preklad alebo chcete pridať nový jazyk, otvorte issue alebo kontaktujte správcu.

Pridanie vlastných prekladov

Tiptapify automaticky zlúči svoje vstavané lokalizačné správy do vašej inštancie vue-i18n, keď ju odovzdáte pluginu. Preklady môžete rozšíriť alebo prepísať pred registráciou pluginu:

import { createI18n } from 'vue-i18n'
import TiptapifyPlugin from 'tiptapify'
import 'tiptapify/style.css'

const i18n = createI18n({
  legacy: false,
  locale: 'en',
  messages: {
    // Custom translations take precedence over Tiptapify's built-in ones
    en: {
      toolbar: {
        bold: 'Make bold',
        italic: 'Make italic',
      },
    },
  },
})

app.use(i18n)
app.use(TiptapifyPlugin, { i18n })

Alebo ich zlúčte po vytvorení inštancie i18n:

const i18n = createI18n({
  legacy: false,
  locale: 'en',
})

i18n.global.mergeLocaleMessage('en', customTranslations)

app.use(i18n)
app.use(TiptapifyPlugin, { i18n })

Jazyky s písmom sprava doľava (RTL)

Pre jazyky s písmom sprava doľava, ako je arabčina, zabezpečte, aby vaša téma Vuetify podporovala RTL:

const vuetify = createVuetify({
  locale: {
    rtl: true,
  },
})

Lokalizácia pre jednotlivé inštancie

Tiptapify používa lokalizáciu vue-i18n vašej aplikácie globálne. Ak potrebujete lokalizáciu pre jednotlivé inštancie, použite scoped sloty vue-i18n alebo composition API v rozsahu danej inštancie:

<script setup lang="ts">
import { useI18n } from 'vue-i18n'

const { t, locale } = useI18n({ useScope: 'local' })
</script>

<template>
  <Tiptapify :placeholder="t('editor.placeholder')" />
</template>