Schnellstart

Überblick

In diesem Leitfaden führen wir Sie in die Grundlagen der Nutzung der generaltranslation‑Bibliothek ein. Wir behandeln die Übersetzung von Zeichenketten und von Dateien.

Übersetzen Sie Ihre erste Zeichenfolge

1. Richten Sie Ihre Umgebungsvariablen ein

Der erste Schritt besteht darin, GT_PROJECT_ID und GT_API_KEY zu erstellen. Das ist völlig kostenlos und verschafft Ihnen Zugriff auf die Übersetzungsdienste. Navigieren Sie zur Seite API Keys und klicken Sie auf Create API Key. Wählen Sie einen Namen für Ihren API-Schlüssel und klicken Sie auf Create.

API key page

General Translation bietet sehr großzügige kostenlose Ratenlimits, um persönliche Projekte, Solo-Entwickler und die Community zu unterstützen.

2. Initialisieren Sie die GT-Klasse

Initialisieren Sie die GT-Klasse und übergeben Sie sicher Ihre GT_PROJECT_ID und GT_API_KEY.

src/index.ts

import { GT } from 'generaltranslation';

const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
});

3. Übersetzen Sie Ihre erste Zeichenfolge

Rufen Sie die Methode translate auf, um Ihre Zeichenfolge zu übersetzen. Übergeben Sie die zu übersetzende Zeichenfolge und die Ziel-Lokale.

src/index.ts

const { translation } = await gt.translate('Hello, world!', 'es'); // Spanish

console.log(translation); // "¡Hola, mundo!"

Wenn Sie einen Locale-Code nachschlagen möchten, sehen Sie sich die Seite unterstützte Locales an.

Übersetzen Sie Ihre erste Datei

Diese Anleitung setzt voraus, dass Sie bereits die Schritte 1 und 2 der Anleitung Übersetzen Sie Ihre erste Zeichenfolge abgeschlossen haben und über eine GT_PROJECT_ID, GT_API_KEY sowie eine Instanz der Klasse GT verfügen.

Angenommen, Sie möchten eine Datei namens en.json ins Spanische übersetzen.

en.json

{
  "hello": "Hallo",
  "world": "Welt"
}

Um eine Datei zu übersetzen, befolge diese vier Schritte:

Die Datei hochladen
Die Datei zur Übersetzung in die Warteschlange stellen
Den Status der Datei prüfen (optional)
Die übersetzte Datei herunterladen.

Warum nicht nur ein Aufruf? In der Regel möchten Nutzer viele

files auf einmal übersetzen. Durch die Aufteilung in vier klare Schritte erhalten Nutzer deutlich mehr Flexibilität bei der Nutzung der API.

1. Datei hochladen

Das Hochladen von files gibt mit der Methode uploadSourceFiles eine Liste von Dateireferenzen zurück. So können Sie die Datei später zur Übersetzung einreihen, den Status der Datei prüfen und die übersetzte Datei herunterladen.

src/index.ts

import fs from 'fs';
import path from 'path';
import { FileUpload } from 'generaltranslation';

// (i) Read the content of a file
const filePath = path.join(process.cwd(), 'en.json');
const fileContents = fs.readFileSync(filePath, 'utf8');

// (ii) Dateiinhalt formatieren
const fileUpload: FileUpload = {
  content: fileContents,
  fileName: filePath,
  fileFormat: 'JSON',
  locale: 'en',
};
const files = [ { source: fileUpload } ];

// (iii) Datei hochladen
const { uploadedFiles } = await gt.uploadSourceFiles(
  files,
  {
    sourceLocale: 'en'
  }
);

Dadurch wird eine Liste von Dateireferenzen zurückgegeben:

Output

[
  {
    fileId: '41726368696562616c64204d6342616c64792074686973206973206a6f6b652e',
    versionId: '427269616e204c6f75206d6f7265206c696b65204c696f6e2042726f20686121',
    branchId: '123456789',
    fileName: '/Users/demo/en.json',
    fileFormat: 'JSON'
  }
]

2. Datei zur Übersetzung in die Warteschlange stellen

Der nächste Schritt besteht darin, die Ziel-locales für die Übersetzung mit der Methode enqueueFiles auszuwählen. In diesem Fall übersetzen wir ins Spanische.

src/index.ts

