/ 
Catalyst-Controller-POD-0.02
River stage one • 1 direct dependent • 2 total dependents
/ Catalyst::Controller::POD

NAME

Catalyst::Controller::POD - Serves PODs right from your Catalyst application

VERSION

Version 0.02

SYNOPSIS

Create a new controller and paste this code:

package MyApp::YourNewController;  # <-- Change this to your controller

use strict;
use warnings;
use base 'Catalyst::Controller::POD';
__PACKAGE__->config(
  inc        => 1,
  namespaces => [qw(Catalyst::Manual*)],
  self       => 1,
  dirs       => [qw()]
);
1;

DESCRIPTION

This is a catalyst controller which serves PODs. It allows you to browse through your local repository of modules. On the front page of this controller is a search box which uses CPAN's xml interface to retrieve the results. If you click on one of them the POD is displayed in this application.

Cross links in PODs are resolved and pop up as a new tab. If the module you clicked on is not installed this controller fetches the source code from CPAN and creates the pod locally. There is also a TOC which is always visible and scrolls the current POD to the selected section.

It is written using a JavaScript framework called ExtJS (http://www.extjs.com) which generate beautiful and intuitive interfaces.

Have a look at http://cpan.org/authors/id/P/PE/PERLER/pod-images/pod-encyclopedia-01.png

CONFIGURATION

inc (Boolean)

Search for modules in @INC. Set it to 1 or 0.

Defaults to 0.

namespaces (Arrayref)

Filter by namespaces. See Pod::Simple::Search limit_glob for syntax.

Defaults to ["*"]

self (Boolean)

Search for modules in $c->path_to( 'lib' ).

Defaults to 1.

dirs (Arrayref)

Search for modules in these directories.

Defaults to [].

NOTICE

This module works fine for most PODs but there are a few which do not get rendered properly. Please report any bug you find. See "BUGS".

Have a look at Pod::Browser which is a catalyst application running this controller. You can use it as a stand-alone POD server.

TODO

Write more tests!

AUTHOR

Moritz Onken, <onken at houseofdesign.de>

BUGS

Please report any bugs or feature requests to bug-catalyst-controller-pod at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-Controller-POD. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Catalyst::Controller::POD

You can also look for information at:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2008 Moritz Onken, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 103:

You forgot a '=back' before '=head1'