en:supporting_other_locales
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:supporting_other_locales [2019/12/13 04:06] – anupama | en:supporting_other_locales [2023/03/13 01:46] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Supporting other locales on Windows 10 ====== | + | |
+ | |||
+ | |||
+ | ====== Supporting | ||
Greenstone testing work tends to be done in an English locale, with English specific settings. However, Greenstone is meant to support language users around the world, whose PCs and laptops may be set to different locales and other language settings. | Greenstone testing work tends to be done in an English locale, with English specific settings. However, Greenstone is meant to support language users around the world, whose PCs and laptops may be set to different locales and other language settings. | ||
Line 5: | Line 8: | ||
Months after Greenstone 3.09 was released, we discovered that on a machine running Windows 10 which was set to the Chinese locale and other related settings, different aspects of Greenstone 3 did not function out of the box. | Months after Greenstone 3.09 was released, we discovered that on a machine running Windows 10 which was set to the Chinese locale and other related settings, different aspects of Greenstone 3 did not function out of the box. | ||
- | **In particular, the following issues were detected, with their causes and fixes (which work on Windows 10) described below:** | + | **In particular, the following issues were detected, with their causes and //fixes// (which work on Windows 10) described below:** |
- | 1. **SYMPTOM: | + | **SYMPTOM: |
- | **CAUSE: | + | This issue has been fixed since Dec 2019 and April 2020, months after Greenstone 3.09' |
- | **FIX:** This issue has been fixed since Dec 2019, several months after Greenstone 3.09's release, and will be available from Greenstone 3.10 onwards when released. | + | ====== COMPULSORY |
- | If you wish to implement this fix for yourself in Greenstone 3.09 or earlier | + | **ADDITIONAL SYMPTOM: |
+ | |||
+ | **CAUSE:** This occurs because the Windows PC code page needs to a particular code page in order for the characters in '' | ||
+ | |||
+ | **FIX:** | ||
- Open up your Greenstone 3's gs2build/ | - Open up your Greenstone 3's gs2build/ | ||
- Use the text editor to locate the section below near the top of the file:\\ < | - Use the text editor to locate the section below near the top of the file:\\ < | ||
Line 39: | Line 46: | ||
) else ( | ) else ( | ||
chcp 850 | chcp 850 | ||
- | )**</ | + | )</ |
- Save and close the file. | - Save and close the file. | ||
- If not launching Greenstone applications from the Windows Start Menu, then when you next run any part of the Greenstone suite hereafter to test the fix, make sure to use a fresh DOS prompt so that the updated greenstone environment will be used when you run '' | - If not launching Greenstone applications from the Windows Start Menu, then when you next run any part of the Greenstone suite hereafter to test the fix, make sure to use a fresh DOS prompt so that the updated greenstone environment will be used when you run '' | ||
- | | + | |
- | * Rightclick on your Windows Desktop, choose Display Settings. In the search box, search for " | + | |
- | * Go to Control Panel > Clock and Region > Region. | + | ====== PART 2 OF FIX: TRY THESE 2 SOLUTIONS ====== |
+ | |||
+ | **ONGOING SYMPTOM:** If you now run GLI, visiting '' | ||
+ | |||
+ | **CAUSE:** Still an locale issue leading to encoding problems. | ||
+ | |||
+ | **FIX:** Try Solution 1 below first, and if that doesn' | ||
+ | |||
+ | ==== SOLUTION 1 ==== | ||
+ | If you're using Greenstone 3: | ||
+ | * Make sure Greenstone is not running and all Greenstone related DOS prompts have been exitted too. | ||
+ | * Use a text editor to open your GS3's '' | ||
+ | * At the very end of the file add a newline or two and paste the following, followed by another newline:\\ < | ||
+ | * Save and close the file '' | ||
+ | * Now use a text editor to open '' | ||
+ | * Go to the very bottom of this file, and just before the line that says '': | ||
+ | * Save and close the file '' | ||
+ | * Next, use your text editor to open your GS3's to open the file '' | ||
+ | * Locate the line that contains:\\ < | ||
+ | * Still in '' | ||
+ | * Save and close the file '' | ||
+ | * Relaunch GLI or the Greenstone Server Interface and preview your collections. They should now hopefully work. | ||
+ | |||
+ | |||
+ | ==== SOLUTION 2 ==== | ||
+ | If the above didn't work, try the following to get previewing to work again. | ||
+ | |||
+ | For this, Windows | ||
+ | | ||
+ | | ||
* In the '' | * In the '' | ||
* In the '' | * In the '' | ||
- | | + | |
- | | + | * Restart |
+ | * Try running GLI or the Greenstone Server and previewing your collection now. If there are still issues, see whether the DOS prompt contains error messages mentioning that mention issues running '' | ||
+ | ===== ANOTHER RELATED SYMPTOM AND ITS FIX ===== | ||
+ | //We noticed the following symptom only once in the 3 test cases so far. It has not occurred in the remaining 2 test cases, so although we document its solution here, you may not need to carry out the | ||
+ | instructions for this solution until you actual notice the problem (the symptom) described here.// | ||
- | 2. **SYMPTOM: | + | **SYMPTOM: |
+ | |||
+ | You can test if this is the case by opening a new DOS prompt, using it to navigate into your Greenstone 3 installation area and then running the following 2 commands in sequence there: | ||
+ | perl -S pluginfo.pl -describeall</ | ||
+ | |||
+ | If you see error messages, proceed with the fix for this described below. | ||
**CAUSE: | **CAUSE: | ||
- | **FIX:** Fixes for this have been committed for the future Greenstone 3.10 release and onwards, but at present they have not been made active yet. | + | **FIX:** Fixes for this have been committed for the future Greenstone 3.10 release and onwards, but at present they have not been made active yet. |
- | * If you're working with a nightly Greenstone binary obtained from www.greenstone.org/ | + | |
+ | * If you're working with Greenstone 2.87 or earlier or Greenstone 3.09 or earlier, then: | ||
+ | - Use the Windows file explorer to go to '' | ||
+ | - Use a text editor to open up '' | ||
+ | * If you're working with a nightly | ||
- Use the Windows file explorer to go to '' | - Use the Windows file explorer to go to '' | ||
- Use a text editor to open up '' | - Use a text editor to open up '' | ||
- | * If you're working with Greenstone 2.87 or earlier or Greenstone 3.09 or earlier, then: | ||
- | - Use the Windows file explorer to go to '' | ||
- | - Use a text editor to open up '' | ||
- | |||
- | |||
en/supporting_other_locales.1576209965.txt.gz · Last modified: 2019/12/13 04:06 by anupama