const fileUploadRef = {
  fileId: uploadedFiles[0].fileId,
  versionId: uploadedFiles[0].versionId,
  branchId: uploadedFiles[0].branchId,
  fileName: uploadedFiles[0].fileName,
  fileFormat: uploadedFiles[0].fileFormat,
};
const enqueueResult = await gt.enqueueFiles(
  [fileUploadRef],
  {
  sourceLocale: 'en',
  targetLocales: ['es'],
});

Dadurch wird ein Ergebnis mit Jobinformationen zurückgegeben:

Output

{
  jobId: 'job-123456',
  locales: [ 'es' ],
  message: 'Erstelle 1 Übersetzung(en).'
}

3. Status der Datei prüfen

Okay, nachdem die Datei hochgeladen wurde: Wann wissen wir, dass sie zum Herunterladen bereit ist? Wir können die Methode queryFileData verwenden, um den Dateistatus zu prüfen.

src/index.ts

const { fileId, versionId, branchId } = uploadedFiles[0];
const status = await gt.queryFileData({
  translatedFiles: [{
    fileId,
    versionId,
    branchId,
    locale: 'es'
  }]
});

Solange die Datei noch übersetzt wird, lautet der Status pending. Sobald die Übersetzung abgeschlossen ist, lautet er completed.

Output

{
  translatedFiles: [
    {
      fileId: '41726368696562616c64204d6342616c64792074686973206973206a6f6b652e',
      versionId: '427269616e204c6f75206d6f7265206c696b65204c696f6e2042726f20686121',
      branchId: '123456789',
      locale: 'es',
      status: 'completed',
      completedAt: '2024-01-15T12:00:00Z',
      ...
    }
  ]
}

4. Die übersetzte Datei herunterladen

Zum Schluss können wir die übersetzte Datei mit der Methode downloadFile herunterladen.

src/index.ts

const { fileId, branchId } = uploadedFiles[0];
const content = await gt.downloadFile({
  fileId,
  branchId,
  locale: 'es',
});

Dadurch wird der Inhalt der übersetzten Datei zurückgegeben:

Output

{
  "hello": "Hallo",
  "world": "Welt"
}

Überblick

In diesem Leitfaden führen wir Sie in die Grundlagen der Nutzung der generaltranslation‑Bibliothek ein. Wir behandeln die Übersetzung von Zeichenketten und von Dateien.

Übersetzen Sie Ihre erste Zeichenfolge

1. Richten Sie Ihre Umgebungsvariablen ein

API key page

General Translation bietet sehr großzügige kostenlose Ratenlimits, um persönliche Projekte, Solo-Entwickler und die Community zu unterstützen.

2. Initialisieren Sie die GT-Klasse

Initialisieren Sie die GT-Klasse und übergeben Sie sicher Ihre GT_PROJECT_ID und GT_API_KEY.

src/index.ts

import { GT } from 'generaltranslation';

const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
});

3. Übersetzen Sie Ihre erste Zeichenfolge

Rufen Sie die Methode translate auf, um Ihre Zeichenfolge zu übersetzen. Übergeben Sie die zu übersetzende Zeichenfolge und die Ziel-Lokale.

src/index.ts

const { translation } = await gt.translate('Hello, world!', 'es'); // Spanish

console.log(translation); // "¡Hola, mundo!"

Wenn Sie einen Locale-Code nachschlagen möchten, sehen Sie sich die Seite unterstützte Locales an.

Übersetzen Sie Ihre erste Datei

Angenommen, Sie möchten eine Datei namens en.json ins Spanische übersetzen.

en.json

{
  "hello": "Hallo",
  "world": "Welt"
}

Um eine Datei zu übersetzen, befolge diese vier Schritte:

Die Datei hochladen
Die Datei zur Übersetzung in die Warteschlange stellen
Den Status der Datei prüfen (optional)
Die übersetzte Datei herunterladen.

Warum nicht nur ein Aufruf? In der Regel möchten Nutzer viele

files auf einmal übersetzen. Durch die Aufteilung in vier klare Schritte erhalten Nutzer deutlich mehr Flexibilität bei der Nutzung der API.

1. Datei hochladen

src/index.ts

import fs from 'fs';
import path from 'path';
import { FileUpload } from 'generaltranslation';

// (i) Read the content of a file
const filePath = path.join(process.cwd(), 'en.json');
const fileContents = fs.readFileSync(filePath, 'utf8');

// (ii) Dateiinhalt formatieren
const fileUpload: FileUpload = {
  content: fileContents,
  fileName: filePath,
  fileFormat: 'JSON',
  locale: 'en',
};
const files = [ { source: fileUpload } ];

