Internationalisation/Offline/Export to Web - Revision history

Cudo29: The Lang templete was added.

2010-01-11T20:38:28Z

The Lang templete was added.

AngelHerraez: trying another method to show image thumbnails

2008-08-31T16:45:16Z

trying another method to show image thumbnails

AngelHerraez: typo and TOC relocation

2008-08-30T19:57:43Z

typo and TOC relocation

AngelHerraez: /* Translating some terms showing in the final web pages */

2008-08-30T19:42:43Z

‎Translating some terms showing in the final web pages

AngelHerraez: /* Translating some terms showing in the final web pages */

2008-08-30T16:32:17Z

‎Translating some terms showing in the final web pages

AngelHerraez at 15:58, 30 August 2008

2008-08-30T15:58:35Z

AngelHerraez at 12:53, 30 August 2008

2008-08-30T12:53:09Z

AngelHerraez: (new) instructions for translation of Export to Web

2008-08-30T12:07:38Z

(new) instructions for translation of Export to Web

New page

[[Image:WebPageMakerPopInTab.png|thumb|sample Web Page Maker window]]
The ''Export to web'' module [[Image:ToWebButton.png|Export To Web button]],
part of the Jmol application, consists of an interface
(a window entitled ''Jmol Web Page Maker'' that opens separate from the
main app window and can be operated in parallel),
a help window
and a set of internal templates that will be used to generate the
web pages according to user instructions.
Both need translation, with a different procedure.

== Translating the interface ==

