How to build guide for a new country

To add new country to generation list please follow next steps:

1. Add country's name from file all_countries.txt to file countries_to_generate.txt
2. Add default image for this country into the folder default_images this image will be used for articles which don't have image (or we dont have image for them). It's name must be <country_name>.jpg.
3. Remove file process_html if exists to update data.

Now you'r ready to build new amazing guides with me!

• run bash build.sh to prepare data for guides and Android obb files.

iOS - add new country

0. Duplicate any existing iOS target and give it a name of new country
1. Delete copy of plist which was created by XCode
2. Some target's proj settings are set to default values and should be fixed/set equal to other targets
3. Set PRODUCT_NAME in target project properties equal to a name of new country
4. Set BUNDLE_ID in target properties to com.guidewithme.newcountry (all lowercase, dots instead of spaces)
5. Set URL_SCHEME in target properties to guidewithme-newcountry (all lowercase)
6. Add all necessary app icons to the corresponding folder
7. Fix "target membership" for icons and for data folder in resources for original target which was duplicated
8. Drag "../builder/wikivoyage/Countries//content/data" folder to the Resources and create folder reference
9. Add new target name to iOS/build.sh to use Jenkins autobuild
10. Create new app/key in Flurry and add it to iOS/offlineguides/Statistics.m file

To build new guide locally from XCode, you should copy guide data generated by builder to iOS/Countries/New_Country folder. In this folder there is content/data folder with *.html files, css, js, images and thumb subfolders

Android notes

IMPORTANT

• Don't forget to edit file android/src/com/guidewithme/expansion/KeyMap.java Please add Google Play public license key at the end of the COUTRY_2_KEY map AND increment KEY_COUNT constant.
• Add icons for every resolution to android/icons/CountryName/

There is one script you need to use to build guides for Android: build-with-android.sh. It places it's result (obb, apk) into countries folder Countries/<country_name>.

Android applications have package name made of lowercased country name and underscores replaced with dotes, added to "com.guidewithme.". For instance: United_States -> com.guidewithme.united.states

United_Kingdom hack

We have package name "com.guidewithme.uk" for it for the sake compatibility with first release. obb and apk files are generated accordingly.