blob: ec3ac43acf08ad1c663b375dadfe63f316ba4f5d [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. 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-Type" content="text/html; charset=iso-8859-1">
<title>
Externalize Strings Wizard
</title>
<link rel="stylesheet" href="../book.css" charset="ISO-8859-1" type="text/css">
</head>
<body>
<h1>
Externalize Strings Wizard
</h1>
<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. The wizard
consists of the following pages:
</p>
<ul>
<li>
String selection page
</li>
<li>
Translation settings page
</li>
<li>
Error page
</li>
<li>
Preview page
</li>
</ul>
<h2 class="Head">
String selection page
</h2>
<p>
This page specifies which strings are translated and which not.
</p>
<table border="1" cellspacing="0" cellpadding="5" width="100%">
<thead>
<tr>
<th>
<p>
Field
</p>
</th>
<th>
<p>
Description
</p>
</th>
</tr>
</thead>
<tbody>
<tr>
<td valign="top">
<p>
Use Eclipse's string externalization mechanism
</p>
</td>
<td valign="top">
<p>
If unchecked the standard externalization mechanism is used, otherwise the new
<a href="http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-core-home/documents/3.1/message_bundles.html">Eclipse string externalization mechanism</a> is used.
<br><em>Note:</em> This field is only present if the project build path contains the <code>org.eclipse.osgi.util.NLS</code> class.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Enter common prefix for generated keys
</p>
</td>
<td valign="top">
<p>
Specifies an optional prefix for every generated key. For example, the fully qualified name of the compilation unit could be used.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Strings to externalize
</p>
</td>
<td valign="top">
<p>
Displays the list of non-externalized strings with proposed keys and values.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Translate
</p>
</td>
<td valign="top">
<p>
Marks the selected strings to be translated.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Never Translate
</p>
</td>
<td valign="top">
<p>
Marks the selected strings as not to be translated.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Skip
</p>
</td>
<td valign="top">
<p>
Marks the selected strings as to be skipped.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Edit Key...
</p>
</td>
<td valign="top">
<p>
Opens a dialog for entering a new key.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Context
</p>
</td>
<td valign="top">
<p>
Displays the occurrence of the string in the context of the compilation unit.
</p>
</td>
</tr>
</tbody>
</table>
<h2 class="Head">
Translation settings page
</h2>
<p>
This page specifies translation specific settings.
</p>
<table border="1" cellspacing="0" cellpadding="5" width="100%">
<thead>
<tr>
<th>
<p>
Option
</p>
</th>
<th>
<p>
Description
</p>
</th>
</tr>
</thead>
<tbody>
<tr>
<td valign="top">
<p>
Package
</p>
</td>
<td valign="top">
<p>
Specifies the destination package for the property file.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Property file name
</p>
</td>
<td valign="top">
<p>
Specifies the property file name.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Create resource bundle accessor class in &quot;<var>package</var>&quot;
</p>
</td>
<td valign="top">
<p>
If enabled, the wizard creates a class to access the language specific resource bundle.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Class name
</p>
</td>
<td valign="top">
<p>
The name of the class to access the resource bundle.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Use default substitution pattern
</p>
</td>
<td valign="top">
<p>
If enabled, the wizard will use default substitution patterns.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Substitution pattern
</p>
</td>
<td valign="top">
<p>
Specifies the source pattern to replace the string to externalize.
</p>
</td>
</tr>
<tr>
<td valign="top">
<p>
Add import declaration
</p>
</td>
<td valign="top">
<p>
Specifies additional import declarations. This might be required depending on referenced types by the substitution pattern.
</p>
</td>
</tr>
</tbody>
</table>
<h2 class="Head">
Error page
</h2>
<p>
Displays a list of errors and warnings if any.
</p>
<h2 class="Head">
Preview page
</h2>
<p>
Displays a preview of the actions which will be performed on 'Finish'.
</p>
<p>
<img border="0" src="../images/ngrelc.png" alt="Related concepts" ></p>
<p>
<a href="../concepts/cnls.htm">String externalization</a><br>
<a href="http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-core-home/documents/3.1/message_bundles.html">Eclipse string externalization mechanism</a>
</p>
<p>
<img src="../images/ngrelt.png" alt="Related tasks" border="0" ></p>
<p>
<a href="../tasks/tasks-206.htm">Externalizing Strings</a><br>
<a href="../tasks/tasks-180.htm">Using the Externalize Strings wizard</a>
<a href="../tasks/tasks-110.htm"></a>
</p>
<p>
<img border="0" src="../images/ngrelr.png" alt="Related reference"></p>
<p>
<a href="../reference/ref-menu-source.htm">Source actions</a>
</p>
</body>
</html>