comparison README.txt @ 5:0c2b1fe8f53f

update documentation a little
author k0s <k0scist@gmail.com>
date Sun, 14 Feb 2010 13:25:01 -0500
parents
children
comparison
equal deleted inserted replaced
4:28c7009bc463 5:0c2b1fe8f53f
1 wordstream
2 ==========
3
4 wordstream is a simple corpus of text associations and tools to use them. Feeding the corpus text will grow a stack of left to right word associations on a per word basis. Words are defined (for now) as the bits that sit between whitespace. The corpus can then be eaten: given a word, pop the top of its stack.
5
6 There are two interfaces to the corpus in the wordstream package:
7 wordstream and dissociate. Additional applications of wordstream can
8 also be imagined.
9
10 The wordstream source is at http://k0s.org/hg/wordstream
11
12
13 wordstream interface
14 --------------------
15
16 An interactive interface for eating and feeding the corpus. Wordstream has a command line interface, ``wordstream``, and a web interface usable by running ``paster serve wordstream.ini`` . In both cases, the usage is the same. From an initial corpus, the user types lines of text. wordstream will eat the corpus and print a response to the text and feed the user's lines to the corpus
17
18
19 dissociate interface
20 --------------------
21
22 Named after emacs' ``M-x dissociated-press`` (try it!), dissociate will feed documents to a corpus, scramble the corpus (shuffle the stack order for each word), and output the corpus eating itself, selecting random words, eating their associations, and then eating the associations of the associations until the corpus is empty. Dissociate has a command line interface (install the software and run ``dissociate --help`` for usage), and a web interface usable via paster serve dissociate.ini.
23
24 Applications
25 ------------
26
27 While the wordstream corpus is a simple model, the basic idea can be
28 used to
29
30 * Thesaurus: By feeding the corpus synonyms, wordstream could be used
31 as a thesaurus program. Synonymity could be indicated via either
32 word count or by position towards the top of the stack. The
33 thesaurus could be displayed as a web interface to allow automatic
34 suggestions while writing
35
36 * Writing analysis: The amount of text on the web is vast.
37 Wordstream could be used to present what is being talked about most
38 within a number of websites and what is associated to it.
39
40 * Collaborative fiction: Since wordstream can use a collective corpus
41 that is fed by interacting with it, several authors could
42 simultaneously iteract with the wordstream web interface each
43 feeding the collective corpus and literally eating each others'
44 words
45