Ignore:
Timestamp:
2006-11-15T10:58:19+13:00 (17 years ago)
Author:
kjdon
Message:

upgraded the OAI downloading exercise - now it uses GLI as well as command line building

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/gsdl-documentation/tutorials/xml-source/tutorial_en.xml

    r13250 r13265  
    29652965<Content>
    29662966<Comment>
    2967 <Text id="0734">The previous exercise did not obtain the data from an external OAI-PMH server. This missing step is accomplished by running a command-line program. To do this, your computer must have a direct connection to the Internet&mdash;being behind a firewall may interfere with the ability to download the information. Note, this can now be done through the <AutoText key="glidict::GUI.Download"/> panel in the Librarian Interface.</Text>
    2968 </Comment>
    2969 <NumberedItem>
    2970 <Text id="0735"><b>Save</b> your collection. Note its directory name, which should be <i>oaiservi</i> (it appears in the title bar of the Librarian Interface), and <b>quit</b> the Librarian Interface.</Text>
     2967<Text id="0734">The previous exercise did not obtain the data from an external OAI-PMH server. This missing step is accomplished either by running a command-line program or by using the <AutoText key="glidict::GUI.Download"/> panel in the Librarian Interface. This exercise shows you how to do this using both methods.</Text>
     2968</Comment>
     2969<Heading>
     2970<Text id="oai-1">Downloading using the Librarian Interface</Text>
     2971</Heading>
     2972<NumberedItem>
     2973<Text id="oai-2">In the Librarian Interface, switch to the <AutoText key="glidict::GUI.Download"/> panel. Select <AutoText key="glidict::DOWNLOAD.MODE.OAIDownload"/> from the list of download types on the left hand side.</Text>
     2974</NumberedItem>
     2975<NumberedItem>
     2976<Text id="oai-3">In the <AutoText text="url"/> box, type in the following URL:</Text>
     2977<Link>http://rocky.dlib.vt.edu/~jcdlpix/cgi-bin/OAI/jcdlpix.pl</Link>
     2978</NumberedItem>
     2979<NumberedItem>
     2980<Text id="oai-4">We want to download the documents as well as the metadata, so tick the <AutoText text="get_doc"/> checkbox.</Text>
     2981</NumberedItem>
     2982<NumberedItem>
     2983<Text id="oai-5">If your computer is behind a firewall or proxy server, you will need to edit the proxy settings in the Librarian Interface. Click the <AutoText key="glidict::Mirroring.Preferences" type="button"/> button. Switch on the <AutoText key="glidict::Preferences.Connection.Use_Proxy"/> checkbox. Enter the proxy server address and port number in the <AutoText key="glidict::Preferences.Connection.Proxy_Host"/> and <AutoText key="glidict::Preferences.Connection.Proxy_Port"/> boxes. Click <AutoText key="glidict::General.OK" type="button"/>.</Text>
     2984</NumberedItem>
     2985<NumberedItem>
     2986<Text id="oai-7">Now click <AutoText key="glidict::Mirroring.Download" type="button"/>. If you have set proxy information in <AutoText key="glidict::Menu.File_Options"/>, a popup will ask for your user name and password. Once the download has started, a progress bar appears in the lower half of the panel that reports on how the downloading process is doing.</Text>
     2987</NumberedItem>
     2988<NumberedItem>
     2989<Text id="oai-8">Downloaded files are stored in a top-level folder called <AutoText key="glidict::Tree.DownloadedFiles"/> that appears on the left-hand side of the <AutoText key="glidict::GUI.Gather"/> panel. These can files can then be added to a collection.</Text>
     2990</NumberedItem>
     2991<Heading>
     2992<Text id="oai-9">Downloading using the command line</Text>
     2993</Heading>
     2994<Comment>
     2995<Text id="oai-10">For command line downloading to work, your computer must have a direct connection to the Internet&mdash;being behind a firewall may interfere with the ability to download the information. You will need to use the Librarian Interface for downloading if you are behind a firewall.</Text>
     2996</Comment>
     2997<NumberedItem>
     2998<Text id="oai-11">Close the Librarian Interface.</Text>
     2999<Text id="oai-12">We will work with the OAI collection used in exercise <TutorialRef id="OAI_collection"/>. You may have noticed that its internal name is <AutoText text="oaiservi"/>.</Text>
    29713000</NumberedItem>
    29723001<NumberedItem>
    29733002<Text id="0736">In a text editor (e.g. WordPad), open the collection's configuration file, which is in <Path>Greenstone &rarr; collect &rarr; oaiservi &rarr; etc &rarr; collect.cfg</Path>. Add the following line (all on one line):</Text>
    2974 <Command>acquire OAI -src rocky.dlib.vt.edu/~jcdlpix/cgi-bin/OAI1.1/jcdlpix.pl -getdoc</Command>
     3003<Command>acquire OAI -src http://rocky.dlib.vt.edu/~jcdlpix/cgi-bin/OAI/jcdlpix.pl -getdoc</Command>
    29753004<Text id="0737">Although the position of this line is not critical, we recommend that you place it near the beginning of the file, after the public and creator lines but before the index line. Save the file and quit the editor.</Text>
    29763005</NumberedItem>
Note: See TracChangeset for help on using the changeset viewer.