tr8n 3.0.5 → 3.1.1

data/app/views/tr8n/help/advanced_tools.html.erb

@@ -0,0 +1,13 @@
+<%= render :partial => "header" %>
+
+<div class="documentation_section_title">
+  <%= tr("Advanced Tools") %>
+</div>
+
+<div class="documentation_section">
+	<p>
+    Click Translation Tools from the Language Selector to access the complete suite of translation tools, including bulk translation tools, awards, and discussions.  
+  </p>
+</div>
+
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/awards.html.erb

@@ -1,13 +1,13 @@
-<%= render :partial => "/tr8n/help/navigation" %>
+<%= render :partial => "header" %>
 
-<div id="tr8n_help_content">
-  
-  <h1><%= @page_title %></h1>
+<div class="documentation_section_title">
+  <%= tr("Awards") %>
+</div>
 
-  <p>
-    The Leaders Score Board for each language lists the users with the best translations. You can rise in the rankings by adding translations that other users vote up. Click the Awards for All Languages link to see how you stack up against Geni users translating other languages!
+<div class="documentation_section">
+	<p>
+    The Leaders Score Board for each language lists the users with the best translations. You can rise in the rankings by adding translations that other users vote up. Click the Awards for All Languages link to see how you stack up against Geni users translating other languages!      
   </p>
-
 </div>
 
-<%= render :partial => "/tr8n/common/footer" %>
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/creating_translations.html.erb

@@ -1,16 +1,26 @@
-<%= render :partial => "/tr8n/help/navigation" %>
+<%= render :partial => "header" %>
 
-<div id="tr8n_help_content">
-  
-  <h1><%= @page_title %></h1>
+<div class="documentation_section_title">
+  <%= tr("Creating Translations") %>
+</div>
 
-  <p>
-    Translations that have a high enough rank are considered accepted. The accepted translation with the highest rank replaces the English phrase for that language.
+<div class="documentation_section">
+	<p>
+    <%=tr("Translations that have a high enough rank are considered accepted.")%>
+		<%=tr("The accepted translation with the highest rank replaces the English phrase for that language.")%> 
   </p>
+	
   <p>
-    When a phrase is correctly translated, it can be locked by a language manager. Locked phrases are removed from the list of translatable phrases. Users can no longer be able to submit new translations for the phrase or vote on existing translations. The currently accepted translation with the most votes is the translation used until the phrase is unlocked again.
+   <%=tr("When a phrase is correctly translated, it can be locked by a language manager.")%>  
+	 <%=tr("Locked phrases are removed from the list of translatable phrases.")%>
+	 <%=tr("Users can no longer be able to submit new translations for the phrase or vote on existing translations.") %>
+	 <%=tr("The currently accepted translation with the most votes is the translation used until the phrase is unlocked again.")%>	
   </p>
-
+	
+	<h2><%=tr("Translation Context Rules")%></h2>
+	<p>Translations for some phrases can depend on the gender of the user viewing the translation and the gender or numerical value of tokens in the phrase. For example, in some languages "Invite Family & Friends to View Your Tree" has two different translations, one if the viewer is male and one if they are female. Tokens are parts of the phrase that are not translated, such as a profile name or a number. The translation for "{actor} tagged {target} in {count} photos" can depend on the gender of the actor and target as well as the number of photos. Tokens themselves are not translated. Geni will automatically replace them with the actual value. </p>
+	<p>If the translation of the phrase depends on any of these factors, click the generate context rules for this phrase link. Select the gender or number for each token that the translation depends on and click the "Continue... " button. This will show you a list of all possible contexts so you can provide an appropriate translation for each. </p>
+  
 </div>
 
-<%= render :partial => "/tr8n/common/footer" %>
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/dashboard.html.erb

@@ -1,13 +1,40 @@
-<%= render :partial => "/tr8n/help/navigation" %>
+<%= render :partial => "header" %>
 
