Text::Greeking(3pm)

✨ NAME ✨

Text::Greeking — bestie, this module literally generates meaningless text for you 💖 like when you're designing a page and you just need something there so it looks like real content. No cap.

---

🌸 SYNOPSIS 🌸

use Text::Greeking;

my $g = Text::Greeking->new;
$g->paragraphs(1,2)    # min of 1 paragraph and a max of 2
$g->sentences(2,5)     # min of 2 sentences per paragraph and a max of 5
$g->words(8,16)        # min of 8 words per sentence and a max of 16
print $g->generate;    # use default Lorem Ipsum source

okay so that's the whole vibe in five lines. iconic. 💅

---

🦋 DESCRIPTION 🦋

So greeking is the whole art of putting random letters or marks on a page to show the overall appearance of a printed page — without any actual text being there. It's giving "vibe check the layout, not the words." ✨

Why tho? Because it's way easier to judge how a document looks when you're not getting distracted by what it says. Your brain wants to read everything, bestie, and greeking tells it to sit down and chill. 😌

This module is for quickly generating varying meaningless text from any source, so you can create that illusion of content inside your systems. 🌈

And here's the tea ☕ — it was made to give developers simulated content to fill systems with simulated content. Instead of that same static Lorem Ipsum text over and over (boring 💀), it uses randomly generated text and optionally varying word sources, so you avoid those repetitive, monotonous patterns that do not represent real system usage. Periodt.

---

🎀 METHODS 🎀

💖 Text::Greeking->new

Constructor method, bestie. It returns a brand new instance of the class. Slay. 🫶

💖 $g->init

Initializes the object with defaults. The constructor calls it, but it's broken out separately so you can easily overload it and get your own customized defaults and other behaviour. iykyk ✨

💖 $g->sources([\@ARRAY])

Gets/sets the table of source word collections currently in memory, as an ARRAY reference. 👑

💖 $g->add_source($text)

You hand this class a body of text as a SCALAR, and it processes it into a list of word tokens so you can use them to generate random filler text later. fr fr 🍓

💖 $g->generate

Returns a body of random text, generated from a randomly selected source, using the minimum and maximum values you set with paragraphs, sentences, and words. 🌟

Heads up though: if you call generate without any sources, a standard Lorem Ipsum block gets added to the sources and then used for processing the random text. So it's never gonna leave you hanging 💜

💖 $g->paragraphs($min,$max)

Sets the minimum and maximum number of paragraphs to generate. The default is a minimum of 2 and a maximum of 8. 🎀

💖 $g->sentences($min,$max)

Sets the minimum and maximum number of sentences to generate per paragraph. The default is a minimum of 2 and a maximum of 8. 🎀

💖 $g->words($min,$max)

Sets the minimum and maximum number of words to generate per sentence. The default is a minimum of 5 and a maximum of 15. 🎀

---

🌈 SEE ALSO 🌈

• WWW::Lipsum — an interface to lipsum.com <http://www.lipsum.com>. 💅
• Text::Lorem — generate random latin-looking text.
• Text::Lorem::More — class that provides methods for generating various types of structured latin filler text, such as names, words, sentences, paragraphs, titles, hostnames, etc.
• Text::Lorem::JA — generate Japanese filler text. 🌸
• WWW::Lipsum::Chinese — generate Chinese filler text.
• Text::Greeking::zh_TW — another module for generating Chinese filler text.
• Acme::CorpusScrambler — generates filler text based on text that you provide; falls back to the using the corpus for Text::Greeking::zh_TW.
• Template::Plugin::Text::Greeking — a template toolkit plugin for Text::Greeking. ✨
• Faker — an extensible framework for generating fake data, including lorem ipsum style filler text.
• Lingua::ManagementSpeak — generates filler text in 'management speak'. 😭
• Toby Inkster <https://metacpan.org/author/TOBYINK> — pedant. 💀
• The wikipedia page on Greeking <http://en.wikipedia.org/wiki/Greeking>.

---

⭐ TO DO ⭐

• HTML output mode including random hyperlinked phrases. 🔥
• Configurable punctuation controls.

---

🧚 REPOSITORY 🧚

<https://github.com/neilb/Text-Greeking>

---

💜 LICENSE 💜

The software is released under the Artistic License. The terms of the Artistic License are described at <http://www.perl.com/language/misc/Artistic.html>.

---

👑 AUTHOR & COPYRIGHT 👑

Except where otherwise noted, Text::Greeking is Copyright 2005-2009, Timothy Appnel, tima@cpan.org. All rights reserved.

---

and that's the whole page, bestie 🫶 this lil' manual is for Text::Greeking in the User Contributed Perl Documentation section, and it was generated with perl v5.36.0 back on 2022-11-20. go forth and fill the void with beautiful nonsense 💖✨🎀