File Coverage

lib/YAML/Yuyu.pm

Criterion	Covered	Total	%
statement	29	107	27.1
branch	1	32	3.1
condition	0	5	0.0
subroutine	8	15	53.3
pod	3	7	42.8
total	41	166	24.7

package YAML::Yuyu;

use strict;
use warnings;

use Carp;

=head1 NAME

    YAML::Yuyu - Easily create presentations from a YAML file.

=head1 SYNOPSIS

    my $yuyu = new YAML::Yuyu( path => $path,
                                 plantilla => 'plantilla.tmpl',
                                 contenido => 'contenido.yaml' );

    # From an array of pre-loaded or programatically created slides
    use YAML qw(LoadFile);
    @slides = LoadFile('yourslides.yaml');
    my $yuyu = new YAML::Yuyu( path => $path,
                               plantilla => 'plantilla.tmpl',
                               contenido => \@slides  );

    # From a glob; v. gr. data behind the __END__ marker
    my $yuyu3 = YAML::Yuyu->new( path => $path,
			         plantilla => $plantilla,
			         contenido => \*main::DATA );

    my $nth_slide = $yuyu->slide( $n );
    my $front_page = $yuyu->portada();
    my $index = $yuyu->index();

=cut

=head1 DESCRIPTION

Derived from L, which is a way cool module, this module
loads a YAML from which it derives a presentation: index, slides, and
so on. It can be used from another module, but you'll usually want to
do it from the scripts for standalone presentations (with its own web
server, no less) or to generate a single or several HTML pages you'll
want to present from somewhere else or upload to a website.

=head1 USAGE

Stand-alone presentation tool. It will use default templates, if none
is indicated

    bash$ yuyupress presentation.yaml [path-to-templates] [template(s)]

Generate a web page with the presentation

    bash$ yuyugen presentation.yaml [path-to-templates] [template(s)]

=head1 METHODS

=cut

use YAML qw(LoadFile Load); # Para configuración
use Template;
use Exporter;

our ($CVSVERSION) = ( '$Revision: 1.15 $' =~ /(\d+\.\d+)/ ) ;

#Declaración de propiedades
use Object::props qw( path plantilla contenido );

use Class::constr {
  init => sub {
    my $template = Template->new( {INCLUDE_PATH => $_[0]->path } );
    $_[0]->{_template} = $template;
    my @stream;
    if ( ref $_[0]->contenido eq '' ) {
      @stream =  LoadFile( $_[0]->contenido );
    } elsif ( ref $_[0]->contenido eq 'ARRAY' ) {
      @stream = @{$_[0]->contenido};
    } elsif ( ref $_[0]->contenido eq 'GLOB' ) {
      my $glob = $_[0]->contenido;
      my $stream = join('',<$glob>);
      @stream = Load($stream);
    }
    carp "Bad content stream" if !@stream;
    $_[0]->{_portada} = shift @stream;
    $_[0]->{_slides} = \@stream;
    $_[0]->{_doc} = $_[0]->plantilla;
    $_[0]->{_size } = scalar @stream - 1;
  }
};

=head2 portada

C is the main page; it returns the title and general front matter for the presentation

=cut

sub portada {
  my $self = shift;
  my %data = %{$self->{_portada}->[0]};
  my $contenido=<
$data{'autor'}

$data{'email'}

$data{'sitio'}

Comienzo
EIF
  my $salida;
  $self->{_template}->process( $self->plantilla,
			       { titulo => $data{'titulo'},
				 contenido => $contenido },
			       \$salida )
    || die $self->{_template}->error(), "\n"; ;
  return $salida;
}


=head2 slide

C( $slide_number) returns the $slide_number'th slide from the presentation

=cut

sub slide {
  my $self = shift;
  my $nr = shift || 0;
  die if ($nr > $self->{_size}) || ($nr < 0);
  my @slide = @{$self->{_slides}[$nr]};
  my $salida;
  my $titulo = shift @slide;
  my $contenido;
  $contenido = procesa(\@slide  );
  my $navegacion;
  if ( $nr ) {
    $navegacion .= "Anterior ";
  }
  $navegacion .= "Índice ";
  if ( $nr < $self->{_size} ) {
    $navegacion .= "Siguiente ";
  }
  $self->{_template}->process( $self->plantilla,
			       { titulo => $titulo,
				 contenido => $contenido,
				 navegacion => $navegacion,
				 number => $nr+1
			       },
			       \$salida )
    || die $self->{_template}->error(), "\n"; ;
  return $salida;
};

=head2 indice

Returns the presentation index

=cut

sub indice {
  my $self = shift;
  my $i;
  my $contenido="".
    join("\n",
	 map("".$_->[0]."", @{$self->{_slides}} ) )."";

  my $salida;
  $self->{_template}->process( $self->plantilla,
			       { titulo => 'Indice',
				 contenido => $contenido
			       },
			       \$salida )
    || die $self->{_template}->error(), "\n"; ;
  return $salida;
}


sub procesa {
  my $yref = shift;
  my $contenido='';
  if (@$yref > 0 ) {
    $contenido = "".procesaArray( $yref )."";
  } else {
    $contenido = procesaItem( $yref );
  }
  return $contenido;
}

sub procesaArray {
  my $yref = shift;
  my $contenido='';
  for ( @$yref ) {
    $contenido .= procesaItem( $_ )."\n";
  }
  return $contenido;
}

sub procesaHash {
  my $yref = shift;
  my $contenido='';
  for ( keys %$yref ) {
    $contenido .= "$_\n";
    for my $i ( @{$yref->{$_}} ) {
      $contenido .= procesaItem( $i );
    }
    $contenido .="\n";
  }
  $contenido .= "";
  return $contenido;
}

sub procesaItem {
  my $yref = shift;
  my $contenido='';
  if ( ref $yref eq '' ) {
    $contenido.= "$yref";
  } else {
    my $tag = ref $yref;
    if ( $tag eq 'ARRAY' ) {
      $contenido = procesaArray( $yref );
    } elsif ( $tag eq 'HASH' ) {
      $contenido = procesaHash( $yref );
    } else {
      $contenido = "<$tag";
      for ( keys %$yref ) {
	if ( $_ ne 'body' ) {
	  $contenido .= " $_='$yref->{$_}'";
	}
      }
      if ( $yref->{'body'} ) {
	$contenido.=">".$yref->{'body'}."";
      } else {
	$contenido.=">";
      }
    }
  }
  return $contenido;
}

=head1 Copyright

  This file is released under the GPL. See the LICENSE file included in this distribution,
  or go to http://www.fsf.org/licenses/gpl.txt

  CVS Info: $Date: 2008/02/11 13:03:55 $
  $Header: /home/jmerelo/repos/yuyupress/lib/YAML/Yuyu.pm,v 1.15 2008/02/11 13:03:55 jmerelo Exp $
  $Author: jmerelo $
  $Revision: 1.15 $

=cut


'Sacabó';