op public repos

Blob

Date:: Mon Nov 29 20:11:25 2021 UTC
Message:: don't mention binaries they aren't currently available
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>Source code is available:</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>
162       When in doubt, compile from source.  It’s easy and takes less
163       than a minute on a raspberry pi 3.  The dependencies are:
164     </p>
165     <ul>
166       <li>libncurses</li>
167       <li>libevent</li>
168       <li>libtls (from either LibreSSL or libretls)</li>
169       <li>yacc (or GNU bison)</li>
170     </ul>
171     <p>Once all the dependencies are installed, building is as easy as:</p>
172     <pre>$ curl -LO https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.1.tar.gz
173 $ tar xzvf telescope-0.6.1.tar.gz
174 $ cd telescope-0.6.1
175 $ ./configure
176 $ make
177 $ sudo make install # eventually
178     </pre>
179     <p>
180       A SHA256 file containing the checksums is available.  However,
181       that only checks for accidental corruption: you can use signify
182       (<code>SHA256.sig</code> and the public key
183       <code>telescope-0.6.pub</code>) or GPG.  The hash of the signify
184       public key is also included in the SHA256 file and signed with
185       my GPG too. The signify public key for the next release
186       <code>telescope-0.7.pub</code> is also included.
187     </p>
188     <ul>
189       <li>
190         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256">
191           SHA256
192         </a>
193       </li>
194       <li>
195         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256.gpg">
196           SHA256.gpg
197         </a>
198       </li>
199       <li>
200         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256.sig">
201           SHA256.sig
202         </a>
203       </li>
204       <li>
205         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.pub">
206           telescope-0.6.pub
207         </a>
208       </li>
209       <li>
210         <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.7.pub">
211           telescope-0.7.pub
212         </a>
213       </li>
214     </ul>
215     <p>How to verify the signature with signify:</p>
216     <pre>$ signify -C -p telescope-0.5.pub -x SHA256.sig
217 Signature Verified
218 telescope-0.6.pub: OK
219 telescope-0.6.1.tar.gz: OK
220 telescope-0.7.pub: OK
221 telescope.linux.aarch64: OK
222 telescope.linux.amd64: OK
223     </pre>
224     <p>Finally, it’s possible to fetch the sources using git:</p>
225     <ul>
226       <li>
227         <a href="https://git.omarpolo.com/telescope/">git repository</a>
228       </li>
229       <li>
230         <a href="https://github.com/omar-polo/telescope">GitHub mirror</a>
231       </li>
232     </ul>
233     <h2>Changelog</h2>
234     <p>0.6.1 “Piccola storia ignobile” bugfix release — Released November 29, 2021</p>
235     <ul>
236       <li>
237         Handle gracefully when landlock is disabled at runtime.
238         Reported and tested by Nikolay Korotkiy, thanks!
239       </li>
240     </ul>
241     <hr />
242     <p>0.6 “Piccola storia ignobile” — Released November 29, 2021</p>
243     <h3>New features</h3>
244     <ul>
245       <li>added a pane that lists all the downloads (current or not)</li>
246       <li>download-path is customizable</li>
247       <li>
248         sandbox/safe mode: telescope won't write anything to the file
249         system.
250       </li>
251       <li>
252         XDG-style directories if ~/.telescope does not exists; idea
253         and implementation by Andrea Feletto, thanks!  (there's a
254         script also by him in contrib to migrate the setup)
255       </li>
256     </ul>
257     <h3>Improvements</h3>
258     <ul>
259       <li>prefill the save prompt with the file name</li>
260       <li>use landlock on linux if available</li>
261       <li>
262         add <code>HOSTCC</code> and <code>HOSTCFLAGS</code> variables
263         for the configure script to allow cross-compiling (<code>pagebundler</code>
264         needs to be built with the host compiler no matter what.)
265         Prompted and tested by Nikolay Korotkiy, thanks!
266       </li>
267     </ul>
268     <h3>Bug fixes</h3>
269     <ul>
270       <li>fix diff syntax highlighting with more than one header involved</li>
271       <li>
272         [gemini] fix item line detection: a space is required after
273         the <code>*</code> character
274       </li>
275       <li>
276         handle empty replies (i.e. no header.)  Found thanks to
277         ondollo' capsule :)
278       </li>
279       <li>
280         fixed a crash on macOs, by Nikolay Korotkiy (sikmir on
281         github). Thanks!
282       </li>
283       <li>
284         mention that telescope expects an UTF-8 environment in the
285         CAVEATS section of the manpage
286       </li>
287     </ul>
288   </body>
289 </html>