-<div id="tr8n_help_content">
-  
-  <h1><%= @page_title %></h1>
+<div class="documentation_section_title">
+  <%= tr("Dashboard") %>
+</div>
 
-  <p>
-    Your dashboard provides an overview of all of your languages and your translation activity.
+<div class="documentation_section">
+	<p>
+    Your dashboard provides an overview of all of your languages and your translation activity.   
   </p>
+	
+	<h2>Your Dashboard</h2>
+	<p>Your dashboard focuses on your rankings, translations, and other activity. Your overall rank is based on the percentage of your translations in all languages that have received positive votes. There are three states for each translation you've provided: accepted, pending, and rejected. Accepted means that its rank has meet the necessary threshold to be accepted. Pending means that the translation has not been accepted or rejected. Rejected translations have been voted down by users or reported. </p>
+  <p>Note that only the translation with the highest overall rank for that phrase will be used. This means that you can have a translation accepted but not used on the site.</p>	
+	
+	<h2>Language Dashboard</h2>
+	<p>After your dashboard, you'll have a dashboard for each of the languages you are translating. Most users will only have one language other than English, and so will only have one language module. </p>
+	<p>On the same line as the language name you'll see a set of links. Select will switch you to that language. Remove will remove the language from your languages list and your dashboard. The rest of the links take you to the various translation and management tools for that language. </p>
+	<p>Next you'll see how many phrases have not been translated yet for that language. Click the link to view a list of these phrases and translate them. </p>
+	
+	<h3>Language Phrases</h3>
+	<p>Shows the status of each translatable phrase for that language. A phrase is accepted if it has at least one accepted translation. Pending means that there are translations for the phrase, but none have been accepted. Not translated means that the phrase is translatable, but no translations have been submitted. </p>
+	<p>Note: If a phrase has been locked, it is not considered translatable. Rejected translations are not counted as translations. This means that if a phrase has only one translation, and that translation has been rejected, the phrase will be considered not translated. </p>
+	
+	<h3>Your Translations</h3>
+	<p>Your translations shows you the status of each translation you've provided for this language. There are three states for each translation you've provided: accepted, pending, and rejected. Accepted means that its rank has meet the necessary threshold to be accepted. Pending means that the translation has not been accepted or rejected. Rejected translations have been voted down by users or reported. </p>
+	<p>Note that only the translation with the highest overall rank for that phrase will be used. This means that you can have a translation accepted but not used on the site. </p>
 
+  <h3>Recent Discussions</h3>
+	<p>Lists the last five posts to the discussion forum for the language. Click view to see the whole thread and reply to the discussion. </p>
+	
+  <h3>Recent Translations</h3>
+	<p>Recent translations lists the five most recently added translations for the language. You can vote on the translations or view all for a longer list of recent translations.</p>
+	
+  <h3>Recent Translation Votes</h3>
+	<p>Recent translation votes lists the five translations that were voted on most recently for the language. You can add your own vote or view all for a longer list of translations with recent votes. </p>
+	
 </div>
 
-<%= render :partial => "/tr8n/common/footer" %>
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/discussions.html.erb

@@ -1,13 +1,13 @@
-<%= render :partial => "/tr8n/help/navigation" %>
+<%= render :partial => "header" %>
 
-<div id="tr8n_help_content">
-  
-  <h1><%= @page_title %></h1>
+<div class="documentation_section_title">
+  <%= tr("Discussions") %>
+</div>
 
-  <p>
-    Each language has its own discussion forum for translators to discuss topics relevant to that language. This is a great way to communicate with other Geni users working on the same language. You can ask questions, post comments, or seek advice from others translating the same language. Switch to your language to English for discussions that aren't language specific, such as general questions about the translation tools or language management.
+<div class="documentation_section">
+	<p>
+    Each language has its own discussion forum for translators to discuss topics relevant to that language. This is a great way to communicate with other Geni users working on the same language. You can ask questions, post comments, or seek advice from others translating the same language. Switch to your language to English for discussions that aren't language specific, such as general questions about the translation tools or language management.       
   </p>
