blob: 729db021382f897ad4f257752aa8b3f2b3f0b825 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<script language="JavaScript" type="text/javascript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
<title>Externalizing Strings</title>
<link href="../../book.css" rel="stylesheet" type="text/css">
<style type="text/css">
<!--
.style1 {
font-size: 18px;
font-weight: bold;
}
.style3 {
font-size: 12pt;
font-weight: bold;
}
-->
</style>
</head>
<body>
<p class="style1">Externalizing Strings</p>
<p>PDE provides an <strong>Externalize Strings</strong> wizard to help
externalize strings in your Manifest and plugin.xml files.
Externalizing manifest files extracts translatable strings and stores
them in a properties file for multi-language support.
The wizard is available under the <strong>PDE Tools</strong> menu in
the context menu of a PDE project's MANIFEST.MF or plugin.xml files.
</p>
<p>&nbsp;</p>
<p class="style3">File Selections</p>
<p><img src="../../images/pde_actions/externalize_strings_selection.png" alt="File Selections" hspace="30"></p>
<p>The <strong>Plug-ins with non-externalized strings</strong> table
displays all the plug-in related files in the workspace that contain
non-externalized strings. The files are grouped by project, and they
display the number of non-externalized strings in brackets.
You can select one or more files to externalize at one time.
</p>
<p>The text in the <strong>Localization</strong> box will be
used to define the properties file in which the externalized
string keys should be stored. The file's name is created by
adding ".properties" to the localization value.
</p>
<p>&nbsp;</p>
<p class="style3">String Substitution</p>
<p><img src="../../images/pde_actions/externalize_strings_substitution.png" alt="String Substitution" hspace="30"></p>
<p>After selecting a file in the <strong>Plug-ins with non-externalized strings</strong>
table, the non-externalized strings will be displayed in the
<strong>Strings to be externalized</strong> table.
Since you may not want to externalize all the strings in the
file, you may choose which strings you wish to externalize by
checking or unchecking strings in the table. Click on the
<strong>Substitution Key</strong> column to change the key name.
</p>
<p>To see the current string value in the table, select either the
<strong>Value</strong> or <strong>Substitution Key</strong> column of a string.
The strings location will be highlighted and displayed in the <strong>Source</strong>
display.
</p>
</body>
</html>