Index: /documentation/trunk/tutorials/xml-source/tutorial_en.xml
===================================================================
--- /documentation/trunk/tutorials/xml-source/tutorial_en.xml (revision 36363)
+++ /documentation/trunk/tutorials/xml-source/tutorial_en.xml (revision 36364)
@@ -5500,4 +5500,5 @@
Do not build the collection in GLI. We'll be building and rebuilding manually, from the command-line terminal. So close GLI once the files and folders have finished copying into your collection. You can choose to run the Greenstone server at any stage, however.
+
Since this is the first time we're building our collection, we're going to do a complete build. And we'll use the command line to do so. Open a terminal. To open a terminal in Windows, press Ctrl+r and type cmd in the Run dialog that displays. To open a terminal on a Mac machine, click on menu Go → Utilities → Terminal. Use the terminal to cd into your Greenstone installation folder. For instance, if you have your Greenstone installed on Windows as "Greenstone" within your account folder at C:\Users\me, then type the following in your terminal and hit Enter:
@@ -5593,6 +5595,9 @@
<Manifest>
<Delete>
- <OID>b18ase-b18ase_htm</OID>
+
+ <OID>b18ase</OID>
+ <OID>fb33fe</OID>
</Delete>
</Manifest>
@@ -5600,10 +5605,13 @@
As per the above manifest file, the operation to be performed by an incremental build is a <Delete> operation on two documents. For the delete operation, the documents are not indicated by the <Filename> XML element, but by the <OID> element which specifies the object identifier. We need to use the OID here because we're telling Greenstone precisely what the identifiers of the documents are that we wish to have removed from our collection. The identifiers of every built document in a Greenstone collection are specified in the Identifier field of the document's doc.xml file located in the collection's archives folder. The doc.xml file is the Greenstone-specific XML format in which Greenstone stores documents already imported.
For instance, to find the identifier of the b18ase.htm document in your built collection, open up web\sites\localsite\collect\incremen\archives\b18ase-b.dir\doc.xml in a text editor. Then scroll down, looking for a piece of Greenstone extracted metadata labelled Identifier, which is the OID for this document:
-<Metadata name="Identifier">b18ase-b18ase_htm</Metadata>
+
+<Metadata name="Identifier">b18ase</Metadata>
The above value for the document identifier is what's used in the delete-some-files.xml manifest file to refer to this document. This document is one of two that are to be deleted as per the manifest file. Make sure to close the doc.xml file if you have it open.
+
Finally, let's incrementally rebuild the collection, specifying the manifest file that Greenstone should use this time to carry out the incremental build operation. As before, there are two steps.
@@ -5668,5 +5676,5 @@
- Now repeat all the above exercises in the same sequence once again, but with a new collection called autoincr also based on the Demo collection. Remember to once again set <importOption name="OIDtype" value="full_filename"/> in the collectionConfig.xml file and to make document level for searching the default. And build the collection the first time around with perl -S full-rebuild.pl -site localsite autoincr, also largely as before. However, this time don't pass in any manifest file as an argument to the subsequent rebuild commands which use the incremental-import.pl script. So you'd be running these commands after each change:
+ Now repeat all the above exercises in the same sequence once again, but with a new collection called autoincr also based on the Demo collection. Remember to make document level for searching the default. And build the collection the first time around with perl -S full-rebuild.pl -site localsite autoincr, also largely as before. However, this time don't pass in any manifest file as an argument to the subsequent rebuild commands which use the incremental-import.pl script. So you'd be running these commands after each change:
perl -S incremental-import.pl -incremental -site localsite autoincr