Merge branch 'testing'

README.md

@@ -1,4 +1,3 @@
-
 ## disclaimer
 
 i wrote this cli rapper for the `markovify` python module because i wanted its features to be available as a cli tool.
@@ -11,7 +10,7 @@ maybe this functionality already exists somewhere, but i couldn't find it. if it
 
 ## mkv-this
 
-`mkv-this` is a little script that outputs a bunch of bot-like sentences based on a bank of text that you feed it. the results are saved to a text file. if you run it again with the same output file, the new results are appended after the old ones.
+`mkv-this` is a script that outputs a bunch of bot-like sentences based on a bank of text that you feed it, either from a local text file or a URL, and saves the results to a text file. if you run it again with the same output file, the new results are appended after the old ones.
 
 a second command, `mkv-this-dir` (see below) allows you to input a directory and it will read all text files within it as the input.
 
@@ -44,21 +43,18 @@ the script implements a number of the basic `markovify` options, so you can spec
 * a maximum sentence length, in characters.
 * the amount of (verbatim) overlap allowed between input and output.
 * if your text's sentences end with newlines rather than full-stops.
-* an additional file to use for text input. you can add only one. if you want to feed a stack of files into your bank, use `mkv-this-dir`.
+* an additional file or URL to use for text input. you can add only one. if you want to feed a stack of files into your bank, use `mkv-this-dir`.
 * the relative weight to give to the second file if it is used.
 
-as of 0.1.29 you can also specify:
-
-* a URL to a text file online. (you can input something that isn't a text file but the results will be mush or the programme will crash.)
-* an additional URL to use as text input.
-
 run `mkv-this -h` to see how to use these options.
 
 ### mkv-this-dir: markovify a directory of text files
 
-`mkv-this` can only take two files as input. if you want to input a stack of files, use `mkv-this-dir`. specify a directory and all text files in it will be used as input.
+if you want to input a stack of files, use `mkv-this-dir` instead. specify a directory and all text files in it will be used as input.
 
-if for some reason you want to get a similar funtionality with `mkv-this`, you can easily concatenate files yourself from the command line, then process them:
+as with `mkv-this` you can also combine this directory with a URL.
+
+if for some reason you want to get a similar funtionality with `mkv-this`, you can easily concatenate the files yourself from the command line, then process the resulting file:
 
 * copy all your text files into a directory
 * cd into the directory
@@ -72,7 +68,7 @@ you need to input plain text files. currently accepted file extensions are `.txt
 
 ### for best results
 
-feed `mkv-this` large-ish amounts of well punctuated text. it works best if you bulk replace/remove as much mess as possible (URLs, code, HTML tags, metadata, stars, bullets, lines, etc.), unless you want mashed versions of those things in your output.
+feed `mkv-this` large-ish amounts of well punctuated text. it works best if you bulk replace/remove as much mess as possible (URLs, code, HTML tags, metadata, stars, bullets, lines, etc.), unless you want mashed versions of those things in your output. (no need to clean up URLs though.)
 
 you’ll probably want to edit or select things from the output. it is very much supposed to be a kind of raw material rather than print-ready boilerplate bosh, although many bots are happily publishing such output directly. you might find that it prompts you to edit it like a bot yourself.
 
@@ -91,5 +87,4 @@ i know nothing about macs so if you ask me for help i'll just send you random co
 ### todo
 
 * option to also append input model to a saved JSON file. (i.e. `text_model.to_json()`, `markovify.Text.from_json()`)
-* maybe some copy in some basic webscraping boilerplate code.
 * learn how to programme.