Method Translate

Namespace: LMKit.Translation

Assembly: LM-Kit.NET.dll

Translate(string, Language, CancellationToken)

Translates the specified text into the target language synchronously while preserving the original layout.

public string Translate(string text, Language language, CancellationToken cancellationToken = default)

Parameters

text string: The text to be translated. This parameter must not be null, empty, or consist solely of whitespace.
language Language: The target language represented as a member of the Language enumeration.
cancellationToken CancellationToken: An optional token that can be used to cancel the translation operation.

Returns

string: A string containing the translated text with formatting and layout preserved.

Examples

// Initialize the language model.
LM languageModel = new LM("path/to/your/model");

// Create an instance of TextTranslation.
TextTranslation translator = new TextTranslation(languageModel);

// Text to be translated.
string text = "This is a sample text to be translated.";

// Translate the text to German.
string translatedText = translator.Translate(text, Language.German);

Console.WriteLine(translatedText);
// Expected Output: "Dies ist ein Beispieltext, der übersetzt werden soll."

Remarks

This method synchronously wraps the asynchronous translation process. It partitions large texts into chunks, translates each chunk individually, and then reassembles the final translated text.

Exceptions

ArgumentException: Thrown if the input text is null or whitespace.