Difference between revisions of "Translate ICA-AtoM application"

Revision as of 16:55, 1 August 2008

Please note that ICA-AtoM is no longer actively supported by Artefactual Systems.
Visit https://www.accesstomemory.org for information about AtoM, the currently supported version.

This page has been replaced by UM-5 User manual > Translate content / interface.

Difference between revisions of "Translate ICA-AtoM application"

Revision as of 16:55, 1 August 2008

Navigation menu

Search

@@ Line 1: / Line 1: @@
-[[Main Page]] > Translate ICA-AtoM application
+This page has been replaced by [[UM-5|UM-5 User manual > Translate content / interface]].
-== Overview ==
-ICA-AtoM is a multi-lingual application. This page is for project participants preparing the default translations of the application.
-ICA-AtoM release 1.0 beta is expected to support the following languages:
-*Dutch
-*English
-*French
-*Portuguese
-*Spanish
-There are two broad classes of information that need to be translated into all of the supported languages:
-*'''User interface''': User interface elements include field labels, column headers, screen titles, buttons, links and pop-up dialog boxes. These are the generic template elements that structure how the application content is presented on the user interface.
-*'''Default content''': Data that is included by default when the application is installed. This includes things like the default homepage content and picklist values that are stored in taxonomies such as ''level of description'' or ''note types''.
-Users of an ICA-AtoM application will still have the option to modify the default translations to suit their own purposes (as described in [[User manual]] > [[Translate ICA-AtoM]]). The procedures on this page, however, are for the one-time translations that provide the application defaults.
-== Log in as translator ==
-{| border="0" cellpadding="2"
-|- valign="top"
-|width="600" |
-. Access the translator's version of the ICA-AtoM application at http://www.ica-atom.org/translate/
-. Click the <span class="button">LogIn</span> link on the <span class="menu">SystemMenu</span>.
-. Enter your user name and password.
-|width="500" align="right"|
-[[Image:LogIn1.png|500px|thumb|left|Log in]]
-|}
-== Access the internationalization module ==
-{| border="0" cellpadding="2"
-|- valign="top"
-|width="600" |
-ICA-AtoM's <span calss="entity">Internationalization module</span> facilitates the translation process by organizing the elements requiring translation and providing translators with a central place from which to translate them. To access the Internationalization module:
-. Click the <span class="button">Translate</span> tab on the <span class="menu">MainMenuBar</span>.
-. ICA-AtoM opens the Internationalization module, organized by three sub-tabs.
-. <span class="button">UserInterface</span> sub-tab:
-*Provides links to pages in the application that contain all the user interface elements that need translation.
-*Links / pages are organized by module.
-. <span class="button">DefaultContent</span> sub-tab:
-*Provides all default content that needs to be translated.
-. <span class="button">NewContent</span> sub-tab:
-*Not currently operational, included in the current version of ICA-AtoM (v0.6) as a place-holder.
-*Intended to support the management of translation of all new content in an ICA-AtoM application, listing all pages that contain newly added or revised content requiring translation (e.g. new archival descriptions, revised authority records).
-|width="500" align="right"|
-[[Image:AccessI18NModule1.png|500px|thumb|left|Access translate tab]]
-[[Image:AccessI18NModule2.png|500px|thumb|left|Internationalization module]]
-|}
-== Translate user interface ==
-{| border="0" cellpadding="2"
-|- valign="top"
-|width="600" |
-. In the <span class="menu">LanguageMenuBar</span> (top left-hand corner of the screen), select the language into which you are translating. Your selected language will appear underlined. Because you  have translator permissions, the yellow <span class="menu">TranslationBar</span> will appear on the bottom of the screen.
-. Click the <span class="button">Translate > UserInterface</span> sub-tab to open a list of links to pages that contain all the user interface elements requiring translation.
-. Click one of the links. ICA-AtoM routes you to the target page; the <span class="menu">TranslationBar</span> appears along the bottom of the screen.
-. Click the <span class="button">TranslateUserInterface</span> button on the <span class="menu">TranslationBar</span>.
-. ICA-AtoM opens the <span class="menu">TranslationPanel</span> in the lower frame of your screen. The panel is organized into three columns:
-*Column 1 ("Page text") lists all elements for translation; '''all elements shaded with a yellow background have not yet been translated'''; elements with no shading (white background) have already been translated and appear in the list under their translated name.
-*Column 2 ("Source") shows the name of the element in the default source language (English).
-*Column 3 ("Translation") is where you input the translation.
-. Select an element for translation; ICA-AtoM bolds the selected element.
-. Add / edit the translation in column 3.
-. When translation is complete, click or tab out of column 3; the element will now appear in column 1 unshaded.
-. Continue until all elements on the page have been translated.
-. Note that some element names include a number enclosed by percent sign (e.g. "%1%", "%2%"). This is a template "token" indicating a variable whose value is dynamically generated by the context in which the template is displayed. The token must be included in the translation. See below, [[#template tokens | template tokens]], for an enumeration of elements that include tokens and how to handle them.
-. Click the <span class="button">SaveTranslation</span> button; ICA-AtoM closes the <span class="menu">TranslationPanel</span>. All interface elements on the screen will now appear in their translations.
-. Return to the <span class="button">Translate > User interface</span> tab and repeat this process for all templates that are listed as links on this screen.
-|width="500" align="right"|
-[[Image:TranslateInterface1.png|500px|thumb|left|Links organized by module]]
-[[Image:TranslateInterface2.png|500px|thumb|left|Open translation panel]]
-[[Image:TranslateInterface3.png|500px|thumb|left|Translate elements]]
-|}
-=== template tokens ===
-The names of some user interface element include "template tokens".
-*A template token is a variable whose value is determined by dynamically by the context.
-*A template token is represented by a number enclosed in percent signs (e.g. "%1%").
-*Template tokens must be included in the translation, but because different languages have different grammar rules, translators need to be aware of the type of information being handled in any given variable in any given context.
-The following list enumerates in English the elements whose name includes a tokens, the nature of the variable and the context in which it occurs.
-{| border="1" cellpadding="2"
-|- valign="top" align="left"
-!width="150" | Element name
-!width="150" | Variable
-!width="800" | Context
-|-
-| %1% profile
-| User's account name
-| Returns user's account name in the <span class="menu">SystemMenu</span> link; clicked by the user clicks to edit his or her user profile; appears on all screens.
-|-
-| add new %1%
-| Entity type
-| Returns the type of entity being viewed on the current screen (e.g. "archival description", "authority record"); appears as part of text on the <span class="button">AddNew</span> button on <span class="screen">Edit</span> screens.
-|-
-| list all %1%
-| Entity type
-| Returns the type of entity being viewed on the current screen (e.g. "archival description", "authority record"); appears as part of text on the <span class="button">ListAll</span> button on <span class="screen">Edit</span> screens.
-|-
-| edit %1%
-| Entity type
-| Returns the type of entity being viewed on the current screen (e.g. "archival description", "authority record"); appears as part of screen title on <span class="screen">Edit</span> screens.
-|-
-| list %1%
-| Entity type
-| Returns the type of entity being viewed on the current screen (e.g. "archival description", "authority record"); appears as part of screen title on <span class="screen">List</span> screens.
-|-
-| view %1%
-| Entity type
-| Returns the type of entity being viewed on the current screen (e.g. "archival description", "authority record"); appears as part of screen title on <span class="screen">View</span> screens.
-|}
-== Translate default content ==
-{| border="0" cellpadding="2"
-|- valign="top"
-|width="600" |
-"Default content" refers to data that is stored in the database by default so that users can begin using an ICA-AtoM application "out of the box".
-. Click the <span class="button">Translate > DefaultContent</span> sub-tab. This page provides links to all default content that requires translation, organized into three sections.
-*Static pages: pages whose content is always the same (e.g. Home page, About page); these are stored in the <span class="entity">Static page</span> table.
-*Taxonomies: names of controlled vocabularies that generate drop-down value lists throughout the system (e.g. "Levels of description"); these are stored in the <span class="entity">Taxonomy</span> table.
-*Terms: the values that make up the taxonomies (.e.g. in the "Level of description" taxonomy: "Fonds", "Sub-fonds", "Series", "Sub-series", "File", "Item"); these are stored in the <span class="entity">Term</span> table.
-. To translate an element, click its name; it will expand into two columns.
-. The <span class="field">Source content</span> column shows the text in the original source language.
-. Enter the translation in the <span class="field">Translated content</span> column.
-. Click the <span class="button">Save</span> button.
-. ICA-AtoM stores the translated value and collapses the element.
-. Repeat until all elements have been translated.
-. '''Note when translating static pages:''' the same html and css coding used in the original must also be used in the translation; the coding is visible in the <span class="field">Source content</span> column.
-|width="500" align="right"|
-[[Image:TranslateDefaultContent1.png|500px|thumb|left|Select content]]
-[[Image:TranslateDefaultContent2.png|500px|thumb|left|Translate content]]
-|}