dimsum

Dimsum generates lorem ipsum text. You can use it in your Node.js and web projects.

npm install dimsum
19 downloads in the last week
39 downloads in the last month

Dimsum

Dimsum generates lorem ipsum text. You can use it in your Node.js and web projects.

Build Status

Installation

With npm, just run:

npm install dimsum@0.1

Or grab the source from GitHub, and pull it into your own project.

Dimsum in two lines

var dimsum = require('dimsum');
dimsum(); // => 'Impedit ex veniam doloribus possimus quod laudantium...'

You can configure Dimsum to return HTML, too:

dimsum.configure({ format: 'html' });
dimsum(); // => '<p>Reiciendis fugit fuga ut placeat officiis nostrud...'

You can tell Dimsum exactly how much text you want:

dimsum(3);

In-browser replacement

Dimsum can also inject lorem ipsum into your static HTML! Just include the library and add tokens to your HTML:

<script src="/js/dimsum.js"></script>
<article>{{dimsum}}</article>

Dimsum will replace the token with one paragraph of HTML-formatted lorem ipsum. If you want more, just ask:

<article>{{dimsum:p3}}</article>

Flavors

Dimsum contains classic "latin" and "jabberwocky" flavors. Switching between them is easy:

dimsum.configure({ flavor: 'jabberwocky' });
dimsum() // => 'Frabjous snicker-snack to son brillig, took vorpal...'

You can even add your own flavors. Larger blocks of text work best:

dimsum.flavor('outerspace', 'This is not science fiction. This is a sober \
, realistic presentation prepared by leading scientists. I have found this \
statement so informative and interesting that I wish to share it with all the \
people of America, and indeed with all the people of the earth. I hope that it \
can be widely disseminated by all news media for it clarifies many aspects of \
space and space technology in a way which can be helpful to all people as the \
United States proceeds with its peaceful program in space science and exploration. \
Every person has the opportunity to share through understanding in the adventures \
which lie ahead.');

dimsum.configure({ flavor: 'outerspace' });
dimsum() // => Science clarifies every to realistic for news...

API

JavaScript:

// One unformatted paragraph of lorem ipsum
dimsum();

// Three unformatted paragraphs of lorem ipsum
dimsum(3);

// Three HTML-formatted paragraphs of lorem ipsum
dimsum(3, { format: 'html' });

// Two unformatted sentences of lorem ipsum
dimsum.sentence(2);

// Always use HTML
dimsum.configure({ format: 'html' });

// Always use Jabberwocky
dimsum.configure({ flavor: 'jabberwocky' });

// Get a list of available flavors
dimsum.flavors();

// Add a new flavor
dimsum.flavor( 'key', 'a large body of text' );

HTML:

<!-- Replace with one paragraph of lorem ipsum -->
<div>{{dimsum}}</div>

<!-- Replace with three paragraphs of lorem ipsum -->
<div>{{dimsum:p3}}</div>

<!-- Replace with four sentences of lorem ipsum -->
<span>{{dimsum:s4}}</div>

Misc

Dimsum is licensed under the MIT License. Feel free to use it however you like.

Issues or feature requests? https://github.com/ninjascribble/dimsum/issues

npm loves you