Multilingualism tutorial : rubedo cms

August 2013

Multilingual websites

Version 1.3

Rubedo & multilingual websites

CONTENTS

I. Introduction

II. Concepts & Terminology

III. Translating a website

INTRODUCTION

� Since version 1.3, Rubedo can handle multilingual websites

� The following elements can be translated:

– Websites (title, description, keywords)

– Taxonomy

– Content types and media types

– Contents and assets

– Pages (title, URL, description, keywords…), block titles, some block contents

– Workspaces

� The main objectives of this tutorial are the following:

– Clarify some concepts of multilingualism (interface language, working language, active languages…)

– Show how to translate different elements of a website


INTRODUCTION

� The following slides explain some concepts of multiligualism :

– Default language

– User interface language

– Activation of new languages

– Working language

– Localization strategy (available languages and content display strategy) for eachwebsite

– Website translation tutorial


CONCEPTS & TERMINOLOGY

� Default language

– During install, a default language must be set.

– Other languages can be activated later from the back-office.

– If you are upgrading from an older version of Rubedo (v1.2.2 or older), already created contents will be flagged with this language.



� Rubedo user interface language (back-office and front-Office administration) – Rubedo user interface language is a user setting. It is the language in which the interface of

Rubedo is displayed for each user (application titles in back-office, action bar, display language of the top action bar in front-office, …)

Rubedo user interface (back-office)in english

Rubedo user interface(back-office)

in french



� Rubedo user interface language (back-office and front-Office administration)

– Each user can change their own Rubedo user interface language in the « Settings » application

– N.B. : in order for the new language to be taken into account, you must refreshthe back-office page in your browser (F5)

Rubedo user interface languagefor current user



� Active languages– Other languages than the one set during install can be activated in Rubedo thanks to the

« Languages » application (in « Administration » menu)

« Languages » application



� Language activation

– A language can be activated by clicking on the checkbox on the appropriaterow

� You can also specify:

– The flag corresponding to this language

– The native name (it will be displayed in the pulldown language menu in front-office)

� N.B. : « Languages » application is the same for all websites managed by the Rubedo instance



� Working language

– The working language is the language in which the logged-in user will createnew contents, new pages, …

– The working language is specific to each user. It is not necessarily the same as the Rubedo user interface language: a contributor can choose to display the interface in english, but create contents in spanish.

– If only one language is active, then the working language is obviously this one.

– If several languages are active, the worling language can be specified by eachuser thanks to a pulldown menu at the bottom right of the back-office user interface, next to the search field.



� « Sites » application is used to specify different parameters for multilingual websites:

– Default language: Default language in which the website will bedisplayed.

– Languages:List of languages in which the website will betranslated.

– Localisation strategy:→ Either « Only one » : only the elements (pages, contents, assets…) that are translated in the current language of the website are displayed.→ Or « With fallback » : if a content is not translated in the current language of the website, itis still displayed in the default language.

– Use browser language: If this checkbox is checked, then when a new visitor arrives on the website, pages will bedisplayed in the first place in the browser language.


TRANSLATING A WEBSITE

� Translation of a website

Click on« Add translation »



Choose the language in whichthe website parameters will betranslated





Fill in website parameters (default title, description, author, keywords) in the new language

Save


� Translation of taxonomy


For a given vocabulary, click on « Add translation »




Choose the language in which the vocabulary will be translated




Fill in vocabulary parameters (name, description, help text) in the new languageand Save




For each of the terms, double-click on the field of the correspondingto the new language to translate this term,

then Save.



� Translation of a content type

For a given content type, in the « Properties » tab, click on « Add translation »




Choose the language in which the content type will be translated




Fill in the name of the content type in the new language




For each field on a content type (« Edit » tab), label and tooltip can also betranslated: click on the flag next to the field, choose a different language

and fill in the translation in the field



� Translation of a content

On a content, click on « Add translation »




Choose the language in which the content will be translated




Translate the content in the new language and Publish (ou Submit / Draft)

In the content list, flags let you know in which languagescontents have been translated



� Translation of a media type

For a given media type, in the « Properties » tab, click on « Add translation »




Choose the language in which the media type will be translated




Fill in the name of the media type in the new language




For each field on a media type (« Edit » tab), label and tooltip can also betranslated: click on the flag next to the field, choose a different language

and fill in the translation in the field



� Translation of a media

On an asset, click on « Add translation »




Choose the language in which the asset will be translated




Translate the title and alternative text in the new language and Save

In the DAM (details mode), flags let you knowin which languages assetshave been translated



� Translation of a page

On a page, in the « Properties » tab, click on « Add translation »




Choose the language in which the page will be translated




Translate the parameters of the page (name, URL, title, description, keywords) in the new language and Save

In the page list, flags let you know in which languagespages have been translated



� Translation of block titles on a page

On a page, each block title can be translated : click on the flag next to the field,choose a different language and enter the title in the new language



� Translation of some contents in a block

For blocks involving textual information, these contents can be translated: click on « Add translation », choose a language and enter the text in the new language



� Translation of a workspace

For a given workspace, click on « Add translation »




Choose the language in which the workspace will be translated




Translate the name of the workspace in the new language and Save



� « Language menu » block– The « Language menu » block (can be added,

like any block, on a page or a page mask) allowsa visitor to choose the language in which the website is displayed from a pulldown menu

– Languages displayed in the menu are the onesthat have been selected for the current website

Default layout of the « Language menu » block Parameters of the

« Language menu » block



� Front-office contribution– When creating or modifying a content in front-office, contribution is always done in the

current language of the website (whether « inline » editing or full edit mode)

– In the case of a website with a fallback localisation strategy, editing a content which is not yet translated in the current language allows to create a translation of the content in thislanguage

• For example: a website is displayed both in english and in french, english being the default language, and with a fallback localisation strategy. If I want to see this website in french, a content which is not yet translated in french will anyway be displayed (but in english). If I modify thiscontent in the front-office, a french translation will be created.

Next to the content title, a flag reminds you of the language in which you are editing this content


Thanks!

See also:

http://rubedo-project.org @Rubedo_project

Facebookhttp://www.webtales.fr

Date post:	19-May-2015
Category:	Technology
Upload:	rubedo
View:	3,542 times
Download:	5 times

Multilingualism tutorial : rubedo cms

Technology