https://github.com/yourls/yourls.pot

🌍 Official YOURLS .pot file to create and maintain your own YOURLS translation
https://github.com/yourls/yourls.pot

i18n l10n language poedit pot translation yourls

Last synced: 4 days ago
JSON representation

🌍 Official YOURLS .pot file to create and maintain your own YOURLS translation

• Host: GitHub
• URL: https://github.com/yourls/yourls.pot
• Owner: YOURLS
• Created: 2013-02-03T22:21:26.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2022-07-28T10:09:35.000Z (over 2 years ago)
• Last Synced: 2024-10-24T00:16:06.884Z (20 days ago)
• Topics: i18n, l10n, language, poedit, pot, translation, yourls
• Homepage:
• Size: 53.7 KB
• Stars: 14
• Watchers: 10
• Forks: 31
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# YOURLS `.POT` [![Listed in Awesome YOURLS!](https://img.shields.io/badge/Awesome-YOURLS-C5A3BE)](https://github.com/YOURLS/awesome-yourls/) [](https://github.com/YOURLS/YOURLS.pot)

This is the official YOURLS `.pot` file to generate and maintain your own translations.

> **Current version** : for **YOURLS 1.9**

> 

> (Check the [release archives](https://github.com/YOURLS/YOURLS.pot/releases) for older versions)

## Awesome! How do I create my own translations?

### To create your translation :

1. Download the translation file template `YOURLS.pot`

2. Rename it to `[your-locale].po`, where `[your-locale]` is typically `language code, underscore, country code` (for instance in Portugal that would be `pt_PT`, while in Brazil it’d be `pt_BR`).  

3. Install a translation software: it’s nothing more than a text editor capable of reading `.po` files, showing you the untranslated string and a text box where you type in the translation, and saving a `.mo` file which is what PHP needs. A cross platform, simple yet complete editor is [Poedit](http://www.poedit.net/).  

4. Translate all the strings. You'll have a fully translated `pt_BR.po` and the generated `pt_BR.mo`

### To check your translation and load it in YOURLS:

1. Install the latest [YOURLS release](https://github.com/YOURLS/YOURLS/releases)

2. Drop your `pt_BR.po` and `pt_BR.mo` files in `user/languages`

3. Add `define( 'YOURLS_LANG', 'pt_BR' )` to your `config.php`

4. That’s it! Play with YOURLS to check everything is fine

For more details, tips and screenshots, see the [related blog post](http://blog.yourls.org/2013/02/workshop-how-to-create-your-own-translation-file-for-yourls/)

## Awesome! How do I update my translation file?

When the `YOURLS.pot` template file is updated with new or modified strings to translate, you don't have to start over your translation file.

1. Download the translation file template `YOURLS.pot`  

2. Put it in the same directory as your translation file, *eg* `pt_BR.po`  

3. In Poedit select **Catalogue** then **Update from POT file**. Now translate only the new strings.

## Awesome! How do I make my translation available to all?

When your translation file is all fine, make sure others can benefit from you hard work!

1. Upload your two `PO` and `MO` files somewhere on the interweb.  

It's best to use a *source control service*, such as Github or GitLab: this will make your changes easy to track, your files easy to maintain, and others' contributions easy to implement. If you don’t want to use SVN or Git, a regular hosting (your blog) will be OK  

2. Make it clear for users: a directory with clearly labelled files (`yourls-1.6-pt_BR.zip` for instance) so they know what to pick.  

3. Open a pull request on https://github.com/YOURLS/awesome-yourls and get your translation listed!   

## What are the available languages already?

See https://github.com/YOURLS/awesome-yourls

## Credits and license

Thanks to [LeoColomb](https://github.com/LeoColomb) - L10n was a low priority feature but he threw his patch at my face :)

License is "Do whatever the hell you want with it".