Changeset 37863 for documentation/trunk


Ignore:
Timestamp:
2023-08-01T18:50:33+12:00 (9 months ago)
Author:
anupama
Message:
  1. Thanks to Ying-yu for discovering the latest JQuery UI themeroller needs updates to instructions (yet again). These changed instructions being committed appear to work for the CollectionTheme tutorial and thus would apply to the TutorialTheme tutorial as well. 2. Changed current year and current GS3 version.
File:
1 edited

Legend:

Unmodified
Added
Removed
  • documentation/trunk/tutorials/xml-source/tutorial_en.xml

    r37768 r37863  
    88<TutorialList>
    99<Title>
    10 <Text id="0001">Greenstone tutorial exercises (2019)</Text>
     10<Text id="0001">Greenstone tutorial exercises (2023)</Text>
    1111</Title>
    1212<MajorVersion number="2"><Version current="2.87"/></MajorVersion>
    13 <MajorVersion number="3"><Version current="3.10"/></MajorVersion>
     13<MajorVersion number="3"><Version current="3.11"/></MajorVersion>
    1414<SupplementaryText>
    1515<Text id="title">Greenstone tutorial exercise</Text>
     
    508508</Title>
    509509<SampleFiles folder="simple_html"/>
    510 <Version initial="2.60|3.06" current="2.87|3.10"/>
     510<Version initial="2.60|3.06" current="2.87|3.11"/>
    511511<Content>
    512512<Comment>
     
    525525  <MajorVersion number="3">
    526526    <Menu>
    527       <Text id="0255c">Start &rarr; All Programs &rarr; Greenstone-3.10 &rarr; Greenstone Librarian Interface (GLI)</Text>
     527      <Text id="0255c">Start &rarr; All Programs &rarr; Greenstone-3.11 &rarr; Greenstone Librarian Interface (GLI)</Text>
    528528    </Menu>
    529529  </MajorVersion>
     
    628628</Title>
    629629<SampleFiles folder="images"/>
    630 <Version initial="2.60|3.06" current="2.87|3.10"/>
     630<Version initial="2.60|3.06" current="2.87|3.11"/>
    631631<Content>
    632632<Comment>
     
    783783<SampleFiles folder="images_gps"/>
    784784<Prerequisite id="simple_image_collection"/>
    785 <Version initial="3.06" current="3.10"/>
     785<Version initial="3.06" current="3.11"/>
    786786<Content>
    787787<Comment>
     
    886886</Title>
    887887<SampleFiles folder="Word_and_PDF"/>
    888 <Version initial="2.60|3.06" current="2.87|3.10"/>
     888<Version initial="2.60|3.06" current="2.87|3.11"/>
    889889<Content>
    890890<Comment>
     
    10001000</Title>
    10011001<Prerequisite id="word_pdf_collection"/>
    1002 <Version initial="2.70w|3.06" current="2.87|3.10"/>
     1002<Version initial="2.70w|3.06" current="2.87|3.11"/>
    10031003<Content>
    10041004<Comment>
     
    15291529</Title>
    15301530<SampleFiles folder="Word_and_PDF"/>
    1531 <Version initial="3.09" current="3.10"/>
     1531<Version initial="3.09" current="3.11"/>
    15321532<Content>
    15331533  <Comment><Text id="ep-2">Prior to Greenstone 3.09, Greenstone shipped with a plugin called <AutoText text="PDFPlugin"/>. It was the plugin Greenstone used to convert PDF files to HTML using the third-party software <AutoText text="pdftohtml.pl" type="italics"/>. PDFPlugin allowed users to view PDF documents even if they didn't have the PDF software installed. Unfortunately, sometimes the formatting of the resulting HTML files was not so good. Earlier versions of this tutorial would provide some instruction on extra options to the PDFPlugin for producing a nicer version for display. The older pdftohtml process could however not cope with much newer versions of PDF unless PDFPlugin's <Format>pdfbox_conversion</Format> option was switched on.</Text>
     
    17511751<Text id="ew-a">Enhanced Word document handling</Text>
    17521752</Title>
    1753 <Version initial="2.70w|3.06" current="2.87|3.10"/>
     1753<Version initial="2.70w|3.06" current="2.87|3.11"/>
    17541754<Prerequisite id="word_pdf_collection"/>
    17551755<Content>
     
    18881888</Title>
    18891889<Prerequisite id="word_pdf_collection"/>
    1890 <Version initial="2.85|3.06" current="2.87|3.10"/>
     1890<Version initial="2.85|3.06" current="2.87|3.11"/>
    18911891<Content>
    18921892<Comment>
     
    21312131</Title>
    21322132<SampleFiles folder="tudor"/>
    2133 <Version initial="2.60|3.06" current="2.87|3.10"/>
     2133<Version initial="2.60|3.06" current="2.87|3.11"/>
    21342134<Content>
    21352135<Comment>
     
    21922192</Title>
    21932193<Prerequisite id="large_html_collection"/>
    2194 <Version initial="2.60|3.06" current="2.87|3.10"/>
     2194<Version initial="2.60|3.06" current="2.87|3.11"/>
    21952195<Content>
    21962196<Comment>
     
    23032303</Title>
    23042304<Prerequisite id="large_html_collection"/>
    2305 <Version initial="2.60|3.06" current="2.87|3.10"/>
     2305<Version initial="2.60|3.06" current="2.87|3.11"/>
    23062306<Content>
    23072307<NumberedItem>
     
    26142614<Text id="st-1">Section tagging for HTML documents</Text>
    26152615</Title>
    2616 <Version initial="2.70w|3.06" current="2.87|3.10"/>
     2616<Version initial="2.70w|3.06" current="2.87|3.11"/>
    26172617<Content>
    26182618<NumberedItem>
     
    26892689<Text id="0411">Downloading files from the web</Text>
    26902690</Title>
    2691 <Version initial="2.60|3.06" current="2.87|3.10"/>
     2691<Version initial="2.60|3.06" current="2.87|3.11"/>
    26922692<Content>
    26932693<Comment>
     
    27342734</Title>
    27352735<Prerequisite id="downloading_from_internet"/>
    2736 <Version initial="2.60|3.06" current="2.87|3.10"/>
     2736<Version initial="2.60|3.06" current="2.87|3.11"/>
    27372737<Content>
    27382738<NumberedItem>
     
    27862786</Title>
    27872787<SampleFiles folder="marc"/>
    2788 <Version initial="2.60|3.06" current="2.87|3.10"/>
     2788<Version initial="2.60|3.06" current="2.87|3.11"/>
    27892789<Content>
    27902790<Comment>
     
    30693069</Title>
    30703070<SampleFiles folder="isis"/>
    3071 <Version initial="2.70w|3.06" current="2.87|3.10"/>
     3071<Version initial="2.70w|3.06" current="2.87|3.11"/>
    30723072<Content>
    30733073<Comment>
     
    34083408</Title>
    34093409<SampleFiles folder="beatles"/>
    3410 <Version initial="2.60|3.06" current="2.87|3.10"/>
     3410<Version initial="2.60|3.06" current="2.87|3.11"/>
    34113411<Content>
    34123412<NumberedItem>
     
    34623462<Prerequisite id="multimedia_collection_explore"/>
    34633463<SampleFiles folder="beatles"/>
    3464 <Version initial="2.60|3.06" current="2.87|3.10"/>
     3464<Version initial="2.60|3.06" current="2.87|3.11"/>
    34653465<Content>
    34663466<Comment>
     
    40044004</Title>
    40054005<SampleFiles folder="niupepa"/>
    4006 <Version initial="2.60|3.06" current="2.87|3.10"/>
     4006<Version initial="2.60|3.06" current="2.87|3.11"/>
    40074007<Content>
    40084008<Comment>
     
    43494349<SampleFiles folder="niupepa"/>
    43504350<Prerequisite id="scanned_image_collection"/>
    4351 <Version initial="2.70|3.06" current="2.87|3.10"/>
     4351<Version initial="2.70|3.06" current="2.87|3.11"/>
    43524352<Content>
    43534353<Comment>
     
    44804480</Title>
    44814481<SampleFiles folder="oai"/>
    4482 <Version initial="2.60|3.06" current="2.87|3.10"/>
     4482<Version initial="2.60|3.06" current="2.87|3.11"/>
    44834483<Content>
    44844484<Comment>
     
    46704670</Title>
    46714671<Prerequisite id="simple_image_collection"/>
    4672 <Version initial="2.85|3.06" current="2.87|3.10"/>
     4672<Version initial="2.85|3.06" current="2.87|3.11"/>
    46734673<Content>
    46744674<Comment>
     
    48074807</Title>
    48084808<Prerequisite id="GS_OAI_server"/>
    4809 <Version initial="2.60|3.06" current="2.87|3.10"/>
     4809<Version initial="2.60|3.06" current="2.87|3.11"/>
    48104810<Content>
    48114811<Comment>
     
    49374937</Title>
    49384938<!--<SampleFiles folder="pdfbox"/>-->
    4939 <Version initial="2.88|3.09" current="2.87|3.10"/>
     4939<Version initial="2.88|3.09" current="2.87|3.11"/>
    49404940<Content>
    49414941<Comment><Text id="ucp-02">This is an advanced tutorial, in that it not only supposes you have familiarised yourself with most of what you've learned in preceding tutorials, but that you're also comfortable with downloading and installing software from the web, and have a little familiarity with using image editing software.</Text></Comment>
     
    52325232</Title>
    52335233<Prerequisite id="dspace_to_greenstone"/>
    5234 <Version initial="2.60|3.06" current="2.87|3.10"/>
     5234<Version initial="2.60|3.06" current="2.87|3.11"/>
    52355235<Content>
    52365236<Comment>
     
    52835283<Text id="gems-1">Editing metadata sets</Text>
    52845284</Title>
    5285 <Version initial="2.70w|3.06" current="2.87|3.10"/>
     5285<Version initial="2.70w|3.06" current="2.87|3.11"/>
    52865286<Content>
    52875287<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>
     
    52915291<NumberedItem>
    52925292<Text id="gems-4">Start the Greenstone Editor for Metadata Sets (GEMS)</Text>
    5293 <Text id="gems-5"><MajorVersion number="2"><Menu>Start &rarr; All Programs &rarr; Greenstone-2.87 &rarr; Metadata Set Editor (GEMS)</Menu></MajorVersion><MajorVersion number="3"><Menu>Start &rarr; All Programs &rarr; Greenstone-3.10 &rarr; Greenstone Editor for Metadata Sets (GEMS)</Menu></MajorVersion></Text>
     5293<Text id="gems-5"><MajorVersion number="2"><Menu>Start &rarr; All Programs &rarr; Greenstone-2.87 &rarr; Metadata Set Editor (GEMS)</Menu></MajorVersion><MajorVersion number="3"><Menu>Start &rarr; All Programs &rarr; Greenstone-3.11 &rarr; Greenstone Editor for Metadata Sets (GEMS)</Menu></MajorVersion></Text>
    52945294<Text id="gems-5a">(If you're on a Unix system, use a terminal to run the <Command>gli/gems.sh</Command> start-up script. On a Mac, you can also double-click on the green <Format>gems</Format> application icon that's located in your Greenstone installation folder in order to launch GEMS.) </Text>
    52955295</NumberedItem>
     
    53255325</Title>
    53265326<MajorVersion number="2"><SampleFiles folder="demo"/></MajorVersion>
    5327 <Version initial="2.70w|3.06" current="2.87|3.10"/>
     5327<Version initial="2.70w|3.06" current="2.87|3.11"/>
    53285328<Content>
    53295329<Text id="indexers-2">Greenstone supports three indexers <b>MG</b>, <b>MGPP</b> and <b>Lucene</b>.</Text>
     
    55985598<SampleFiles folder="incr_build"/>
    55995599<Prerequisite id="indexers"/>
    5600 <Version initial="3.08" current="3.10"/>
     5600<Version initial="3.08" current="3.11"/>
    56015601<Content>
    56025602<Text id="ic-00">To allow you to quickly try out and experiment with our tutorial exercises, we tend to keep the number of sample files small. Every time you rebuild these collections, for simplicity, the default settings used in Greenstone mean that the previous version built is removed in its entirety. We refer to this as a <i>full-rebuild</i>. When building larger collections, this is inefficient.</Text>
     
    58115811</Title>
    58125812<SampleFiles folder="custom"/>
    5813 <Version initial="3.05" current="3.10"/>
     5813<Version initial="3.05" current="3.11"/>
    58145814<Content>
    58155815<Comment>
     
    58205820</Heading>
    58215821<NumberedItem>
    5822 <Text id="themes-3">Enter your Greenstone Library. ( Go to <Path>Start &rarr; All Programs &rarr; Greenstone-3.10 &rarr; Greenstone3 Server</Path> and click <AutoText text="Enter Library"/>.)</Text>
     5822<Text id="themes-3">Enter your Greenstone Library. ( Go to <Path>Start &rarr; All Programs &rarr; Greenstone-3.11 &rarr; Greenstone3 Server</Path> and click <AutoText text="Enter Library"/>.)</Text>
    58235823</NumberedItem>
    58245824<NumberedItem>
     
    58925892</NumberedItem>
    58935893<NumberedItem>
    5894   <Text id="themes-14">Click the <AutoText text="Download theme"/> button. <!--Ensure the Stable version of jQuery is selected.--> Select "<i>1.11.4 (Legacy, for jQuery1.6+)</i>". Under <AutoText text="Components"/> uncheck <AutoText text="Toggle All" type="italics"/>, which will uncheck all of the boxes. Under <AutoText text="UI Core"/> check <AutoText text="jQuery 1.8+ Support" type="italics"/>, and under <AutoText text="Widgets"/> check <AutoText text="Datepicker" type="italics"/>. At the bottom of the page, under <AutoText text="Theme"/>, <AutoText text="Custom Theme" type="italics"/> should be selected. (If there's an option to provide a <AutoText text="Theme Folder Name"/>, enter <AutoText text="TutorialTheme" type="italics"/>.) Leave <AutoText text="CSS Scope"/> blank. Click <AutoText text="Download"/>. In the pop-up window, select <AutoText text="Save File"/> and click <AutoText text="OK"/> to download the zip file.</Text>
     5894<!--<Text id="themes-14">Click the <AutoText text="Download theme"/> button. Select "<i>1.11.4 (Legacy, for jQuery1.6+)</i>". Under <AutoText text="Components"/> uncheck <AutoText text="Toggle All" type="italics"/>, which will uncheck all of the boxes. Under <AutoText text="UI Core"/> check <AutoText text="jQuery 1.8+ Support" type="italics"/>, and under <AutoText text="Widgets"/> check <AutoText text="Datepicker" type="italics"/>. At the bottom of the page, under <AutoText text="Theme"/>, <AutoText text="Custom Theme" type="italics"/> should be selected. (If there's an option to provide a <AutoText text="Theme Folder Name"/>, enter <AutoText text="TutorialTheme" type="italics"/>.) Leave <AutoText text="CSS Scope"/> blank. Click <AutoText text="Download"/>. In the pop-up window, select <AutoText text="Save File"/> and click <AutoText text="OK"/> to download the zip file.</Text>-->
     5895  <Text id="themes-14">Click the <AutoText text="Download theme"/> button. <!--Ensure the Stable version of jQuery is selected.--> Select "<i>1.13.2 (Stable, for jQuery1.8+)</i>". Under <AutoText text="Components"/> uncheck <AutoText text="Toggle All" type="italics"/>, which will uncheck all of the boxes. Under <AutoText text="UI Core"/> check <AutoText text="jQuery 1.8+ Support" type="italics"/> and <AutoText text="Keycode" type="italics"/>, and under <AutoText text="Widgets"/> check <AutoText text="Datepicker" type="italics"/>. At the bottom of the page, under <AutoText text="Theme"/>, <AutoText text="Custom Theme" type="italics"/> should be selected. (If there's an option to provide a <AutoText text="Theme Folder Name"/>, enter <AutoText text="TutorialTheme" type="italics"/>.) Leave <AutoText text="CSS Scope"/> blank. Click <AutoText text="Download"/>. In the pop-up window, select <AutoText text="Save File"/> and click <AutoText text="OK"/> to download the zip file.</Text>
    58955896  <Text id="themes-14a">If you're unable to download the theme you've created, then we have prepared a zip file in advance containing the same ThemeRoller theme: <Path>sample_files &rarr; downloads &rarr; TutorialTheme2019.zip.</Path> After extracting, in the following instructions, work with the folder "TutorialTheme" <i>inside</i> any <Format>TutorialTheme2019</Format> folder.</Text>
    58965897</NumberedItem>
     
    59425943<SampleFiles folder="custom"/>
    59435944<Prerequisite id="using_themes"/>
    5944 <Version initial="3.05" current="3.10"/>
     5945<Version initial="3.05" current="3.11"/>
    59455946<Content>
    59465947<Comment>
     
    59885989</NumberedItem>
    59895990<NumberedItem>
    5990   <Text id="customize-04">Click the <AutoText text="Download theme"/> button. <!--Ensure the Stable version of jQuery is selected.--> Select "<i>1.11.4 (Legacy, for jQuery1.6+)</i>". Under <AutoText text="Components"/> uncheck <AutoText text="Toggle All" type="italics"/>, which will uncheck all of the boxes. Under <AutoText text="UI Core"/> check <AutoText text="jQuery 1.8+ Support" type="italics"/>, and under <AutoText text="Widgets"/> check <AutoText text="Datepicker" type="italics"/>. At the bottom of the page, under <AutoText text="Theme"/>, <AutoText text="Custom Theme" type="italics"/> should be selected. (If there's an option to provide a <AutoText text="Theme Folder Name"/>, enter <AutoText text="CollectionTheme" type="italics"/>.) Leave <AutoText text="CSS Scope"/> blank. Click <AutoText text="Download"/>. In the pop-up window, select <AutoText text="Save File"/> and click <AutoText text="OK"/> to download the zip file.</Text>
     5991  <!--<Text id="customize-04">Click the <AutoText text="Download theme"/> button. Select "<i>1.11.4 (Legacy, for jQuery1.6+)</i>". Under <AutoText text="Components"/> uncheck <AutoText text="Toggle All" type="italics"/>, which will uncheck all of the boxes. Under <AutoText text="UI Core"/> check <AutoText text="jQuery 1.8+ Support" type="italics"/>, and under <AutoText text="Widgets"/> check <AutoText text="Datepicker" type="italics"/>. At the bottom of the page, under <AutoText text="Theme"/>, <AutoText text="Custom Theme" type="italics"/> should be selected. (If there's an option to provide a <AutoText text="Theme Folder Name"/>, enter <AutoText text="CollectionTheme" type="italics"/>.) Leave <AutoText text="CSS Scope"/> blank. Click <AutoText text="Download"/>. In the pop-up window, select <AutoText text="Save File"/> and click <AutoText text="OK"/> to download the zip file.</Text>-->
     5992<Text id="customize-04">Click the <AutoText text="Download theme"/> button. <!--Ensure the Stable version of jQuery is selected.--> Select "<i>1.13.2 (Stable, for jQuery1.8+)</i>". Under <AutoText text="Components"/> uncheck <AutoText text="Toggle All" type="italics"/>, which will uncheck all of the boxes. Under <AutoText text="UI Core"/> check <AutoText text="jQuery 1.8+ Support" type="italics"/> and <AutoText text="Keycode" type="italics"/>, and under <AutoText text="Widgets"/> check <AutoText text="Datepicker" type="italics"/>. At the bottom of the page, under <AutoText text="Theme"/>, <AutoText text="Custom Theme" type="italics"/> should be selected. (If there's an option to provide a <AutoText text="Theme Folder Name"/>, enter <AutoText text="CollectionTheme" type="italics"/>.) Leave <AutoText text="CSS Scope"/> blank. Click <AutoText text="Download"/>. In the pop-up window, select <AutoText text="Save File"/> and click <AutoText text="OK"/> to download the zip file.</Text>
    59915993<Text id="customize-04a">Once again, if you're unable to download the theme you've created, then we have also prepared a zip file containing the CollectionTheme. Get it from <Path>sample_files &rarr; downloads &rarr; CollectionTheme2019.zip</Path>. After extracting, in the following instructions, work with the folder "CollectionTheme" <i>inside</i> any <Format>CollectionTheme2019</Format> folder.</Text>
    59925994</NumberedItem>
     
    60266028</Title>
    60276029<SampleFiles folder="custom"/>
    6028 <Version initial="3.06" current="3.10"/>
     6030<Version initial="3.06" current="3.11"/>
    60296031<Content>
    60306032<Comment>
     
    60326034</Comment>
    60336035<NumberedItem>
    6034 <Text id="hp-02">Start up your Greenstone server (<Path>Start &rarr; All Programs &rarr; Greenstone3.10 &rarr; Greenstone3 Server</Path>) and click the <b>Enter Library</b> button. This will take you to your library home page, which we will be replacing with our custom home page.</Text>
     6036<Text id="hp-02">Start up your Greenstone server (<Path>Start &rarr; All Programs &rarr; Greenstone3.11 &rarr; Greenstone3 Server</Path>) and click the <b>Enter Library</b> button. This will take you to your library home page, which we will be replacing with our custom home page.</Text>
    60356037</NumberedItem>
    60366038<Heading>
     
    62636265</Title>
    62646266<SampleFiles folder="libraries"/>
    6265 <Version initial="3.06" current="3.10"/>
     6267<Version initial="3.06" current="3.11"/>
    62666268<Content>
    62676269<Comment>
     
    62766278</Heading>
    62776279<NumberedItem>
    6278 <Text id="dl-02">Start up your Greenstone server (<Path>Start &rarr; All Programs &rarr; Greenstone3.10 &rarr; Greenstone3 Server</Path>) and click the <b>Enter Library</b> button. This will take you to the default library's home page. This library uses the site called <b>localsite</b> and the interface called <b>default</b>. </Text>
     6280<Text id="dl-02">Start up your Greenstone server (<Path>Start &rarr; All Programs &rarr; Greenstone3.11 &rarr; Greenstone3 Server</Path>) and click the <b>Enter Library</b> button. This will take you to the default library's home page. This library uses the site called <b>localsite</b> and the interface called <b>default</b>. </Text>
    62796281
    62806282<Text id="dl-03">Change the url from <i>http://localhost:8383/greenstone3/library</i> to <i>http://localhost:8383/greenstone3/halftone-library</i> and reload the page. This is another library that is defined by Greenstone3. Again, the site it uses is <b>localsite</b>, but this library (called <b>halftone-library</b>) uses the <b>halftone</b> interface, which is based on the Greenstone2 layout. Let's take a look at where these libraries are defined.</Text>
     
    64416443</Title>
    64426444<SampleFiles folder="interfaces"/>
    6443 <Version initial="3.06" current="3.10"/>
     6445<Version initial="3.06" current="3.11"/>
    64446446<Content>
    64456447<Comment>
     
    65626564<SampleFiles folder="interfaces"/>
    65636565<Prerequisite id="new_interface1"/>
    6564 <Version initial="3.06" current="3.10"/>
     6566<Version initial="3.06" current="3.11"/>
    65656567<Content>
    65666568<Comment>
     
    67666768<SampleFiles folder="interfaces"/>
    67676769<Prerequisite id="new_interface2"/>
    6768 <Version initial="3.06" current="3.10"/>
     6770<Version initial="3.06" current="3.11"/>
    67696771<Content>
    67706772<Comment>
Note: See TracChangeset for help on using the changeset viewer.