SiSU - Search,
Ralph Amissah

  1

SiSU Search

  2

6. Hyperestraier

6. Hyperestraier

  77

See the documentation for hyperestraier:

  78

<http://hyperestraier.sourceforge.net/>

  79

/usr/share/doc/hyperestraier/index.html

  80

man estcmd

  81

on sisu_hyperestraier:

  82

man sisu_hyperestraier

  83

/usr/share/doc/sisu/sisu_markup/sisu_hyperestraier/index.html

  84

NOTE: the examples that follow assume that sisu output is placed in the directory /home/ralph/sisu_www

  85

(A) to generate the index within the webserver directory to be indexed:

  86

estcmd gather -sd [index name] [directory path to index]

  87

the following are examples that will need to be tailored according to your needs:

  88

cd /home/ralph/sisu_www

  89

estcmd gather -sd casket /home/ralph/sisu_www

  90

you may use the 'find' command together with 'egrep' to limit indexing to particular document collection directories within the web server directory:

  91

find /home/ralph/sisu_www -type f | egrep '/home/ralph/sisu_www/sisu/.+?.html$' |estcmd gather -sd casket -

  92

Check which directories in the webserver/output directory (~/sisu_www or elsewhere depending on configuration) you wish to include in the search index.

  93

As sisu duplicates output in multiple file formats, it it is probably preferable to limit the estraier index to html output, and as it may also be desirable to exclude files 'plain.txt', 'toc.html' and 'concordance.html', as these duplicate information held in other html output e.g.

  94

find /home/ralph/sisu_www -type f | egrep '/sisu_www/(sisu|bookmarks)/.+?.html$' | egrep -v '(doc|concordance).html$' |estcmd gather -sd casket -

  95

from your current document preparation/markup directory, you would construct a rune along the following lines:

  96

find /home/ralph/sisu_www -type f | egrep '/home/ralph/sisu_www/([specify first directory for inclusion]|[specify second directory for inclusion]|[another directory for inclusion? ...])/.+?.html$' | egrep -v '(doc|concordance).html$' |estcmd gather -sd /home/ralph/sisu_www/casket -

  97

(B) to set up the search form

  98

(i) copy estseek.cgi to your cgi directory and set file permissions to 755:

  99

sudo cp -vi /usr/lib/estraier/estseek.cgi /usr/lib/cgi-bin

  100

sudo chmod -v 755 /usr/lib/cgi-bin/estseek.cgi

  101

sudo cp -v /usr/share/hyperestraier/estseek.* /usr/lib/cgi-bin

  102

[see estraier documentation for paths]

  103

(ii) edit estseek.conf, with attention to the lines starting 'indexname:' and 'replace:':

  104

indexname: /home/ralph/sisu_www/casket

  105

replace: ^file:///home/ralph/sisu_www{!}

  106

replace: /index.html?${{!}}/

  107

(C) to test using webrick, start webrick:

  108

sisu -W

  109

and try open the url: <http://localhost:8081/cgi-bin/estseek.cgi>

  110

Output generated by SiSU 0.59.0 2007-09-23 (2007w38/0)
SiSU Copyright ^© Ralph Amissah 1997, current 2007. All Rights Reserved.
SiSU is software for document structuring, publishing and search,
www.jus.uio.no/sisu and www.sisudoc.org
w3 since October 3 1993 ralph@amissah.com

SiSU using:
Standard SiSU markup syntax,
Standard SiSU meta-markup syntax, and the
Standard SiSU object citation numbering and system, (object/text positioning system)
Copyright ^© Ralph Amissah 1997, current 2007. All Rights Reserved.

SiSU is released under GPLv3 or later, <http://www.gnu.org/licenses/gpl.html>

SiSU, developed using Ruby on Debian/Gnu/Linux software infrastructure, with the usual GPL (or OSS) suspects.
Better - "performance, reliability, scalability, security & total cost of ownership" [not to mention flexibility & choice] use of and adherence to open standards (where practical and fair) and it is software libre.
Get With the Future Way Better!