I'll try to answer the questions;
NOTE I am not a developer; so if anyone notices any errors please correct
me and let me know. (thanks)
>Could you, please tell when I have to import, and re-build the collection
if you ever change, or remove a document form the collection. (or change
your plugin settings).
If you are changing your classifiers you will need to rebuild (but not
If you are changing your format statements you only need to refresh
browser. (but watch out for pages cached on a proxy). You may need
restart greenstone if you are using windows. (check the mailing list
archives - I'm sure this issue has been covered there).
>If I include a document?
Import and build, but you only need to import that document only. (so
import sould be very quick)
>If I update a document?
Import and build the whole collection. Unless you want two copies.
In more detail:
Adding documents happens in two stages in greenstone;
The import stage, started by import.pl which ADDS* the documents and
associated files to your '/archives/' directory.
This stage uses plugins to extract/convert the documents into the
GreenstoneArchive (xml) format so it can be indexed in the build stage.
also uses the plugins to collect any metadata associated with the document;
either either extracted or derived from the document itself, or from
It also assigns a unique identifier(OID) - as part of the metadata.
*note that it is possble to add the same document to your '/archives/'
directory twice, creating two identical versions in the final collection.
If something changes in your plugin settings or some documents get
then you would normally delete your archives folder import your whole
collection. If you are just adding new documents then you just import
new documents alone.
you can use import.pl -removeold demo to automatically remove the old
The build stage looks at the /archives/ folder and creates the /building/
This stage creates all the indexes for the text and metadata. It also
creates the browsable classifications defined by the classifiers.
When building is complete you can erase the contents of the /index/
and copy in the contents of the building folder. Normally you would
/index/ and rename /building/ to /index/ (quicker). As you can see
does not take place 'live' on the /index/ folder so you collection
only be offline for the few seconds it takes to rename the /building/
>If I change the format in the configuration?
You can change format statements at any time.
Sometimes this doesn't take effect because;
a) your web browser is getting a cached copy
b) if you are using the windows version you may need to restart greenstone
I hope this helps.
Check out the developers guide, especially chapters 1 and 2 cover this
See documentation at: http://www.greenstone.org/
If you are keen you can use greenstone to search its own source and
Stephen De Gabrielle
Northern Territory University Library
Tel: (08) 8946 7009 from overseas: 61 8 8946 7009
Postal address: P.O.Box 41246, Casuarina, NT, 0811, Australia
CRICOS Provider No: 00300K
greenstone-users mailing list