Translation

From RSSOwl

Jump to: navigation, search

Contents

[edit]

Introduction

This page outlines the details on how to translate RSSOwl 2.0 to new languages. The table below shows a list of already existing translations. If your language is not showing up yet, you can help out!

Language Translator
English Benjamin Pasero
German Benjamin Pasero
[edit]

How to Translate RSSOwl 2.0

  1. Send a Mail to Benjamin Pasero with your language to translate
  2. Receive a Zip file with the files to translate
  3. Follow the instructions below to translate
  4. Take your time for the translation! Quality is more important than speed.
  5. Send the Zip file back to Benjamin Pasero
[edit]

Translation Editor

  • Using Eclipse makes it easy to test your translation in RSSOwl
    • But any other Editor can be used too!
  • Install Eclipse 3.5.1
  • Import the ZIP file that Ben sent you into Eclipse
    • File | Import | Existing Projects Into Workspace | Select Archive File
    • Select all Projects included in the Archive File
    • Finish
  • Note: If you see an error in Eclipse that some bundles are missing after import, this is ok. It just complains that it does not find the RSSOwl source code.
  • Set the encoding of the two projects to UTF-8
    • Open the Properties of each Project
    • Select Resource
    • Set the Text File Encoding to Other: UTF-8
  • Edit the Properties file as described below
[edit]

Translation Instructions

  • Every properties file needs to be translated except for build.properties
    • 21 files in org.rssowl.ui.<language>
    • 12 files in org.rssowl.core.<language>
  • Only translate the right side of a value in the properties file, for example:
    • WebBrowserView_BACK=Back
  • Do not add leading or trailing whitespaces
  • Use UTF-8 encoding when editing the properties files
  • Be consistent with your words across all properties files
  • Short translations are better than long ones
    • Consider keeping an english word if a direct translation is not possible or results in a very long confusing translation
  • Some words contain an ampersand (&) to mark a mnemonic
    • Do not remove the ampersand, its transformed in the UI to an underline if the ALT key is pressed
  • Some properties contain \t which indicates a tab-stop character or \n which indicates a newline
    • Do not remove these special character sequences
  • Dynamic content is surrounded by curly brackets so that you can move it around as appropiate, for example:
    • Do you want to delete {0}?
    • {0}: {1}
  • If you are using a single quote (') together with a curly brackets, it needs to be escaped by using another single quote
    • for example: Download Attachments to ''{0}''
  • Some properties make use of HTML Tags, keep them functional and only translate words inside
    • for example: <a>{0}</a> (<a href="play">Play Now</a>)
[edit]

How to Test your Translation in RSSOwl

  • If you are not using Eclipse as Editor for the Translations
    • Install Eclipse 3.5.1
    • Import the two projects org.rssowl.core.<language> and org.rssowl.ui.<language> into Eclipse
      • File | Import | Existing Projects Into Workspace | Select root directory of the two projects you translated
      • Finish
      • Note: If you see an error in Eclipse that some bundles are missing after import, this is ok. It just complains that it does not find the RSSOwl source code.
    • Set the encoding of the two projects to UTF-8
      • Open the Properties of each Project
      • Select Resource
      • Set the Text File Encoding to Other: UTF-8
  • You also need to Import RSSOwl
    • Download the RSSOwl Source from SourceForge
    • Import the Zip file into Eclipse via File | Import | Existing Projects Into Workspace | Select Archive File
    • Select all Projects included in the Archive File
    • Finish
  • Open build.properties of each of the two projects
    • Ensure that for the binary build, all files and folders are selected
  • Export the two projects to use them in RSSOwl
    • File | Export | Deployable plug-ins and fragments
    • Select the two projects
    • Select e.g. your Desktop as Directory for the export
    • Finish
  • Install your translation into RSSOwl 2.0
    • Close RSSOwl if running
    • Copy the two JAR files from the Export into the folder "plugins" of the RSSOwl installation
    • Start RSSOwl with parameters: rssowl -clean -nl <ISO Language Code>
      • For example rssowl -clean -nl de (for german)
  • Do not hesitate to contact Benjamin Pasero for any questions
Retrieved from "http://wiki.rssowl.org/index.php/Translation"
Personal tools