OpenGuides - A complete web application for managing a collaboratively-written guide to a city or town.
The OpenGuides software provides the framework for a collaboratively-written city guide. It is similar to a wiki but provides somewhat more structured data storage allowing you to annotate wiki pages with information such as category, location, and much more. It provides searching facilities including "find me everything within a certain distance of this place". Every page includes a link to a machine-readable (RDF) version of the page.
my $config = OpenGuides::Config->new( file => "wiki.conf" ); my $guide = OpenGuides->new( config => $config );
An accessor, returns the underlying CGI::Wiki object.
An accessor, returns the underlying OpenGuides::Config object.
An accessor, returns the underlying CGI::Wiki::Plugin::Locator::UK object.
An accessor, returns the underlying CGI::Wiki::Plugin::Diff object.
# Print node to STDOUT. $guide->display_node( id => "Calthorpe Arms", version => 2, ); # Or return output as a string (useful for writing tests). $guide->display_node( id => "Calthorpe Arms", return_output => 1, ); # Or return the hash of variables that will be passed to the template # (not including those set additionally by OpenGuides::Template). $guide->display_node( id => "Calthorpe Arms", return_tt_vars => 1, );
If version is omitted then the latest version will be displayed.
version
$guide->display_recent_changes;
As with other methods, the return_output parameter can be used to return the output instead of printing it to STDOUT.
return_output
$guide->display_diffs( id => "Home Page", version => 6, other_version => 5, ); # Or return output as a string (useful for writing tests). my $output = $guide->display_diffs( id => "Home Page", version => 6, other_version => 5, return_output => 1, ); # Or return the hash of variables that will be passed to the template # (not including those set additionally by OpenGuides::Template). my %vars = $guide->display_diffs( id => "Home Page", version => 6, other_version => 5, return_tt_vars => 1, );
$guide->find_within_distance( id => $node, metres => $q->param("distance_in_metres") );
$guide->show_backlinks( id => "Calthorpe Arms" );
As with other methods, parameters return_tt_vars and return_output can be used to return these things instead of printing the output to STDOUT.
return_tt_vars
$guide->show_index( type => "category", value => "pubs", ); # RDF version. $guide->show_index( type => "locale", value => "Holborn", format => "rdf", ); # Or return output as a string (useful for writing tests). $guide->show_index( type => "category", value => "pubs", return_output => 1, );
$guide->list_all_versions ( id => "Home Page" ); # Or return output as a string (useful for writing tests). $guide->list_all_versions ( id => "Home Page", return_output => 1, ); # Or return the hash of variables that will be passed to the template # (not including those set additionally by OpenGuides::Template). $guide->list_all_versions ( id => "Home Page", return_tt_vars => 1, );
# Last ten non-minor edits to Hammersmith pages. $guide->display_rss( items => 10, ignore_minor_edits => 1, locale => "Hammersmith", ); # All edits bob has made to pub pages in the last week. $guide->display_rss( days => 7, username => "bob", category => "Pubs", );
$guide->commit_node( id => $node, cgi_obj => $q, );
The geographical data that you should provide in the CGI object depends on the handler you chose in wiki.conf.
wiki.conf
British National Grid - provide either os_x and os_y or latitude and longitude; whichever set of data you give, it will be converted to the other and both sets will be stored.
os_x
os_y
latitude
longitude
Irish National Grid - provide either osie_x and osie_y or latitude and longitude; whichever set of data you give, it will be converted to the other and both sets will be stored.
osie_x
osie_y
UTM ellipsoid - provide latitude and longitude; these will be converted to easting and northing and both sets of data will be stored.
$guide->delete_node( id => "FAQ", version => 15, password => "beer", );
version is optional - if it isn't supplied then all versions of the node will be deleted; in other words the node will be entirely removed.
If password is not supplied then a form for entering the password will be displayed.
password
UTF8 data are currently not handled correctly throughout.
Other bugs are documented at http://rt.cpan.org/NoAuth/Bugs.html?Dist=OpenGuides
http://london.openguides.org/, the first and biggest OpenGuides site.
http://openguides.org/, with a list of all live OpenGuides installs.
CGI::Wiki, the Wiki toolkit which does the heavy lifting for OpenGuides
If you have a question, a bug report, or a patch, or you're interested in joining the development team, please contact openguides-dev@openguides.org (moderated mailing list, will reach all current developers but you'll have to wait for your post to be approved) or file a bug report at http://rt.cpan.org/NoAuth/Bugs.html?Dist=OpenGuides
The OpenGuides Project (openguides-dev@openguides.org)
Copyright (C) 2003-2005 The OpenGuides Project. All Rights Reserved.
The OpenGuides distribution is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Programming by Dominic Hargreaves, Earle Martin, Kake Pugh, and Ivor Williams. Testing and bug reporting by Billy Abbott, Jody Belka, Kerry Bosworth, Simon Cozens, Cal Henderson, Steve Jolly, and Bob Walker (among others). Much of the Module::Build stuff copied from the Siesta project http://siesta.unixbeard.net/
2 POD Errors
The following errors were encountered while parsing the POD:
alternative text 'http://london.openguides.org/' contains non-escaped | or /
alternative text 'http://openguides.org/' contains non-escaped | or /
To install OpenGuides, copy and paste the appropriate command in to your terminal.
cpanm
cpanm OpenGuides
CPAN shell
perl -MCPAN -e shell install OpenGuides
For more information on module installation, please visit the detailed CPAN module installation guide.