op public repos

Blob

Date:: Thu Dec 9 17:18:10 2021 UTC
Message:: typo
Actions:: History | Blame | Raw File
1 <!doctype html>
2 <html lang="en">
3   <head>
4     <title>Telescope</title>
5     <meta charset="utf8">
6     <meta name="viewport" content="width=device-width, initial-scale=1">
7     <style>
8     body {
9       font-family: monospace;
10       font-size: 14px;
11       max-width: 780px;
12       margin: 0 auto;
13       padding: 20px;
14       padding-bottom: 80px;
15     }
16 
17     h1::before {
18       content: "# ";
19     }
20 
21     h2 {
22       margin-top: 40px;
23     }
24 
25     h2::before {
26       content: "## ";
27     }
28 
29     h3::before {
30       content: "### ";
31     }
32 
33     blockquote {
34       margin: 0;
35       padding: 0;
36     }
37 
38     blockquote::before {
39       content: "> ";
40     }
41 
42     blockquote p {
43       font-style: italic;
44       display: inline;
45     }
46 
47     p.link::before {
48       content: "→ ";
49     }
50 
51     hr {
52       border: 0;
53       height: 1px;
54       background-color: #222;
55       width: 100%;
56       display: block;
57       margin: 2em auto;
58     }
59 
60     pre {
61       overflow: auto;
62     }
63 
64     pre.banner {
65       display: flex;
66       flex-direction: row;
67       justify-content: center;
68     }
69 
70     code, kbd {
71       color: #9d109d;
72     }
73 
74     img {
75       display: block;
76       margin: 0 auto;
77       max-width: 100%;
78     }
79 
80     @media (prefers-color-scheme: dark) {
81       body {
82         background-color: #222;
83         color: white;
84       }
85 
86       img {
87         filter: brightness(0.65);
88         transition: filter 0.2s ease-in-out;
89       }
90 
91       img:hover {
92         filter: brightness(1.0);
93       }
94 
95       a {
96         color: aqua;
97       }
98 
99       hr {
100         background-color: #ddd;
101       }
102 
103       code, kbd {
104         color: #ff4cff;
105       }
106     }
107 
108     @media (max-width: 400px) {
109       pre.banner { font-size: 9px; }
110     }
111 
112     @media (max-width: 500px) {
113       pre.banner { font-size: 10px; }
114     }
115     </style>
116   </head>
117   <body>
118     <header>
119       <nav>
120         Home | <a href="/gallery/">Gallery</a> | <a href="telescope.1.html">Docs</a>
121       </nav>
122     </header>
123     <pre class="banner"> _______         __
124 |_     _|.-----.|  |.-----.-----.----.-----.-----.-----.
125   |   |  |  -__||  ||  -__|__ --|  __|  _  |  _  |  -__|
126   |___|  |_____||__||_____|_____|____|_____|   __|_____|
127                                            |__| v0.6.1</pre>
128     <blockquote>
129       <p>Telescope is a w3m-like browser for Gemini</p>
130     </blockquote>
131     <p>
132       Telescope is written entirely for fun, as a hobbystic project in
133       my free time.  As such, it lacks a ton of features you’ll find
134       in more mature Gemini browsers, but it also has some unique
135       ones.
136     </p>
137     <p>
138       The UI is strongly inspired from Emacs and W3M, so you’ll find
139       some familiar concepts, such as the minibuffer or the tabline,
140       and the default keybindigs also reflect this, but keys familiar
141       for vi and CUA users are also present by default.
142     </p>
143     <p>
144       <a href="https://asciinema.org/a/426862" target="_blank">
145         <img src="https://asciinema.org/a/426862.svg" />
146       </a>
147     </p>
148     <h2>Install</h2>
149     <p>Some distros provide a package — thanks to the maintainers!</p>
150     <a href="https://repology.org/project/telescope/versions">
151       <img src="https://repology.org/badge/vertical-allrepos/telescope.svg" alt="Packaging status">
152     </a>
153     <p>otherwise build from sources:</p>
154     <ul>
155       <li>
156         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.1.tar.gz">
157           telescope-0.6.1.tar.gz
158         </a>
159       </li>
160     </ul>
161     <p>The dependencies are:</p>
162     <ul>
163       <li>libncurses</li>
164       <li>libevent</li>
165       <li>libtls (from either LibreSSL or libretls)</li>
166       <li>yacc (or GNU bison)</li>
167     </ul>
168     <p>Once all the dependencies are installed, building is as easy as:</p>
169     <pre>$ curl -LO https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.1.tar.gz
170 $ tar xzvf telescope-0.6.1.tar.gz
171 $ cd telescope-0.6.1
172 $ ./configure
173 $ make
174 $ sudo make install # eventually
175     </pre>
176     <p>
177       A SHA256 file containing the checksums is available.  However,
178       that only checks for accidental corruption: you can use signify
179       (<code>SHA256.sig</code> and the public key
180       <code>telescope-0.6.pub</code>) or GPG.  The hash of the signify
181       public key is also included in the SHA256 file and signed with
182       my GPG too. The signify public key for the next release
183       <code>telescope-0.7.pub</code> is also included.
184     </p>
185     <ul>
186       <li>
187         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256">
188           SHA256
189         </a>
190       </li>
191       <li>
192         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256.gpg">
193           SHA256.gpg
194         </a>
195       </li>
196       <li>
197         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256.sig">
198           SHA256.sig
199         </a>
200       </li>
201       <li>
202         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.pub">
203           telescope-0.6.pub
204         </a>
205       </li>
206       <li>
207         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.7.pub">
208           telescope-0.7.pub
209         </a>
210       </li>
211     </ul>
212     <p>How to verify the signature with signify:</p>
213     <pre>$ signify -C -p telescope-0.6.pub -x SHA256.sig
214 Signature Verified
215 telescope-0.6.pub: OK
216 telescope-0.6.1.tar.gz: OK
217 telescope-0.7.pub: OK
218 telescope.linux.aarch64: OK
219 telescope.linux.amd64: OK
220     </pre>
221     <p>Finally, it’s possible to fetch the sources using git:</p>
222     <ul>
223       <li>
224         <a href="https://git.omarpolo.com/telescope/">git repository</a>
225       </li>
226       <li>
227         <a href="https://github.com/omar-polo/telescope">GitHub mirror</a>
228       </li>
229     </ul>
230     <h2>Changelog</h2>
231     <p>0.6.1 “Piccola storia ignobile” bugfix release — Released November 29, 2021</p>
232     <ul>
233       <li>
234         Handle gracefully when landlock is disabled at runtime.
235         Reported and tested by Nikolay Korotkiy, thanks!
236       </li>
237     </ul>
238     <hr />
239     <p>0.6 “Piccola storia ignobile” — Released November 29, 2021</p>
240     <h3>New features</h3>
241     <ul>
242       <li>added a pane that lists all the downloads (current or not)</li>
243       <li>download-path is customizable</li>
244       <li>
245         sandbox/safe mode: telescope won't write anything to the file
246         system.
247       </li>
248       <li>
249         XDG-style directories if ~/.telescope does not exists; idea
250         and implementation by Andrea Feletto, thanks!  (there's a
251         script also by him in contrib to migrate the setup)
252       </li>
253     </ul>
254     <h3>Improvements</h3>
255     <ul>
256       <li>prefill the save prompt with the file name</li>
257       <li>use landlock on linux if available</li>
258       <li>
259         add <code>HOSTCC</code> and <code>HOSTCFLAGS</code> variables
260         for the configure script to allow cross-compiling (<code>pagebundler</code>
261         needs to be built with the host compiler no matter what.)
262         Prompted and tested by Nikolay Korotkiy, thanks!
263       </li>
264     </ul>
265     <h3>Bug fixes</h3>
266     <ul>
267       <li>fix diff syntax highlighting with more than one header involved</li>
268       <li>
269         [gemini] fix item line detection: a space is required after
270         the <code>*</code> character
271       </li>
272       <li>
273         handle empty replies (i.e. no header.)  Found thanks to
274         ondollo' capsule :)
275       </li>
276       <li>
277         fixed a crash on macOs, by Nikolay Korotkiy (sikmir on
278         github). Thanks!
279       </li>
280       <li>
281         mention that telescope expects an UTF-8 environment in the
282         CAVEATS section of the manpage
283       </li>
284     </ul>
285   </body>
286 </html>