Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jeffwilcox/4thandmayor-resources

Localization resources for 4th & Mayor, a Windows + Windows Phone app
https://github.com/jeffwilcox/4thandmayor-resources

Last synced: 5 days ago
JSON representation

Localization resources for 4th & Mayor, a Windows + Windows Phone app

Awesome Lists containing this project

README 

        
# 4th and Mayor - Localization Project #



Hi, as many of us have spoken in the past, a key ask has been the availability of 4th & Mayor in many languages.



As hundreds of people have offered their support in localizing the app, I have finally started to take the time to prepare the underlying infrastructure here on GitHub to enable this.



I've also been working with localization resources, vendors, friends and others in 2014 to enable more scenarios here.



The goal of this project is to support the languages that Foursquare also supports from a cloud-side; because many components - badges, messages, notes, notifications, warnings, etc. - are passed on from the cloud, this is a key limitation.



Thank you so much,

[@jeffwilcox](https://twitter.com/jeffwilcox)



## Languages ##

The initial languages of interest (depending on developer interest) include:



- English (EN)

- Spanish (ES)

- French (fr-FR)

- German (DE)

- Indonesian (ID)

- Italian (IT)

- Japanese (JA)

- Korean (KO)

- Russian (RU)

- Portuguese (pt-PT, pt-BR)

- Thai (TH)

- Turkish (TR)



You can see the supported language/country codes on this page on Foursquare: [https://developer.foursquare.com/overview/versioning](https://developer.foursquare.com/overview/versioning)



> Unfortunately no other languages will receive the cloud components localized, including badges, messages, alerts, and experiences. As a result, this is a hard limitation on the languages that can be localized. Sorry! The limitation is on the foursquare side.



### Regional Languages ###

Regional languages are not necessarily supported on the server-side, but in situations where it makes sense for the client UI to be localized into variants, this is fine to do - with the understanding that server-provided content will still be in a more generic form that may or may not be appropriate for the sub-locale.



## Target Release ##



The Windows Phone 8.1 release is the initial target for localization. Adding localization to the Windows Phone 7.1 OS or 8.0 versions will be very involved.



## Tools ##



- Windows 8.1 Operating System

- Windows Phone 8.1 Developer Preview SDK

- Visual Studio 2013 (Express or any SKU that can edit resource files, the format of the files is .resw)



## Process ##



Initially the process is designed for developers who are fluent in the language of interest. This is because the localization tools of choice include modern development environments at this time (Visual Studio or its localization tools, etc., plus a Windows 8 dependency) instead of a more traditional localization format such as Excel files that are shared.



The GitHub process, including fork and pull request, should be used.



Language translation should not be used if at all possible, unless to fill any last-minute strings before supporting a language; in such cases, issues should be opened relating to that language.



I recommend the app [Zeta Resource Editor](http://www.zeta-resource-editor.com/index.html) for side-by-side work; though I may also use the multilingual app toolkit.



When submitting a pull request, the author should also make sure to update the CONTRIBUTORS.txt file with their desired display name under the language of contribution if they wish to be included in the app's credits.



## Thanks ##



Thank you, as always, for your efforts. It has been a long time coming :-)



## License ##



**This repo in GitHub and the content within it is under the Apache 2.0 license**. See also the LICENSE.txt file.



All contributions should adhere to the Apache 2.0 license as well; contributors understand that they are not receiving any special rights relating to compensation.



It is fine for other app developers, foursquare-apps, or not, to use these strings as they wish in their app, as long as they respect the 4th & Mayor trademark. 4th & Mayor(TM) is a trademark of Wilcox Digital, LLC.