en:supporting_other_locales
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionNext revisionBoth sides next revision | ||
en:supporting_other_locales [2019/12/13 03:51] – created anupama | en:supporting_other_locales [2020/04/29 06:59] – anupama | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Supporting other locales on Windows ====== | + | ====== 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 5: | ||
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 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 43: | ||
) 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 '' | ||
- | 2. **SYMPTOM: | + | ====== 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:\\ < | ||
+ | * Also locate the line containing: | ||
+ | * 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 will require system configuration changes followed by a restart. | ||
+ | * POSSIBLY OPTIONAL: Rightclick on your Windows Desktop, choose '' | ||
+ | * POSSIBLY OPTIONAL: Go to '' | ||
+ | * In the '' | ||
+ | * In the '' | ||
+ | * **Most importantly, | ||
+ | * Restart your Windows machine. | ||
+ | * 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 '' | ||
+ | |||
+ | |||
+ | 2. **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/ | + | |
- | - Use the Windows file explorer to go to '' | + | |
- | - Use a text editor to open up '' | + | |
* If you're working with Greenstone 2.87 or earlier or Greenstone 3.09 or earlier, then: | * 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 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 a nightly '' | ||
+ | - Use the Windows file explorer to go to '' | ||
+ | - Use a text editor to open up '' | ||
en/supporting_other_locales.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1