Skip to content

A universal module for generating Lorem Ipsum placeholder text. Used on https://getlorem.com

License

Notifications You must be signed in to change notification settings

lukehaas/getlorem

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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>