X-Git-Url: http://git.indexdata.com/?p=idzebra-moved-to-github.git;a=blobdiff_plain;f=doc%2Fexamples.xml;h=ebbac178df224830168ebc8367c93f26a4136753;hp=a2c2ab35d8d296d7224399488230bc3ea0166fae;hb=27bdd6aa26843aeac89f635ed495996088d8e8aa;hpb=5ca4e60e990af6ad6b62ebff855d7b642f37c3ec diff --git a/doc/examples.xml b/doc/examples.xml index a2c2ab3..ebbac17 100644 --- a/doc/examples.xml +++ b/doc/examples.xml @@ -1,5 +1,4 @@ - Example Configurations @@ -29,7 +28,7 @@ - What record schemas to support. (Subsidiary files specifiy how + What record schemas to support. (Subsidiary files specify how to index the contents of records in those schemas, and what format to use when presenting records in those schemas to client software.) @@ -61,12 +60,12 @@ - Example 1: XML Indexing And Searching + Example 1: &acro.xml; Indexing And Searching This example shows how &zebra; can be used with absolutely minimal configuration to index a body of - XML + &acro.xml; documents, and search them using XPath expressions to specify access points. @@ -81,14 +80,14 @@ records are generated from the family tree in the file dino.tree.) Type make records/dino.xml - to make the XML data file. - (Or you could just type make dino to build the XML + to make the &acro.xml; data file. + (Or you could just type make dino to build the &acro.xml; data file, create the database and populate it with the taxonomic records all in one shot - but then you wouldn't learn anything, would you? :-) - Now we need to create a &zebra; database to hold and index the XML + Now we need to create a &zebra; database to hold and index the &acro.xml; records. We do this with the &zebra; indexer, zebraidx, which is driven by the zebra.cfg configuration file. @@ -103,7 +102,7 @@ That's all you need for a minimal &zebra; configuration. Now you can - roll the XML records into the database and build the indexes: + roll the &acro.xml; records into the database and build the indexes: zebraidx update records @@ -121,8 +120,8 @@ . - Now you can use the Z39.50 client program of your choice to execute - XPath-based boolean queries and fetch the XML records that satisfy + Now you can use the &acro.z3950; client program of your choice to execute + XPath-based boolean queries and fetch the &acro.xml; records that satisfy them: $ yaz-client @:9999 @@ -187,8 +186,8 @@ How, then, can we build broadcasting Information Retrieval applications that look for records in many different databases? - The Z39.50 protocol offers a powerful and general solution to this: - abstract ``access points''. In the Z39.50 model, an access point + The &acro.z3950; protocol offers a powerful and general solution to this: + abstract ``access points''. In the &acro.z3950; model, an access point is simply a point at which searches can be directed. Nothing is said about implementation: in a given database, an access point might be implemented as an index, a path into physical records, an @@ -198,7 +197,7 @@ For convenience, access points are gathered into attribute - sets. For example, the BIB-1 attribute set is supposed to + sets. For example, the &acro.bib1; attribute set is supposed to contain bibliographic access points such as author, title, subject and ISBN; the GEO attribute set contains access points pertaining to geospatial information (bounding coordinates, stratum, latitude @@ -207,7 +206,7 @@ (provenance, inscriptions, etc.) - In practice, the BIB-1 attribute set has tended to be a dumping + In practice, the &acro.bib1; attribute set has tended to be a dumping ground for all sorts of access points, so that, for example, it includes some geospatial access points as well as strictly bibliographic ones. Nevertheless, this model @@ -215,21 +214,21 @@ records in databases. - In the BIB-1 attribute set, a taxon name is probably best + In the &acro.bib1; attribute set, a taxon name is probably best interpreted as a title - that is, a phrase that identifies the item - in question. BIB-1 represents title searches by + in question. &acro.bib1; represents title searches by access point 4. (See - The BIB-1 Attribute + The &acro.bib1; Attribute Set Semantics) So we need to configure our dinosaur database so that searches for - BIB-1 access point 4 look in the + &acro.bib1; access point 4 look in the <termName> element, inside the top-level <Zthes> element. This is a two-step process. First, we need to tell &zebra; that we - want to support the BIB-1 attribute set. Then we need to tell it + want to support the &acro.bib1; attribute set. Then we need to tell it which elements of its record pertain to access point 4. @@ -265,12 +264,12 @@ xelm /Zthes/termModifiedBy termModifiedBy:w - Declare Thesausus attribute set. See zthes.att. + Declare Thesaurus attribute set. See zthes.att. - Declare Bib-1 attribute set. See bib1.att in + Declare &acro.bib1; attribute set. See bib1.att in &zebra;'s tab directory. @@ -284,13 +283,13 @@ xelm /Zthes/termModifiedBy termModifiedBy:w Make termName word searchable by both - Zthes attribute termName (1002) and Bib-1 atttribute title (4). + Zthes attribute termName (1002) and &acro.bib1; attribute title (4). - After re-indexing, we can search the database using Bib-1 + After re-indexing, we can search the database using &acro.bib1; attribute, title, as follows: Z> form xml @@ -305,7 +304,7 @@ Elapsed: 0.106896 Z> s Sent presentRequest (1+1). Records: 1 -[Default]Record type: XML +[Default]Record type: &acro.xml; <Zthes> <termId>2</termId> <termName>Eoraptor</termName>