summaryrefslogtreecommitdiff
path: root/plugins/hitchhiker/README.md
diff options
context:
space:
mode:
authorTuowen Zhao <ztuowen@gmail.com>2021-03-31 17:13:28 -0600
committerTuowen Zhao <ztuowen@gmail.com>2021-03-31 17:13:28 -0600
commitb6baa00fd2d8e44b5abda20f95461942b615258c (patch)
treebee316446409245d86dba5dc70502486831734d1 /plugins/hitchhiker/README.md
parent0a67be1024b1e54b6af59f01b01ceace9fdf7bb2 (diff)
parent2d40b562e5da4c885babc1f7f09aa33a8a891eb2 (diff)
downloadzsh-b6baa00fd2d8e44b5abda20f95461942b615258c.tar.gz
zsh-b6baa00fd2d8e44b5abda20f95461942b615258c.tar.bz2
zsh-b6baa00fd2d8e44b5abda20f95461942b615258c.zip
Merge remote-tracking branch 'origin/master'
Diffstat (limited to 'plugins/hitchhiker/README.md')
-rw-r--r--plugins/hitchhiker/README.md44
1 files changed, 44 insertions, 0 deletions
diff --git a/plugins/hitchhiker/README.md b/plugins/hitchhiker/README.md
new file mode 100644
index 000000000..d12a1e93f
--- /dev/null
+++ b/plugins/hitchhiker/README.md
@@ -0,0 +1,44 @@
+# hitchhiker
+
+This plugin adds quotes from The Hitchhiker's Guide to the Galaxy, from Douglas Adams.
+
+To use it, add `hitchhiker` to the plugins array in your zshrc file:
+
+```zsh
+plugins=(... hitchhiker)
+```
+
+## Aliases
+
+- `hitchhiker`: displays a quote from the book using `fortune`.
+- `hitchhiker_cow`: displays a quote from the book using `cowthink`.
+
+```console
+$ hitchhiker_cow
+ _______________________________________
+( "OK, so ten out of ten for style, but )
+( minus several million for good )
+( thinking, yeah? " )
+ ---------------------------------------
+ o ^__^
+ o (oo)\_______
+ (__)\ )\/\
+ ||----w |
+ || ||
+```
+
+## Requirements
+
+- `fortune` and `strfile`.
+- `cowthink` if using the `hitchhiker_cow` command.
+
+## Credits
+
+Fortune file: Andreas Gohr <andi@splitbrain.org> ([splitbrain.org](https://www.splitbrain.org/projects/fortunes/hg2g))
+
+Spelling and formatting fixes: grok@resist.ca
+
+Original quotes from:
+
+- https://web.archive.org/web/20120106083254/http://tatooine.fortunecity.com/vonnegut/29/hitch/parhaat.html
+- https://web.archive.org/web/20011112065737/http://www-personal.umd.umich.edu/~nhughes/dna/faqs/quotedir.html