Pixi’VN
Narration

Internationalisierung

Erfahre, wie du ink-Texte in Pixi’VN mit einer Bibliothek wie i18next und der Funktion onInkTranslate übersetzt.

Wie hier ausführlicher erläutert wird, können mit Pixi’VN Spieltexte mithilfe einer Bibliothek wie i18next übersetzt werden. Auch bei der Integration von ink mit Pixi’VN kannst du eine Bibliothek verwenden, um Texte in ink zu übersetzen.

Pixi’VN ermöglicht es dir, das Übersetzungsereignis mit der Funktion onInkTranslate abzufangen.

import { onInkTranslate } from "@drincs/pixi-vn-ink";
import { useEffect } from "react";
import { useTranslation } from "react-i18next";

export default function useInkInitialization() {
    const { t } = useTranslation(["narration"]);
    useEffect(() => {
        onInkTranslate(t);
    }, [t]);

    return null;
}

Automatische Erstellung von Übersetzungsdateien

Vorlagen

In allen Vorlagen kannst du mit der folgenden Schaltfläche in den Einstellungen automatisch die JSON-Datei erstellen, die für Übersetzungen verwendet wird. dowload-translate

Um das Erstellen von Übersetzungsdateien zu vereinfachen, kannst du mit der Funktion generateJsonInkTranslation automatisch die JSON-Struktur aus dem ink-Text erzeugen.

lib/i18n.ts
import { generateJsonInkTranslation } from "@drincs/pixi-vn-ink";
import i18n from "i18next";
import { convertInkToJson } from "./utils/ink-utility";

function getLocalesResource(
    lng: string,
): Promise<Record<string, Record<string, string>>> {
    return import(`./../locales/${lng}.json`);
}

async function generateResourceToTranslate(lng: string): Promise<any> {
    let res = await getLocalesResource(lng);
    res = { ...res };
    if (!res) {
        res = {};
    }
    if (!res.narration) {
        res.narration = {};
    }
    if (res.default) {
        delete res.default;
    }
    const manifest = await import("@/assets/ink-manifest.gen.json");
    for (const path of manifest.default) {
        const element = await fetch(path).then((r) => r.json());
        element && (await generateJsonInkTranslation(element, res.narration));
    }
    return res;
}

export async function downloadResourceToTranslate() {
    const lng = i18n.options.fallbackLng?.toString() || "en";
    const data = await generateResourceToTranslate(lng);
    const jsonString = JSON.stringify(data);
    // download the save data as a JSON file
    const blob = new Blob([jsonString], { type: "application/json" });
    // download the file
    const url = URL.createObjectURL(blob);
    const a = document.createElement("a");
    a.href = url;
    a.download = `strings_${lng}.json`;
    a.click();
}

Auf dieser Seite