X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README;h=55bf29ab70b4e46b869c7a3ac72a9d10d2223d30;hb=1270168d62b6ab3b3ee5a923022577c99ba97f3a;hp=9af6fc325a1636e8ec688548b91f3727a4c1a3ed;hpb=030fd7f27657713fb185238ffd53c65326e0ee39;p=catagits%2FCatalystX-HelpText.git diff --git a/README b/README index 9af6fc3..55bf29a 100644 --- a/README +++ b/README @@ -1,14 +1,52 @@ NAME - CatalystX::HelpText - + CatalystX::HelpText - Helper to include text/html snippets in Catalyst + View templates + +SYNOPSIS + Create a model class in your Catalyst project like: package + TestApp::Model::Help; use Moose; use namespace::autoclean; + + extends 'CatalystX::HelpText::Model'; + + 1; + + Configure it setting value for: + + help_files_path + Where the help files will be found + + help_files_ext + What is the extension for the help files (default: html) + + wrapper_tag + What tag will be used to wrap the shippet (default: span) + + wrapper_css_class + What css class will be applied to the wrapper tag (default: + help_text) + + Create files with the text/html to be included and store them at + help_files_path. + + Apply the CatalystX::HelpText::ViewRole in your View. + + Uses the "[% helptext('SomeHelpTopic') %]"in your templates to include + the file "SomeHelpTopic.html" in the page. + + Uses the script "search_undocumented_templates.pl" to find the missing + help text files. + +SEE ALSO + CatalystX::HelpText::Model + CatalystX::HelpText::ViewRole -DESCRIPTION -METHODS -BUGS AUTHOR - Cinxgler Mariaca Minda,"cinxgler at ci-info.com" + Toomas Doran, "t0m at state51.co.uk" + + Cinxgler Mariaca Minda, "cinxgler at ci-info.com" COPYRIGHT - Copyright state51. + Copyright Oscar Music and Media 2011. LICENSE This sofware is free software, and is licensed under the same terms as