Blame


1 a2728733 2021-07-18 op # Help
2 a2728733 2021-07-18 op
3 a2728733 2021-07-18 op Welcome to Telescope!
4 a2728733 2021-07-18 op
5 f2b332a5 2021-07-19 op Essential key bindings: arrow keys to move the cursor and read the page, > to enter an URL, B and F (uppercase) to navigate backward and forward in the history. ‘q’ to quit.
6 a2728733 2021-07-18 op
7 a2728733 2021-07-18 op This page is always available as
8 f2b332a5 2021-07-19 op
9 a2728733 2021-07-18 op > $ telescope about:help
10 a2728733 2021-07-18 op
11 a2728733 2021-07-18 op
12 a2728733 2021-07-18 op ## What is Telescope?
13 a2728733 2021-07-18 op
14 a2728733 2021-07-18 op Telescope is a Gemini browser written for fun, as hobbystic project in my free time. As such, it lacks tons of features available in others, more mature Gemini browsers, but it also has some unique ones.
15 a2728733 2021-07-18 op
16 a2728733 2021-07-18 op The UI is strongly inspired from Emacs and w3m, so it’s possible to notice various familiar concepts, such as the minibuffer or the tab line. Care has been taken to make it as familiar as possible for vi and “CUA” users too.
17 a2728733 2021-07-18 op
18 a2728733 2021-07-18 op => gemini://telescope.omarpolo.com Telescope Project Homepage
19 a2728733 2021-07-18 op
20 f2b332a5 2021-07-19 op > Tip: move the cursor over a link and press M-RET (alt + enter) to open it in another tab. Then use [ and ] to switch between tabs.
21 a2728733 2021-07-18 op
22 f2b332a5 2021-07-19 op Telescope is documented carefully, so please refer to the manual page to know more about all the available keybindings, the format and location of the configuration file and more:
23 f2b332a5 2021-07-19 op
24 a2728733 2021-07-18 op > man telescope
25 a2728733 2021-07-18 op
26 f2b332a5 2021-07-19 op
27 f2b332a5 2021-07-19 op ## Operate the Telescope
28 f2b332a5 2021-07-19 op
29 f2b332a5 2021-07-19 op > Tip: on long and structured pages like this one, try to use the ‘toc’ command. Press ‘t’ to open the table of content and jump to a specific heading.
30 f2b332a5 2021-07-19 op
31 f2b332a5 2021-07-19 op By default Telescope includes various keys inspired from either Emacs or vi. However, knowledge of these editors is not required. Here’s a quick list of essential commands
32 f2b332a5 2021-07-19 op
33 f2b332a5 2021-07-19 op * > to prompt for a URL;
34 f2b332a5 2021-07-19 op * arrow keys to move the cursor;
35 f2b332a5 2021-07-19 op * page up/down to scroll;
36 f2b332a5 2021-07-19 op * tab and shift-tab to jump to the next/previous link;
37 f2b332a5 2021-07-19 op * F and B (uppercase) to navigate forward and backward in the history;
38 f2b332a5 2021-07-19 op * enter to open the link under the cursor;
39 f2b332a5 2021-07-19 op * alt-enter to open the link under the cursor in a new tab;
40 f2b332a5 2021-07-19 op * [ and ] to move between tabs;
41 f2b332a5 2021-07-19 op * control + t to open a new tab;
42 f2b332a5 2021-07-19 op * control + w to close the current tab;
43 f2b332a5 2021-07-19 op * q to quit
44 f2b332a5 2021-07-19 op
45 f2b332a5 2021-07-19 op
46 f2b332a5 2021-07-19 op ## Operate — Emacs version
47 f2b332a5 2021-07-19 op
48 f2b332a5 2021-07-19 op If you’re familiar with Emacs, most of the keybindings are available on Telescope by default! C-{b,f,n,p} works as expected, as well as C-x C-c, C-x t o, C-v/M-v and even M-x!
49 f2b332a5 2021-07-19 op
50 f2b332a5 2021-07-19 op ## Operate — vi version
51 f2b332a5 2021-07-19 op
52 f2b332a5 2021-07-19 op Telescope strives to be familiar for vi/vim users too! hjkl is available by default, as well as ‘g t’, ‘g T’ etc. :tabnew, :tabn and :wq work too!
53 f2b332a5 2021-07-19 op
54 f2b332a5 2021-07-19 op
55 a2728733 2021-07-18 op ## Appearance
56 a2728733 2021-07-18 op
57 a2728733 2021-07-18 op Telescope is fully customizable. The default configuration file is
58 a2728733 2021-07-18 op
59 a2728733 2021-07-18 op > ~/.telescope/config
60 a2728733 2021-07-18 op
61 f2b332a5 2021-07-19 op By default Telescope doesn’t use colours too much in order to adapt to both light and dark-themed terminals. This doesn’t mean that Telescope cannot use colours though! See for example contrib/light.config and contrib/dark.config.
62 a2728733 2021-07-18 op
63 a2728733 2021-07-18 op
64 f2b332a5 2021-07-19 op # What is Gemini?
65 a2728733 2021-07-18 op
66 f2b332a5 2021-07-19 op Gemini is a new internet protocol which:
67 a2728733 2021-07-18 op
68 f2b332a5 2021-07-19 op * is heavier than gopher
69 f2b332a5 2021-07-19 op * is lighter than the web
70 f2b332a5 2021-07-19 op * will not replace either
71 f2b332a5 2021-07-19 op * strives for maximum power to weight ratio
72 f2b332a5 2021-07-19 op * takes user privacy very seriously
73 a2728733 2021-07-18 op
74 f2b332a5 2021-07-19 op => gemini://gemini.circumlunar.space Project Gemini Homepage