Make the README more markdownish - plumb - Open certain URL patterns with an ad-hoc opener (plumber)
(HTM) hg clone https://bitbucket.org/iamleot/plumb
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
---
(DIR) changeset 221ebe4fcfb1cdb9e5c237b2e2d9c7cbfd60904c
(DIR) parent 6604cb15a95b7c3caa3fd6cb8c59c26640107294
(HTM) Author: Leonardo Taccari <iamleot@gmail.com>
Date: Wed, 19 Sep 2018 17:19:15
Make the README more markdownish
Diffstat:
README | 59 +++++++++++++++++++++++++++++------------------------------
1 files changed, 29 insertions(+), 30 deletions(-)
---
diff -r 6604cb15a95b -r 221ebe4fcfb1 README
--- a/README Wed Sep 19 17:13:43 2018 +0200
+++ b/README Wed Sep 19 17:19:15 2018 +0200
@@ -10,47 +10,46 @@
default it is `~/.plumb/openers') and ${PLUMB_RULES} (if not defined
by default it is `~/.plumb/rules') need to be populated:
- % mkdir -p ~/.plumb/openers
- % cp openers/* ~/.plumb/openers
- % cp rules ~/.plumb/rules
+ % mkdir -p ~/.plumb/openers
+ % cp openers/* ~/.plumb/openers
+ % cp rules ~/.plumb/rules
After that you can start using `plumb', e.g.:
- % plumb https://xkcd.com/1172/
- [... opens the URL to the web browser ...]
- % plumb -n https://xkcd.com/1172/
- web "https://xkcd.com/1172/"
- % plumb -n https://imgs.xkcd.com/comics/workflow.png
- image "https://imgs.xkcd.com/comics/workflow.png"
-
+ % plumb https://xkcd.com/1172/
+ [... opens the URL to the web browser ...]
+ % plumb -n https://xkcd.com/1172/
+ web "https://xkcd.com/1172/"
+ % plumb -n https://imgs.xkcd.com/comics/workflow.png
+ image "https://imgs.xkcd.com/comics/workflow.png"
dplumb filter and show all URLs passed via arguments or stdin with
dmenu and then open the selected one via plumb, e.g.:
- % cat << EOF | dplumb
- ... doi:10.1145/361604.361612
- ... https://tools.suckless.org/dmenu/
- ... gopher://gopherproject.org/
- ... EOF
- [... opens dmenu with 3 lines, in the following order: ...]
- [... ...]
- [... 1. doi://10.1145/361604.361612 ...]
- [... 2. https://tools.suckless.org/dmenu/ ...]
- [... 3. gopher://gopherproject.org/ ...]
- [... ...]
- [... If an entry is seleted plumb will be invoked accordingly. ...]
+ % cat << EOF | dplumb
+ ... doi:10.1145/361604.361612
+ ... https://tools.suckless.org/dmenu/
+ ... gopher://gopherproject.org/
+ ... EOF
+ [... opens dmenu with 3 lines, in the following order: ...]
+ [... ...]
+ [... 1. doi://10.1145/361604.361612 ...]
+ [... 2. https://tools.suckless.org/dmenu/ ...]
+ [... 3. gopher://gopherproject.org/ ...]
+ [... ...]
+ [... If an entry is seleted plumb will be invoked accordingly. ...]
It is also possible to just filter and show all URLs - without
invoking nor dmenu nor plumb - via `-l' option, e.g.:
- % cat << EOF | dplumb -l
- ... arXiv:1610.07997
- ... https://en.wikipedia.org/
- ... http://ars.userfriendly.org/cartoons/?id=20170824
- ... EOF
- arxiv://1610.07997
- https://en.wikipedia.org/
- http://ars.userfriendly.org/cartoons/?id=20170824
+ % cat << EOF | dplumb -l
+ ... arXiv:1610.07997
+ ... https://en.wikipedia.org/
+ ... http://ars.userfriendly.org/cartoons/?id=20170824
+ ... EOF
+ arxiv://1610.07997
+ https://en.wikipedia.org/
+ http://ars.userfriendly.org/cartoons/?id=20170824
For more information regarding the real plumber please read `Plumbing
and Other Utilities' by Rob Pike: