getlorem

Generate passages of Lorem Ipsum text, suitable for use as placeholder text in documents.

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
getlorem
1.0.17 years ago7 years agoMinified + gzip package size for getlorem in KB

Readme

Generate passages of Lorem Ipsum text, suitable for use as placeholder text in documents.
This library can be used as a Node.js module as well as a being included as a standalone script on a page via Require.js or in a script tag.
For a live demo see getlorem.com.

Installing the module (Node.js)

npm install getlorem

Require getlorem and use it to generate a passage of lorem ipsum text.
var getlorem = require('getlorem');

var output = getlorem.paragraphs(5);

Usage

Generating words

getlorem.words(5);

Generating sentences

getlorem.sentences(5);

Generating paragraphs

getlorem.paragraphs(5);

Generating lists

getlorem.lists(5);

Generating bytes

getlorem.bytes(5);

Wrapping text with HTML tags

If you would like to wrap the generated text with a tag, pass it as the second parameter.
getlorem.paragraphs(5,'p');

// Generates: <p>Lorem ipsum...</p><p>...</p><p>...</p>

Starting with 'Lorem ipsum...'

To generate a passage of text that begins with the opening 'Lorem ipsum…' sentence. Set the third parameter to true.
getlorem.paragraphs(4,'p',true);

Using the CLI (Node.js)

getlorem can be used from the command line. To do this, install it globally.
npm install getlorem --global

Execute the statement getlorem to generate lorem ipsum text.
getlorem --units words --count 200 --copy

Refine the output with the following arguments.
| Argument | Description | | -------- | ---------------------------------------- | | --units | Generate words, sentences, paragraphs, lists, bytes | | —count | The number of unites to be generated | | —copy | Copy to clipboard | | —tags | HTML tags to wrap the units | | —swl | Start with 'lorem ipsum...' |

As a jQuery plugin

This library can also be used as a jQuery plugin. Placing the attribute data-getlorem on any container element will populate that element with the assigned number of Lorem Ipsum words.
<div data-getlorem="50"></div>