-
 </div>
 
-<%= render :partial => "/tr8n/common/footer" %>
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/help.html.erb

@@ -0,0 +1,14 @@
+<%= render :partial => "header" %>
+
+<div class="documentation_section_title">
+  <%= tr("Help") %>
+</div>
+
+<div class="documentation_section">
+	<p>
+    Help section is what you are looking at right now.
+		Throughout the translation system you may see the help icon: <%= image_tag("tr8n/help.png") %> Click on it and it will take you to the help section regarding the topic of your interest.
+	</p>
+</div>
+
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/index.html.erb

@@ -1,18 +1,23 @@
-<%= render :partial => "/tr8n/help/navigation" %>
-<% @page_title = "Introduction" %>
+<%= render :partial => "header" %>
 
-<div id="tr8n_help_content">
-  
-  <h1><%= @page_title %></h1>
+<div class="documentation_section_title">
+  <%= tr("Welcome to #{Tr8n::Config.site_title} Translation Engine Documentation") %>
+</div>
 
-  <p>
-    Thank you for becoming a <%= Tr8n::Config.site_title %> translator. We're happy to provide you with a set of translation tools that will enable you to quickly create translations, view and vote on others' translations, and to monitor the progress of each language you are translating.
+<div class="documentation_section">
+	<div style="text-align:center;padding:30px;">
+		<%=image_tag("tr8n/tr8n_logo2.png")%>
+	</div>	
+	
+	<p>
+    <%=tr("Thank you for becoming a #{Tr8n::Config.site_title} translator.")%> 
+		<%=tr("We're happy to provide you with a set of translation tools that will enable you to quickly create translations, view and vote on others' translations, and to monitor the progress of each language you are translating.")%>
   </p>
-  
+	
   <p>
-    To learn more, use the menu to the left of each page.
+    <%=tr("To learn more, use the menu to the left of each page.")%>
   </p>
   
 </div>
 
-<%= render :partial => "/tr8n/common/footer" %>
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/inline_translator.html.erb

@@ -0,0 +1,59 @@
+<%= render :partial => "header" %>
+
+<div class="documentation_section_title">
+  <%= tr("Inline Translator") %>
+</div>
+
+<div class="documentation_section">
+  <p>
+  Use Inline translations to translate phrases while you are using and browsing the site. Use the Enable inline translations link in the language selector to enable inline translations. The link changes to "Disable inline translations" so you can turn it inline translations off when you are done.
+	</p>
+	<p>
+		<%= image_tag("tr8n/help/color_coding.png") %>
+	</p>
+	
+  <p>
+  <ul>
+    <li>Red - The phrase has not yet been translated for this language</li>
+    <li>Yellow - The phrase has been translated in a fallback language</li>
+    <li>Green - The phrase has been translated into this language</li>
+  </ul>
+  </p>
+
+  <p>
+  	Right-click (or Control-click on a Mac) on any underlined word to add a translation or to view and vote on existing translations. 
+  </p>	
+	
+	<h2>Phrases Without Translations</h2>
+	<p>Phrases that have not been translated are underlined in red. Right-click on a phrase to add a translation. </p>
+	<p>
+		<%= image_tag("tr8n/help/translator.png") %>
+	</p>
+	
+	<h3>Original Phrase</h3>
+	<p>Displays the phrase you are translating in English along with a short description. </p>
+	
+	<h3>Enter Translation</h3>
+	<p>Enter your translation for this phrase. Click the keyboard icon to enter your translation in other character sets such as Hebrew or Cyrillic. Click the Translate button after you enter your translation to save it. </p>
+	
+	<h3>Generate Context Rules</h3>
+	<p>Translations for some phrases can depend on the gender of the user viewing the translation and the gender or numerical value of tokens in the phrase. For example, in some languages "Invite Family & Friends to View Your Tree" has two different translations, one if the viewer is male and one if they are female. Tokens are parts of the phrase that are not translated, such as a profile name or a number. The translation for "{actor} tagged {target} in {count} photos" can depend on the gender of the actor and target as well as the number of photos. Tokens themselves are not translated. Geni will automatically replace them with the actual value. </p>
+	<p>If the translation of the phrase depends on any of these factors, click the generate context rules for this phrase link. Select the gender or number for each token that the translation depends on and click the "Continue... " button. This will show you a list of all possible contexts so you can provide an appropriate translation for each. </p>
+
+  <h3>Translation Tokens</h3>
+	<p>Tokens are parts of the phrase that are not translated, such as a profile name. Click on a token to add it to your translation. When a user is viewing the phrase, the tokens will automatically be replaced by the translation egnine. </p>
+	
+	<h3>Suggested Translations</h3>
+	<p>Displays the translation suggested by Google when you are translating a language they support. Click on their suggestion if you like it to insert it into the translation window. You can then save the translation or further edit it. </p>
+	
+	<h2>Phrases With Translations</h2>
+	<p>Phrases that have been translated are underlined in blue. Right click on one to vote on existing translations or add a new one.</p>
+	<p>The top ten translations for each phrase are listed. The rank indicates how many users have voted for the translation (+1 for up votes, -1 for down votes). Use the thumbs to vote a translation up or down. Report a translation to remove it from the list of translations and put the translator on a watch list. This should only be used when the translation is intentionally incorrect or offensive. </p>
+  <p>If you don't like any of the translations listed, use the view all link to find another translation to vote up or use the translate it yourself link to add a better translation.</p>
+	
+		
+	
+		
+</div>
+
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/language_selector.html.erb

