[Esbox-commits] r1642 - in trunk/org.maemo.esbox.help/html: images images/externalize tasks

ilpyykko at garage.maemo.org ilpyykko at garage.maemo.org
Tue May 26 11:40:14 EEST 2009 

Author: ilpyykko
Date: 2009-05-26 11:40:14 +0300 (Tue, 26 May 2009)
New Revision: 1642

Added:
   trunk/org.maemo.esbox.help/html/images/externalize/
   trunk/org.maemo.esbox.help/html/images/externalize/es-menu.png
   trunk/org.maemo.esbox.help/html/images/externalize/es-select.png
   trunk/org.maemo.esbox.help/html/images/externalize/es-translate.png
   trunk/org.maemo.esbox.help/html/images/externalize/es-view.png
   trunk/org.maemo.esbox.help/html/images/externalize/never_translate.gif
   trunk/org.maemo.esbox.help/html/images/externalize/skip.gif
   trunk/org.maemo.esbox.help/html/images/externalize/translate.gif
Removed:
   trunk/org.maemo.esbox.help/html/images/extractstrings.png
   trunk/org.maemo.esbox.help/html/images/extractstrings1.png
   trunk/org.maemo.esbox.help/html/images/extractstrings2.png
Modified:
   trunk/org.maemo.esbox.help/html/tasks/ExternalizeString.html
Log:
Updated Externalize String help.

Added: trunk/org.maemo.esbox.help/html/images/externalize/es-menu.png
===================================================================
(Binary files differ)


Property changes on: trunk/org.maemo.esbox.help/html/images/externalize/es-menu.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: trunk/org.maemo.esbox.help/html/images/externalize/es-select.png
===================================================================
(Binary files differ)


Property changes on: trunk/org.maemo.esbox.help/html/images/externalize/es-select.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: trunk/org.maemo.esbox.help/html/images/externalize/es-translate.png
===================================================================
(Binary files differ)


Property changes on: trunk/org.maemo.esbox.help/html/images/externalize/es-translate.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: trunk/org.maemo.esbox.help/html/images/externalize/es-view.png
===================================================================
(Binary files differ)


Property changes on: trunk/org.maemo.esbox.help/html/images/externalize/es-view.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: trunk/org.maemo.esbox.help/html/images/externalize/never_translate.gif
===================================================================
(Binary files differ)


Property changes on: trunk/org.maemo.esbox.help/html/images/externalize/never_translate.gif
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: trunk/org.maemo.esbox.help/html/images/externalize/skip.gif
===================================================================
(Binary files differ)


Property changes on: trunk/org.maemo.esbox.help/html/images/externalize/skip.gif
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: trunk/org.maemo.esbox.help/html/images/externalize/translate.gif
===================================================================
(Binary files differ)


Property changes on: trunk/org.maemo.esbox.help/html/images/externalize/translate.gif
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Deleted: trunk/org.maemo.esbox.help/html/images/extractstrings.png
===================================================================
(Binary files differ)

Deleted: trunk/org.maemo.esbox.help/html/images/extractstrings1.png
===================================================================
(Binary files differ)

Deleted: trunk/org.maemo.esbox.help/html/images/extractstrings2.png
===================================================================
(Binary files differ)

Modified: trunk/org.maemo.esbox.help/html/tasks/ExternalizeString.html
===================================================================
--- trunk/org.maemo.esbox.help/html/tasks/ExternalizeString.html	2009-05-23 12:30:44 UTC (rev 1641)
+++ trunk/org.maemo.esbox.help/html/tasks/ExternalizeString.html	2009-05-26 08:40:14 UTC (rev 1642)
@@ -1,48 +1,134 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <html lang="en">
 <head>
 	<meta name="copyright" content="Copyright (c) INdT 2007-2009, (c) Nokia 2008-2009. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
 	<meta http-equiv="Content-Language" content="en-us">
 	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-	<title>Externalize string on C/C++ application</title>
+	
+	<title>Externalize Strings</title>
+	
 	<link rel="stylesheet" type="text/css" href="../help.css">
+    
     <style type="text/css">
-<!--
-.style1 {font-weight: bold}
--->
+	<!--
+
+		.title {
+			font-weight: bold
+		}
+		
+		.separate {
+ 			margin-bottom: 3em;
+		}
+			
+	-->
     </style>
 </head>
 
 <body>
-<h2 class="style1">Extracting Strings</h2>
 
+<h2 class="title">
+	Extracting Strings
+</h2>
 
