Changeset 33793 for main/trunk/greenstone2/setup.bat

Timestamp:

2019-12-11T18:28:29+13:00 (4 years ago)

Author:

ak19

Message:

Changes for getting a running GS3 server to display collections on Cher's Chinese locale machine. 1. A key change so far turned out to be the improvement Dr Bainbridge wanted in gs2build\setup.bat for this: which is controlling the codepage to be the English locale's Windows default of codepage 850 (but changed to 866 if GSDLLANG is Russian, so setup,bat's display strings in Russian print correctly. 2. Other changes were for XML parsing to parse utf8-file contents correctly on the Chinese locale, by seting JAVA_TOOL_OPTIONS env var to pass file.encoding=UTF-8 to the JVM (set in gs2build\setup.bat and exported in gs3-setup.bat), as well as for ant targets force-start-tomcat and force-stop-tomcat in build.xml to do the same. 3. Finally, uncomment Alias.pm import in perllib\plugins\DirectoryPlugin.pm and rename the new perllib\cpan\Encode's Alias.pm.newForLocaleIssue and updated Locale.pm.newForLocaleIssue to Alias.pm and Locale.pm respectively. Dr Bainbridge found that this was necessary for perl to work with the encoding on the Chinese locale, else running things like pluginfo.pl -describeAll on Windows would break on such locales.

File:

• main/trunk/greenstone2/setup.bat (modified) (2 diffs)

main/trunk/greenstone2/setup.bat

@@ -6 +6 @@
 CD /D "%~dp0"
 set GSDLLANG=en
+
+:: This script's contents were created in Windows codepage 850 (Western European).
+:: When this script is run in non-English locales like the Chinese locale, the 
+:: character content/encoding of this script can get wrongly interpreted by the
+:: different encoding of the locale. And then the GS environment gets set wrongly
+:: or incompletely in those cases.
+:: So we force this script to be run and interpreted in codepage 850.
+:: However, the Russian display strings in this script were desgined to work in the
+:: default Russian Windows codepage 866. Whereas, codepage 850 works for this
+:: script's remaining English, French, Spanish display strings. So:
+if ("!GSDLLANG!" == "ru") (
+    chcp 866
+) else (
+    chcp 850
+)
 
 echo.
@@ -282 +297 @@
 :: https://www.gnu.org/software/wget/manual/html_node/Wgetrc-Location.html
 set WGETRC=%GSDLHOME%/bin/%GSDLOS%/wgetrc
+
+
+:: On other localse, like Chinese locales, for XMLParsers to read (XML) files
+:: in UTF-8 encoding (instead of defaulting to encoding GBK when on Chinese locale),
+:: need to pass -Dfile.encoding=UTF-8 to the JVM. Can have this passed to the JVM by
+:: setting the JAVA_TOOL_OPTIONS environment variable to this here.
+:: For example, the example at https://www.mkyong.com/java/how-to-read-utf-8-xml-file-in-java-sax-parser/
+:: doesn't work in a Chinese locale until the program is run with 
+:: java -Dfile.encoding=UTF-8 <ReadXMLUTF8FileSAX>
+::
+::set JAVA_TOOL_OPTIONS=%JAVA_TOOL_OPTIONS% -Dfile.encoding=UTF-8
+rem set JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8