Changeset 32021 for documentation
- Timestamp:
- 2017-10-02T19:18:45+13:00 (7 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
documentation/trunk/tutorials/xml-source/tutorial_en.xml
r31997 r32021 10 10 <Text id="0001">Greenstone tutorial exercises (2016)</Text> 11 11 </Title> 12 <MajorVersion number="2"><Version current="2.8 6"/></MajorVersion>12 <MajorVersion number="2"><Version current="2.87"/></MajorVersion> 13 13 <MajorVersion number="3"><Version current="3.08"/></MajorVersion> 14 14 <SupplementaryText> … … 382 382 <Text id="0193">Installing Greenstone</Text> 383 383 </Title> 384 <Version initial="2.60" current="2.8 6"/>384 <Version initial="2.60" current="2.87"/> 385 385 <Content> 386 386 <Heading> … … 441 441 </Bullet> 442 442 </BulletList> 443 <Text id="0218">To invoke the Greenstone Reader's Interface, go to the <i>Greenstone-2.8 6</i> item under <i>All Programs</i> on the Windows <i>Start</i> menu and select <i>Greenstone Server</i>, once the server window is displayed click <<b>Enter Library</b>>.</Text>443 <Text id="0218">To invoke the Greenstone Reader's Interface, go to the <i>Greenstone-2.87</i> item under <i>All Programs</i> on the Windows <i>Start</i> menu and select <i>Greenstone Server</i>, once the server window is displayed click <<b>Enter Library</b>>.</Text> 444 444 <Text id="0219">To invoke the Greenstone Librarian Interface, go to the same item and select <i>Librarian Interface (GLI)</i>.</Text> 445 445 </Content> … … 452 452 </Title> 453 453 <Prerequisite id="install_greenstone"/> 454 <Version initial="2.60" current="2.8 6"/>454 <Version initial="2.60" current="2.87"/> 455 455 <Content> 456 456 <Comment> … … 507 507 </Title> 508 508 <SampleFiles folder="simple_html"/> 509 <Version initial="2.60|3.06" current="2.8 6|3.08"/>509 <Version initial="2.60|3.06" current="2.87|3.08"/> 510 510 <Content> 511 511 <Comment> … … 519 519 <MajorVersion number="2"> 520 520 <Menu> 521 <Text id="0255a">Start → All Programs → Greenstone-2.8 6→ Librarian Interface (GLI)</Text>521 <Text id="0255a">Start → All Programs → Greenstone-2.87 → Librarian Interface (GLI)</Text> 522 522 </Menu> 523 523 </MajorVersion> … … 615 615 </Title> 616 616 <SampleFiles folder="images"/> 617 <Version initial="2.60|3.06" current="2.8 6|3.08"/>617 <Version initial="2.60|3.06" current="2.87|3.08"/> 618 618 <Content> 619 619 <Comment> … … 870 870 </Title> 871 871 <SampleFiles folder="Word_and_PDF"/> 872 <Version initial="2.60|3.06" current="2.8 6|3.08"/>872 <Version initial="2.60|3.06" current="2.87|3.08"/> 873 873 <Content> 874 874 <Comment> … … 979 979 </Title> 980 980 <Prerequisite id="word_pdf_collection"/> 981 <Version initial="2.70w|3.06" current="2.8 6|3.08"/>981 <Version initial="2.70w|3.06" current="2.87|3.08"/> 982 982 <Content> 983 983 <Comment> … … 1242 1242 <SampleFiles folder="pdfbox"/> 1243 1243 <Prerequisite id="word_pdf_collection"/> 1244 <Version initial="2.85|3.06" current="2.8 6|3.08"/>1244 <Version initial="2.85|3.06" current="2.87|3.08"/> 1245 1245 <Content> 1246 1246 <Comment> … … 1287 1287 </Title> 1288 1288 <SampleFiles folder="Word_and_PDF"/> 1289 <Version initial="2.70|3.06" current="2.8 6|3.08"/>1289 <Version initial="2.70|3.06" current="2.87|3.08"/> 1290 1290 <Content> 1291 1291 <Text id="ep-2">Greenstone converts PDF files to HTML using third-party software: <AutoText text="pdftohtml.pl" type="italics"/>. This lets users view these documents even if they don't have the PDF software installed. Unfortunately, sometimes the formatting of the resulting HTML files is not so good. This exercise explores some extra options to the PDF plugin which may produce a nicer version for display.</Text> … … 1500 1500 <Text id="ew-a">Enhanced Word document handling</Text> 1501 1501 </Title> 1502 <Version initial="2.70w|3.06" current="2.8 6|3.08"/>1502 <Version initial="2.70w|3.06" current="2.87|3.08"/> 1503 1503 <Prerequisite id="word_pdf_collection"/> 1504 1504 <Content> … … 1624 1624 </Title> 1625 1625 <Prerequisite id="word_pdf_collection"/> 1626 <Version initial="2.85|3.06" current="2.8 6|3.08"/>1626 <Version initial="2.85|3.06" current="2.87|3.08"/> 1627 1627 <Content> 1628 1628 <Comment> … … 1785 1785 <Text id="0403">Exporting a collection to CD-ROM/DVD</Text> 1786 1786 </Title> 1787 <Version initial="2.60" current="2.8 6"/>1787 <Version initial="2.60" current="2.87"/> 1788 1788 <Content> 1789 1789 <Comment> … … 1811 1811 </Title> 1812 1812 <SampleFiles folder="tudor"/> 1813 <Version initial="2.60|3.06" current="2.8 6|3.08"/>1813 <Version initial="2.60|3.06" current="2.87|3.08"/> 1814 1814 <Content> 1815 1815 <Comment> … … 1873 1873 </Title> 1874 1874 <Prerequisite id="large_html_collection"/> 1875 <Version initial="2.60|3.06" current="2.8 6|3.08"/>1875 <Version initial="2.60|3.06" current="2.87|3.08"/> 1876 1876 <Content> 1877 1877 <Comment> … … 1982 1982 </Title> 1983 1983 <Prerequisite id="large_html_collection"/> 1984 <Version initial="2.60|3.06" current="2.8 6|3.08"/>1984 <Version initial="2.60|3.06" current="2.87|3.08"/> 1985 1985 <Content> 1986 1986 <NumberedItem> … … 2290 2290 <Text id="st-1">Section tagging for HTML documents</Text> 2291 2291 </Title> 2292 <Version initial="2.70w|3.06" current="2.8 6|3.08"/>2292 <Version initial="2.70w|3.06" current="2.87|3.08"/> 2293 2293 <Content> 2294 2294 <NumberedItem> 2295 <Text id="st-1a">In a browser, visit the Greenstone demo collection and have a ook at it. Browse to one of the documents. This collection is based on HTML files, but they appear structured in the collection. This is because these HTML files were tagged by hand into sections.</Text>2295 <Text id="st-1a">In a browser, visit the Greenstone demo collection and have a look at it. Browse to one of the documents. This collection is based on HTML files, but they appear structured in the collection. This is because these HTML files were tagged by hand into sections.</Text> 2296 2296 </NumberedItem> 2297 2297 <NumberedItem> … … 2365 2365 <Text id="0411">Downloading files from the web</Text> 2366 2366 </Title> 2367 <Version initial="2.60|3.06" current="2.8 6|3.08"/>2367 <Version initial="2.60|3.06" current="2.87|3.08"/> 2368 2368 <Content> 2369 2369 <Comment> … … 2410 2410 </Title> 2411 2411 <Prerequisite id="downloading_from_internet"/> 2412 <Version initial="2.60|3.06" current="2.8 6|3.08"/>2412 <Version initial="2.60|3.06" current="2.87|3.08"/> 2413 2413 <Content> 2414 2414 <NumberedItem> … … 2459 2459 </Title> 2460 2460 <SampleFiles folder="marc"/> 2461 <Version initial="2.60|3.06" current="2.8 6|3.08"/>2461 <Version initial="2.60|3.06" current="2.87|3.08"/> 2462 2462 <Content> 2463 2463 <Comment> … … 2731 2731 </Title> 2732 2732 <SampleFiles folder="isis"/> 2733 <Version initial="2.70w|3.06" current="2.8 6|3.08"/>2733 <Version initial="2.70w|3.06" current="2.87|3.08"/> 2734 2734 <Content> 2735 2735 <Comment> … … 2850 2850 </Title> 2851 2851 <SampleFiles folder="custom"/> 2852 <Version initial="2.70" current="2.8 6"/>2852 <Version initial="2.70" current="2.87"/> 2853 2853 <Content> 2854 2854 <Text id="mf-2">The appearance of all pages produced by Greenstone is governed by macro files, which reside in the folder <Path>Greenstone → macros</Path>, and images and CSS stylesheets reside in <Path>Greenstone → web → style</Path>.</Text> … … 2942 2942 <Text id="mf-73-1">Changing the colour of the page title and page text</Text> 2943 2943 </Heading> 2944 <Text id="mf-17">In the previous exercises we changed a single collection. Now we change all the pages in our Greenstone installation by modifying style and macro files outside the Librarian Interface. First, we format the page so that some other parts are blue. Preview any collection after each change to make sure that it has worked properly. On Windows, macro file changes require a restart of the Greenstone local library server. Stylesheet changes may require a forced reload in the web browser.</Text>2944 <Text id="mf-17">In the previous exercises we changed a single collection. Now we change all the pages in our Greenstone installation by modifying style and macro files outside the Librarian Interface. First, we format the page so that some other parts are blue. Preview any collection after each change to make sure that it has worked properly. On Windows, macro file changes may require a restart of the Greenstone local library server. Stylesheet changes may require a forced reload in the web browser.</Text> 2945 2945 <Comment> 2946 2946 <Text id="mf-17-1">Note, use any collection <b>except</b> the reports collection to preview the following changes. Because the reports collection has been modified to use its own custom stylesheet, changes to the main stylesheet won't have any effect on it.</Text> … … 2966 2966 </Bullet> 2967 2967 </BulletList> 2968 <Text id="mf-27b">Preview the collection. You m ight want to reload the page. Now text in the page body is a light green color (teal), and the font of the collection title has changed from black to blue.</Text>2968 <Text id="mf-27b">Preview the collection. You may need to force the browser to reload the page to see the changes in effect, or else may need to restart the Greenstone server. Now text in the page body is a light green color (teal), and the font of the collection title has changed from black to blue.</Text> 2969 2969 </NumberedItem> 2970 2970 <comment>(If a collection title image is used, you won't see the change on the collection title.)</comment> … … 3010 3010 </NumberedItem> 3011 3011 <NumberedItem> 3012 <Text id="mf-15">Preview the home page in a web browser. On Windows, restart the Greenstone library server. On unix systems, You may need to reload pages in order to see the changes take effect, as the browser may at first display cached versions of pages you'd already visited earlier. The header of the home page, and the background of every page of each collection (except <i>reports</i>, which uses a custom _cssheader_ macro) should now use the new graphics, and the green box background images are no longer present on the collection pages.</Text>3012 <Text id="mf-15">Preview the home page in a web browser. On Windows, if forcing the browser to reload the pages does not show the changes in effect, restart the Greenstone library server before reloading the pages in the browser. On unix systems, you may need to reload pages in order to see the changes take effect, as the browser may at first display cached versions of pages you'd already visited earlier. The header of the home page, and the background of every page of each collection (except <i>reports</i>, which uses a custom _cssheader_ macro) should now use the new graphics, and the green box background images are no longer present on the collection pages.</Text> 3013 3013 </NumberedItem> 3014 3014 <Heading> … … 3029 3029 </NumberedItem> 3030 3030 <NumberedItem> 3031 <Text id="mf-47">Preview the newly structured home page in a web browser. (On Windows, restart the Greenstone library server.) Look at the file macros/yourhome.dm in a text editor to see how these changes are expressed.</Text>3031 <Text id="mf-47">Preview the newly structured home page in a web browser. (On Windows, force reload the browser or else restart the Greenstone library server before reloading the pages in the browser.) Look at the file macros/yourhome.dm in a text editor to see how these changes are expressed.</Text> 3032 3032 </NumberedItem> 3033 3033 <NumberedItem> … … 3279 3279 </Title> 3280 3280 <SampleFiles folder="beatles"/> 3281 <Version initial="2.60|3.06" current="2.8 6|3.08"/>3281 <Version initial="2.60|3.06" current="2.87|3.08"/> 3282 3282 <Content> 3283 3283 <NumberedItem> … … 3333 3333 <Prerequisite id="multimedia_collection_explore"/> 3334 3334 <SampleFiles folder="beatles"/> 3335 <Version initial="2.60|3.06" current="2.8 6|3.08"/>3335 <Version initial="2.60|3.06" current="2.87|3.08"/> 3336 3336 <Content> 3337 3337 <Comment> … … 3865 3865 </Title> 3866 3866 <SampleFiles folder="niupepa"/> 3867 <Version initial="2.60|3.06" current="2.8 6|3.08"/>3867 <Version initial="2.60|3.06" current="2.87|3.08"/> 3868 3868 <Content> 3869 3869 <Comment> … … 4205 4205 <SampleFiles folder="niupepa"/> 4206 4206 <Prerequisite id="scanned_image_collection"/> 4207 <Version initial="2.70|3.06" current="2.8 6|3.08"/>4207 <Version initial="2.70|3.06" current="2.87|3.08"/> 4208 4208 <Content> 4209 4209 <Comment> … … 4336 4336 </Title> 4337 4337 <SampleFiles folder="oai"/> 4338 <Version initial="2.60|3.06" current="2.8 6|3.08"/>4338 <Version initial="2.60|3.06" current="2.87|3.08"/> 4339 4339 <Content> 4340 4340 <Comment> … … 4526 4526 </Title> 4527 4527 <Prerequisite id="simple_image_collection"/> 4528 <Version initial="2.85|3.06" current="2.8 6|3.08"/>4528 <Version initial="2.85|3.06" current="2.87|3.08"/> 4529 4529 <Content> 4530 4530 <Comment> … … 4553 4553 <NumberedItem> 4554 4554 <MajorVersion number="2"> 4555 <Text id="oaiserver-9">You are now ready to visit your oaiserver home page to check that it's all looking good. Start up the Greenstone Server by going to Windows <Path>Start → All Programs → Greenstone 2.8 6→ Greenstone Server</Path>.</Text>4555 <Text id="oaiserver-9">You are now ready to visit your oaiserver home page to check that it's all looking good. Start up the Greenstone Server by going to Windows <Path>Start → All Programs → Greenstone 2.87 → Greenstone Server</Path>.</Text> 4556 4556 </MajorVersion> 4557 4557 <MajorVersion number="3"> … … 4662 4662 </Title> 4663 4663 <Prerequisite id="GS_OAI_server"/> 4664 <Version initial="2.60|3.06" current="2.8 6|3.08"/>4664 <Version initial="2.60|3.06" current="2.87|3.08"/> 4665 4665 <Content> 4666 4666 <Comment> … … 4721 4721 </NumberedItem> 4722 4722 <NumberedItem> 4723 <Text id="0740">Before you start, you must set up your Greenstone environment in the terminal. In the DOS window , move to the home directory where you installed Greenstone. This is accomplished by something like:</Text>4723 <Text id="0740">Before you start, you must set up your Greenstone environment in the terminal. In the DOS window or terminal, move to the home directory where you installed Greenstone. This is accomplished by something like:</Text> 4724 4724 <Command>cd C:\Program Files\Greenstone</Command> 4725 4725 </NumberedItem> … … 4782 4782 <Text id="0750">Use METS as Greenstone's Internal Representation</Text> 4783 4783 </Title> 4784 <Version initial="2.60" current="2.8 6"/>4784 <Version initial="2.60" current="2.87"/> 4785 4785 <Content> 4786 4786 <NumberedItem> … … 4812 4812 </Title> 4813 4813 <SampleFiles folder="dspace"/> 4814 <Version initial="2.60" current="2.8 6"/>4814 <Version initial="2.60" current="2.87"/> 4815 4815 <Content> 4816 4816 <NumberedItem> … … 4941 4941 </Title> 4942 4942 <Prerequisite id="dspace_to_greenstone"/> 4943 <Version initial="2.60|3.06" current="2.8 6|3.08"/>4943 <Version initial="2.60|3.06" current="2.87|3.08"/> 4944 4944 <Content> 4945 4945 <Comment> … … 4992 4992 <Text id="gems-1">Editing metadata sets</Text> 4993 4993 </Title> 4994 <Version initial="2.70w|3.06" current="2.8 6|3.08"/>4994 <Version initial="2.70w|3.06" current="2.87|3.08"/> 4995 4995 <Content> 4996 4996 <Text id="gems-2">GEMS (Greenstone Editor for Metadata Sets) can be used to modify existing metadata sets or create new ones. GEMS is launched from the Librarian Interface when you want to create a new metadata set, or edit an existing one. In this exercise, we run GEMS outside of the Librarian Interface.</Text> … … 5000 5000 <NumberedItem> 5001 5001 <Text id="gems-4">Start the Greenstone Editor for Metadata Sets (GEMS)</Text> 5002 <Text id="gems-5"><MajorVersion number="2"><Menu>Start → All Programs → Greenstone-2.8 6→ Metadata Set Editor (GEMS)</Menu></MajorVersion><MajorVersion number="3"><Menu>Start → All Programs → Greenstone-3.08 → Greenstone Editor for Metadata Sets (GEMS)</Menu></MajorVersion></Text>5002 <Text id="gems-5"><MajorVersion number="2"><Menu>Start → All Programs → Greenstone-2.87 → Metadata Set Editor (GEMS)</Menu></MajorVersion><MajorVersion number="3"><Menu>Start → All Programs → Greenstone-3.08 → Greenstone Editor for Metadata Sets (GEMS)</Menu></MajorVersion></Text> 5003 5003 <Text id="gems-5a">(If you're on Linux, use a terminal to run the <Command>gli/gems.sh</Command> start-up script.) </Text> 5004 5004 </NumberedItem> … … 5034 5034 </Title> 5035 5035 <MajorVersion number="2"><SampleFiles folder="demo"/></MajorVersion> 5036 <Version initial="2.70w|3.06" current="2.8 6|3.08"/>5036 <Version initial="2.70w|3.06" current="2.87|3.08"/> 5037 5037 <Content> 5038 5038 <Text id="indexers-2">Greenstone supports three indexers <b>MG</b>, <b>MGPP</b> and <b>Lucene</b>. </Text> … … 5214 5214 <SampleFiles folder="demo_NewFiles"/> 5215 5215 <Prerequisite id="indexers"/> 5216 <Version initial="2.71" current="2.8 6"/>5216 <Version initial="2.71" current="2.87"/> 5217 5217 <Content> 5218 5218 <Text id="depositor-2">Collections built with the <i>Lucene</i> indexer support incremental addition, updates, and deletion of documents and metadata. By default, the <b>import</b> and <b>build</b> processes delete old index files in the <b>index</b> directory and intermediate files in the <b>archives</b> directory. With incremental building, the <b>import</b> and <b>build</b> process will keep the old files and only process the new or modified ones.</Text> … … 5226 5226 <Text id="depositor-7">Enabling <AutoText key="coredm::_depositor:textdepositor_"/></Text> 5227 5227 </Heading> 5228 <Text id="depositor-8">For Windows users, first make sure that you are using a Web Server (e.g. Apache) instead of the Local Library Server. The binary installation of Greenstone will install Apache, but by default the Local Library Server will be used. To switch to using Apache, <AutoText text="rename"/> the <Path>GSDLHOME → server.exe</Path> file to something else. Then re-run the Greenstone Server, from the <Path>Start → Greenstone Server</Path> menu followed by pressing its <b>Enter Library</b> button.</Text>5228 <Text id="depositor-8">For Windows users, first make sure that you are using a Web Server (e.g. Apache) instead of the Local Library Server. The binary installation of Greenstone will install Apache, but by default the Local Library Server will be used. To switch to using Apache, <AutoText text="rename"/> the <Path>GSDLHOME → server.exe</Path> file to something else. Then re-run the Greenstone Server, from the <Path>Start → Greenstone Server</Path> menu if on Windows, followed by pressing its <b>Enter Library</b> button. (On unix systems, run <Format>./gs2-server.sh</Format> from Greenstone 2's installed location to start up the Greenstone server.)</Text> 5229 5229 <Text id="depositor-access">Note: You might need to set permissions for the <Path>GSDLHOME → tmp</Path> and <Path>GSDLHOME → collect</Path> or <Path>GSDLHOME → collect → your_accessible_collection</Path> directory.</Text> 5230 5230 <Text id="depositor-enable">In Greenstone, <AutoText key="coredm::_depositor:textdepositor_"/> is disabled by default. To enable it, edit the file <Path>GSDLHOME → etc → main.cfg</Path>. Look for the "depositor" line, and change <i>disabled</i> to <i>enabled</i>. Then save and close the file.</Text> … … 5268 5268 <Text id="depositor-meta3">In the <AutoText key="coredm::_Global:textSubject_"/> field, type: </Text> 5269 5269 <Format>Communication, Information and Documentation|Records and Archives Management Programme (RAMP) of UNESCO, Archive Management</Format> 5270 <Text id="depositor-meta4">In <AutoText key="coredm::_Global:textKeyword_"/> field, type: </Text>5270 <Text id="depositor-meta4">In the <AutoText key="coredm::_Global:textKeyword_"/> field, type: </Text> 5271 5271 <Format>manage records and archives</Format> 5272 5272 <Text id="depositor-meta5">Finally in the <AutoText key="coredm::_Global:textLanguage_"/> field, type: <Format>English</Format></Text> … … 5276 5276 </NumberedItem> 5277 5277 <NumberedItem> 5278 <Text id="depositor-15">Click the <AutoText key="auxdm::_depositor:textbild_"/> button and wait for the process to finish. You will see the < AutoText key="auxdm::_wizard:textbildsuc_"/> message if the collection has been built successfullyor error messages if something has gone wrong. </Text>5278 <Text id="depositor-15">Click the <AutoText key="auxdm::_depositor:textbild_"/> button and wait for the process to finish. You will see the <i><AutoText key="auxdm::_wizard:textbildsuc_"/></i> message if the collection has been built successfully, or error messages if something has gone wrong. </Text> 5279 5279 </NumberedItem> 5280 5280 <NumberedItem>
Note:
See TracChangeset
for help on using the changeset viewer.
