Re: ePod - write easy and simple in easy-POD, convert to POD, and from there you know the way.

Thanks for the tip. But the idea of ePod is to always convert it to POD, and produce nice well formated POD. For example, this ePod:

=> Break Math
Some simple Math:

  ## A simple definition:
  A = B

  ## Now multiply both side by A:
  A**2 = AB

  ## Now add A**2 - 2AB in both sides:
  A**2 + A**2 - 2AB = AB + A**2 - 2AB 

  ## That we can simplify by:
  2(A**2 -AB) = A**2 - AB

  ## And finally we divide both sides by A**2 - AB:
  2 = 1

*> Soo, 2 is really equal 1?
*> But we didn't anything wrong!
*> Hummm, take a deep look!
Som link sample: L<X|http://somedomain>

=> Font
I<"The Last Theorem of Fermat".>
[download]

Will generate this POD:


=head1 Break Math

Some simple Math:

  ## A simple definition:
  A = B

  ## Now multiply both side by A:
  A**2 = AB

  ## Now add A**2 - 2AB in both sides:
  A**2 + A**2 - 2AB = AB + A**2 - 2AB

  ## That we can simplify by:
  2(A**2 -AB) = A**2 - AB

  ## And finally we divide both sides by A**2 - AB:
  2 = 1

=over 10

=item Soo, 2 is really equal 1?

=item But we didn't anything wrong!

=item Hummm, take a deep look!

Som link sample: L<X|http://somedomain>

=back

=head1 Font

I<"The Last Theorem of Fermat".>

=cut
[download]

Soo, ePod is indirectly suported by OODoc.

To generate the HTML files I use Pod::HtmlEasy

What I think interesting on OODoc is the use of templates to generate the HTML. How they work?

Graciliano M. P.
"Creativity is the expression of the liberty".

Comment on Re: ePod - write easy and simple in easy-POD, convert to POD, and from there you know the way. Select or Download Code

Replies are listed 'Best First'.
Re: Re: ePod - write easy and simple in easy-POD, convert to POD, and from there you know the way. by Anonymous Monk on Jan 14, 2004 at 16:03 UTC
But the idea of ePod is to always convert it to POD, and produce nice well formated POD. There is not a big difference between "can produce POD" (and HTML) and "always produces POD". So why a "But"? What I think interesting on OODoc is the use of templates to generate the HTML. How they work? Just like CGI templates: have a constant template, which indicates where dynamic data must be filled in. You can best look at the examples included in the distribution. For HTML you may need a lot of templates, but for POD it is very very simple. In my experience, POD (being a visual markup language) does not contain sufficient information to create good HTML. The resulting HTML can be much nicer. See for instance the Mail::Box docs. For the author, it still looks like POD...	[reply]

Replies are listed 'Best First'.

Re: Re: ePod - write easy and simple in easy-POD, convert to POD, and from there you know the way.
by Anonymous Monk on Jan 14, 2004 at 16:03 UTC

But the idea of ePod is to always convert it to POD, and produce nice well formated POD.

There is not a big difference between "can produce POD" (and HTML) and "always produces POD". So why a "But"?

What I think interesting on OODoc is the use of templates to generate the HTML. How they work?

Just like CGI templates: have a constant template, which indicates where dynamic data must be filled in. You can best look at the examples included in the distribution. For HTML you may need a lot of templates, but for POD it is very very simple.

In my experience, POD (being a visual markup language) does not contain sufficient information to create good HTML. The resulting HTML can be much nicer. See for instance the Mail::Box docs. For the author, it still looks like POD...

[reply]