Changes between Initial Version and Version 1 of FAQ


Ignore:
Timestamp:
Nov 18, 2005, 6:56:21 PM (16 years ago)
Author:
Dominic Hargreaves
Comment:

Import from old wiki

Legend:

Unmodified
Added
Removed
Modified
  • FAQ

    v1 v1  
     1== Corrupt index ==
     2
     3If you receive this message:
     4
     5{{{
     6Search::InvertedIndex::add_index() - Unable to locate the existing 'ie_first_index_enum' value. Database may be corrupt. at /usr/share/perl5/CGI/Wiki/Search/SII.pm line 127
     7}}}
     8
     9Delete the index files (/var/lib/openguides/indexes/default/ in the Debian packages) and run examples/reindex.pl from the distribution (/usr/share/doc/openguides/examples/reindex.pl in the Debian packages) in the same directory as wiki.conf.
     10
     11This will rebuild the indexes from scratch.  Search::InvertedIndex indexes do this occasionally, and it is recommended that you use Plucene instead.
     12
     13== Distance calculations and ellipsoids ==
     14
     15wiki.conf contains an option to use British National Grid, Irish National Grid or a Universal Transverse Mercator (UTM) for distance calculations and storage of coordinates.  UTM is recommended for sites covering areas outside Britain and Ireland.
     16
     17A further option, if using UTM, is the ellipsoid to use.  An elipsoid estimates the (non-spherical) shape of the globe and is used to calculate distances while taking the curvature of the earth into account.  See: http://www.vterrain.org/Projections/  Kake gives an explanation in [http://openguides.org/mail/openguides-dev/2004-December/000723.html this post].
     18
     19The ellipsoid you use can be any of those mentioned in the [http://search.cpan.org/src/GRAHAMC/Geo-Coordinates-UTM-0.03/README readme] for GEO::Coordinates::UTM.  International is recommended.
     20
     21In practical terms, you don't need to really worry about this overly, unless you are building the '''Open Guide to Terrorist Training Camps''' and don't want the nice lady down the road from said camps getting bombed. http://openguides.org/mail/openguides-dev/2004-June/000462.html includes some calculations that show the error between different UTM ellipsoids isn't great enough to cause real problems.
     22
     23This presentation explains the issues, and the Perl modules in use, for you: [wiki:Ivor's_Geo_Talk_Slides Ivor's Geo Talk Slides]
     24
     25== Locales ==
     26
     27<i>Can someone explain what a locale is meant to do in Openguides  - what
     28sort of area is it meant to cover.
     29Specifically I have seen a couple of entries with Locale = "Southwark"
     30that  I don't consider to be within Southwark.  I assume that it is not
     31meant to cover the London Borough of that name.</i>
     32
     33For me, a locale is the answer to the question "where is foo?"  So for
     34example if someone said "Where is Manna?" I'd say "Primrose Hill", and
     35so that's its locale.  If someone said "Where is the Crabtree Tavern?"
     36I'd answer "Well, it's sort of on the border of Hammersmith and
     37Fulham", so it's in both locales.
     38
     39If something's down as being in Southwark but you know Southwark well
     40and you disagree, then you're probably right and the locale was added
     41by someone who doesn't know the area very well - sort of the "South of
     42the river is all the same place" syndrome.
     43
     44== Authentication ==
     45
     46<i>I'm wondering if anyone has developed, or is working on, an authentication module for OpenGuide.</i>
     47
     48Put something like this in .htaccess in the same directory as the wiki.cgi:     
     49
     50{{{
     51<Limit POST>
     52Order deny,allow
     53Deny from all                                                                   
     54AuthType Basic                                                                 
     55AuthName "Username: "                                                           
     56AuthUserFile /home/kake/.htpasswd-openguides                                   
     57require valid-user                                                             
     58satisfy any                                                                     
     59</Limit>                                                                       
     60}}}
     61
     62All the edit forms are POST.  I think there is a POST search form as           
     63well, but this really needs changing to GET - there's no reason for             
     64search results not to be linkable to, and a search doesn't change               
     65data.  Um, hack that in your version pending a fix in the distro.  I           
     66wouldn't normally recommend that, but you seem to be in dire straits,           
     67and it's a bugfix which will go in at some point.                               
     68
     69(Dom suggests instead limiting with
     70{{{
     71<Files wiki.cgi>
     72}}}
     73)
     74
     75They won't get the auth request until after they've submitted the edit         
     76form though.  I think (but have not tested this) that you can get               
     77around this by making a little login.cgi that's protected by the same           
     78htpasswd file and adding a link to this somewhere.                             
     79
     80That really is a bit of a hack, but it might do.