# Refugee Phrasebook
## Print versions

The printable versions of the phrasebook are organized according to the regions where refugees arrive. Further versions can be added as needed.
please update versions regularly with the progress in the Gdocs, see below

### Phrasebooks for Helpers

A separate booklet with only phrases for helpers
Phrases for Helpers - Germany (2015-09-28) - German, English, Kurdish, Bo/Cro/Ser, Bangla + phonetics, Farsi + phonetic, Arabic + phonetics
* PDF: http://www.refugeephrasebook.de/pdf/helpersDE150928.pdf (portrait, 4 pages)
Phrases for Helpers - Greece (2015-09-15)

#### ARABIC ENGLISH BILINGUAL VISUAL DICTIONARY

* USEFUL RESOURCE FOR HELPERS AND HEALTHCARE PERSONNEL (PDF) https://taitho.com/PDF/arabic-english-bilingual-visual-dictionary.pdf

### Short Version

Contains minimal vocabulary; print ranges: 7 to 50 pages

#### Austria, Germany, Switzerland, Sweden

2015-10-26 German - Swedish - Arabic - Serbian - Farsi - Albanian - Kurdish - Romanian - Russian - English
* PDF: http://www.refugeephrasebook.de/pdf/de-kiel151026-a4.pdf (CC-BY-SA by Kunsthochschule Muthesius Kiel; landscape, A4)
* PDF: http://www.refugeephrasebook.de/pdf/de-kiel151026-a5.pdf (CC-BY-SA by Kunsthochschule Muthesius Kiel; portrait, A5)
2015-09-20: Austria/Germany/Switzerland: German, English, French, Bos/Cro/Ser, Kurdish, Turkish, Bangla, Urdu, Farsi, Arabic
* PDF: http://www.refugeephrasebook.de/pdf/germany150920.pdf (portrait, 50 pages)
* Two versions included:
** German, English, Bangla, Urdu, Farsi/Dari, Arabic (with phonetics)
** German, English, Turkish, Kurdish, Bos/Cro/Ser, French, Arabic (with phonetics)
Austria/Germany/Switzerland: German, English, Bos/Cro/Ser, Albanian, Arabic
* PDF: http://www.refugeephrasebook.de/pdf/germany150920b.pdf (portrait, 24 pages)
* Requested by the Notunterkunft in der Sporthalle Wichertstraße
2015-09-12:
Welcome to Austria, Germany, Switzerland
* PDF with translation data from 2015-09-12, portrait, 12 pages
* PDF with translation data from 2015-09-12, portrait, 12 pages
* ePub with translation data from 2015-09-12, 465K (server is down at the moment)

#### Balkans (Bos/Cro/Ser, Hungary, Macedonia, Slovenia)

* Bos/Cro/Ser; Slovenia: Arabic, Farsi, Bos/Cro, Slovenian, German, English (2015-09-16)
** http://www.refugeephrasebook.de/pdf/balkans-slov150916.pdf (portrait, 22 pages)
** http://www.refugeephrasebook.de/pdf/balkans-slov150916-ls.pdf (landscape, 11 pages (redable?))
* Bos/Cro/Ser; Hungary: Arabic (Fusha), Farsi, Bos/Cro/Ser, Hungarian, German, English (2015-09-13)
** http://www.refugeephrasebook.de/pdf/balkans-hu150913-ls.pdf (landscape, 7 pages)
** http://www.refugeephrasebook.de/pdf/balkans-hu150913.pdf (portrait, 14 pages)
* Bos/Cro/Ser; Albania; Macedonia: Arabic (Fusha), Farsi, Bos/Cro/Ser, Macedonian, Albanian, English (2015-09-13)
** http://www.refugeephrasebook.de/pdf/balkans-mac150913-ls.pdf (landscape, 10 pages)
** http://www.refugeephrasebook.de/pdf/balkans-mac150913.pdf (portrait, 20 pages)

#### Greece + Balkans

