# pod_browser visit http://localhost:3030
This is a Catalyst server which serves PODs. It allows you to browse through your local repository of modules. On the front page 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.
First you have to locate the config file. Try
# locate pod_browser.yml
in your command line and open it.
- inc (Boolean)
Search for modules in @INC. Set it to 1 or 0.
- namespaces (Arrayref)
Filter by namespaces. See Pod::Simple::Search
- self (Boolean)
Search for modules in
$c->path_to( 'lib' ).
- dirs (Arrayref)
Search for modules in these directories.
STARTING THE SERVER
pod_browser --help or see plackup for more information.
INTEGRATION IN CATALYST
If you want to integrate this application directly into your catalyst application have a look at Catalyst::Controller::POD. This controller is used by this application.
ExtJS (http://www.extjs.com) is used for the user interface.
Other Pod Web Servers: