A command line xlf to txt converter (for use with Coastline).
You can install the helper globally:
npm i -g @wearesponge/xlf2txt
or install it as part of your project:
npm i --save @wearesponge/xlf2txt
Add the following two tasks to to package.json of your coastline project.
This conversion script was created to allow clients who are not tech/XLIFF savy, to use for instance, Excel, to translate their Coastline course content. It is to be used in conjuction with Coastline's
Within your Coastline project xlf2txt can be used to convert an XLIFF file into a newline delimited .txt file, which can be pasted into, for instance, Excel, and sent over to a client for translation. Once the Excel file has been translated, you can then convert the translated text back into an XLIFF file by pasting the translated text from the Excel file directly into a .txt file, placing it in import\translation\txt2xlf, and then by using the
When using the
translation:txt2xlf command for conversion back to .xlf, the original .xlf file is required to be used as a template for the conversion. You will be prompted for this when running the command.
||Converts all .xlf files within export\translation to .txt, and outputs files to export\translation\xlf2txt|
||Prompts user to select .txt file within import\translation\txt2xlf to convert to .xlf, and outputs to import\translation|
Note: ONLY works with XLIFF 1.2.
.xlf to txt conversion (export)
- Export XLIFF from Coastline by using
npm run translation:exportand choose 'XLIFF 1.2', and 'Comtec'
- Convert XLIFF into text by using
npm run translation:xlf2txt
- Copy contents of converted text file into for example, an Excel spreadsheet
- Send Excel spreadsheet to client for translation. Note: Client may need to be informed on what shouldn't be translated. E.g HTML tags, Mustaches, etc.
.txt to xlf conversion (import)
- Recieve translated Excel spreadsheet
- Create .txt file named as per the country code (E.g fr.txt, ru.txt, de.txt etc.) in import\translation\txt2xlf.
- Copy translated column of Excel spreadsheet into this file and save.
npm run translation:txt2xlfto convert the text file back to an XLIFF
- Import translated XLIFF back into Coastline using
npm run translation:import