Ashampoo.Translation.Systems.Formats 1.1.0-prerelease.3

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
This is a prerelease version of Ashampoo.Translation.Systems.Formats.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Ashampoo.Translation.Systems.Formats --version 1.1.0-prerelease.3
NuGet\Install-Package Ashampoo.Translation.Systems.Formats -Version 1.1.0-prerelease.3
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Ashampoo.Translation.Systems.Formats" Version="1.1.0-prerelease.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Ashampoo.Translation.Systems.Formats --version 1.1.0-prerelease.3
#r "nuget: Ashampoo.Translation.Systems.Formats, 1.1.0-prerelease.3"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Ashampoo.Translation.Systems.Formats as a Cake Addin
#addin nuget:?package=Ashampoo.Translation.Systems.Formats&version=1.1.0-prerelease.3&prerelease

// Install Ashampoo.Translation.Systems.Formats as a Cake Tool
#tool nuget:?package=Ashampoo.Translation.Systems.Formats&version=1.1.0-prerelease.3&prerelease

Ashampoo-Translation-Systems-Formats

This package provides the implementation of several translation file formats, such as PO and Json, for the Ashampoo Translation Studio.

Supported Formats

AshLang

AshLang is a file format for storing a translations with their english original text.
An AshLang file is a binary file with the following structure:

TODO: complete readme

Gengo

The Gengo format is a simple format for storing translations.
It is meant to be used for sending it to Gengo for translating.
Gengo is based on Excel (.xlsx) and has a specific structure:\

[[[ ID ]]] source target
[[[ first id ]]] first source first target
[[[ second id ]]] second source second target
[[[ third id ]]] third source third target

As you can see, the ids are always in the first column and the source and target are in the second and third columns. Also, the ids are inside of 3 square brackets.
This is because Gengo doesn't translates strings that are in three square brackets.

Json

The Json format is a simple format for storing translations.
It is a JSON file with the following structure:

{
  "first id": "first target",
  "second id": "second target",
  "third id": "third target"
}

Json also supports nested objects:

{
  "first id": "first target",
  "second id": "second target",
  "third id": {
    "first nested id": "first nested target",
    "second nested id": "second nested target",
    "third nested id": "third nested target"
  }
}

The id for translations in nested objects is constructed by concatenating the ids of the parent objects with a / .
For example, the id for the first nested id is third id/first nested id.

Additionally, arrays are supported:

{
  "first id": [
    "first target",
    "second target",
    "third target"
  ]
}

The id for translations in arrays is constructed by concatenating the id of the parent object with a / and the index of the array.
For example, the id for the first target is first id/0.

NLang

NLang is a simple key-value format.

firstId=firstTarget
secondId=secondTarget
thirdId=thirdTarget

PO

The PO format is a simple format for storing translations.
It is a text file with the following structure:

msgid "first source"
msgstr "first target"

msgid "second source"
msgstr "second target"

msgid "third source"
msgstr "third target"

Po files can also contain comments, and context.
Both can be used to store additional information about the translation.
At the moment, context and comments in files are accepted as inputs, but are not properly handled.
If a translation has a context, the id of the translation is constructed by concatenating the context with a / and the id.
For the full documentation of the PO format, see the GNU gettext manual.

Resx

The Resx format is a simple format for storing translations.
It is a XML file with the following structure:

<?xml version="1.0" encoding="utf-8"?>
<root>
  <data name="first id">
    <value>first target</value>
  </data>
  <data name="second id">
    <value>second target</value>
  </data>
  <data name="third id">
    <value>third target</value>
  </data>
</root>

For more information about the Resx format, see the Microsoft documentation.

TsProj

TsProj is a file format for storing translation strings in a .tsproj file.
It is a xml based format, intended to use with the Ashampoo Translation Studio, with the following structure:

<?xml version="1.0" encoding="utf-8"?>
<project name="My Project" version="1.0" author="Author" mail="author@email.com" source_language="source_language"
target_language="target_language">
    <component pluginguid="{F0D8F625-2EE3-4C84-96EC-BFBDD4946878}">
        <translation id="first id">
            <comment>first comment</comment>
            <source>first source</source>
            <target>first target</target>
        </translation>
        <translation id="second id">
            <comment>second comment</comment>
            <source>second source</source>
            <target>second target</target>
        </translation>
        <translation id="third id">
            <comment>third comment</comment>
            <source>third source</source>
            <target>third target</target>
        </translation>
    </component>
</project>

License

This project is licensed under the MIT license.

Contributing

Contributions are always welcome!
Please read the contribution guidelines first.

Code of Conduct

This project and everyone participating in it is governed by the Code of Conduct.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
4.0.6 47 2/28/2024
4.0.4-prerelease.1 39 2/22/2024
4.0.3-prerelease.1 39 2/22/2024
4.0.2-prerelease.2 39 2/22/2024
4.0.1-prerelease.1 43 2/21/2024
4.0.0-prerelease.1 39 2/21/2024
3.1.1 364 2/15/2023
3.1.0 358 11/23/2022
3.0.0 323 11/15/2022
2.3.0 454 10/20/2022
2.2.1 414 10/12/2022
2.2.0 442 9/8/2022
2.1.1 404 9/7/2022
2.1.0-prerelease.15 87 9/7/2022
2.0.0-prerelease.66 83 9/2/2022
1.1.1-prerelease.12 93 8/31/2022
1.1.0-prerelease.3 71 8/30/2022