The ''Jmol Web Page Maker'' window contains several texts that are translated in the
same way as the rest of the application (either online through Launchpad web site,
or offline by editing the {{File|''LANG''.po}} files on your computer; see
[[Internationalisation#Translating_the_application.2Fapplet|Translating the application/applet]]).

=== Translating the instructions ===

[[Image:WebPageMakerIntroTab.png|thumb|Introduction panel of Web Page Maker]]
[[Image:WebPageMakerHelp.png|thumb|Help window of Web Page Maker]]
The introduction panel (a tab inside the ''Jmol Web Page Maker'' interface)
and the help/instructions panels (opened in a separate window)
are built from html files.
:These files are in <code>org/openscience/jmol/app/webexport/html/</code>
:Currently:
: {{File|Installing_Applet.html}}
: {{File|Path_to_Applet.html}}
: {{File|pop_in_instructions.html}}
: {{File|script_button_instructions.html}}
: {{File|Testing_Pages_Locally.html}}
: {{File|WebExportIntro.html}}

You must duplicate those original English files and rename them according to
your language, then translate their content using a text or html editor.
See
[[Internationalisation/Translating_html_files|Translating html files]].

== Translating the web page templates ==

=== Translating the html files ===

The templates are composed of several html files.
:These files are in <code>org/openscience/jmol/app/webexport/html/</code>
:Currently:
: {{File|pop_in_template.html}}
: {{File|pop_in_template2.html}}
: {{File|script_button_template.html}}
: {{File|script_button_template2.html}}

You must duplicate those original English files and rename them according to
your language, then translate their content using a text or html editor.
See
[[Internationalisation/Translating_html_files|Translating html files]].

=== Translating some terms showing in the final web pages ===

Some text strings are shown in the final web pages but are not included in the
html template files themselves.
Instead, they are included in the PO files (the same as text for the interface is).
However, given that they will be shown in html files and not within the application,
special precautions are needed to assure the proper visualization in any user's browser.

You must provide translated text strings (using either the online or offline methods)
that do not use accented characters per se, but converted into the equivalent
HTML entities. Examples:
&aacute; or &#x00E1; for accute-accented a (Ã¡)
&eacute; or &#x00E9; for accute-accented e (Ã©)
&iacute; or &#x00ED; for accute-accented i (Ã)
&oacute; or &#x00F3; for accute-accented o (Ã³)
&uacute; or &#x00FA; for accute-accented u (Ãº)
&ntilde; or &#x00F1; for tilde-n (Ã±)
&iquest; or &#x00BF; for opening question mark (Â¿)
&iexcl; or &#x00A1; for opening exclamation mark (Â¡)
(see http://htmlhelp.com/reference/html40/entities/ for a full list of entity codes)

← Older revision		Revision as of 20:38, 11 January 2010
Line 1:		Line 1:
		+	{{Lang:Internationalisation/Offline/Export to Web}}
	= Translating the ''Export to Web'' module =		= Translating the ''Export to Web'' module =

@@ Line 1: / Line 1: @@
 = Translating the ''Export to Web'' module =
 __TOC__
 The ''Export to Web'' module [[Image:ToWebButton.png|Export To Web button]],
 part of the Jmol application, consists of
@@ Line 10: / Line 10: @@
 * a set of internal templates that will be used to generate the user's web pages.
 All of them need translation, with a different procedure.
 == Translating the interface ==
 The ''Jmol Web Page Maker'' window contains several texts that are translated in the
 same way as the rest of the application (that is, either online through Launchpad web site,
@@ Line 20: / Line 23: @@
 === Translating the instructions ===
 The introduction panel (a tab inside the ''Jmol Web Page Maker'' interface)
 and the help/instructions panels (opened in a separate window)
@@ Line 38: / Line 39: @@
 See
 [[Internationalisation/Translating_html_files|Translating html files]].
 ==  Translating the web page templates ==

@@ Line 1: / Line 1: @@
 = Translating the ''Export to Web'' module =
 [[Image:WebPageMakerPopInTab.png|thumb|sample Web Page Maker window]]
-The ''Export to Web'' modulW [[Image:ToWebButton.png|Export To Web button]],
+The ''Export to Web'' module [[Image:ToWebButton.png|Export To Web button]],
 part of the Jmol application, consists of
-* an interface
+* an interface (a window entitled ''Jmol Web Page Maker'' that opens separate from the main app window and can be operated in parallel),
 * a help window,
-* a set of internal templates that will be used to generate the
+* a set of internal templates that will be used to generate the user's web pages.
 All of them need translation, with a different procedure.

@@ Line 61: / Line 61: @@
 Some text strings are shown in the final web pages but are not included in the
 html template files themselves.
-Instead, they are included in the {{File|''LANG''.po}} files (the same as text for the interface is).
+Instead, they are included in the {{File|''LANG''.po}} files (the same as text for the interface is). So, you translate them together with all the application terms.

@@ Line 76: / Line 76: @@
   &amp;iquest;  or  &amp;#x00BF;  for opening question mark (Â¿)
   &amp;iexcl;   or  &amp;#x00A1;  for opening exclamation mark (Â¡)
-(see http://htmlhelp.com/reference/html40/entities/ for a full list of entity codes)
+For a full list of entity codes, see http://htmlhelp.com/reference/html40/entities/ or http://www.alanwood.net/demos/ent4_frame.html

@@ Line 1: / Line 1: @@
-= Translating the ''Export to web'' module =
+= Translating the ''Export to Web'' module =
 [[Image:WebPageMakerPopInTab.png|thumb|sample Web Page Maker window]]
-The ''Export to web'' module [[Image:ToWebButton.png|Export To Web button]],
+The ''Export to Web'' modulW [[Image:ToWebButton.png|Export To Web button]],
-part of the Jmol application, consists of an interface
+part of the Jmol application, consists of
 (a window entitled ''Jmol Web Page Maker'' that opens separate from the
 main app window and can be operated in parallel),
-a help window,
+* a help window,
-and a set of internal templates that will be used to generate the
+* a set of internal templates that will be used to generate the
 user's web pages.
 All of them need translation, with a different procedure.
@@ Line 14: / Line 15: @@
 The ''Jmol Web Page Maker'' window contains several texts that are translated in the
-same way as the rest of the application (either online through Launchpad web site,
+same way as the rest of the application (that is, either online through Launchpad web site,
 or offline by editing the {{File|''LANG''.po}} files on your computer; see
 [[Internationalisation#Translating_the_application.2Fapplet|Translating the application/applet]]).
@@ Line 60: / Line 61: @@
 Some text strings are shown in the final web pages but are not included in the
 html template files themselves.
-Instead, they are included in the PO files (the same as text for the interface is).
+Instead, they are included in the {{File|''LANG''.po}} files (the same as text for the interface is).
-However, given that they will be shown in html files and not within the application,
+However, given that they will be shown as part of html files and not within the application,
-special precautions are needed to assure the proper visualization in any user's browser.
+special precautions are needed to ensure the proper visualization in any user's browser.
 You must provide translated text strings (using either the online or offline methods)
 that do not use accented characters per se, but converted into the equivalent
 HTML entities. Examples:
-  &amp;aacute;  or  &amp;#x00E1;  for accute-accented a (Ã¡)
+  &amp;aacute;  or  &amp;#x00E1;  for acute-accented a (Ã¡)
-  &amp;eacute;  or  &amp;#x00E9;  for accute-accented e (Ã©)
+  &amp;eacute;  or  &amp;#x00E9;  for acute-accented e (Ã©)
-  &amp;iacute;  or  &amp;#x00ED;  for accute-accented i (Ã)
+  &amp;iacute;  or  &amp;#x00ED;  for acute-accented i (Ã)
-  &amp;oacute;  or  &amp;#x00F3;  for accute-accented o (Ã³)
+  &amp;oacute;  or  &amp;#x00F3;  for acute-accented o (Ã³)
-  &amp;uacute;  or  &amp;#x00FA;  for accute-accented u (Ãº)
+  &amp;uacute;  or  &amp;#x00FA;  for acute-accented u (Ãº)
   &amp;ntilde;  or  &amp;#x00F1;  for tilde-n (Ã±)
   &amp;iquest;  or  &amp;#x00BF;  for opening question mark (Â¿)
   &amp;iexcl;   or  &amp;#x00A1;  for opening exclamation mark (Â¡)
 (see http://htmlhelp.com/reference/html40/entities/ for a full list of entity codes)