A universal module for generating Lorem Ipsum placeholder text. Used on https://getlorem.com
JavaScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
test
.gitignore
LICENSE
README.md
bower.json
package.json

README.md

getlorem

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>