Changeset 30205 for documentation/trunk

Show
Ignore:
Timestamp:
07.09.2015 17:38:31 (4 years ago)
Author:
davidb
Message:

Updated version of the Images-GPS tutorial

Files:
1 modified

Legend:

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

    r30195 r30205  
    778778</NumberedItem> 
    779779<NumberedItem> 
    780 <Text id="images-gps-1a">Since the images are organised by folder, we can easily assign <i>folder-level</i> metadata to the images which will help with classifying them. In the <b>Enrich</b> panel, select the eiffel-tower folder, and in its <b>dc.Title</b> field type <i>Eiffel Tower</i>. Since this metadata is assigned at folder level, it is inherited as <b>dc.Title</b> metadata by all the images in the folder. Now select each of the remaining folders in turn, and assign the appropriate values for their <b>dc.Title</b>: <i>Musée d'Orsay</i>, <i>Parc de Luxembourg</i> and <i>Panthéon district</i>, respectively.</Text> 
    781 </NumberedItem> 
    782 <NumberedItem> 
    783 <Text id="images-gps-2">In the <b>Document Plugins</b> section of the <b>Design</b> panel, go down to the <b>select plugin to add</b> and choose the <b>EmbeddedMetadataPlugin</b>. Press the <b>Add Plugin</b> button, and then click <b>OK</b> to add it to the plugin list. Select this plugin in the list, then use the <b>Move Up</b> button to shift it upwards until it comes just after the GreenstoneXMLPlugin.</Text> 
    784 </NumberedItem> 
    785 <NumberedItem> 
    786 <Text id="images-gps-3">Now go to the <b>Create</b> panel and press <b>Build Collection</b>.</Text> 
    787 </NumberedItem> 
    788 <NumberedItem> 
    789 <Text id="images-gps-4">Preview the collection and click the <b>Titles</b> tab. This is what an image collection looks like by default. However, these images have embedded GPS metadata, and we can use this extracted GPS metadata to display these images more meaningfully. In the <b>Enrich</b> panel, expand the <b>eiffel-tower</b> folder and select the first image. Scroll down to see the metadata extracted during the building process. Among the extracted metadta, you will find several pieces of Latitude and Longitude metadata, which we will be taking advantage of: ex.LatShort, ex.Latitude, ex.LngShort and ex.Longitude. Greenstone has a map view that can make use of this location metadata to present the images.</Text> 
    790 </NumberedItem> 
    791 <NumberedItem> 
    792 <Text id="images-gps-6">In the <b>Search Indexes</b> section of the <b>Design</b> panel, press the <b>New Index...</b> button. Scroll down and tick the boxes for <b>ex.LatShort</b>, <b>ex.Latitude</b>, <b>ex.LngShort</b> and <b>ex.Longitude</b> and press <b>Add Index</b> to create an index on all these 4 pieces of metadata.</Text>  
    793 </NumberedItem> 
    794 <NumberedItem> 
    795 <Text id="images-gps-7">In the <b>Browsing Classifiers</b> section, choose <b>AZCompactList</b> from the <b>select classifier to add</b> dropdown box and press <b>Add Classifier...</b>. In the configuration dialog that appears, set the metadata field to <b>dc.Title</b> and set the buttonname field to <Format>location</Format>. This will create a classifier labelled <Format>location</Format> that groups all images under Eiffel Tower into one bookshelf and similarly creates bookshelves for the other 3 categories.</Text>  
    796 </NumberedItem> 
    797 <NumberedItem> 
    798 <Text id="images-gps-8">To enable the map, go to the <b>Format Features</b> section of the <b>Format</b> panel, and select the <b>browse</b> format feature. In the editor below, enter the following format statement <i>above</i> the documentNode template:</Text> 
     780  <Text id="images-gps-1a">Since the images are organised by folder, we can easily assign <i>folder-level</i> metadata to the images which will help with classifying them. In the <b>Enrich</b> panel, select the <Path>eiffel-tower</Path> folder, and in its <b>dc.Title</b> field type <i>Eiffel Tower</i>. Since this metadata is assigned at folder level, it is inherited as <b>dc.Title</b> metadata by all the images in the folder.</Text> 
     781  <Text id="images-gps-1b">When setting folder-level metadata like this, the default setting in GLI is to produce a popup window alerting you to the fact that the assigned metadata will be assigned 
     782  to all files and sub-folders contained in the selected folder.  For this collection, this is what we want, so press <i>OK</i> for the action to proceed.</Text> 
     783  <Text id="images-gps-1c">Note: if you prefer this popup not to appear each time you assign folder-level metadata, there is a tick-box in the lower left-hand corner of the popup window (&quot;do not show this warning again&quot;) that allows you to control this.  If you choose to supress the popup, then it can be turned back on through <Path>File &rarr; Preferences</Path> and then clicking on the <i>Warnings</i> tab.  The various options are alphabetically sorted, with the option that controls this popup: &quot;About to add folder level metadata&quot;.</Text> 
     784</NumberedItem> 
     785<NumberedItem>   
     786  <Text id="images-gps-2">Now select each of the remaining folders of images in turn, and assign the appropriate values for their <b>dc.Title</b>: <i>Musée d'Orsay</i>, <i>Parc de Luxembourg</i> and <i>Panthéon district</i>, respectively.</Text> 
     787</NumberedItem> 
     788<NumberedItem> 
     789<Text id="images-gps-3">In the <b>Browsing Classifiers</b> section, choose <b>AZCompactList</b> from the <b>select classifier to add</b> dropdown box and press <b>Add Classifier...</b>. In the configuration dialog that appears, set the metadata field to <b>dc.Title</b> and set the buttonname field to <Format>location</Format>. This will create a classifier labelled <Format>location</Format> that groups all images under Eiffel Tower into one bookshelf and similarly creates bookshelves for the other 3 categories.</Text>  
     790</NumberedItem> 
     791<NumberedItem> 
     792<Text id="images-gps-4">Now go to the <b>Create</b> panel and press <b>Build Collection</b>.</Text> 
     793</NumberedItem> 
     794<NumberedItem> 
     795<Text id="images-gps-5">Preview the collection and click the <b>Locations</b> tab in the web browser. Expand the bookshelf icons displayed in the web browser to see thumbnail pictures of the photos gathered under the displayed metadata heading. Explore further, and click on a thumbnail photos or two to view larger versions of the photos in the document view.</Text> 
     796</NumberedItem> 
     797 
     798<Heading> 
     799<Text id="0350gpsa">Extracting embedded metadata</Text> 
     800</Heading> 
     801<NumberedItem> 
     802  <Text id="images-gps-6"> 
     803  Each of these image files has metadata embedded in it&mdash;including GPS data&mdash;generated by the smartphone when the photo was taken. We can extract this metadata when the collection is built, and in particular, make use of the GPS metadata to provide map-based views of the collection to the user.</Text> 
     804 
     805  <Text id="images-gps7">In the <b>Document Plugins</b> section of the <b>Design</b> panel, go down to the <b>select plugin to add</b> and choose the <b>EmbeddedMetadataPlugin</b>. Press the <b>Add Plugin</b> button, and then click <b>OK</b> to add it to the plugin list. Select this plugin in the list, then use the <b>Move Up</b> button to shift it upwards until it comes just after the GreenstoneXMLPlugin.</Text> 
     806</NumberedItem> 
     807 
     808<NumberedItem> 
     809<Text id="images-gps-8">Go to the <b>Create</b> panel and press <b>Build Collection</b>.</Text> 
     810</NumberedItem> 
     811 
     812<NumberedItem> 
     813  <Text id="images-gps-9">Now go to the <b>Enrich</b> panel, expand the <b>eiffel-tower</b> folder and select the first image. Scroll down to see the metadata extracted during the building process. Among the extracted metadta, you will find several pieces of Latitude and Longitude metadata, which we will be taking advantage of shortly: ex.Latitude, ex.Longitude, ex.LatShort, and ex.LngShort.  </Text> 
     814</NumberedItem> 
     815   
     816<Heading> 
     817<Text id="0350gpsb">Adding in a map view to browsing</Text> 
     818</Heading> 
     819<Text id="image-gps-10"> 
     820  Greenstone has a map view, based on the Google Maps API, that can make use of this location metadata.  The map view can be controlled to appear in different parts of the interface: as part of a collection's search results page when browsing the collection, and/or when viewing a document.  For this view to be operational in a Grenstone, it is necessary for the collection to index the GPS metadata.</Text> 
     821<NumberedItem> 
     822<Text id="images-gps-11">In the <b>Search Indexes</b> section of the <b>Design</b> panel, press the <b>New Index...</b> button. Scroll down and tick the boxes for <b>ex.LatShort</b>, <b>ex.Latitude</b>, <b>ex.LngShort</b> and <b>ex.Longitude</b> and press <b>Add Index</b> to create an index on all these 4 pieces of metadata.</Text>  
     823</NumberedItem> 
     824<NumberedItem> 
     825<Text id="images-gps-12">Select <b>Search</b> on the right of the <b>Format</b> panel. For the index on the combined longitude and latitude metadata, type <i>location</i> as its display name.</Text> 
     826</NumberedItem> 
     827<NumberedItem> 
     828<Text id="images-gps-13">Now go to the <b>Create</b> panel and press <b>Build Collection</b>.</Text> 
     829</NumberedItem> 
     830<NumberedItem> 
     831<Text id="images-gps-14">To enable the map, go to the <b>Format Features</b> section of the <b>Format</b> panel, and select the <b>browse</b> format feature. In the editor below, enter the following format statement <i>above</i> the documentNode template:</Text> 
    799832<Format>&lt;gsf:option name="mapEnabled" value="true" /&gt;</Format>  
    800833</NumberedItem> 
    801834<NumberedItem> 
    802 <Text id="images-gps-9">Select <b>Search</b> on the right of the <b>Format</b> panel. For the index on the combined longitude and latitude metadata, type <i>location</i> as its display name.</Text> 
    803 </NumberedItem> 
    804 <NumberedItem> 
    805 <Text id="images-gps-10">Go to the <b>Create</b> panel and rebuild the collection. Once rebuilt, press the <b>Preview Collection</b> button, and click on the new browsing classifier. The page that opens up shows a Google map, with the locations of the images in the collection pinpointed on it. The map view can also scroll through all the images, locating each place and associated image in turn.</Text>  
    806 </NumberedItem> 
     835<Text id="images-gps-15">In the <b>Format</b> panel press the <b>Preview Collection</b> button, and click on the new browsing classifier. The page that opens up shows a Google map, with the locations of the images in the collection pinpointed on it. The map view can also scroll through all the images, locating each place and associated image in turn.</Text>  
     836</NumberedItem> 
     837<Text id="images-gps-16"> 
     838  By adding the <Format>&lt;gsf:option name="mapEnabled" value="true" /&gt;</Format> statement 
     839  to the <b>browser</b> format feature, all of the classifiers built will have the map 
     840  view enabled.  It is also possible to activiate the map view on individual classifiers, 
     841  and on the search results page by adding the <i>mapEnabled</i> statement to the <i>search</i> 
     842  format feature. 
     843</Text> 
     844 
     845<Heading> 
     846<Text id="0350gpsc">Adding in a map view to a document</Text> 
     847</Heading> 
     848  <NumberedItem> 
     849    <Text id="images-gps-17"> 
     850      To activate a map view when viewing the document, go to the <b>Format Features</b> section of the <b>Format</b> panel, and select the <b>display</b> format feature. In the editor below, enter the following format statement <i>above</i> the documentNode template: 
     851    <Format>&lt;gsf:option name="mapEnabled" value="true" /&gt;</Format> 
     852    </Text> 
     853  </NumberedItem> 
     854  <NumberedItem> 
     855    <Text id="images-gps-18">Still in the <b>Format</b> panel press the <b>Preview Collection</b> button, browsing or search to locate a document, and then view the document. The page that opens up shows a Google map, shows the location of document (where the photo was taken), in addition to the screen-sized photo.</Text> 
     856  </NumberedItem>   
    807857</Content> 
    808 </Tutorial> 
     858</Tutorial 
     859> 
    809860</MajorVersion> 
    810861<Tutorial id="word_pdf_collection">