@@ -1,13 +1,53 @@
-<%= render :partial => "/tr8n/help/navigation" %>
+<%= render :partial => "header" %>
 
-<div id="tr8n_help_content">
-  
-  <h1><%= @page_title %></h1>
+<div class="documentation_section_title">
+  <%= tr("Language Selector") %>
+</div>
+
+<div class="documentation_section">
+	<p>
+    The language selector is your primary interface for the translation engine. You can change your current language, enable inline translations, and access additional tools for translators and language managers. Click on you current language at the top right corner of any page to access the language selector window.  
+  </p>
 
+  <p style="text-align:center">
+  <%= image_tag("tr8n/help/language_selector_v2.png") %>
+  </p>
+	
+	<h2>Your Languages</h2>
+	<p>
+		Your languages gives you quick access to the languages you've previously selected. When you first open the language selector, you will notice that English (US) has been added to Your Languages by default. Select a language from the Other Languages list to add it to your languages. 
+	</p>
+	
+  <h2>Other Languages</h2>
+	<p>Click Other Languages to view a list of all of the languages available on Geni. Select a language to switch to that language and add it to Your Languages list. The percentage next to each language indicates how much of the site has been translated into that language.</p>
+
+  <h2>Actions</h2>
+	<h3>Enable/Disable Inline Translations</h3>
   <p>
-    The language selector is your primary interface for the translation engine. You can change your current language, enable inline translations, and access additional tools for translators and language managers. Click on you current language at the top right corner of any page to access the language selector window.
+    When viewing a language other than English, click the enable inline translations link to begin translating the site into that language. Use the same link to disable inline translations.   
   </p>
 
+  <p>When you enable inline translations you'll notice that all translatable phrases are underlined in various colors: </p>
+  
+  <p>
+  <ul>
+    <li>Red - The phrase has not yet been translated for this language</li>
+    <li>Yellow - The phrase has been translated in a fallback language</li>
+    <li>Green - The phrase has been translated into this language</li>
+  </ul>
+  </p>
+  
+  <p>Right-click (or Control-click on a Mac) on a phrase to translate it. See Translating Inline for more details.</p>	
+
+  <h3>Translation Translations</h3>
+	<p>Click Translation Tools to access the complete suite of advanced translation tools, including bulk translation tools, awards, and discussions. </p>
+	
+	<h3>Manage Language</h3>
+	<p>This feature is only available for language managers. Click Manage Language to access language management tools, such as the language's native name and grammar rules.</p>
+
+  <h3>Configure tr8n</h3>
+  <p>This feature is only available for tr8n administrators. Click Configure tr8n to access advanced configuration options.</p>
+
 </div>
 
