• Cambridge
• Croydon
• Randomness (London)
• Oxford
• Vegan Oxford

Latest project news

After three years of failing to update this website, we’ve finally moved it to GitHub Pages to make it easier to keep current.

Eleven versions of OpenGuides have been released since our last news report here. Changes include:

• template and CSS changes to facilitate mobile-friendly (responsive) guides
• improved JSON output
• added configuration for Vagrant, Travis, and Coveralls
• added a new search backend based on Lucy
• added the ability to create custom macros and override existing ones

The Software

The OpenGuides system is free software, written in Perl. It is available for download from the CPAN. To see what's new in the latest version, consult the release notes.

System Requirements

To run OpenGuides, you will need a webserver capable of running Perl, and a number of Perl modules as prerequisites, all of which are also available from the CPAN. We recommend installing OpenGuides via CPAN.pm or the newer CPANPLUS.pm, as these will handle the installation of prerequisites for you. Alternatively, if you run a Debian system, you can install OpenGuides with "apt". Full details and packages are available at the package home page.

Installation

General documentation is being developed on the development wiki; you may also find the INSTALL file that comes with the software useful.

Hosting

If you don't have your own webserver to run a Guide on, two people are kindly offering to help out. In the UK, contact Dominic Hargreaves (dom(at)earth.li); in the US, Christopher Schmidt (crschmidt(at)crschmidt.net).

Help and Troubleshooting

Some common issues are dealt with in TROUBLESHOOTING. If you have other problems, please get in touch with us via the mailing list or IRC.

Reporting Bugs and Suggesting Features

You can use dev.openguides.org to report bugs and make feature suggestions.