-<p>The Externalize Strings wizard allows you to refactor a compilation unit 
-such that strings used in the compilation unit can be translated to different languages using
-the GNU gettext mechanism.</p>
-<p>To externalize strings:</p>
-  <ol>
-	<li>Select a project in Project Explorer and right-click to display the popup menu and select <strong>Source &gt; Externalize Strings</strong>.
-	<p/><img src="../images/extractstrings.png" alt="Externalize String" width="430" height="459"></p>
+<p>
+	The Externalize Strings wizard allows you to refactor a compilation unit 
+	such that strings used in the compilation unit can be translated to different
+	languages using	the GNU gettext mechanism. The wizard supports C/C++ and
+	Python projects. 
+</p>
+
+<p>
+	To externalize strings:
+</p>
+
+<ol>
+	<li class="separate">
+		<p>	
+			Select a project in Project Explorer and right-click project root to display 
+			the popup menu and select <strong>Source &gt; Externalize Strings</strong>.	
+		<p/>
+		
+		<img src="../images/externalize/es-menu.png" alt="Externalize String">
 	</li>
-    <li>Select the file(s) that should be externalized to enable the Externalize button, then click Externalize.
-	<p/><img src="../images/extractstrings1.png" alt="File that should be externalized" width="400" height="500"></p>
+	
+    <li class="separate">
+    	<p>
+    		Select the file(s) that should be externalized to enable the Externalize 
+    		button, then click Externalize.
+		<p/>
+		
+		<img src="../images/externalize/es-select.png"
+		     alt="File that should be externalized">
 	</li>
-    <li>A Wizard will appear showing strings that will be externalized. You can define the name of the output file, msgstr, and msgid. Click on a message string or message id to make a change.
-	<p/><img src="../images/extractstrings2.png" alt="Externalize Wizard" width="719" height="726"></p>
+	
+    <li class="separate">
+    	<p>
+    		A Wizard will appear showing strings that will be externalized. You can
+    		define the name of the output file and msgstr (translation). Click on a
+    		message string to make a change. Insert missing definitions option checks
+    		source code for missing headers and insert those if needed.
+		</p>
+		<p>
+			There is three actions for each string. 
+			<ul style="list-style-type:none">
+				<li>
+					<img src="../images/externalize/translate.gif" alt="Translate button">
+					<em>Externalize</em>: 
+					Translate string.
+				</li>
+				
+				<li>
+					<img src="../images/externalize/never_translate.gif"
+					     alt="Never translate button">
+					<em>Internalize</em>:
+					Do not translate the string and do not include string next time. 
+				</li>
+				
+				<li>
+					<img src="../images/externalize/skip.gif" alt="Skip button">
+					<em>Skip</em>:
+					Do not change the string.
+				</li>
+			</ul>
+		</p>
+
+		<img src="../images/externalize/es-translate.png" alt="Externalize Wizard">
 	</li>
-	<li>Click Finish.
+	
+	<li class="separate">
+		<p>
+			Next page shows translation changes. Cancel discard changes and finish
+			applies changes into selected files.
+		</p>
+		
+		<img src="../images/externalize/es-view.png" alt="Externalize Wizard">
 	</li>
+	
+	<li class="separate">
+		<p>
+			Click Finish.
+		</p>
+	</li>
 </ol>
 
-<p>A couple of files will be generated (<tt>POTFILE.in</tt> and <tt>outputName.po</tt>) which will be placed in 
-the <strong><em>ProjectName</em>/po/</strong> directory.</p>
+<p>
+	This generates or updates translation file <tt><em>outputName</em>.po</tt> and
+	files for Automake (<tt>POTFILE.in</tt>, and <tt>LINGUAS</tt>) which will be
+	placed in the <strong><em>ProjectName</em>/po/</strong> directory.
+</p>
+
 <ul>
- <li><tt>POTFILES.in</tt> contains the list of source code files that will be localized.</li> 
- <li> <tt>outputName</tt>.po includes translated text.</li>
+	<li>
+		<tt>POTFILES.in</tt> contains the list of source code files that will be localized.
+	</li>
+	<li>
+		<tt><em>outputName</em>.po</tt> includes translated text.
+	</li>
+	<li>
+		<tt>LINGUAS</tt> contains the list of languages that will be generated.
+	</li>
 </ul>
 
-<p>The Console view will output any warnings and errors.</p>
-
 </body>
 </html>
+

More information about the Esbox-commits mailing list