xhtml2pdf(1) [debian man page]

XHTML2PDF(1)							   User Commands						      XHTML2PDF(1)

NAME

       xhtml2pdf - PDF generator using HTML and CSS

SYNOPSIS

       xhtml2pdf [-b base path] [--base=base path] [-c CSS file] [--css=CSS file] [--css-dump] [-d] [--debug] [--encoding=character encoding] [-h]
		 [--help] [-q] [--quiet] [--version] [-w] [--warn] [-x] [--xml] [--xhtml] [--html] [SRC] [DEST]

DESCRIPTION

       This manual page documents briefly the xhtml2pdf command.

       xhtml2pdf is an HTML-to-PDF converter using the ReportLab Toolkit, HTML5lib and pyPdf.

       It supports HTML 5 and CSS 2.1 (and some of CSS 3). It is completely written in pure Python so it is platform independent. The main benefit
       of this tool that a user with Web skills like HTML and CSS is able to generate PDF templates very quickly without learning new
       technologies. Easy integration into Python frameworks like CherryPy, KID Templating, TurboGears, Django, Zope, Plone, Google AppEngine
       (GAE) etc.

OPTIONS

       A summary of options is included below.

       SRC
	   Name of a HTML file or a file pattern using * placeholder. If you want to read from stdin use - as file name. You may also load an URL
	   over HTTP. Take care of putting the src in quotes if it contains characters like ?.

       DEST
	   Name of the generated PDF file or - if you like to send the result to stdout. Take care that the destination file is not already opened
	   by an other application like the Adobe Reader. If the destination is not writeable a similar name will be calculated automatically.

       -b, --base
	   Specify a base path if input comes via STDIN.

       -c, --css
	   Path to default CSS file

       --css-dump
	   Dumps the default CSS definitions to STDOUT.

       -d, --debug
	   Show debugging information.

       --encoding
	   The character encoding of SRC. If left empty (default) this information will be extracted from the HTML header data.

       -h, --help
	   Show the help text.

       -q, --quiet
	   Show no messages.

       --version
	   Show version information.

       -w, --warn
	   Show warnings

       -x, --xml, --xhtml
	   Force parsing in XML mode (automatically used if SRC ends with .xml).

       --html
	   Force parsin in HTML mode (default).

AUTHOR

       xhtml2pdf was written by Dirk Holtwick <dirk.holtwick@gmail.com>.

       This manual page was written by Toby Smithe <tsmithe@ubuntu.com>, for the Debian project (but may be used by others).

pisa								    02/08/2010							      XHTML2PDF(1)

HTML::TagCloud(3pm)					User Contributed Perl Documentation				       HTML::TagCloud(3pm)

NAME

       HTML::TagCloud - Generate An HTML Tag Cloud

SYNOPSIS

	 # A cloud with tags that link to other web pages.
	 my $cloud = HTML::TagCloud->new;
	 $cloud->add($tag1, $url1, $count1);
	 $cloud->add($tag2, $url2, $count2);
	 $cloud->add($tag3, $url3, $count3);
	 my $html = $cloud->html_and_css(50);

	 # A cloud with tags that do not link to other web pages.
	 my $cloud = HTML::TagCloud->new;
	 $cloud->add_static($tag1, $count1);
	 $cloud->add_static($tag2, $count2);
	 $cloud->add_static($tag3, $count3);
	 my $html = $cloud->html_and_css(50);

	 # A cloud that is comprised of tags in multiple categories.
	 my $cloud = HTML::TagCloud->new;
	 $cloud->add($tag1, $url1, $count1, $category1);
	 $cloud->add($tag2, $url2, $count2, $category2);
	 $cloud->add($tag3, $url3, $count3, $category3);
	 my $html = $cloud->html_and_css(50);

	 # The same cloud without tags that link to other web pages.
	 my $cloud = HTML::TagCloud->new;
	 $cloud->add_static($tag1, $count1, $category1);
	 $cloud->add_static($tag2, $count2, $category2);
	 $cloud->add_static($tag3, $count3, $category3);
	 my $html = $cloud->html_and_css(50);

	 # Obtaining uncategorized HTML for a categorized tag cloud.
	 my $html = $cloud->html_without_categories();

	 # Explicitly requesting categorized HTML.
	 my $html = $cloud->html_with_categories();

DESCRIPTION

       The HTML::TagCloud module enables you to generate "tag clouds" in HTML. Tag clouds serve as a textual way to visualize terms and topics
       that are used most frequently. The tags are sorted alphabetically and a larger font is used to indicate more frequent term usage.

       Example sites with tag clouds: <http://www.43things.com/>, <http://www.astray.com/recipes/> and <http://www.flickr.com/photos/tags/>.

       This module provides a simple interface to generating a CSS-based HTML tag cloud. You simply pass in a set of tags, their URL and their
       count.  This module outputs stylesheet-based HTML. You may use the included CSS or use your own.

CONSTRUCTOR

   new
       The constructor takes a few optional arguments:

	 my $cloud = HTML::TagCloud->new(levels=>10);

       if not provided, levels defaults to 24

	 my $cloud = HTML::TagCloud->new(distinguish_adjacent_tags=>1);

       If distinguish_adjacent_tags is true HTML::TagCloud will use different CSS classes for adjacent tags in order to be able to make it easier
       to distinguish adjacent multi-word tags.  If not specified, this parameter defaults to a false value.

	 my $cloud = HTML::TagCloud->new(categories=>@categories);

       If categories are provided then tags are grouped in separate divisions by category when the HTML fragment is generated.

METHODS

   add
       This module adds a tag into the cloud. You pass in the tag name, its URL and its count:

	 $cloud->add($tag1, $url1, $count1);
	 $cloud->add($tag2, $url2, $count2);
	 $cloud->add($tag3, $url3, $count3);

   add_static
       This module adds a tag that does not link to another web page into the cloud.  You pass in the tag name and its count:

	 $cloud->add_static($tag1, $count1);
	 $cloud->add_static($tag2, $count2);

   tags($limit)
       Returns a list of hashrefs representing each tag in the cloud, sorted by alphabet. Each tag has the following keys: name, count, url and
       level.

   css
       This returns the CSS that will format the HTML returned by the html() method with tags which have a high count as larger:

	 my $css  = $cloud->css;

   html($limit)
       This returns the tag cloud as HTML without the embedded CSS (you should use both css() and html() or simply the html_and_css() method). If
       any categories were specified when items were being placed in the cloud then the tags will be organized into divisions by category name.
       If a limit is provided, only the top $limit tags are in the cloud, otherwise all the tags are in the cloud:

	 my $html = $cloud->html(200);

   html_with_categories($limit)
       This returns the tag cloud as HTML without the embedded CSS.  The tags will be arranged into divisions by category.  If a limit is
       provided, only the top $limit tags are in the cloud.  Otherwise, all tags are in the cloud.

   html_without_categories($limit)
       This returns the tag cloud as HTML without the embedded CSS.  The tags will not be grouped by category if this method is used to generate
       the HTML.

   html_and_css($limit)
       This returns the tag cloud as HTML with embedded CSS. If a limit is provided, only the top $limit tags are in the cloud, otherwise all the
       tags are in the cloud:

	 my $html_and_css = $cloud->html_and_css(50);

AUTHOR

       Leon Brocard, "<acme@astray.com>".

COPYRIGHT

       Copyright (C) 2005-6, Leon Brocard

       This module is free software; you can redistribute it or modify it under the same terms as Perl itself.

perl v5.12.3							    2011-06-18						       HTML::TagCloud(3pm)