sinusfox/Operations-Research-Tool
Archived
1
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Destroyed lang.ts (markdown)

bRNS98
2024-10-11 23:17:15 +02:00
parent 463d16f63e
commit 5055cdfd23
1 changed files with 0 additions and 97 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lang.ts.md
-97
@@ -1,97 +0,0 @@
# Documentation for `lang.ts`
## Overview
The `lang.ts` file is a TypeScript module responsible for translating interface strings based on given language codes. It currently supports two languages: German (denoted by `"ger"`) and English (denoted by `"eng"`). This functionality is essential for applications that require multi-language support, especially in user interfaces where users can choose their preferred language.
## Table of Contents
1. [Function Description](#function-description)
2. [Supported Languages](#supported-languages)
3. [Key Translations](#key-translations)
4. [Example Usage](#example-usage)
5. [Error Handling](#error-handling)
---
## Function Description
The primary function in this module is:
```typescript
export default function text(lang: string, input: string): string
```
- **Purpose**: This function takes in a language code and an input key and returns the corresponding translated string.
- **Parameters**:
- `lang`: A string representing the language code ("ger" for German, "eng" for English).
- `input`: A string representing a key that needs to be translated.
- **Returns**: A string that is the translation of the input key in the specified language. If no translation is available, it returns the input key itself or an error message if the language is not supported.
---
## Supported Languages
This module supports translation for two languages:
| Language Code | Language |
|---------------|----------|
| `ger` | German |
| `eng` | English |
---
## Key Translations
The module includes translations for several interface components and messages. Below is a list of some key translations:
| Key | English Translation | German Translation |
|-----------------------|---------------------------------------------|---------------------------------------------|
| `header_title` | OR-Tool | OR-Tool |
| `header_subtitle` | by Spaceholder Programming | von Spaceholder Programming |
| `boxObjTitle` | Objective | Ziel |
| `GmplHeader` | General Linear Problems | Allgemeine Lineare Probleme |
| `FileUpload` | Upload File | Datei hochladen |
| `buttonCalc` | Calculate | Berechnen |
| `err_invalidInput` | Error: Invalid input in | Fehler: Ungültige Eingabe in |
| `calculating` | Calculating... | Berechne... |
| `maximize` | Maximize | Maximieren |
| `minimize` | Minimize | Minimieren |
---
## Example Usage
To use the `text` function, simply import it in your TypeScript file and call it with the desired language code and input key.
```typescript
import text from './lang';
// Example: Getting the German translation for the "Calculate" button
const germanCalculateButton = text("ger", "buttonCalc");
console.log(germanCalculateButton); // Outputs: "Berechnen"
// Example: Getting the English translation for the "Objective" title
const englishObjectiveTitle = text("eng", "boxObjTitle");
console.log(englishObjectiveTitle); // Outputs: "Objective"
```
---
## Error Handling
The function is designed to handle various error scenarios:
- **Unknown Language**: If the language code provided is not recognized, the function will return an error message:
```typescript
return "Error: Translation Module - Language Not Known.";
```
- **Invalid Input Key**: If the input key does not have a corresponding translation, the function returns the input key itself. This acts as a fallback mechanism to prevent the application from crashing due to missing translations.
- **Redundant Error Message Key**: It is noted that the `err_invalidInput` key is duplicated in the code. This should be addressed to ensure consistent error messaging.
---
This documentation provides an in-depth look at the `lang.ts` file, detailing its purpose, supported features, and usage examples. By following this guide, developers can efficiently implement and troubleshoot language translation in their applications.