lorem-hipsum
v0.1.7
Published
Generates passages of lorem hipsum text
Downloads
6,927
Maintainers
Readme
lorem-hipsum
lorem-hipsum is a npm module for generating passages of lorem hipsum text. lorem hipsum text is not commonly used as placeholder text in publishing, graphic design, and web development, but should be.
Why Fork?
We all love lorem ipsum but deep down inside we know it's not the artisanal filter text we really crave.
Getting Started
Install the lorem-hipsum npm module locally in your project
npm install lorem-hipsum --save-dev
Require the lorem-hipsum module and use it to generate a passage of lorem hipsum text.
var loremHipsum = require('lorem-hipsum'),
output = loremHipsum();
Options
You can customize the output with options.
Pass the options to the loremHipsum()
function to fine-tune the output. The API is the same programatically and on the CLI. See below:
var loremHipsum = require('lorem-hipsum'),
output = loremHipsum();
output = loremHipsum({
count: 1, // Number of words, sentences, or paragraphs to generate.
units: 'sentences', // Generate words, sentences, or paragraphs.
sentenceLowerBound: 5, // Minimum words per sentence.
sentenceUpperBound: 15, // Maximum words per sentence.
paragraphLowerBound: 3, // Minimum sentences per paragraph.
paragraphUpperBound: 7, // Maximum sentences per paragraph.
format: 'plain', // Plain text or html
words: ['ad', 'dolor', ... ], // Custom word dictionary. Uses dictionary.words (in lib/dictionary.js) by default.,
random: Math.random, // A PRNG function. Uses Math.random by default
});
Using it globally from the CLI
lorem-hipsum includes a command line interface for generating passages of lorem hipsum text. Install the module globally to take advantage of this feature.
npm install lorem-hipsum --global
Execute the statement lorem-hipsum
from your terminal to generate a passage of lorem hipsum text. You can pass arguments to the program to fine-tune the output.
lorem-hipsum --units words --count 100 --copy
Or using the shorthand way to easily copy a sentence to your clipboard.
hipsum --copy
See below for a description of the arguments to the program.
You may now also use a short form when running lorem hipsum from the command line. Here's some examples:
lorem-hipsum 1 word
lorem-hipsum 15 sentences --copy
lorem-hipsum 5 paragraphs --copy --format html
Shoutouts
Special thanks for @boohah for doing a dump of the http://hipsum.co database on his gist
To @hipsum_ for the artisanal corpus.
And to @knicklabs for all of the heavy lifting and original module.
License
This software is licensed under the MIT license.
Copyright (c) 2015 Petar Bojinov