{"id":78871,"date":"2017-08-17T09:40:09","date_gmt":"2017-08-17T09:40:09","guid":{"rendered":"http:\/\/www.esri.com\/arcgis-blog\/products\/product\/uncategorized\/producing-a-story-map-in-multiple-languages\/"},"modified":"2023-11-10T07:41:54","modified_gmt":"2023-11-10T15:41:54","slug":"producing-a-story-map-in-multiple-languages","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/story-maps\/constituent-engagement\/producing-a-story-map-in-multiple-languages","title":{"rendered":"Producing a Story Map in Multiple Languages"},"author":5441,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[37131,37511],"tags":[27871,24861,27501,32471,25261],"industry":[],"product":[36551,36611],"class_list":["post-78871","blog","type-blog","status-publish","format-standard","hentry","category-constituent-engagement","category-sharing-collaboration","tag-story-map-cascade","tag-story-map-journal","tag-story-map-series","tag-story-map-shortlist","tag-story-map-tour","product-arcgis-online","product-story-maps"],"acf":{"short_description":"Learn how to translate a story map into multiple languages and present the translated story to readers.","flexible_content":[{"acf_fc_layout":"sidebar","content":"

Note<\/strong>: This article specifically references the classic Esri Story Maps templates, which are now deprecated; however, many of the concepts and ideas are applicable to writing stories using the new ArcGIS StoryMaps<\/a>. Story authors are encouraged to use ArcGIS StoryMaps for new storytelling projects.<\/em><\/p>\n

For the most up to date information about telling stories in multiple languages, see Bilingual storytelling with ArcGIS StoryMaps (esri.com)<\/a>.<\/em><\/p>\n","image_reference":false,"layout":"standard","image_reference_figure":"","snippet":"","spotlight_name":"","section_title":"","position":"Center","spotlight_image":false},{"acf_fc_layout":"content","content":"

 <\/p>\n

Authors sometimes need to publish a story map in more than one language to effectively reach everyone in their intended audience. For example, employees of governments with two official languages may be required to publish content in both languages. Below is a Map Tour created by the National Capital Commission in Ottawa (available in English<\/a>\u00a0and\u00a0French<\/a>). Readers can click the link in the top right to load the story in the other language.<\/p>\n

\"\"<\/a><\/p>\n

In some cases, the topic of a story may suggest that it should be made available in multiple languages, such as this story by Esri’s Story Maps Team about the restoration of Havana, Cuba (available in\u00a0English<\/a>\u00a0and Spanish<\/a>). In this case, there is a blue button on the cover that readers can use to read the story in the other language.<\/p>\n

\"\"<\/a><\/p>\n

Now that you’ve seen a few examples, read on to learn how to go about translating a story map into multiple languages and how to present the translated story to readers…<\/em><\/p>\n

***<\/span><\/p>\n

The Basics of Translating a Story Map<\/h2>\n

Hold on, can’t readers just use a browser translation tool to read my story in their native language?<\/strong><\/p>\n

Yes, readers can use browser plug-ins like\u00a0Google Translate<\/a>\u00a0to read a story in their native language; however, while translation tools are good, they have limitations. With an automated translation, portions of a story may not come across as the author intended. Browser translation tools also won\u2019t translate text in maps, images, charts, or infographics, and if a story contains audio or video with spoken narration or video with text elements those cannot be automatically translated either.<\/p>\n

It’s usually best to create translated versions of a story in specific languages so you control the translation quality for all aspects of the story.<\/p>\n

How do I translate a story into another language?<\/strong><\/p>\n

Once you decide what alternate language(s) you need to reach your intended audience, follow these instructions:<\/p>\n

    \n
  1. Translate the text of the story. In addition to the main narrative, you’ll also need to translate the story title and subtitle, section titles\/headings, captions, bookmarks, and header links.<\/li>\n
  2. Create alternate, translated versions of all media elements from the original story.\u00a0For infographics or charts, be sure to translate any labels or text. For maps, be sure to consider translating labels and pop-up content. Here’s\u00a0a story from Staridas Geography<\/a>\u00a0that’s available in\u00a0English<\/a>\u00a0and\u00a0Greek<\/a>\u00a0that uses different label layers for each language (see screenshots below).<\/li>\n
  3. Use the translated text and alternate media elements from steps 1 and 2 to create a version of your story for each additional language.\u00a0You can either: A) create a new story and build it from scratch, or B) use a tool like the\u00a0ArcGIS Online Assistant<\/a>\u00a0to copy the original story and replace the text and media in the copy with the corresponding translated versions.<\/li>\n
  4. Finally, you can optionally link the translated versions of your story so it’s easy for readers to switch languages. Several ideas and examples of how to do this are in the next section.<\/li>\n<\/ol>\n

    Pro Tip!<\/strong>\u00a0Use vector basemaps in your story maps so you can change the language of the basemap labels (available in select areas). See\u00a0here<\/a>\u00a0and\u00a0here<\/a>\u00a0for details.<\/p><\/blockquote>\n

    \"\"\"\"<\/a>
    \n***<\/span><\/p>\n

    Presenting Translated Stories<\/h2>\n

    There are several ways to present translated stories together so that readers can easily switch between them. The first three methods described below can be done in the story map builder while the last two require hosting your own web page or a developer to customize the app code.<\/p>\n

    Use the header link or logo (builder)<\/strong><\/p>\n

    The easiest way to link the translated versions of a story is to use the tagline<\/em> or\u00a0header link<\/em>. The header link usually shows “A Story Map” and links to the Esri Story Maps website<\/a>, but the text and link are configurable. In each version of the story you’d enter the language of the other translation as the tagline and then enter the link to the other story.<\/p>\n

    For example, let’s say you have a story that you created using the Story Map Journal app and wrote in English. Then you created another Map Journal for the French translation. For the English version of the story you’d open the Map Journal builder and go to Settings > Header<\/strong> and change the tagline<\/strong> to “French” and the link<\/strong> to the URL of the French story. Then you’d do the same thing in the French version of the story to point the header link to the English version.<\/p>\n

    \"\"<\/p>\n

    This works well if your story is available in two languages. The\u00a0Map Tour about Ottawa<\/a>\u00a0mentioned at the beginning of this blog post is a example of this technique.<\/p>\n

    You can also use the logo<\/em> to link between translated stories. The Cruel Reality<\/a> is an example of a story that’s available in English and Polish and flags are used to indicate that a translation is available. Clicking the flag loads the story in the other language.<\/p>\n

    \"\"<\/a><\/p>\n

    Add links within the story narrative (builder)<\/strong><\/p>\n

    Another way to link to translated versions of a story is to add links to the first section of your story. This works well if your story is available in more than two languages. For example,\u00a0this Cascade story<\/a>\u00a0by the Australian Government about the data used in the search for missing Malaysian Airlines flight MH380 can be read in English, Malay, and Chinese.<\/p>\n

    \"\"<\/a><\/p>\n

    Provide original and translated text in a single story (builder)<\/strong><\/p>\n

    Another option is to add text from each language to the same story. We noticed this technique in\u00a0a Cascade story<\/a> from Listen to the Amazon\u00a0and think it can work well\u00a0if the amount of narrative text is small; that is, if you don’t have many long paragraphs of text.<\/p>\n

    Simply present translated text alongside the original text. To make sure readers can easily differentiate the text consider formatting (such as italic or color) to distinguish text in each language. Be sure to include translations for titles, bookmarks, and credit text. For titles, you can use a dash (-) or pipe (|) to separate text in each language. Be sure to keep all text short when using this technique — especially titles, which have limited space and must accommodate text for each language.\u00a0Also, consider using numbered bookmarks to avoid having to include translated bookmark labels in the header.<\/p>\n

    \"\"<\/a><\/p>\n

    Add the story maps to a web page on your organization’s website (custom)<\/strong><\/p>\n

    You can also add translated story maps to a page on your organization’s web site. Here’s an example of this from The Nature Conservancy for their Map Journal story about the\u00a0Ogoou\u00e9 River in Gabon<\/a>.<\/p>\n

    \"\"<\/a><\/p>\n

    Add a button on the cover to switch languages (custom)<\/strong><\/p>\n

    Because Esri’s Story Map apps<\/a> are open source, you can download the code from GitHub<\/a> and modify it to create a custom language switcher, like the button on the cover of the Havana story mentioned above. If you want to know how to add a language switch button to a Cascade story and get the sample code, see this article<\/a> on our Story Map Developers’ Corner blog.<\/p>\n

    \"\"<\/p>\n

    Bonus tips!<\/h2>\n

    Translate the user interface text<\/strong><\/span><\/p>\n

    After doing the work to translate your story narrative, you should also make sure the user interface text of the story map app is translated. This includes components like the “Explore Map” button in Cascade and\u00a0the Share dialog.<\/p>\n

    When linking to your story, for example from the header link, include the\u00a0locale<\/code><\/strong>\u00a0URL parameter at the end of the link so the text of the story map app’s user interface also appears in the same language as your story.\u00a0See\u00a0this blog post<\/a>\u00a0for more information about this technique.<\/p>\n

    \"\"<\/p>\n

    Can I use story map builders in other languages?<\/strong><\/p>\n

    Yes! If your web browser language is set, then you will already see story map builders in your native language (as long it is\u00a0supported by ArcGIS Online<\/a>). If you don’t see the builder user interface in your language, you can make a story map builder display a different language by using the\u00a0locale<\/code><\/strong>\u00a0URL parameter and a 2-letter\u00a0ISO language code<\/a>.<\/p>\n

    To use the Cascade builder in French, for example, append\u00a0locale=fr<\/code><\/strong>\u00a0to the URL like this:<\/p>\n

    https:\/\/www.arcgis.com\/apps\/Cascade\/index.html?appid=ABC123&edit&locale=fr<\/code><\/p>\n

    <\/code>
    \n\"\"
    \nYou can choose to write a story in any language regardless of which language is used in the builder.<\/p>\n

    More Information and Examples<\/h2>\n

    See also these blogs on creating apps in multiple languages:<\/p>\n