Textpattern CMS language files

This repository contains Textpacks for Textpattern CMS. Textpacks are the translation file format Textpattern will eventually use in a future version.

Contributing

To make corrections to existing translations, or to add new ones, fork the repository, make your changes and commit to your fork. Once you are done, open a pull request. To boost workflow the repository contains synchronisation scripts and automated tests.

Contributing via GitHub web editor

GitHub’s web based editing features allow you to easily do smaller edits to existing translations without you needing to delve into git. Changing files through the web interface isn’t really recommended, but it’s an option for those that do not use git, or are away from their computer.

To contribute to a translation directly from GitHub.com website:

1. Sign in with your GitHub account
2. Navigate to a Textpack file you want to alter, e.g. textpacks/en-gb.textpack.
3. Click or tap the Edit button above the presented file contents.
4. Make some alterations to existing strings. Please, don’t remove or add any string.
5. After you’ve done, fill in the short commit message describing the change, e.g. “Fixed typo in the name string”.
6. Click or tap the Save button.

Now to submit in a new pull request with your changes:

1. Click or tap the Click to create a pull request for this comparison link on the page presented to you after saving, or you can use the Compare and pull request button on your fork’s repository page.
2. Fill in the comment field; explain what your changes do. Be precise and clear.
3. Click or tap the Send pull request button.

Once your pull request is processed and marked closed (merged or denied), go back to your GitHub profile page and delete your clone of the Textpacks repository:

1. Find the textpacks repository on your profile page; it should be listed on your repository list.
2. Open it.
3. On the repository’s page, click or tap the Settings link.
4. Scroll down until you see Delete repository button.
5. Click or tap it and confirm the action.

Developing

Adding and removing strings

Adding and removing strings happens through the main translation file, en-gb.textpack. Open up the file and add or remove strings as needed (remember to place new strings where they belong). Once you are done, run the sync tool:

$ ./textpack

The Textpack tool will sync your alterations to all other Textpack files. It creates new empty strings and removes anything that is no longer present in the root translation.

Creating new translation

When creating entirely new translations, always use the en-gb.textpack as your template and reference point – this file is always up-to-date.

Creating new empty template

Start by creating a new empty Textpack file:

$ touch textpacks/xx-xx.textpack

Then run the Textpack sync tool:

$ ./textpack

This will populate your empty xx-xx.textpack file with an empty Textpack template.

Updating an existing translation

After running the sync tool, any new strings will be empty – you have to compare it with en-gb.textpack in order to review and update it, which can prove laborious. The tip below will help you translate new strings. Note: Commit everything before you do it!

First, filter all new strings:

$ grep " =>[[:blank:]]*$" xx-xx.textpack | \
xargs -n1 printf "grep '^%s =>' en-gb.textpack\n" | \
bash > xx-xx.txt

Then, delete untranslated lines:

$ sed -i '/ =>[[:blank:]]*$/d' xx-xx.textpack

This will leave you with just the new/empty strings. Edit xx-xx.txt in your favourite editor, then append the strings at the end of the original xx-xx.textpack. Finally, run the sync tool and test:

$ ./textpack
$ ./vendor/bin/phpunit

Testing

The project uses PHPunit for running its unit tests. Before running the tests, make sure you have installed dev-requirements using Composer:

$ composer install --dev

To run a test:

$ ./vendor/bin/phpunit