aboutsummaryrefslogtreecommitdiffstats
path: root/examples/rest_pastebin/README.asciidoc
diff options
context:
space:
mode:
Diffstat (limited to 'examples/rest_pastebin/README.asciidoc')
-rw-r--r--examples/rest_pastebin/README.asciidoc47
1 files changed, 47 insertions, 0 deletions
diff --git a/examples/rest_pastebin/README.asciidoc b/examples/rest_pastebin/README.asciidoc
new file mode 100644
index 0000000..d0cabc1
--- /dev/null
+++ b/examples/rest_pastebin/README.asciidoc
@@ -0,0 +1,47 @@
+= REST pastebin example
+
+To try this example, you need GNU `make` and `git` in your PATH.
+
+To build and run the example, use the following command:
+
+[source,bash]
+$ make run
+
+Then point your browser to http://localhost:8080
+
+== Usage
+
+To upload something to the paste application, you can use `curl`:
+
+[source,bash]
+$ <command> | curl -i --data-urlencode paste@- localhost:8080
+
+Or, to upload the file `my_file`:
+
+[source,bash]
+curl -i --data-urlencode paste@my_file localhost:8080
+
+The URL of your data will be in the location header. Alternately, you can visit
+http://localhost:8080 with your favorite web browser and submit your paste via
+the form.
+
+Code that has been pasted can be highlighted with ?lang=<language> option if
+you have http://www.andre-simon.de/doku/highlight/en/highlight.html[highlight]
+installed (although `pygments` or any other should work just fine).
+
+This will show the contents of the HTML file:
+
+[source,bash]
+curl -i --data-urlencode paste@priv/index.html localhost:8080
+curl <url from location header>
+
+If your terminal supports color sequences and `highlight` is installed,
+the following command will show the same contents but with HTML syntax
+highlighting.
+
+[source,bash]
+curl <url from location header>?lang=html
+
+If you open the same URL in your web browser and your web browser tells
+Cowboy that it prefers HTML files, you will see the file highlighted
+with special HTML markup and CSS. Firefox is known to work.