Show quoted text> This was a long way to find that modules are missing. Where are the
> prerequisites?
You mean the listing of distribution required to install
PerlPoint::Package, found in Makefile.PL, I assume.
The problem is that the generator, formatter and template modules are no
prerequisites in the usual sense. They are *not* required to use
perlpoint, basically. Instead, being plugins they add optional
functionality:
* perlpoint is a general converter that can produce various output
formats. To do so, it uses plugins.
* -target ABC is a request to produce format ABC. By convention, it
is accepted there is a module PerlPoint::Generator::ABC that
provides the necessary functionality. perlpoint searches for the
module and complains if it is not installed.
* Likewise, -formatter DEF (used with -target ABC) is a request to
format the ABC output the DEF way. Again, by convention it is
expected the necessary module is installed as
PerlPoint::Generator::ABC::DEF. If it cannot be found, perlpoint
recommends to install it.
* A similar concept is true for the template engines which can be
plugged in. The template engine use is usually hidden in styles.
Again, it seems the documentation of PerlPoint::Package did not clearly
explain this concept. I think it is explained clearly in the quick start
guide and the tutorial, but it seems the package docs need to be
improved. Could you please tell me which documentation you read?
perlpoint -h also provides an intro but I confess it is misleading, as
it reports the XML plugins were installed with PerlPoint::Package. The
help needs to be fixed at this point.
As a note, the all-in-one packages mentioned above should contain all
available plugins and their prerequisites, so they can be used for an
instant start.
Show quoted text> --------------------------------------------
>
> D:\Perl\site\bin\perlpoint.bat --style perlpoint --target XML --format
> XHTML::Paged Object-Lazy_STEFFENW.pp
>
> [Fatal] Missing plugin PerlPoint::Generator::XML, please install it
The generator plugin module is missing and perlpoint recommends to
install it.
Show quoted text> --------------------------------------------
>
> Installing: XML::Generator
>
> --------------------------------------------
>
> D:\Perl\site\bin\perlpoint.bat --style perlpoint --target XML --format
> XHTML::Paged Object-Lazy_STEFFENW.pp
> [Fatal] Missing plugin PerlPoint::Generator::XML::XHTML::Paged, please
> install it (Can't locate HTML/TagCloud/Extended.pm in @INC (@INC
You are right, here a prerequisite listing is missing and needs to be
added to the plugins distribution.
Show quoted text> --------------------------------------------
>
> Installing: HTML::TagCloud::Extended
>
> --------------------------------------------
>
The following messages are related to missing mandatory options. An
explanation of these options is given when calling
perlpoint -help -target XML -formatter XHTML::Paged
Show quoted text> [Info] The PerlPoint parser 0.42 starts.
> Active contents is ignored.
> Paragraph cache is deactivated.
> [Info] Processing Object-Lazy_STEFFENW.pp ...
> [Error 1] Object-Lazy_STEFFENW.pp, line 1: File H:\pp\macros.pp does
> not exist or cannot be read (current directory: H:/pp).
> ... 13 chapters read.
> Object-Lazy_STEFFENW.pp was parsed in 0 seconds.
> [Info] Input contains 1 semantic error.
> [Info] Parsing completed.
>
> -----------------------------------------
>
> create an empty file: macros.pp
>
> because macros.pp is default for the "German Perl Workshop" handout
> layout
Alternatively, if the macros are not required to produce your slides,
you could delete the \INCLUDE tag for macros.pp in line 1.
Show quoted text> [Info] Parsing completed.
>
> [Info] Perl Point backend "PerlPoint::Generator::XML::XHTML::Paged"
> starts.
> ... 13 chapters processed.
> Stream processed in 1 seconds.
>
> [Info] Backend "PerlPoint::Generator::XML::XHTML::Paged" is ready.
>
> [Info] Finish started ...
> [Info] Finish completed.
Thank you for your report. I added the tasks to the todo lists and will
try to improve the next release in these points.
