Finally had a chance to read this - looks great, thanks Jim! I think we can improve it ever so slightly by being a little more explicit at the end:> {{{ > /usr/local/bin/omindex --db /var/lib/omega/data/default > --url /book /var/www/book > }}}[...]> The --url parameter identifies the url prefix that corresponds to > the directory we start indexing from. Since we put the documents in > /var/www/book we need to specify --url /book. If we were adding > files that were in the document root, we'd set use --url /. > > The last parameter, /var/www/book tells omindex to look for the > documents at that location on disk. Omindex does not web crawl, it > only looks at files on disk.The sentence "since we put the documents in /var/www/book we need to specify --url /book" needs unpacking in my opinion, just to mention that /var/www is the document root. Not quite sure what to add though. In fact, earlier one when book.0.1.tar.gz is unpacked we could perhaps do with making this explicit as well. Immediately after the unpack {{{...}}} code block we get:> You may also extract the files somewhere else and copy them to your > document root.Perhaps we should add after that:> In this example our document root is /var/www - if yours is > different you will need to modify the instructions in the rest of > this document accordingly.J -- /--------------------------------------------------------------------------\ James Aylett xapian.org james@tartarus.org uncertaintydivision.org
Hi, James, Please change it as you see fit. I appreciate the help. I still consider myself a novice at this and still learning. I'll be the first to admit the document is far from perfect and welcome expert modifications. Jim. James Aylett wrote:>Finally had a chance to read this - looks great, thanks Jim! > >I think we can improve it ever so slightly by being a little more >explicit at the end: > > > >>{{{ >>/usr/local/bin/omindex --db /var/lib/omega/data/default >>--url /book /var/www/book >>}}} >> >> > >[...] > > > >>The --url parameter identifies the url prefix that corresponds to >>the directory we start indexing from. Since we put the documents in >>/var/www/book we need to specify --url /book. If we were adding >>files that were in the document root, we'd set use --url /. >> >>The last parameter, /var/www/book tells omindex to look for the >>documents at that location on disk. Omindex does not web crawl, it >>only looks at files on disk. >> >> > >The sentence "since we put the documents in /var/www/book we need to >specify --url /book" needs unpacking in my opinion, just to mention >that /var/www is the document root. Not quite sure what to add though. > >In fact, earlier one when book.0.1.tar.gz is unpacked we could perhaps >do with making this explicit as well. Immediately after the unpack >{{{...}}} code block we get: > > > >>You may also extract the files somewhere else and copy them to your >>document root. >> >> > >Perhaps we should add after that: > > > >>In this example our document root is /var/www - if yours is >>different you will need to modify the instructions in the rest of >>this document accordingly. >> >> > >J > > >
On Mon, Apr 24, 2006 at 08:59:43AM +0100, James Aylett wrote:> Perhaps we should add after that: > > > In this example our document root is /var/www - if yours is > > different you will need to modify the instructions in the rest of > > this document accordingly.("my" would be more consistent than "our" here). It's not just "/var/www", there's "/usr/lib/cgi-bin" too, and perhaps other things. It might be clearest to pick a convention to represent the various assumed values (e.g. put them in italics or a particular colour) and say this at the top, though you can't use markup in {{{...}}} which gets in the way of that somewhat. Anyway, it is a wiki so feel free to improve it. Cheers, Olly