vinou/translations

3.7.5 2024-09-02 11:28 UTC

This package is auto-updated.

Last update: 2024-10-02 11:40:54 UTC


README

由于 Vinou 平台本身依赖于这个库,因此它处于持续集成和开发状态。关于这一点,翻译文件包含了对我们平台每个工作阶段的翻译工作。

以下 README 文件记录了当前翻译定义规则的现状。考虑到大量语言键和其他依赖旧编码指南的 Web 项目,翻译文件有时看起来真的很混乱。

目录

1. 贡献

如果您想贡献,请随时加入并创建拉取请求。我们想确保大多数依赖的 Web 项目可以轻松更新,因此您的作品可能需要一些时间才能被添加。您可以通过 PN、发送邮件至 kontakt@vinou.de 或拨打 +49 61316245390 联系我们。

2. 编码指南

  1. 如果一个键用于键的数组,它总是复数,例如国家或 wineRegions
  2. 如果一个键标识一个对象或只是一个字符串,它总是单数,例如 wine、product、bundle
  3. 所有标识符都必须是 lowerCamelCase。不允许使用连字符、下划线或其他分隔符。在特殊情况下,id 可以用于翻译表示静态数据库对象,如 grapeTypes。
  4. 如果一个对象在两个以上的其他对象中使用,它可以在通用对象下定义
  5. 如果一个对象包含多个静态选项,值应在父对象中定义为数组,例如:产品对象有一个类型字段,具有 3 个静态选项,这些选项应在对象 "product" 中定义为 "types"。
  6. 所有键应按字母数字顺序排列,除非是基对象的属性(见下文)。
"product": {
  "fields": {
    "type": "Type of product"
  },
  "types": {
    "optionOne": "Option 1",
    "optionTwo": "Option 2",
    "optionThree": "Option 3"
  }
}

3. 标准对象键

每个对象可以定义以下标准键,以下列出了首选定义顺序。

4. 对象示例

"bundle": {
  "name": {
    "singular": "Weinpaket",
    "plural": "Weinpakete"
  },
  "actions": {
    "addItem": "+ Artikel hinzufügen",
    "create": {
      "main": "Neues Weinpaket",
      "sub": "anlegen"
    }
  },
  "fields": {
    "active": "aktiv",
    "articleNumber": {
      "label": "Art.-Nr.",
      "placeholder": "SKU 000 - 0000000"
    },
    "category": "Kategorie",
    "description": "Beschreibung",
    "sorting": "Manueller Sortierindex (z.B. für den Shop)"
  },
  "fieldSets": {
    "facts": "Daten & Fakten",
    "general": "Allgemeines",
    "items": "Artikel"
  },
  "views": {
    "create": {
      "title": "Neues Weinpaket erstellen"
    },
    "files": {
      "title": "Dateien",
      "empty": "Es liegen keine {label} zu diesem Weinpaket vor."
    }
  },
  "filters": {
    "category": {
      "label": "Kategorie auswählen",
      "none": "Pakete ohne Kategorie anzeigen"
    },
    "search": {
      "placeholder": "z.B. Name, Beschreibung"
    },
  },
  "dialogs": {
    "delete": "Möchtest Du dieses Weinpaket wirklich löschen?"
  },
  "toasts": {
    "changed": "Weinpaket geändert!",
    "changeError": "Weinpaket konnte nicht geändert werden!",
    "created": "Weinpaket angelegt!",
    "createError": "Weinpaket konnte nicht angelegt werden!",
    "deleted": "Weinpaket gelöscht!",
    "deleteError": "Weinpaket konnte nicht gelöscht werden!",
    "imageDeleted": "Bild zum Weinpaket gelöscht",
    "imageUploaded": "Bild zum Weinpaket hochgeladen!"
  },
  "hints": {
    "imageSize": "<b>Empfehlung für optimale Darstellung</b><br>Abmessungen: 1500x1500px<br/>Datei-Format: .png (freigestellt)"
  },
  "packageTypes": {
    "mixed": "Gemischt",
    "surprise": "Überaschungspaket",
    "wineOnly": "Nur Wein",
  }
}

5. Twig 扩展

这个库还包含一个 Twig 扩展。要实现此扩展,您可以使用以下代码。

  $languageKey = 'de';
  $twig = new \Twig\Environment();
  $twig->addExtension(new \Vinou\Translations\TwigExtension($languageKey));

之后,您可以在模板中使用 translate 过滤器,如下所示

  <p id="wine">
    <a class="action-button">
      <span class="main">{{ 'wine.actions.create.main' | translate }}</span>
      <span class="sub">{{ 'wine.actions.create.sub' | translate }}</span>
    </a>
  </p>

提供者

这个库由 Vinou GmbH 开发。

Vinou GmbH
Mombacher Straße 68
55122 Mainz
电子邮件: kontakt@vinou.de
电话:+49 6131 6245390