lib/CatalystX/HelpText.pm

   1 package CatalystX::HelpText;
   2 use Moose;
   3 use namespace::autoclean;
   4
   5 1;
   6
   7 =head1 NAME
   8
   9 CatalystX::HelpText - Helper to include text/html snippets in Catalyst TT View templates
  10
  11 =head1 SYNOPSIS
  12
  13 Create a model class in your Catalyst project like:
  14     package TestApp::Model::Help;
  15     use Moose;
  16     use namespace::autoclean;
  17
  18     extends 'CatalystX::HelpText::Model';
  19
  20     1;
  21
  22 Configure it setting value for:
  23  - help_files_path: where the help files will be found
  24  - help_files_ext: what is the extension for the help files (default html)
  25
  26 Create files with the text/html to be included and store them at help_files_path.
  27
  28 Apply the CatalystX::HelpText::ViewRole in your TT View.
  29
  30 Uses the [% helptext('SomeHelpTopic') %] in your templates to include the file SomeHelpTopic.html in the page.
  31
  32 Uses the script bin/search_undocumented_templates.pl to find the missing help text files.
  33
  34 =head1 AUTHOR
  35
  36 Thomas Doran,C<t0m at state51.co.uk>
  37 Cinxgler Mariaca Minda,C<cinxgler at ci-info.com>
  38
  39 =head1 COPYRIGHT
  40
  41 Copyright state51.
  42
  43 =head1 LICENSE
  44
  45 This sofware is free software, and is licensed under the same terms as perl itself.
  46
  47 =cut
  48