.CSV Serializer Plugin

Plugin source location: <serge_root>/lib/Serge/Engine/Plugin/serialize_csv.pm

This plugin serializes/parses translation files in .CSV format. The generated CSV files are UTF-8-encoded and have the following columns:

  1. ID — string ID
  2. Context — string context
  3. Hint — comment provided by developers or generated by Serge
  4. Source — source string
  5. Translation — current translation (or empty if no translation is provided yet)
  6. Needs Work — flag that indicates that the translation is not final; any value different from empty value or 0 is considered a 'true' one.
  7. Translator's Comment — optional comment that translator may set

Translators are supposed to alter only Translation, Needs Work and Translator's Comment columns. They can provide new values, edit or remove existing ones. Other columns are considered read-only. Changing ID, Context or Source filed values will render the line invalid and any changes in such row, including changes done to other fields, will be reverted on subsequent CSV file update. Changes to Hint value will also be reverted.

Example

source-file.ext.csv
ID,Context,Hint,Source,Translation,Needs Work,Translator's Comment b27b28fa4633c77743f378907ae13b73,,Email subject,ACME account activation,,, 3fd521e005eae6802f087c09d18a058d,,,The ACME team,,,

Usage

example-project.serge