Translate Novius OS ################### Novius OS is ready to be translated into any language (It has already been translated into French, Japanese, Russian, Spanish and Interlingue). Here is the process to translate Novius OS into your language. Remember `we are here to help `__. Your contribution is very appreciated, thank you. Quick start guide ***************** The best way to get started with Novius OS translation is to begin with the front-office texts (~220 words only). They shouldn’t take you more than an hour to translate. Here are the steps to follow: 1. Go to `translate.novius-os.org `__. 2. In the projects’ list (on the right-hand side), click Novius OS latest version (Novius OS versions are released in alphabetical order). If your language is not listed on the next page, `let us know `__, we'll add it for you. 3. There are only four files to translate. No account required to suggest translations. * Blog application: :file:`noviusos_blognews > front.po` * Forms application: :file:`noviusos_forms > front.po` * Comments application: :file:`noviusos_comments > front.po` * Core: :file:`framework > front.po` That’s it, you’re done! Many thanks for your contribution. Now that you’re started, what about translating more? That’d be fantastic. Keep reading, we tell you all you need to know about Novius OS translation. Copy style guide **************** We take copywriting and translation very seriously. We have therefore established guidelines common to all applications and languages in order to provide every Novius OS user with consistent and enjoyable copy. * :doc:`copy_style_guide` * :ref:`Charte rédactionnelle (Français) ` * :ref:`スタイルガイド（日本語）` * :doc:`copy_style_guide_es` The copy style guide is to be read by every translator. If it's not available in your language then it is the first document to translate. .. note:: We're happy to have the style guide translated by a professionnal translator. This key document may indeed prove hard to localise. `Contact us `__ about this translation. How to translate **************** Novius OS translation server is available at `translate.novius-os.org `__. It is powered by `Pootle `__. Here is a quick guide to Pootle. (You may also want to have a look at `Evernote's handy tour of Pootle `__.) Translate offline ================= If you prefer to translate offline (or just don't like Pootle!), you can use `OmegaT `__ or any other CAT software which handles PO files. Go to the version and language you want to translate (see below) and click the 'Download' link. Once you're done translating, `contact us `__ and we'll grant you the rights to upload language files. Available languages =================== .. image:: images/pootle-nos-languages.png :alt: Available languages :align: center If on :file:`translate.novius-os.org` home page, your language is not listed under :guilabel:`Languages`, just `contact us `__. We'll add it for you. Translation files ================= Once your language is available on :file:`translate.novius-os.org`, click it. Then click the version of Novius OS you want to translate. If you don't know which one to choose, go for the latest version (Novius OS versions are released in alphabetical order). You now see a list of directories. The directories starting with :file:`noviusos_` are applications. :file:`framework` contains the strings from the core. .. image:: images/pootle-nos-directories.png :alt: Translation directories :align: center To start translating, don't click :guilabel:`Continue translation` but a number in the :guilabel:`Need translation` column. This allows you to choose a directory. Please follow these priorities: * Top priority, the core: :file:`framework`. * Then the native applications: Webpages (:file:`noviusos_pages`), Media Centre (:file:`noviusos_media`), Users (:file:`noviusos_user`) and Applications manager (:file:`noviusos_appmanager`). * And finally the non-native applications. Suggesting and submitting translations ====================================== Everybody can suggest translations. A suggestion will be reviewed by an approved translator before being submitted. Only submitted translations are applied to Novius OS. Unreviewed or rejected suggestions stay in Pootle. .. note:: You don't even need to create an account to suggest translations. Nevertheless creating an account only takes you a minute and allows you to select your languages and avoid the CAPTCHA protection. Being an approved translators is a great way to make a difference to the Novius OS project. Everyone can apply: Just `drop us `__ a few lines about yourself and include your Pootle username. We'll review your application before granting you extended permissions. When translating **************** Placeholders and tags ===================== * Some strings include variables, e.g. ``‘Welcome back, {{user}}’``. Obviously, Novius OS end users don't see these variables which are replaced by the actual value, e.g. ``‘Welcome back, Joe’``. Variables are to be kept, untranslated, e.g. ``‘Re-bonjour {{user}}’``. * HTML tags are also to be kept and not to be translated. In most cases, you'll find a start tag and an end tag, e.g. ``‘This page has one sub-page’``. Text between tags must be translated, e.g. ``‘Cette page a une sous-page’``. * For non-breaking spaces, please use the HTML entity, i.e. `` ``. Dispelling doubts ================= Don't translate in the dark! When you don't understand a string, need to know the context or have any doubt, please `contact us `__. Our job is to make translation easy. We're happy to add notes to translator in the translation files for others to benefit from your feedback. We can also provide you with screenshots or indications to find a string in the UI of Novius OS. When your question or comment regards a specific string, please give us the link to the string. You'll find it the bottom right corner: .. image:: images/pootle-nos-string-url.png :alt: String URL :align: center Translating the documentation ***************************** This documentation is powered by `Read The Docs `__ which uses Rich Structured Text (RST) files. This format is human-readable and therefore easier to translate. If on this `page `__, your language is not listed under :guilabel:`Translations`, `contact us `__. We'll set up the GitHub repo for you. Once the repo is ready, clone it. You may also want to clone the `English repo `__ so you can copy files from the original version to the translation. That's it, you're all set to start translating. Thank you very much for your contribution!