Changeset 22914

Show
Ignore:
Timestamp:
16.09.2010 10:13:06 (9 years ago)
Author:
sjm84
Message:

More updates to the tutorials for 2.84

Files:
1 modified

Legend:

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

    r22908 r22914  
    11931193<Text id="0403">Exporting a collection to CD-ROM/DVD</Text> 
    11941194</Title> 
    1195 <Version initial="2.60" current="2.82"/> 
     1195<Version initial="2.60" current="2.84"/> 
    11961196<Content> 
    11971197<Comment> 
    1198 <Text id="0404">To publish a collection on CD-ROM or DVD, Greenstone's Export to CD-ROM export module must be installed. This is included with CD-ROM distributions, and all distributions 2.70w and later. It must be installed separately for non-CD-ROM versions of Greenstone, version 2.70 and earlier (see <TutorialRef id="install_greenstone"/>).</Text> 
     1198<Text id="0404">Greenstone collections can be published on a self-installing CD-ROM/DVD that works on Windows.</Text> 
    11991199</Comment> 
    12001200<NumberedItem> 
     
    12181218</Title> 
    12191219<SampleFiles folder="tudor"/> 
    1220 <Version initial="2.60" current="2.82"/> 
     1220<Version initial="2.60" current="2.84"/> 
    12211221<Content> 
    12221222<Comment> 
     
    12791279</Title> 
    12801280<Prerequisite id="large_html_collection"/> 
    1281 <Version initial="2.60" current="2.82"/> 
     1281<Version initial="2.60" current="2.84"/> 
    12821282<Content> 
    12831283<Comment> 
     
    13361336</NumberedItem> 
    13371337<NumberedItem> 
    1338 <Text id="0448">For versions before 2.82, this feature is disabled because you are operating in <AutoText key="glidict::Preferences.Mode.Librarian"/> mode (this is indicated in the title bar at the top of the window). Switch to <AutoText text="Library Systems Specialist"/> mode by going to <AutoText key="glidict::Menu.File_Options"/> (on the <AutoText key="glidict::Menu.File"/> menu) and clicking <AutoText key="glidict::Preferences.Mode" type="button"/>. Read about the other modes too.</Text> 
    1339 </NumberedItem> 
    1340 <NumberedItem> 
    1341 <Text id="0449">Return to the <AutoText key="glidict::CDM.GUI.Subcollections"/> section of the <AutoText key="glidict::GUI.Design"/> panel. Ensure that the <AutoText key="glidict::CDM.SubcollectionManager.Subcollection_Controls"/> tab is selected (the default). Define a subcollection filter with name <b>monarchs</b> that matches against <AutoText key="metadata::dc.Subject"/>, and type <b>Monarchs</b> as the regular expression to match with. Click <AutoText key="glidict::CDM.SubcollectionManager.Add" type="button"/>. This filter includes any file whose <AutoText key="metadata::dc.Subject"/> metadata contains the word <i>Monarchs</i>.</Text> 
     1338<Text id="0449">Ensure that the <AutoText key="glidict::CDM.SubcollectionManager.Subcollection_Controls"/> tab is selected (the default). Define a subcollection filter with name <b>monarchs</b> that matches against <AutoText key="metadata::dc.Subject"/>, and type <b>Monarchs</b> as the regular expression to match with. Click <AutoText key="glidict::CDM.SubcollectionManager.Add" type="button"/>. This filter includes any file whose <AutoText key="metadata::dc.Subject"/> metadata contains the word <i>Monarchs</i>.</Text> 
    13421339</NumberedItem> 
    13431340<NumberedItem> 
     
    13651362<NumberedItem> 
    13661363<Text id="0455a">The text in the drop down box on the search page is based on the filters each partition was built on. To change the text that is displayed, go to the <AutoText key="glidict::CDM.GUI.SearchMetadata"/> section of the <AutoText key="glidict::GUI.Format"/> panel. The single filter partitions have sensible default text, but the combined partition does not. Set the <AutoText key="glidict::CDM.SearchMetadataManager.Component_Name"/> for the combined partition to "all". <b>Preview</b> the collection.</Text> 
    1367 </NumberedItem> 
    1368 <NumberedItem> 
    1369 <Text id="0456">For versions before 2.82, now return to <AutoText key="glidict::Preferences.Mode.Librarian"/> mode in the Librarian Interface, using <AutoText key="glidict::Menu.File_Options"/> (on the <AutoText key="glidict::Menu.File"/> menu).</Text> 
    13701364</NumberedItem> 
    13711365<Heading> 
     
    13911385</Title> 
    13921386<Prerequisite id="large_html_collection"/> 
    1393 <Version initial="2.60" current="2.82"/> 
     1387<Version initial="2.60" current="2.84"/> 
    13941388<Content> 
    13951389<NumberedItem> 
     
    14851479<Text id="st-1">Section tagging for HTML documents</Text> 
    14861480</Title> 
    1487 <Version initial="2.70w" current="2.82"/> 
     1481<Version initial="2.70w" current="2.84"/> 
    14881482<Content> 
    14891483<NumberedItem> 
     
    15411535<Text id="0411">Downloading files from the web</Text> 
    15421536</Title> 
    1543 <Version initial="2.60" current="2.82"/> 
     1537<Version initial="2.60" current="2.84"/> 
    15441538<Content> 
    15451539<Comment> 
     
    15831577</Title> 
    15841578<Prerequisite id="downloading_from_internet"/> 
    1585 <Version initial="2.60" current="2.82"/> 
     1579<Version initial="2.60" current="2.84"/> 
    15861580<Content> 
    15871581<NumberedItem> 
     
    16171611</Title> 
    16181612<SampleFiles folder="marc"/> 
    1619 <Version initial="2.60" current="2.82"/> 
     1613<Version initial="2.60" current="2.84"/> 
    16201614<Content> 
    16211615<Comment> 
     
    17741768</Title> 
    17751769<SampleFiles folder="isis"/> 
    1776 <Version initial="2.70w" current="2.82"/> 
     1770<Version initial="2.70w" current="2.84"/> 
    17771771<Content> 
    17781772<Comment> 
     
    18361830</Title> 
    18371831<SampleFiles folder="custom"/> 
    1838 <Version initial="2.70" current="2.82"/> 
     1832<Version initial="2.70" current="2.84"/> 
    18391833<Content> 
    1840 <Text id="mf-2">The appearance of all pages produced by Greenstone is governed by macro files, which reside in the folder <Path>Greenstone &rarr; macros</Path>, and images and CSS stylesheets reside in <Path>Greenstone &rarr; web &rarr; style</Path> (for versions before 2.82 it's <Path>Greenstone &rarr; images</Path>). </Text> 
     1834<Text id="mf-2">The appearance of all pages produced by Greenstone is governed by macro files, which reside in the folder <Path>Greenstone &rarr; macros</Path>, and images and CSS stylesheets reside in <Path>Greenstone &rarr; web &rarr; style</Path>.</Text> 
    18411835<Text id="mf-3">A macro takes the form <Format>_macroname_ {macro value}</Format>. Macro names start and end with underscores (_), and the macro value is enclosed in curly brackets ({}). Macro values can be text or HTML, and can include other macros.</Text> 
    18421836<Text id="mf-4">Macros are grouped into packages, and different packages control the appearance of different pages. For example, the <AutoText text="home"/>, <AutoText text="help"/>, <AutoText text="preferences"/>, <AutoText text="query"/>, <AutoText text="document"/> packages control the home, help, preferences, query, and document pages, respectively. Some macro files contain macros for just one package, for example, <Path>home.dm</Path>, <Path>query.dm</Path>, <Path>document.dm</Path>, while others contain macros for many packages. <Path>base.dm</Path> contains macros used globally, <Path>style.dm</Path> controls the common style of each page, <Path>english.dm</Path>, <Path>french.dm</Path> and other language files contain the text fragments for the entire interface, in that language. </Text> 
    1843 <Text id="mf-5">The output of the library program is a page of HTML which is viewed in a web browser. CSS (Cascading Style Sheets) are often used alongside HTML pages to control the formatting, such as layout, colour, font etc. The default Greenstone stylesheet is <Path>Greenstone &rarr; web &rarr; style &rarr; style.css</Path> (for versions before 2.82 it's <Path>Greenstone &rarr; images &rarr; style.css</Path>).</Text> 
     1837<Text id="mf-5">The output of the library program is a page of HTML which is viewed in a web browser. CSS (Cascading Style Sheets) are often used alongside HTML pages to control the formatting, such as layout, colour, font etc. The default Greenstone stylesheet is <Path>Greenstone &rarr; web &rarr; style &rarr; style.css</Path>.</Text> 
    18441838<Text id="mf-6">In this exercise, we customize the macros, images and stylesheets to change the appearance of our library.</Text> 
    18451839<Heading> 
     
    19291923<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> 
    19301924<NumberedItem> 
    1931 <Text id="mf-23">The majority of the style definitions reside in an external style file, <Path>Greenstone &rarr; web &rarr; style &rarr; style.css</Path> (<Path>Greenstone &rarr; images &rarr; style.css</Path> for versions before 2.82), and most style changes involve modifying that file. Open the <Path>style.css</Path> file in a text editor, e.g. WordPad (and save a .backup copy). Make the following modifications. You might want to preview after each one to see the effect.</Text> 
     1925<Text id="mf-23">The majority of the style definitions reside in an external style file, <Path>Greenstone &rarr; web &rarr; style &rarr; style.css</Path>, and most style changes involve modifying that file. Open the <Path>style.css</Path> file in a text editor, e.g. WordPad (and save a .backup copy). Make the following modifications. You might want to preview after each one to see the effect.</Text> 
    19321926<Text id="mf-24">Change some of the colours:</Text> 
    19331927<BulletList> 
     
    19641958</NumberedItem> 
    19651959<NumberedItem> 
    1966 <Text id="mf-8">Now we will customize the default Greenstone header image and the background image. Two new images for this exercise can be found in <Path>sample_files &rarr; custom</Path>. Copy <Path>newbgimg.gif</Path>, <Path>newheadimg.gif</Path> from the <Path>custom</Path> folder into the <Path>Greenstone &rarr; web &rarr; images</Path> (for versions before 2.82 it's <Path>Greenstone &rarr; images</Path>) folder.</Text> 
     1960<Text id="mf-8">Now we will customize the default Greenstone header image and the background image. Two new images for this exercise can be found in <Path>sample_files &rarr; custom</Path>. Copy <Path>newbgimg.gif</Path>, <Path>newheadimg.gif</Path> from the <Path>custom</Path> folder into the <Path>Greenstone &rarr; web &rarr; images</Path> folder.</Text> 
    19671961</NumberedItem> 
    19681962<NumberedItem> 
     
    20432037</Title> 
    20442038<SampleFiles folder="beatles"/> 
    2045 <Version initial="2.60" current="2.82"/> 
     2039<Version initial="2.60" current="2.84"/> 
    20462040<Content> 
    20472041<NumberedItem> 
    20482042<Text id="0541">Copy the entire folder</Text> 
    20492043<Path>sample_files &rarr; beatles &rarr; advbeat_large</Path>  
    2050 <Text id="0542">(with all its contents) into your Greenstone <Path>collect</Path> folder. If you have installed Greenstone in the usual place, for Greenstone version 2.81 and above, this is</Text> 
     2044<Text id="0542">(with all its contents) into your Greenstone <Path>collect</Path> folder. If you have installed Greenstone in the usual place, this is</Text> 
    20512045<Path> 
    20522046<Text id="0542a"><Path>My Computer &rarr; Local Disk (C:) &rarr; Users &rarr; &lt;Username&gt; &rarr; collect</Path></Text> 
    20532047</Path>  
    2054 <Text id="0542b">where &lt;Username&gt; is the username under with Greenstone is installed. For versions below 2.81, this is</Text> 
    2055 <Path> 
    2056 <Text id="0542c"><Path>My Computer &rarr; Local Disk (C:) &rarr; Program Files &rarr; Greenstone &rarr; collect</Path></Text> 
    2057 </Path> 
     2048<Text id="0542b">where &lt;Username&gt; is the username under with Greenstone is installed.</Text> 
    20582049<Text id="0543">Put <Path>advbeat_large</Path> in there.</Text> 
    20592050</NumberedItem>