Sentencer Lite
Sentencer Lite
is a Javascript module for madlibs-style sentence templating. It has been forked from Sentencer, which is a great module.
For those who create custom lists that are more specific than nouns and adjectives and who don't need the word files (totaling 78.3 KB), consider this module.
It is a simple templating engine that accepts strings with actions embedded in them:
"This is {{ an_animal }}."
Where each action returns a random string selected from a list:
"This is a dog."
Think of it as madlibs for Javascript. Want to roll your own lorem ipsum generator? Sentencer Lite
allows you to write the structure of your sentences and plug in any kind of vocabulary you choose.
How
npm install sentencer-lite --save
Here are all of the options, described in detail below.
var SentencerLite = ; SentencerLite;
Actions
Sentencer Lite
works by recognizing "actions" within {{ double_brackets }}
. It replaces these actions with strings. There are no default actions, but you can extend Sentencer Lite
to include any custom list or action you need!
NOTE: If you want default actions such as {{ noun }}
, {{ a_noun }}
, {{ nouns }}
, {{ adjective }}
, and {{ an_adjective }}
then Sentencer is a better option for you.
The actions in Sentencer Lite
are written semantically so that your sentence template still reads as a sentence. While this was simply a design decision, it does make templates easier to read and you are encouraged to follow this format if you create custom actions.
Add your own actions
When configuring Sentencer Lite
you can provide your own "actions", which are just functions that return something. The name of the function that you pass into actions
is how you will reference it within a sentence template.
Here's an example of an action that returns a random number from 1 to 10.
var SentencerLite = ; SentencerLite; console
Actions can take arguments
You can pass arguments into your actions. We can use this to make a smarter version of the random number generator above...
var SentencerLite = ; SentencerLite; console
Add your own custom lists
When configuring Sentencer Lite
you can provide your own custom lists, which are converted to "actions". The key
sets the name of the action and the values
the list of values where one is selected when the action is called. You can also specify a name for the articlize
and/or pluralize
actions. These names are referenced within a sentence template.
Here is an example of an animal list that includes options to prefix with an article or to make it plural.
var SentencerLite = ; SentencerLite; console
Where are the verbs?
Verb pluralization, singularization, and tense modification are difficult computer science problems. Sentencer Lite
doesn't aim to solve those problems, however present tense verb pluralization/singularization is an experimental feature of natural
and could be integrated if necessary.
Sentencer Lite
was forked from Sentencer and is maintained by Mark Tucker.
Sentencer was created and is maintained by Kyle Stetz. The original prototype came out of Metaphorpsum but has been rewritten from the ground up.