-<%= render :partial => "/tr8n/common/footer" %>
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/management.html.erb

@@ -0,0 +1,42 @@
+<%= render :partial => "header" %>
+
+<div class="documentation_section_title">
+  <%= tr("Management") %>
+</div>
+
+<div class="documentation_section">
+	<p>
+		Language management features can only be accessed by the language managers. If you would like to become a language manager, please contact the site adminstrator and request management rights for your languages.
+	</p>
+	<p>	
+    Click Manage Language in the language selector to access language management tools, such as the language's native name and grammar rules. 
+	</p>
+	
+	<h2>Basic Information</h2>
+	<p>Provide the basic information for your language.</p>
+	
+	<h3>Native Name</h3>
+	<p>Enter the name of the language in the native language. This will appear after the English name for the language in the Language Selector. </p>
+	
+	<h3>Direction</h3>
+	<p>Determines whether the language is displayed left to right or right to left. </p>
+	
+	<h3>Fallback Language</h3>
+	<p>Use this to specify which language will be used for phrases that have not been translated into this language. For example, the fallback language for French (Canadian) could be French. When a user viewing the French (Canadian) translation views a phrase that has not been translated into French (Canadian), they will see the French translation for that phrase. Languages that don't have a fallback specified will fallback to English, so if there isn't a French (Canadian) or French translation, the user would see the original English version. </p>
+	
+	<h2>Prohibited Words</h2>
+	<p>Add any prohibited/curse words that should not be allowed in translations for this language. Separate words with commas. </p>
+	
+	<h2>Language Context Rules</h2>
+	<p>Tokens are parts of a phrase that are not translated, such as a profile name or a number. Translations in some languages can depend on the gender or numerical value of the tokens in the phrase. For example, the translation for "{actor} tagged {target} in {count} photos" can depend on the gender of the actor and target as well as the number of photos. If translations in your language depend on any of these rules, you can add them here. Make sure you add all of the context rules for your language. When a user translates a phrase, they will have the option to create a translation for each possible context. </p>
+	
+	<h2>Language Case Rules</h2>
+	<p>A language case is an inflection or use of a noun (or pronoun) to show its relation to other words in the sentence. In some languages, like Russian, the form of a token {actor} will changed based on where and how the token is used in a sentence. For instance, in '{target} received a gift from {actor}', {actor} token will be in the genitive form of the language. </p>
+	<p>This section allows you to define the various cases of your language so that translators can provide the correct form for each dynamic value of any token. </p>
+	
+	<h2>Relationships</h2>
+	<p>Relationships are connections between persons by blood or marriage. This section allows to specify the reduction rules for chained relationships. </p>
+	
+</div>
+
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/phrases.html.erb

@@ -1,19 +1,18 @@
-<%= render :partial => "/tr8n/help/navigation" %>
+<%= render :partial => "header" %>
 
-<div id="tr8n_help_content">
-  
-  <h1><%= @page_title %></h1>
+<div class="documentation_section_title">
+  <%= tr("Phrases") %>
+</div>
 
-  <p>
-    Use the Phrases tab to translate all the phrases of the site on a single page. The Phrases tab lists all translatable phrases and the top translations for each phrase. Use the edit icon on the far right of each phrase to add or edit a translation.
-  </p>
-  <p>
-    You can search for a specific English phrase, or use the filters to find specific types of phrases, such as all phrases without translations, or all phrases with approved translations.
-  </p>
-  <p>
-    Click on the name of a phrase to view all translations for that phrase. When viewing the list of translations for a specific phrase, use the Lock This Phrase link to remove the phrase from the list of translatable phrases. Users will no longer be able to submit new translations for the phrase or vote on existing translations. The currently accepted translation with the most votes will be the translation used until the phrase is unlocked again. Only language managers can lock a phrase.
+<div class="documentation_section">
+	<p>
+    Use the Phrases tab to translate all the phrases of the site on a single page. The Phrases tab lists all translatable phrases and the top translations for each phrase. Use the edit icon on the far right of each phrase to add or edit a translation.    
   </p>
 