// (iii) Datei hochladen
const { uploadedFiles } = await gt.uploadSourceFiles(
  files,
  {
    sourceLocale: 'en'
  }
);

Dadurch wird eine Liste von Dateireferenzen zurückgegeben:

Output

[
  {
    fileId: '41726368696562616c64204d6342616c64792074686973206973206a6f6b652e',
    versionId: '427269616e204c6f75206d6f7265206c696b65204c696f6e2042726f20686121',
    branchId: '123456789',
    fileName: '/Users/demo/en.json',
    fileFormat: 'JSON'
  }
]

2. Datei zur Übersetzung in die Warteschlange stellen

Der nächste Schritt besteht darin, die Ziel-locales für die Übersetzung mit der Methode enqueueFiles auszuwählen. In diesem Fall übersetzen wir ins Spanische.

src/index.ts

const fileUploadRef = {
  fileId: uploadedFiles[0].fileId,
  versionId: uploadedFiles[0].versionId,
  branchId: uploadedFiles[0].branchId,
  fileName: uploadedFiles[0].fileName,
  fileFormat: uploadedFiles[0].fileFormat,
};
const enqueueResult = await gt.enqueueFiles(
  [fileUploadRef],
  {
  sourceLocale: 'en',
  targetLocales: ['es'],
});

Dadurch wird ein Ergebnis mit Jobinformationen zurückgegeben:

Output

{
  jobId: 'job-123456',
  locales: [ 'es' ],
  message: 'Erstelle 1 Übersetzung(en).'
}

3. Status der Datei prüfen

Okay, nachdem die Datei hochgeladen wurde: Wann wissen wir, dass sie zum Herunterladen bereit ist? Wir können die Methode queryFileData verwenden, um den Dateistatus zu prüfen.

src/index.ts

const { fileId, versionId, branchId } = uploadedFiles[0];
const status = await gt.queryFileData({
  translatedFiles: [{
    fileId,
    versionId,
    branchId,
    locale: 'es'
  }]
});

Solange die Datei noch übersetzt wird, lautet der Status pending. Sobald die Übersetzung abgeschlossen ist, lautet er completed.

Output

{
  translatedFiles: [
    {
      fileId: '41726368696562616c64204d6342616c64792074686973206973206a6f6b652e',
      versionId: '427269616e204c6f75206d6f7265206c696b65204c696f6e2042726f20686121',
      branchId: '123456789',
      locale: 'es',
      status: 'completed',
      completedAt: '2024-01-15T12:00:00Z',
      ...
    }
  ]
}

4. Die übersetzte Datei herunterladen

Zum Schluss können wir die übersetzte Datei mit der Methode downloadFile herunterladen.

src/index.ts

const { fileId, branchId } = uploadedFiles[0];
const content = await gt.downloadFile({
  fileId,
  branchId,
  locale: 'es',
});

Dadurch wird der Inhalt der übersetzten Datei zurückgegeben:

Output

{
  "hello": "Hallo",
  "world": "Welt"
}

Überblick

In diesem Leitfaden führen wir Sie in die Grundlagen der Nutzung der generaltranslation‑Bibliothek ein. Wir behandeln die Übersetzung von Zeichenketten und von Dateien.

Übersetzen Sie Ihre erste Zeichenfolge

1. Richten Sie Ihre Umgebungsvariablen ein

API key page

General Translation bietet sehr großzügige kostenlose Ratenlimits, um persönliche Projekte, Solo-Entwickler und die Community zu unterstützen.

2. Initialisieren Sie die GT-Klasse

Initialisieren Sie die GT-Klasse und übergeben Sie sicher Ihre GT_PROJECT_ID und GT_API_KEY.

src/index.ts

import { GT } from 'generaltranslation';

const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
});

3. Übersetzen Sie Ihre erste Zeichenfolge

Rufen Sie die Methode translate auf, um Ihre Zeichenfolge zu übersetzen. Übergeben Sie die zu übersetzende Zeichenfolge und die Ziel-Lokale.

src/index.ts

const { translation } = await gt.translate('Hello, world!', 'es'); // Spanish

console.log(translation); // "¡Hola, mundo!"

Wenn Sie einen Locale-Code nachschlagen möchten, sehen Sie sich die Seite unterstützte Locales an.

Übersetzen Sie Ihre erste Datei

Angenommen, Sie möchten eine Datei namens en.json ins Spanische übersetzen.