Greece April 2016-04-05: general orientation, juridical, links Standard Arabic +phonetics / English / [ فارسی. ] Farsi / Greek alphabet + phonetics / Kurdish (Kurmancî) / Urdu)
** http://refugeephrasebook.de/pdf/greece-160405.pdf (portrait , 12 pages)
** source: http://refugeephrasebook.de/pdf/greece-160405.odt (created with Libreoffice)
Greece March 2016-03-22 (more icons + Standard Arabic +phonetics / English / [ فارسی. ] Farsi / Greek alphabet + phonetics / Kurdish (Kurmancî) / Urdu + links
** http://refugeephrasebook.de/pdf/greece-150322-ls.pdf (landscape, 6 pages)
** http://refugeephrasebook.de/pdf/greece-150322.pdf (portrait , 12 pages)
** source: http://refugeephrasebook.de/pdf/greece-150322.odt (created with Libreoffice)
* Greece March 2016-03-19 (more icons + Standard Arabic / English / [ فارسی. ] Farsi / Greek phonetic Greek alphabet Kurdish (Kurmancî) Urdu)
** http://www.refugeephrasebook.de/pdf/greece160319.pdf [pdf, portrait, 10 pages]
* Greece March 2016-03-19b (more icons + Standard Arabic / English / [ فارسی. ] Farsi / Greek phonetic Greek alphabet Kurdish (Kurmancî) Urdu)
** http://www.refugeephrasebook.de/pdf/greece160319-b.pdf [pdf, landscape, 5 pages]
* Greece March 2016-a (Standard Arabic English [ فارسی. ] Farsi Greek phonetic Greek alphabet Kurdish (Kurmancî) Urdu)
** http://www.refugeephrasebook.de/pdf/rpbGreece1603a.pdf [pdf, 9 pages]
* Greece March 2016-b (Sorani (Kurdi), Kurmanji (Kurdi), French, Greek, English)
** http://www.refugeephrasebook.de/pdf/rpbGreece1603b.pdf [pdf, 7 pages]
* Greece March 2016-c (Arabic / Farsi / Urdu / Greek alphabet / Greek phonetic / English)
** http://www.refugeephrasebook.de/pdf/rpbGreece1603c.pdf [pdf, 7 pages]
* PC Greece Version Arabic, Urdu, Farsi, Greek, Bangla, Kurdish, French, Language of FYROM, English (2015-09-29)
** http://www.refugeephrasebook.de/pdf/greece150929.pdf (portrait, 40 pages)
* KOS Version Arabic, Urdu, Farsi, Greek, Bangla, Kurdish, French, Macedonian, English (Kos) (2015-09-17, with area map)
** http://www.refugeephrasebook.de/pdf/greece150917.pdf (portrait, 40 pages)

#### Italy

* TIR-EN-IT-FR-ARB (15.11.2015)
** long version: http://refugeephrasebook.de/pdf/italy-long1511.pdf
** short version: http://refugeephrasebook.de/pdf/italy-short1511.pdf
** medical phrases: http://refugeephrasebook.de/pdf/italy-medical1511.pdf
** phrases for helpers: http://refugeephrasebook.de/pdf/helpers-italy1511.pdf
* Arabic - Arabic phonetics - English - French - Tigrinya - Tigrinya phonetic - Italian (16.10.2015)
** http://www.refugeephrasebook.de/pdf/italy151016-ls.pdf (landscape, 27 pages)

#### Netherlands, Belgium

* Welcome to the Netherlands, Belgium Basic orientation (Short version), Phrases for Helpers, Health, Law
* http://publicationstation.wdka.hro.nl/phrasebook/RPB-basic-Benelux.pdf (portrait, 12 pages, to be double-side printed and folded)

## Online version

http://refugee-phrasebook.github.io
Target languages: German, English, Greek, Hungarian
Select the language you want to translate from and print right away

## About the Phrasebook

* The Refugee Phrasebook is a multilingual tool aiming to empower refugees who just arrived in Europe by providing basic useful vocabulary. The project was realised with the precious contribution, support and expertise of many contributors and translators worldwide.
* Audience: Refugees in Europe. The phrasebook can be easily modified for other areas and languages.
* Description: This open phrasebook provides lists of helpful vocabulary for refugees. Each main chapters of the book targets a specific area. This areas language is included in every subchapter, with further translations.
* Goals: Provide vocabulary for basic orientation in everyday life, including topics of law and health
* WikiBooks Facilitation: MNeuschaefer, Hannah Davis and Castroblob
* Website: http://www.refugeephrasebook.de/

## Help

if you need help or want help, check this out: providing_help

## How to create new versions
### The Sources

The book is based on the following Google Docs:
* Refugee Phrasebook (Gdoc)
* Medical Phrasebook (Gdoc)
* Juridical Phrasebook (Gdoc)
* Autonym and Testpatterns (Gdoc)
* Waste management (Gdoc - under construction)
* Various phrases for refugee homes (Gdoc)
Please check the Google Doc versions regularly for updates. Important:Do not change any phrases in the wikibooks, only comment on the Gdoc version

### With wikibooks
#### Set up a new chapter

* Choose a region where the phrasebook will be distributed
* Go to "New versions" on the main wikibooks page (https://en.wikibooks.org/wiki/Refugee_Phrasebook#New_versions_.28in_progress.29)
* click "Edit" next to the "New Versions" Header
* insert your chapter name at the top, like this:
* click on this chapter

#### Insert template

* In your new chapter, insert all the content from the chapter template:
* write a summary and save

#### Clean up the Gdoc sheets

* Open one of these Google Docs on the main page http://www.refugeephrasebook.de
* select the appropriate sheet (e.g. "Short version" or "Phrases for helpers")
* In the Gdoc, choose "Make a copy" to copy the contents of the translations into a new sheet
** Structure the cells
*** "Select all" (click on upper left corner of table)
*** choose "unmerge cells", the icon is in the middle and looks like two cells merging
*** choose View --> unfreeze rows and View --> unfreeze columns
*** use standardized names, e.g. "Arabic / Syrian", "English" etc
** Remove all line breaks
*** select Edit --> Find all
*** Mark "Regular Expressions"
*** search for the following string:
*** replace this string with " / " (space slash space) to transform linebreaks (-> replace all)
* Arrange the languages in the desired order
* Rename the language column headers
* Select the columns you need

#### Convert Gdoc content

* Go to the gdoc copy that you already cleaned up
* Select the necessary lines
* Copy the content from the selected gdoc columns and convert with http://excel2wiki.net/ or a similar converter
* copy the necessary lines, e.g.
* check and adjust the name of the headers
! (language1) !! (language2) !! (language3) !! (Language4) !! (language5) !! (language6)
* write a summary in the save dialog (e.g. "inserted health content", save
* da capo al fine

#### Print Wikibook

* check that your wikibook is correct
* Open the page with a modern browser like google chrome (recommended)
* print from your browser
* save as pdf (mac) or print to pdf with third party software (PC)
* include the link on the main page (under "new versions")
Congratulations, you converted a wikibook! Please let us know at info@refugeephrasebook that a new version exists. Thanks!

### Automatic conversion
#### LibreOffice and wiki-publisher

note: this method is not working for anyone so far, please stick to the manual method for the time being
* Install LibreOffice and the wiki-publisher plugin.
* Download the Gdoc as opendocument (odt/ods).
* Export to MediaWiki format.

#### Automatic export to PDF
##### refugeePhrasebookCreator

A bash script to automagically create pdf version is available from https://github.com/sgelb/refugeePhrasebookCreator.
Some features:
* Built-in configurations for phrasebooks available on http://www.refugeephrasebook.de:
** Basic conversation for refugees
** Basic conversation for helpers
** Basic conversation, short version
** Medical phrasebook
** Juridical phrasebook
* Configuration system to add more phrasebooks from GoogleDocs
* Template file for simple changing of output
* Automatic calculation of landscape or portrait format
* Automatic detection of Arabic, Bengal, Cyrillic, ge'ez, greek and latin writing systems. More will come.
* Fonts included, no installation necessary
Runs on Linux and Windows. OS X is untested, but should be possible. It is under active development. Feedback, feature requests and bug reports are welcome.
(Disclaimer: this entry was written by the developer)

##### bash-scripts-for-pdf-generation

note: this method is under development but might be helpful for some people
technical-natives (knowledge of TeX, XeTeX, bash-scripts, ...) are are welcome to volunteer their brains and ideas
Please visit the github-site, you are welcome to give feedback on current issues
current version-Download as ZIP
please be aware - this is just a snapshot - redownload to get updates ...
the .md files in the doc-directory are actually text-files :)
next steps will be: users should be able to
* open a site
* ...select some stuff...
* get a pdf for printing

### With design software (Indesign / Scribus /...)
#### conversion with pandoc (experimental)

To easily create a beautiful print version with professional design software, we recommend you create a wikibooks version first (see below). This way there is also an online version of the book to link to. Based on the wikibooks version, conversion is easy:
* click on "printable version" on the side menu in wikibooks
* save the page as HTML with your browser (file -> save)
* have [Pandoc] installed
* open terminal
* convert HTML to ICML using this command:
* place icml file in template
Note: Non-western scripts are often rendered unreadable after being processed with this method. Please consult with a native speaker before printing.

## Revise newly create versions

Checking the integrity of a RPB new version is an essential step. Do not skip it. The following subsections describe some of the often encountered problems have appeared in print versions. Check if your version suffers from any of them.

### Broken Arabic scripts

Arabic script can be displayed erroneously.
If "hello" does not look like the green one, conversion most likely went wrong.
The sentence in green is correct. the sentence in the left lower corner is: in the wrong order and the letters are not connected the sentence on the right lower corner: the letters are not connected (but the order is correct)
Native speakers might be able to decipher it but it takes more concentration I hear, so it should be avoided.
This issue is known to arise when pasting Arabic to Adobe inDesign. To paste Arabic correctly see How to paste Arabic

### Correct translations

Check with translators before you print, e.g. Khaled Barakeh (on Facebook ) or the Translators team FB group

### Testpatterns and fonts

Here you can find information on testpatterns and fonts you want to use when typesetting languages you do not know: Typographic-Testpatterns

## Chapter Template

Template <- use this as a template for new chapters

## Resources
### Refugee centers

* Netherlands gdoc
Please help complete

### Titles, Maps & Pictograms

* List of Pictograms for Refugee Phrasebook
* List of Maps for Refugee Phrasebook
Translation of pictograms' captions and chapter titles in gdoc sheetPlease help complete

## New versions (in progress)

* Workshop Test Chapter 01
* Workshop Test Chapter 02
* Workshop Test Chapter 03
* Workshop Test Chapter 04a - CG
* Workshop Test Chapter 04b - AR
Insert your new versions here. After the editors checked them, we add them to the section on top.
* /Short Version - German-English-Russian-Romanian
* Phrases for Helpers - Italy
* Medical Phrases - Italy
* Welcome to Italy (short)
* Welcome to Italy (long)
* Welcome to Lithuania
* Welcome to the Nordic Countries (longer)
* Welcome to Greece (longer)
* /Test

#### Nordic Countries (Norway, Sweden, Denmark, Finland, and Iceland)

(in progress)
* Welcome to the Nordic Countries (longer)
Want to test conversion methods? You can experiment in this chapter:
* sandbox

## Older / outdated versions

* Greece Version Arabic, Urdu, Farsi, Greek, Bangla, Kurdish, French, Macedonian, English (2015-09-18)
** http://www.refugeephrasebook.de/pdf/greece150918.pdf (portrait, 40 pages)
* Greek, French, Arabic, Dari/Farsi, Kurdish (Kurmanji), Urdu, Bangla, Bos/Cro/Ser, Macedonian, Hungarian, English (2015-09-14)
** http://www.refugeephrasebook.de/pdf/greece+balkans150914.pdf (portrait, 17 pages)
2015-09-12 - 2015-09-14
* Arabic (Fusha), Dari, Albanian, Bos/Cro/Ser, Hungarian (2015-09-13)
** https://commons.wikimedia.org/wiki/File:Balkans-hu150912.pdf (pdf portrait, 14 pages)
* Arabic (Fusha), Dari, Albanian, Bos/Cro/Ser, Macedonian (2015-09-13)
* Arabic/Syrian, Dari, Albanian, Bos/Cro/Ser, Macedonian (2015-09-12)
** http://www.refugeephrasebook.de/pdf/balkans-ma150912-ls.pdf (pdf landscape, 8 pages)
** http://www.refugeephrasebook.de/pdf/balkans-ma150912.pdf (pdf portrait, 16 pages)
2015-09-07 Welcome to Macedonia, Serbia, Croatia (shorter; Arabic, English, BCS, Macedonian, Farsi)
2015-09-10 Welcome to Hungary, Bosnia, Croatia (shorter)
2015-09-10 Welcome to Serbia and Hungary
* PDF: http://www.refugeephrasebook.de/pdf/RP20150910-ar-far-bos,cro,ser-hun-en-de.pdf
2015-09-10 Welcome to Hungary, Bosnia, Croatia (Dari) (includes Dari)
2015-09-12 Arabic/Syrian, Farsi, Albanian, Bos/Cro/Ser, Hungarian Arabic/Syrian, Farsi, Albanian, Bos/Cro/Ser, Hungarian
2015-09-12 Welcome to Macedonia, Bosnia, Croatia
* (includes Syrian/Arabic, Farsi, Pashto / Albanian, Macedonian, Bosnian / Croatian / Serbian, German / French / English (Short Version))
2015-09-12 Arabic/Syrian, Farsi, Albanian, Bos/Cro/Ser, Hungarian
* http://www.refugeephrasebook.de/pdf/balkans-hu150912-ls.pdf (pdf landscape, 7 pages)
* http://www.refugeephrasebook.de/pdf/balkans-hu150912.pdf (pdf portrait, 14 pages)
2015-09-13 Fusha, Farsi, Albanian, Bos/Cro/Ser, Hungarian (includes Fusha Arabic instead of the Syrian dialect)
2015-09-20 Welcome to Austria, Germany, Switzerland: Arabic, Farsi, Bangla, Urdu, Turkish, Kurdish, Bos/Cro/Ser, French, English, German

## documentation

technical documentation (for references) can be found here- documentation-overview