CpanContrib Contrib Package

Provides pure-perl and precompiled CPAN modules in a handy bundle

Bundled Prebuilt CPAN Modules for twiki.org current TWiki:Codev.TWikiRelease and all twiki.org TWiki:Plugins modules

Proin ligula quam, vulputate et, laoreet vel, porttitor at, metus. Aliquam bibendum nisl non ante. Maecenas dignissim eleifend ante. Phasellus pede ligula, cursus id, lacinia id, tristique id, nulla. Donec quam nibh, volutpat vel, accumsan eu, tempus eget, felis. Mauris sagittis lobortis mi.

Included CPAN Modules in package

This TWiki Contrib provides locally-installable versions of the following CPAN modules:

Building

Proin ligula quam, vulputate et, laoreet vel, porttitor at, metus. Aliquam bibendum nisl non ante. Maecenas dignissim eleifend ante. Phasellus pede ligula, cursus id, lacinia id, tristique id, nulla. Donec quam nibh, volutpat vel, accumsan eu, tempus eget, felis. Mauris sagittis lobortis mi. Ut quam felis, ultrices vitae, imperdiet eu, tincidunt id, mauris. Suspendisse ullamcorper augue at eros. Curabitur in ipsum. Aliquam vulputate posuere enim. Nullam mi sem, egestas a, congue non, lacinia et, lectus. Morbi eget arcu. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nunc aliquam venenatis lectus. Fusce a nisi. Etiam justo turpis, interdum eu, volutpat ac, laoreet non, risus. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nullam dolor. Nulla massa. Suspendisse potenti.

Downloading source

   SVN=http://svn.twiki.org/svn/twiki/branches/MAIN
   mkdir -p ~/src/cpan
   cd ~/src/cpan
   svn co $SVN/twikiplugins/BuildContrib
   svn co $SVN/twikiplugins/CpanContrib
   export TWIKI_LIBS=~/src/cpan/BuildContrib/lib/
   cd CpanContrib

   cd $TWIKI/twikiplugins/CpanContrib

Proin ligula quam, vulputate et, laoreet vel, porttitor at, metus. Aliquam bibendum nisl non ante. Maecenas dignissim eleifend ante.

Building a release

In order build the CpanContrib package, each of the CPAN modules

   cd lib/TWiki/Contrib/CpanContrib
   perl build.pl release

Refreshing CPAN modules on a site with CpanContrib already installed

These steps can also be followed on a site that already has CpanContrib installed to refresh the CPAN modules.

   $TWIKI/tools/install-cpan.pl --baselibdir=$TWIKI/lib/CPAN/ </dev/null \
      `perl -e "require qq{$TWIKI/lib/TWiki/Contrib/CpanContrib/CPAN}; print join( ' ', @CPAN )"`

Additional Tools

Installing individual CPAN modules

The CpanContrib is also useful outside of the scope of TWiki as it provides a way to reliably install CPAN modules locally.

	tools/install-cpan.pl --baselibdir=~/lib/CPAN/ module... </dev/null
	# defaults to --mirror=tools/MIRROR/MINICPAN if it exists, otherwise to http://cpan.org/

Mirroring CPAN

As of 07 May 2007, a mirror requires approximately 795MB of storage.

   tools/mirror-cpan.pl

mirror-cpan.pl with its default parameters downloads the latest version of all CPAN modules from http://cpan.org and stores those files locally in a MIRROR/MINICPAN/ directory under mirror-cpan.pl. (see mirror-cpan.pl --help for more information on command line parameters.)

Settings

Settings are stored as preferences variables. To reference a setting write %<plugin>_<setting>%, e.g. %CPANCONTRIB_STUB%

• One line des<cription:
  • Set SHORTDESCRIPTION = Bundled Prebuilt CPAN Modules for twiki.org current TWiki:Codev.TWikiRelease and all twiki.org TWiki:Plugins modules

• Name of the perl package
  • Set STUB = %$STUB%

Installation Instructions

Note: You do not need to install anything on the browser to use this contrib package. The following instructions are for the administrator who installs the package on the server where TWiki is running.

• Download the ZIP file from the Plugin web (see below)
• Unzip CpanContrib.zip in your twiki installation directory. Content:

  File:	Description:

Contrib Info

Related Topics: TWikiPreferences

-- TWiki:Main/WillNorris - %$DATE%