{
    "content": [
        {
            "type": "text",
            "text": "# HTML::TagCloud (perldoc)\n\n## NAME\n\nHTML::TagCloud - Generate An HTML Tag Cloud\n\n## SYNOPSIS\n\n# A cloud with tags that link to other web pages.\nmy $cloud = HTML::TagCloud->new;\n$cloud->add($tag1, $url1, $count1);\n$cloud->add($tag2, $url2, $count2);\n$cloud->add($tag3, $url3, $count3);\nmy $html = $cloud->htmlandcss(50);\n# A cloud with tags that do not link to other web pages.\nmy $cloud = HTML::TagCloud->new;\n$cloud->addstatic($tag1, $count1);\n$cloud->addstatic($tag2, $count2);\n$cloud->addstatic($tag3, $count3);\nmy $html = $cloud->htmlandcss(50);\n# A cloud that is comprised of tags in multiple categories.\nmy $cloud = HTML::TagCloud->new;\n$cloud->add($tag1, $url1, $count1, $category1);\n$cloud->add($tag2, $url2, $count2, $category2);\n$cloud->add($tag3, $url3, $count3, $category3);\nmy $html = $cloud->htmlandcss(50);\n# The same cloud without tags that link to other web pages.\nmy $cloud = HTML::TagCloud->new;\n$cloud->addstatic($tag1, $count1, $category1);\n$cloud->addstatic($tag2, $count2, $category2);\n$cloud->addstatic($tag3, $count3, $category3);\nmy $html = $cloud->htmlandcss(50);\n# Obtaining uncategorized HTML for a categorized tag cloud.\nmy $html = $cloud->htmlwithoutcategories();\n# Explicitly requesting categorized HTML.\nmy $html = $cloud->htmlwithcategories();\n\n## DESCRIPTION\n\nThe HTML::TagCloud module enables you to generate \"tag clouds\" in HTML. Tag clouds serve as a\ntextual way to visualize terms and topics that are used most frequently. The tags are sorted\nalphabetically and a larger font is used to indicate more frequent term usage.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **CONSTRUCTOR**\n- **METHODS** (1 subsections)\n- **AUTHOR**\n- **COPYRIGHT**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "HTML::TagCloud",
        "section": "",
        "mode": "perldoc",
        "summary": "HTML::TagCloud - Generate An HTML Tag Cloud",
        "synopsis": "# A cloud with tags that link to other web pages.\nmy $cloud = HTML::TagCloud->new;\n$cloud->add($tag1, $url1, $count1);\n$cloud->add($tag2, $url2, $count2);\n$cloud->add($tag3, $url3, $count3);\nmy $html = $cloud->htmlandcss(50);\n# A cloud with tags that do not link to other web pages.\nmy $cloud = HTML::TagCloud->new;\n$cloud->addstatic($tag1, $count1);\n$cloud->addstatic($tag2, $count2);\n$cloud->addstatic($tag3, $count3);\nmy $html = $cloud->htmlandcss(50);\n# A cloud that is comprised of tags in multiple categories.\nmy $cloud = HTML::TagCloud->new;\n$cloud->add($tag1, $url1, $count1, $category1);\n$cloud->add($tag2, $url2, $count2, $category2);\n$cloud->add($tag3, $url3, $count3, $category3);\nmy $html = $cloud->htmlandcss(50);\n# The same cloud without tags that link to other web pages.\nmy $cloud = HTML::TagCloud->new;\n$cloud->addstatic($tag1, $count1, $category1);\n$cloud->addstatic($tag2, $count2, $category2);\n$cloud->addstatic($tag3, $count3, $category3);\nmy $html = $cloud->htmlandcss(50);\n# Obtaining uncategorized HTML for a categorized tag cloud.\nmy $html = $cloud->htmlwithoutcategories();\n# Explicitly requesting categorized HTML.\nmy $html = $cloud->htmlwithcategories();",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 34,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 11,
                "subsections": []
            },
            {
                "name": "CONSTRUCTOR",
                "lines": 18,
                "subsections": []
            },
            {
                "name": "METHODS",
                "lines": 26,
                "subsections": [
                    {
                        "name": "html",
                        "lines": 21
                    }
                ]
            },
            {
                "name": "AUTHOR",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 5,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "HTML::TagCloud - Generate An HTML Tag Cloud\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "# A cloud with tags that link to other web pages.\nmy $cloud = HTML::TagCloud->new;\n$cloud->add($tag1, $url1, $count1);\n$cloud->add($tag2, $url2, $count2);\n$cloud->add($tag3, $url3, $count3);\nmy $html = $cloud->htmlandcss(50);\n\n# A cloud with tags that do not link to other web pages.\nmy $cloud = HTML::TagCloud->new;\n$cloud->addstatic($tag1, $count1);\n$cloud->addstatic($tag2, $count2);\n$cloud->addstatic($tag3, $count3);\nmy $html = $cloud->htmlandcss(50);\n\n# A cloud that is comprised of tags in multiple categories.\nmy $cloud = HTML::TagCloud->new;\n$cloud->add($tag1, $url1, $count1, $category1);\n$cloud->add($tag2, $url2, $count2, $category2);\n$cloud->add($tag3, $url3, $count3, $category3);\nmy $html = $cloud->htmlandcss(50);\n\n# The same cloud without tags that link to other web pages.\nmy $cloud = HTML::TagCloud->new;\n$cloud->addstatic($tag1, $count1, $category1);\n$cloud->addstatic($tag2, $count2, $category2);\n$cloud->addstatic($tag3, $count3, $category3);\nmy $html = $cloud->htmlandcss(50);\n\n# Obtaining uncategorized HTML for a categorized tag cloud.\nmy $html = $cloud->htmlwithoutcategories();\n\n# Explicitly requesting categorized HTML.\nmy $html = $cloud->htmlwithcategories();\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "The HTML::TagCloud module enables you to generate \"tag clouds\" in HTML. Tag clouds serve as a\ntextual way to visualize terms and topics that are used most frequently. The tags are sorted\nalphabetically and a larger font is used to indicate more frequent term usage.\n\nExample sites with tag clouds: <http://www.43things.com/>, <http://www.astray.com/recipes/> and\n<http://www.flickr.com/photos/tags/>.\n\nThis module provides a simple interface to generating a CSS-based HTML tag cloud. You simply\npass in a set of tags, their URL and their count. This module outputs stylesheet-based HTML. You\nmay use the included CSS or use your own.\n",
                "subsections": []
            },
            "CONSTRUCTOR": {
                "content": "new\nThe constructor takes a few optional arguments:\n\nmy $cloud = HTML::TagCloud->new(levels=>10);\n\nif not provided, levels defaults to 24\n\nmy $cloud = HTML::TagCloud->new(distinguishadjacenttags=>1);\n\nIf distinguishadjacenttags is true HTML::TagCloud will use different CSS classes for adjacent\ntags in order to be able to make it easier to distinguish adjacent multi-word tags. If not\nspecified, this parameter defaults to a false value.\n\nmy $cloud = HTML::TagCloud->new(categories=>\\@categories);\n\nIf categories are provided then tags are grouped in separate divisions by category when the HTML\nfragment is generated.\n",
                "subsections": []
            },
            "METHODS": {
                "content": "add\nThis module adds a tag into the cloud. You pass in the tag name, its URL and its count:\n\n$cloud->add($tag1, $url1, $count1);\n$cloud->add($tag2, $url2, $count2);\n$cloud->add($tag3, $url3, $count3);\n\naddstatic\nThis module adds a tag that does not link to another web page into the cloud. You pass in the\ntag name and its count:\n\n$cloud->addstatic($tag1, $count1);\n$cloud->addstatic($tag2, $count2);\n\ntags($limit)\nReturns a list of hashrefs representing each tag in the cloud, sorted by alphabet. Each tag has\nthe following keys: name, count, url and level.\n\ncss\nThis returns the CSS that will format the HTML returned by the html() method with tags which\nhave a high count as larger:\n\nmy $css  = $cloud->css;\n\nhtml($limit)\nThis returns the tag cloud as HTML without the embedded CSS (you should use both css() and",
                "subsections": [
                    {
                        "name": "html",
                        "content": "being placed in the cloud then the tags will be organized into divisions by category name. If a\nlimit is provided, only the top $limit tags are in the cloud, otherwise all the tags are in the\ncloud:\n\nmy $html = $cloud->html(200);\n\nhtmlwithcategories($limit)\nThis returns the tag cloud as HTML without the embedded CSS. The tags will be arranged into\ndivisions by category. If a limit is provided, only the top $limit tags are in the cloud.\nOtherwise, all tags are in the cloud.\n\nhtmlwithoutcategories($limit)\nThis returns the tag cloud as HTML without the embedded CSS. The tags will not be grouped by\ncategory if this method is used to generate the HTML.\n\nhtmlandcss($limit)\nThis returns the tag cloud as HTML with embedded CSS. If a limit is provided, only the top\n$limit tags are in the cloud, otherwise all the tags are in the cloud:\n\nmy $htmlandcss = $cloud->htmlandcss(50);\n"
                    }
                ]
            },
            "AUTHOR": {
                "content": "Leon Brocard, \"<acme@astray.com>\".\n",
                "subsections": []
            },
            "COPYRIGHT": {
                "content": "Copyright (C) 2005-6, Leon Brocard\n\nThis module is free software; you can redistribute it or modify it under the same terms as Perl\nitself.\n",
                "subsections": []
            }
        }
    }
}