https://github.com/monken/p5-pod-browser

Pod::Browser - Browse PODs via an AJAX web app
https://github.com/monken/p5-pod-browser

Last synced: 3 months ago
JSON representation

Pod::Browser - Browse PODs via an AJAX web app

• Host: GitHub
• URL: https://github.com/monken/p5-pod-browser
• Owner: monken
• Created: 2009-05-04T13:24:08.000Z (over 15 years ago)
• Default Branch: master
• Last Pushed: 2016-10-22T22:44:42.000Z (about 8 years ago)
• Last Synced: 2024-06-19T05:54:08.828Z (7 months ago)
• Language: Perl
• Homepage:
• Size: 80.1 KB
• Stars: 4
• Watchers: 4
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.pod
  • Changelog: Changes

Awesome Lists containing this project

README

        
package Pod::Browser;

use strict;

use warnings;

# ABSTRACT: Pod Web Server based on Catalyst and ExtJS

use Catalyst::Runtime '5.90012';

use base qw/Catalyst/;

__PACKAGE__->config( name => 'Pod::Browser' );

__PACKAGE__->setup(qw/ ConfigLoader Static::Simple/);

sub { __PACKAGE__->run( @_) }

__END__

=head1 SYNOPSIS

  # pod_browser

  visit http://localhost:3030

=head1 DESCRIPTION

This is a L 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.

It is written using a JavaScript framework called ExtJS (L) which

generates beautiful and rich user interfaces.

=begin html



=end html

=head1 CONFIGURATION

First you have to locate the config file. Try

  # locate pod_browser.yml

in your command line and open it.

=over

=item inc (Boolean)

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

Defaults to C<0>.

=item namespaces (Arrayref)

Filter by namespaces. See L C for syntax.

Defaults to C<["*"]>

=item self (Boolean)

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

Defaults to C<1>.

=item dirs (Arrayref)

Search for modules in these directories.

Defaults to C<[]>.

=back

=head1 STARTING THE SERVER

C makes use of L. As a result, all options from L are

also available to C.

Run C or see L for more information.

=head1 INTEGRATION IN CATALYST

If you want to integrate this application directly into your catalyst application have a look at L.

This controller is used by this application.

=head1 SEE ALSO

L, L

ExtJS (L) is used for the user interface.

Other Pod Web Servers:

L, L, L