Skip to content

textarcana/textforms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Textforms

Synopsis

   perl script/shell.pl

Textforms is an interactive poetry template engine.

If you seed a random number generator with numbers, then it stands to reason that you should seed a poetry generator with poetry.

Poems you create will be saved in poetry/textforms.txt. If you want to save poems somewhere else, just put the path to the file (including the file name) in an environment variable called POETRY_FILE, eg:

  export POETRY_FILE=~/doggerel.txt

What kinds of poems can it generate?

The following poetic forms are supported:

  1. Haiku
  2. Linked Haiku
  3. Couplet
  4. Linked Couplets
  5. Sonnet
  6. English Sonnet
  7. Italian Sonnet
  8. Quatrain
  9. Villanelle
  10. Pantoum

How do I stop it?

The shell runs until you force it to quit by pressing Control C.

Forbidden Words

Textforms allows you to define a dictionary of words you don't want to be allowed in your poems.

Only a couple of example words are forbidden by default. You can forbid more words by editing lib/dictionary_of_forbidden_words

Why forbid certain words?

This practice was directly inspired by John Ashbery, who is assiduous about avoiding the re-use of words that he has already used in the past.

Dependencies

In order to run Textforms, you need the Lingua module from CPAN. Lingua is used to display the line numbers while you are composing. Use the following command (you may need to sudo)

  cpan Lingua::Any::Numbers

If you're on Windows and that fails, try installing Strawberry Perl, then rerunning the command.

Known Issues

Don't trust the line numbers when you are composing Pantoums. Line numbers should be correct for other poetic forms, however.

About

Poetic Template Engine

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages