The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Pod-CYOA-0.002
River stage zero No dependents
++
/ Pod::CYOA::Transformer

NAME

Pod::CYOA::Transformer - transform 'cyoa' regions

VERSION

version 0.002

OVERVIEW

Pod::CYOA::Transformer is a Pod::Elemental::Transformer implementation. It looks for a region with the format name cyoa and transforms it into a =item-list surrounded by html regions.

A cyoa region is written with pairs of ?-separated values representing page links and descriptions. For example:

  =for :cyoa
  ? pie-eating  ? eat a pie
  ? start       ? start over
  ? visit-lefty ? buy an "O"

...will become something like:

  =for html
  <div class='cyoa'>

  =over 4

  =item * If you'd like to L<eat a pie|@pie-eating>

  =item * If you'd like to L<start over|@start>

  =item * If you'd like to L<buy an "O"|@visit-lefty>

  =back

  =for html
  </div>

The @-prefix on the link targets is expected to be handled by Pod::CYOA::XHTML.

AUTHOR

Ricardo SIGNES <rjbs@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.