en.json

{
  "hello": "Hallo",
  "world": "Welt"
}

Um eine Datei zu übersetzen, befolge diese vier Schritte:

Die Datei hochladen
Die Datei zur Übersetzung in die Warteschlange stellen
Den Status der Datei prüfen (optional)
Die übersetzte Datei herunterladen.

Warum nicht nur ein Aufruf? In der Regel möchten Nutzer viele

files auf einmal übersetzen. Durch die Aufteilung in vier klare Schritte erhalten Nutzer deutlich mehr Flexibilität bei der Nutzung der API.

1. Datei hochladen

src/index.ts

import fs from 'fs';
import path from 'path';
import { FileUpload } from 'generaltranslation';

// (i) Read the content of a file
const filePath = path.join(process.cwd(), 'en.json');
const fileContents = fs.readFileSync(filePath, 'utf8');

// (ii) Dateiinhalt formatieren
const fileUpload: FileUpload = {
  content: fileContents,
  fileName: filePath,
  fileFormat: 'JSON',
  locale: 'en',
};
const files = [ { source: fileUpload } ];

// (iii) Datei hochladen
const { uploadedFiles } = await gt.uploadSourceFiles(
  files,
  {
    sourceLocale: 'en'
  }
);

Dadurch wird eine Liste von Dateireferenzen zurückgegeben:

Output

[
  {
    fileId: '41726368696562616c64204d6342616c64792074686973206973206a6f6b652e',
    versionId: '427269616e204c6f75206d6f7265206c696b65204c696f6e2042726f20686121',
    branchId: '123456789',
    fileName: '/Users/demo/en.json',
    fileFormat: 'JSON'
  }
]

2. Datei zur Übersetzung in die Warteschlange stellen

Der nächste Schritt besteht darin, die Ziel-locales für die Übersetzung mit der Methode enqueueFiles auszuwählen. In diesem Fall übersetzen wir ins Spanische.

src/index.ts

const fileUploadRef = {
  fileId: uploadedFiles[0].fileId,
  versionId: uploadedFiles[0].versionId,
  branchId: uploadedFiles[0].branchId,
  fileName: uploadedFiles[0].fileName,
  fileFormat: uploadedFiles[0].fileFormat,
};
const enqueueResult = await gt.enqueueFiles(
  [fileUploadRef],
  {
  sourceLocale: 'en',
  targetLocales: ['es'],
});

Dadurch wird ein Ergebnis mit Jobinformationen zurückgegeben:

Output

{
  jobId: 'job-123456',
  locales: [ 'es' ],
  message: 'Erstelle 1 Übersetzung(en).'
}

3. Status der Datei prüfen

Okay, nachdem die Datei hochgeladen wurde: Wann wissen wir, dass sie zum Herunterladen bereit ist? Wir können die Methode queryFileData verwenden, um den Dateistatus zu prüfen.

src/index.ts

const { fileId, versionId, branchId } = uploadedFiles[0];
const status = await gt.queryFileData({
  translatedFiles: [{
    fileId,
    versionId,
    branchId,
    locale: 'es'
  }]
});

Solange die Datei noch übersetzt wird, lautet der Status pending. Sobald die Übersetzung abgeschlossen ist, lautet er completed.

Output

{
  translatedFiles: [
    {
      fileId: '41726368696562616c64204d6342616c64792074686973206973206a6f6b652e',
      versionId: '427269616e204c6f75206d6f7265206c696b65204c696f6e2042726f20686121',
      branchId: '123456789',
      locale: 'es',
      status: 'completed',
      completedAt: '2024-01-15T12:00:00Z',
      ...
    }
  ]
}

4. Die übersetzte Datei herunterladen

Zum Schluss können wir die übersetzte Datei mit der Methode downloadFile herunterladen.

src/index.ts

const { fileId, branchId } = uploadedFiles[0];
const content = await gt.downloadFile({
  fileId,
  branchId,
  locale: 'es',
});

Dadurch wird der Inhalt der übersetzten Datei zurückgegeben:

Output

{
  "hello": "Hallo",
  "world": "Welt"
}

Schnellstart

Auf dieser Seite

Schnellstart

Auf dieser Seite

Schnellstart

Auf dieser Seite

GitHubAuf GitHub mit Stern markieren

GitHubAuf GitHub mit Stern markieren

Auf GitHub mit Stern markieren

Auf GitHub mit Stern markieren