HTML-Make-Page
2 results

 view release on metacpan or  search on metacpan

lib/HTML/Make/Page.pod  view on Meta::CPAN 

    my ($html, $body) = make_page (title => 'Personal Home Page', lang => 'en');
    $body->add_text (<<EOF);
    <img src='under-construction.gif' alt='This site is ALWAYS under construction!!!'>
    <p>Personal details</p>
    EOF
    print $html->text ();


produces output

    <!DOCTYPE html>
    <html lang="en">
    <head>
    <meta charset="UTF-8">
    <meta content="width=device-width, initial-scale=1.0" name="viewport">
    <title>Personal Home Page</title>
    </head>
    <body>
    <img src='under-construction.gif' alt='This site is ALWAYS under construction!!!'>
    <p>Personal details</p>
    </body>
    </html>


(This example is included as L<F<synopsis.pl>|https://fastapi.metacpan.org/source/BKB/HTML-Make-Page-0.04/examples/synopsis.pl> in the distribution.)


=head1 VERSION

This documents version 0.04 of HTML-Make-Page
corresponding to L<git commit a4b30a2e24715e722e5ae536ede7e8bab77facf8|https://github.com/benkasminbullock/html-make-page/commit/a4b30a2e24715e722e5ae536ede7e8bab77facf8> released on Mon Jul 31 07:13:34 2023 +0900.

=head1 DESCRIPTION

This module simplifies generating the <head> and <body> elements of an
HTML page using L<HTML::Make>.

=head2 Restrictions

The output is restricted to the following variants of HTML:

=over

=item HTML 5 only

The output has a doctype of C<< <!DOCTYPE html> >>.

=item Lower-case tags only

No <HTML> etc., the tags generated are lower-case only.

=item UTF-8 encoding only

The output has C<< <meta charset='UTF-8'> >> added automatically.

=item Viewport is added automatically

The viewport meta element, necessary for viewing web pages on mobile
phones, is automatically added to the output.

=item XHTML tags are not supported

XHTML tags of the form C<< <br/> >> are not necessary in HTML 5 and
are not supported.

=back

=head1 FUNCTIONS

=head2 make_page

    my ($html, $body) = make_page (title => 'My Cool Page');

The argument to the function is a hash of options of the form
C<make_page (%options)>. The options are as follows.

=head3 Options

=over

=item css

An array reference giving a list of style sheets to be added using
<link> in <head>.


    my ($h, $b) = make_page (css => ['my.css', 'your.css']);

=item js

An array reference of names of JavaScript files you want to include in
your header. To add C<async> or C<defer> to the script tag, use a hash
reference in place of the name of the script with the keys C<src> for
the file and then any true value for C<async> or C<defer> to add
those.

To add JavaScript as text, use a field C<text>.


    my ($h, $b) = make_page (js => ['cat.js', 'dog.js', {src => 'parrot.js', async => 1}]);

=item lang

The language of your page, for example "en" for English. This is added
to the opening <html> tag.


    my ($h, $b) = make_page (lang => "en");

=item link

Link elements. The value must be an array reference containing hash
references. Each hash reference must contain the compulsory C<rel>
key, otherwise it is not included in the output. 

If no C<href> is present, a warning is printed. This warning may be
turned off with L</quiet>.

CSS stylesheets can be added using this, but they can also be added
more simply using the L</css> option.


    my ($h, $b) = make_page (link => [{rel=>"icon", type=>"image/png", href=>"favicon.png"}]);



( run in 0.628 second using v1.01-cache-2.11-cpan-f0fbb3f571b )