Twaddle

A never ending stream of nonsense using Markov chains and speeches of famous people.

This module is an extension to the excellent Markoff module, that comes pre-packaged with data to quickly generate filler text from profiles of various speeches.

Using a supplied data pack

See the data directory for a full list of what data comes supplied with this module.

var twaddle = require('twaddle');

console.log( twaddle.generate('politics-us-kennedy-f-john', {sentences: 1}) ); // Ask not what your country...

Combining data packs

You can also supply twaddle.generate() with an array of ID's which will merge these data packs together:

var twaddle = require('twaddle');

console.log( twaddle.generate(['politics-us-trump-j-donald', 'politics-de-hitler-adolph'], {paragraphs: 5}) );

Using your own data

var twaddle = require('twaddle');

twaddle.register('lincoln', __dirname + '/test/data/gettysburg.txt'))

console.log( twaddle.generate({words: 10}) ); // Four score and eleven...

See the test directory for more complex examples.

API

twaddle.register(id, path)

Register a file of text against the ID to use later

twaddle.compile(id)

Compile the given ID into a chain. This is done automatically if generate(id) is called without the chain being present.

twaddle.generate([options={words:20}])

Generate the specified amount of text.

The options parameter can be constructed of the following keys:

| Key | Default | Description | |----------------------------|-------------|-------------------------------------------------------------------------------------------------------------------------| | words | 20 | Generate at minimum this number of words | | sentences | null | Generate at minimum this number of sentences | | paragraphs | null | Generate at minimum this number of paragraphs (this can override sentences to produce its output | | minSentencesPerParagraph | 1 | The smallest number of sentences that can constitute a paragraph | | maxSentencesPerParagraph | 5 | The largest number of sentences that can constitute a paragraph | | paragraphJoiner | "\n\n" | The joining characters used between paragraphs | | paragraphStructure | [] | An array of the sentence length of each paragraph. If omitted this is calculated and randomized from the above settings | | fixTrim | true | Trim all paragraph content before output | | fixCapitalFirst | true | Check that all sentences have a capital letter first |

Credits

• American Rhetoric
• History Place
• Jewish Virtual Library
• Presidential Rhetoric