1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
This is a CLI/emacs web/gopher/file browser inspired by [[https://en.wikipedia.org/wiki/Line_Mode_Browser][Line Mode
Browser]].
It utilizes [[http://pandoc.org/][pandoc]] and external downloaders such as [[https://curl.haxx.se/][curl]], adding
support for Gopher directories and plaintext files, and invoking
external applications (e.g., image and PDF viewers) depending on its
configuration.
User interaction capabilities are rather basic, as it is intended to
be combined with software that provides better user interfaces -- such
as emacs, rlwrap, tmux, screen.
* Installation
Use ~cabal install~ to install pancake, ~M-x package-install-file RET
/path/to/pancake.el RET~ to install its emacs interface. To set it as
your default emacs browser:
#+BEGIN_SRC elisp
(require 'pancake)
(setq browse-url-browser-function 'pancake-browse-url)
#+END_SRC
* Commands
- [q]uit, [b]ack, [f]orward, [h]elp, [r]eload, [re]load config
- <number>: follow a link (or open the referenced file)
- <number>?: show link/image URI
- ?: show current URI
- RET (empty): show the next 2/3 of a page, if pagination is enabled
- <URI>: follow an URI, possibly relative to the current one
- <shortcut> <query>: run a query using a shortcut defined in the
configuration (e.g., search)
pancake-mode provides additional aliases, see built-in emacs
documentation (~C-h m~) for those.
* Sample configuration
#+BEGIN_SRC yaml
externalViewers:
png: xdg-open "${FILE}"
hs: emacsclient -n "${FILE}"
commands:
gopher: torify curl "${URI}"
ssh: scp "${URI_REGNAME}:${URI_PATH}" /dev/stdout
defaultCommand: curl -4 -L "${URI}"
shortcuts:
ddg: https://duckduckgo.com/lite/?q=
wt: https://en.m.wiktionary.org/w/index.php?search=
wp: https://en.m.wikipedia.org/wiki/Special:Search?search=
gp: gopher://gopherpedia.com:70/7/lookup?
vs: gopher://gopher.floodgap.com/7/v2/vs?
historyDepth: 100
paginate: true
#+END_SRC
* Excluded features
The following features were not implemented, since the complication
may be not worth the benefits, but maybe they will be in the future:
- Usage of content types reported by network protocols: pancake relies
on URIs for format detection, what usually works, but can be
improved.
- Semantic markup for embedding: it might be useful to provide
denotations to ~pancake-mode~ (and for embedding in general) in
order to buttonize links, render TeX math, embed images, etc.
* Screenshots
[[https://defanor.uberspace.net/projects/pancake/gopher.png]]
[[https://defanor.uberspace.net/projects/pancake/web-gnu.png]]
[[https://defanor.uberspace.net/projects/pancake/emacs.png]]
|
