en:user:gs2_to_gs3
no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
— | en:user:gs2_to_gs3 [2023/03/13 01:46] (current) – created - external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | |||
+ | |||
+ | ====== Converting Greenstone 2 collections to Greenstone 3 ====== | ||
+ | |||
+ | While the indexes and databases of a Greenstone 3 collection are the same as for a Greenstone 2 version, the configuration files are very different. | ||
+ | |||
+ | A Greenstone 2 collection doesn' | ||
+ | |||
+ | The easiest way to achieve this is to copy the Greenstone 2 collection into the Greenstone 3 collect folder, then open it in Greenstone 3's GLI. (The Greenstone 2 collection will need to have both a etc/ | ||
+ | |||
+ | The tricky part of the conversion process is converting the format statements. For Greenstone versions 3.06 and later a '' | ||
+ | |||
+ | The Format Conversion wizard tries to automatically do the conversions itself, then presents you with the tentative Greenstone 3 format statements generated from the Greenstone 2 ones, one format statement at a time, so that you can adjust them within the Wizard itself, or accept the suggestions for now and adjust them in GLI's Format Features later. | ||
+ | |||
+ | Once you have adjusted or accepted the format statements, you can go to the Create panel and preview the collection. It does not need to be rebuilt at this stage. Depending on how the collection looks, you may need to go back to the Format panel and modify the format statements manually. | ||
+ | |||
+ | ===== A complex example ===== | ||
+ | Sometimes, the Greenstone 3 format statements generated are accurate but can be simplified further. For example, if you were to open the Small Beatles collection from the Greenstone 2 Multimedia tutorial in Greenstone 3.06 GLI, then the Format Conversion wizard will produce the following format statement for the '' | ||
+ | < | ||
+ | <td valign=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | Compare this format statement with the equivalent documentNode template in the manually-created collectionConfig.xml for the same collection in the Greenstone 3 Multimedia tutorial: | ||
+ | |||
+ | < | ||
+ | <td valign=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | <td valign=" | ||
+ | < | ||
+ | <!-- | ||
+ | Defined in the global format statement | ||
+ | --> | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | There are two significant differences between the two. | ||
+ | |||
+ | 1. First, the automatically generated format statements refer to macros like '' | ||
+ | |||
+ | < | ||
+ | |||
+ | < | ||
+ | < | ||
+ | < | ||
+ | ... | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | The above would resolve to: | ||
+ | < | ||
+ | If the same macros were present in multiple collections, | ||
+ | --> | ||
+ | |||
+ | 2. The other thing to notice is that there are many individual ''< | ||
+ | |||
+ | Automatically generated format statement: | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | do something 1 | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | < | ||
+ | < | ||
+ | do something 2 | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | ... | ||
+ | </ | ||
+ | The hand-written version looks like: | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | |||
+ | < | ||
+ | do something 1 | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | do something 2 | ||
+ | </ | ||
+ | |||
+ | ... | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | ===== Using a remote Greenstone server ===== | ||
+ | |||
+ | The new Format Conversion Wizard only appears when you're working with GLI, not client-GLI. The client-GLI for GS3 will only perform the most basic initial step in the conversion process, which is to preserve the GS2 format statements in inactive XML tags in the new collection' | ||
+ | |||
+ | However, if you have a local Greenstone 3 installed, you can still manage to convert a remote collection' | ||
+ | |||
+ | - Open the GS2 collection on the remote GS3 server with client-GLI. Doing so for the first time will perform the preliminary conversion step of the GS2 collect.cfg into collectionConfig.xml. | ||
+ | - Download the remote collection' | ||
+ | - Open regular GLI of a GS3 installation on the client machine. Create a new empty collection. Quit GLI. | ||
+ | - Go to the local GS3 installation' | ||
+ | - Start regular GLI again. Re-open the newly created collection and now it should present you with the Format Conversion Wizard to lead you through inspecting the automatic conversion of the GS2 format statements to GS3. | ||
+ | - Once you're finished with the Wizard, go to the Format > Format features tab and copy all the format statements into a temporary text file. | ||
+ | - Restart client-GLI and connect to the remote GS3 server. | ||
+ | - Re-open the remote collection whose format statements need updating from GS2 to GS3. | ||
+ | - Go to the Format Features tab. | ||
+ | - Back in your temporary text file, copy over the format statement of each format feature into its correct section in the Format Features tab, replacing the text already there. | ||
+ | - The collection including its updated '' |
en/user/gs2_to_gs3.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1