Skip to content

rsrchboy/pod-elemental-transformer-list-converter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build Status Kwalitee status Coverage Status

NAME

Pod::Elemental::Transformer::List::Converter - Convert a list to... something else

VERSION

This document describes version 0.002 of Pod::Elemental::Transformer::List::Converter - released July 10, 2015 as part of Pod-Elemental-Transformer-List-Converter.

SYNOPSIS

# somewhere inside your code...
my $transformer = Pod::Elemental::Transformer::List::Converter->new;
$transformer->transform_node($node);

DESCRIPTION

This Pod::Elemental::Transformer takes a given node's children, and converts any list commands to another command, head2 by default.

That is:

  • =item becomes =head2, and
  • =over and <=back> commands are dropped entirely.

As you can imagine, it's important to be selective with the nodes you run through this transformer -- if you pass the entire document to it, it will obliterate any lists found.

ATTRIBUTES

command

The command we change =item elements to; defaults to head2.

METHODS

command

Accessor to the command attribute.

transform_node($node)

Takes a node, and replaces any =item's with our target command (by default, =head2). We also drop any command elements found for =over and =back.

SEE ALSO

Please see those modules/websites for more information related to this module.

BUGS

Please report any bugs or feature requests on the bugtracker website https://github.com/RsrchBoy/pod-elemental-transformer-list-converter/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Chris Weyl cweyl@alumni.drew.edu

I'm a material boy in a material world

Please note I do not expect to be gittip'ed or flattr'ed for this work, rather it is simply a very pleasant surprise. I largely create and release works like this because I need them or I find it enjoyable; however, don't let that stop you if you feel like it ;)

Flattr, Gratipay, or indulge my Amazon Wishlist... If and *only* if you so desire.

COPYRIGHT AND LICENSE

This software is Copyright (c) 2012 by Chris Weyl.

This is free software, licensed under:

The GNU Lesser General Public License, Version 2.1, February 1999