+  <p>You can search for a specific English phrase, or use the filters to find specific types of phrases, such as all phrases without translations, or all phrases with approved translations. </p>
+	
+	<p>Click on the name of a phrase to view all translations for that phrase. When viewing the list of translations for a specific phrase, use the Lock This Phrase link to remove the phrase from the list of translatable phrases. Users will no longer be able to submit new translations for the phrase or vote on existing translations. The currently accepted translation with the most votes will be the translation used until the phrase is unlocked again. Only language managers can lock a phrase. </p>	
+	
 </div>
 
-<%= render :partial => "/tr8n/common/footer" %>
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/{translation_rank.html.erb → ranks.html.erb}

@@ -1,17 +1,27 @@
-<%= render :partial => "/tr8n/help/navigation" %>
+<%= render :partial => "header" %>
 
-<div id="tr8n_help_content">
-  
-  <h1><%= @page_title %></h1>
+<div class="documentation_section_title">
+  <%= tr("Understanding Ranks") %>
+</div>
 
-  <p>
-    When you add a translation we automatically give it an up vote from you, so it will start with a rank of +1. If you decide later that it is not a good translation, you can change your vote on your own translation to a down vote. The first section focuses on you and your overall activity. Your overall rank is based on the percentage of your translations in all languages that have received positive votes. There are three states for each translation you've provided: accepted, pending, and rejected. Accepted means that its rank has meet the necessary threshold to be accepted. Pending means that the translation has not been accepted or rejected. Rejected translations have been voted down by users or reported.
+<div class="documentation_section">
+	<p>
+    There are two kinds of ranks in Tr8n Translation System: user ranks and translation ranks. 
   </p>
-  
+	
+	<h2>User Ranks</h2>
+	<p>
+		Each translator has a rank of 1 to 5 stars. Their rank is based on the percentage of the translations they've submitted that have been accepted. 
+	</p>
+	
+  <h2>Translation Ranks</h2>
   <p>
-    Note that only the translation with the highest overall rank for that phrase will be used. This means that you can have a translation accepted but not used on the site.
+    When you add a translation we automatically give it an up vote from you, so it will start with a rank of +1. If you decide later that it is not a good translation, you can change your vote on your own translation to a down vote. The first section focuses on you and your overall activity. Your overall rank is based on the percentage of your translations in all languages that have received positive votes. There are three states for each translation you've provided: accepted, pending, and rejected. Accepted means that its rank has meet the necessary threshold to be accepted. Pending means that the translation has not been accepted or rejected. Rejected translations have been voted down by users or reported.  
   </p>
-
+	<p>
+		Note that only the translation with the highest overall rank for that phrase will be used. This means that you can have a translation accepted but not used on the site.
+	</p>
+	
 </div>
 
-<%= render :partial => "/tr8n/common/footer" %>
+<%= render :partial => "footer" %>

data/app/views/tr8n/help/relationships.html.erb

@@ -0,0 +1,14 @@
+<%= render :partial => "header" %>
+
+<div class="documentation_section_title">
+  <%= tr("Relationships") %>
+</div>
+
+<div class="documentation_section">
+	<p>
+    The Relationships sections displayes a list of all available relationship keys that exists in all languages. Choose the relationship keys that apply to your language and provide the translation. Only translate keys that result in a single word or phrase.
+		Translation engine will automatically chain relationships that don't have a translation in your language.      
+  </p>
+</div>
+
+<%= render :partial => "footer" %>