commit - d5e2f954920e7476938d015dace69631ba84501c
commit + d9bfe90a163f327011c6e08d4f64d1a897a12088
blob - 8a0d5f5646cffcf9d72a94423fcd4d738b067ec9
blob + f644c8c426e6af1dfa6d7aaa20e3eb1bb56abcf6
--- site/index.gmi
+++ site/index.gmi
> Telescope is a w3m-like browser for Gemini.
-``` Ascii art of the word “Telescope” and “v0.6.1”
+``` Ascii art of the word “Telescope” and “v0.7”
_______ __
|_ _|.-----.| |.-----.-----.----.-----.-----.-----.
| | | -__|| || -__|__ --| __| _ | _ | -__|
|___| |_____||__||_____|_____|____|_____| __|_____|
- |__| v0.6.1
+ |__| v0.7
```
Telescope is written entirely for fun, as a hobbystic project in my free time. As such, it lacks a ton of features you’ll find in more mature Gemini browsers, but it also has some unique ones.
=> https://repology.org/project/telescope/versions Some distros provide a package — thanks to the maintainers!
-otherwise build from sources:
-=> https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.1.tar.gz telescope-0.6.1.tar.gz
+Source code and precompiled binaries for linux are available:
+=> https://github.com/omar-polo/telescope/releases/download/0.7/telescope-0.7.tar.gz telescope-0.7.tar.gz
+
+=> https://git.omarpolo.com/telescope/ git repository
+=> gemini://git.omarpolo.com/telescope.git/ git repository via Gemini
+=> https://github.com/omar-polo/telescope GitHub mirror
+
+=> https://github.com/omar-polo/telescope/releases/download/0.7/telescope.aarch64 telescope.aarch64
+=> https://github.com/omar-polo/telescope/releases/download/0.7/telescope.amd64 telescope.amd64
+
The dependencies are:
* libncurses
* libevent
Once all the dependencies are installed, building is as easy as:
```Example of how to compile from source
-$ curl -LO https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.1.tar.gz
-$ tar xzvf telescope-0.6.1.tar.gz
-$ cd telescope-0.6.1
+$ curl -LO https://github.com/omar-polo/telescope/releases/download/0.7/telescope-0.7.tar.gz
+$ tar xzvf telescope-0.7.tar.gz
+$ cd telescope-0.7
$ ./configure
$ make
$ sudo make install # eventually
```
-A SHA256 file containing the checksums is available. However, that only checks for accidental corruption: you can use signify (SHA256.sig and the public key telescope-0.6.pub) or GPG. The hash of the signify public key is also included in the SHA256 file and signed with my GPG too. The signify public key for the next release ‘telescope-0.7.pub’ is also included.
+A SHA256 file containing the checksums is available. However, that only checks for accidental corruption: you can use signify (SHA256.sig and the public key telescope-0.7.pub) or GPG. The hash of the signify public key is also included in the SHA256 file and signed with my GPG too. The signify public key for the next release ‘telescope-0.8.pub’ is also included.
-=> https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256 SHA256
-=> https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256.gpg SHA256.gpg
-=> https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256.sig SHA256.sig
-=> https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.pub telescope-0.6.pub
-=> https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.7.pub telescope-0.7.pub
+=> https://github.com/omar-polo/telescope/releases/download/0.7/SHA256 SHA256
+=> https://github.com/omar-polo/telescope/releases/download/0.7/SHA256.gpg SHA256.gpg
+=> https://github.com/omar-polo/telescope/releases/download/0.7/SHA256.sig SHA256.sig
+=> https://github.com/omar-polo/telescope/releases/download/0.7/telescope-0.7.pub telescope-0.7.pub
+=> https://github.com/omar-polo/telescope/releases/download/0.7/telescope-0.8.pub telescope-0.8.pub
```Example of how to verify the signature with signify
-$ signify -C -p telescope-0.6.pub -x SHA256.sig
+$ signify -C -p telescope-0.7.pub -x SHA256.sig
Signature Verified
-telescope-0.6.pub: OK
-telescope-0.6.1.tar.gz: OK
+telescope-0.7-binaries.tar.gz: OK
telescope-0.7.pub: OK
-telescope.linux.aarch64: OK
-telescope.linux.amd64: OK
+telescope-0.7.tar.gz: OK
+telescope-0.8.pub: OK
+telescope.aarch64: OK
+telescope.amd64: OK
```
-Finally, it’s possible to fetch the sources using git:
-=> //git.omarpolo.com/telescope/ git repository
-=> https://github.com/omar-polo/telescope GitHub mirror
-
-
## Changelog
-0.6.1 “Piccola storia ignobile” bugfix release — Released November 29, 2021
+0.7 “Via Paolo Fabbri 43” — Released January 13, 2022
-* Handle gracefully when landlock is disabled at runtime. Reported and tested by Nikolay Korotkiy, thanks!
+### New features
+* caching: telescope will keep a in-memory copy of the visited page for some time to speed up history navigation. See also the new command `cache-info'.
+* persistent tab history: telescope will remember the full history for each tab across sessions.
+* re-open closed tabs (even across sessions!) The `u' key is now bound to `tab-undo-close' by default.
+* allow to customise the space after the end of the buffer. By default telescope now renders a vi-like tilde fringe "~", but it's fully customisable using the new `line.fringe' style identifier. See also the new setting `fringe-ignore-offset'.
-0.6 “Piccola storia ignobile” — Released November 29, 2021
+### Improvements
-## New features
+* ask before quitting telescope.
+* execute-extended-command: execute the selected command on RET.
+* bump default fill-column to 120.
+* bind `del' (backspace) to previous-page. Suggested by Florian, thanks!
+* add --colours as --color alias. Suggested by Florian.
-* added a pane that lists all the downloads (current or not)
-* download-path is customizable
-* sandbox/safe mode: telescope won't write anything to the file system.
-* XDG-style directories if ~/.telescope does not exists; idea and implementation by Andrea Feletto, thanks! (there's a script also by him in contrib to migrate the setup)
+### Bug fixes
-## Improvements
+* fixed crash on --colors. Reported by Florian, thanks!
+* don't push the current url to the history *twice* at startup.
-* prefill the save prompt with the file name
-* use landlock on linux if available
-* add HOSTCC and HOSTCFLAGS variables for the configure script to allow cross-compiling (‘pagebundler’ needs to be built with the host compiler no matter what.) Prompted and tested by Nikolay Korotkiy, thanks!
+### Breaking changes
-## Bug fixes
-
-* fix diff syntax highlighting with more than one header involved
-* [gemini] fix item line detection: a space is required after the `*' character
-* handle empty replies (i.e. no header.) Found thanks to ondollo' capsule :)
-* fixed a crash on macOs, by Nikolay Korotkiy (sikmir on github). Thanks!
-* mention that telescope expects an UTF-8 environment in the CAVEATS section of the manpage
+* variable `set-title' renamed to `update-title'. The old name will still be supported for a while to ease backwards compatibility.
blob - f9b32a034460cbd884512734b1d46b72e4a24ad7
blob + dcb39f8cc40291625aaa07cfb3b40a58d03b6ccb
--- site/index.html
+++ site/index.html
|_ _|.-----.| |.-----.-----.----.-----.-----.-----.
| | | -__|| || -__|__ --| __| _ | _ | -__|
|___| |_____||__||_____|_____|____|_____| __|_____|
- |__| v0.6.1</pre>
+ |__| v0.7</pre>
<blockquote>
<p>Telescope is a w3m-like browser for Gemini</p>
</blockquote>
<a href="https://repology.org/project/telescope/versions">
<img src="https://repology.org/badge/vertical-allrepos/telescope.svg" alt="Packaging status">
</a>
- <p>otherwise build from sources:</p>
+ <p>Source code and precompiled binaries for linux are available:</p>
<ul>
<li>
- <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.1.tar.gz">
- telescope-0.6.1.tar.gz
+ <a href="https://github.com/omar-polo/telescope/releases/download/0.7/telescope-0.7.tar.gz">
+ telescope-0.7.tar.gz
</a>
</li>
+ <li>
+ <a href="https://git.omarpolo.com/telescope/">git repository</a>
+ </li>
+ <li>
+ <a href="https://github.com/omar-polo/telescope">GitHub mirror</a>
+ </li>
+ <li>
+ <a href="https://github.com/omar-polo/telescope/releases/download/0.7/telescope.aarch64">
+ telescope.aarch64
+ </a>
+ </li>
+ <li>
+ <a href="https://github.com/omar-polo/telescope/releases/download/0.7/telescope.amd64">
+ telescope.amd64
+ </a>
+ </li>
</ul>
<p>The dependencies are:</p>
<ul>
<li>yacc (or GNU bison)</li>
</ul>
<p>Once all the dependencies are installed, building is as easy as:</p>
- <pre>$ curl -LO https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.1.tar.gz
-$ tar xzvf telescope-0.6.1.tar.gz
-$ cd telescope-0.6.1
+ <pre>$ curl -LO https://github.com/omar-polo/telescope/releases/download/0.7/telescope-0.7.tar.gz
+$ tar xzvf telescope-0.7.tar.gz
+$ cd telescope-0.7
$ ./configure
$ make
$ sudo make install # eventually
A SHA256 file containing the checksums is available. However,
that only checks for accidental corruption: you can use signify
(<code>SHA256.sig</code> and the public key
- <code>telescope-0.6.pub</code>) or GPG. The hash of the signify
+ <code>telescope-0.7.pub</code>) or GPG. The hash of the signify
public key is also included in the SHA256 file and signed with
my GPG too. The signify public key for the next release
- <code>telescope-0.7.pub</code> is also included.
+ <code>telescope-0.8.pub</code> is also included.
</p>
<ul>
<li>
- <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256">
+ <a href="https://github.com/omar-polo/telescope/releases/download/0.7/SHA256">
SHA256
</a>
</li>
<li>
- <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256.gpg">
+ <a href="https://github.com/omar-polo/telescope/releases/download/0.7/SHA256.gpg">
SHA256.gpg
</a>
</li>
<li>
- <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256.sig">
+ <a href="https://github.com/omar-polo/telescope/releases/download/0.7/SHA256.sig">
SHA256.sig
</a>
</li>
<li>
- <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.pub">
- telescope-0.6.pub
+ <a href="https://github.com/omar-polo/telescope/releases/download/0.7/telescope-0.7.pub">
+ telescope-0.7.pub
</a>
</li>
<li>
- <a href="https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.7.pub">
- telescope-0.7.pub
+ <a href="https://github.com/omar-polo/telescope/releases/download/0.7/telescope-0.8.pub">
+ telescope-0.8.pub
</a>
</li>
</ul>
<p>How to verify the signature with signify:</p>
- <pre>$ signify -C -p telescope-0.6.pub -x SHA256.sig
+ <pre>$ signify -C -p telescope-0.7.pub -x SHA256.sig
Signature Verified
-telescope-0.6.pub: OK
-telescope-0.6.1.tar.gz: OK
+telescope-0.7-binaries.tar.gz: OK
telescope-0.7.pub: OK
-telescope.linux.aarch64: OK
-telescope.linux.amd64: OK
+telescope-0.7.tar.gz: OK
+telescope-0.8.pub: OK
+telescope.aarch64: OK
+telescope.amd64: OK
</pre>
- <p>Finally, it’s possible to fetch the sources using git:</p>
+ <h2>Changelog</h2>
+ <p>0.7 “Via Paolo Fabbri 43” — Released January 13, 2022</p>
+ <h3>New features</h3>
<ul>
<li>
- <a href="https://git.omarpolo.com/telescope/">git repository</a>
+ caching: telescope will keep a in-memory copy of the visited
+ page for some time to speed up history navigation. See also
+ the new command <code>cache-info</code>.
</li>
<li>
- <a href="https://github.com/omar-polo/telescope">GitHub mirror</a>
+ persistent tab history: telescope will remember the full
+ history for each tab across sessions.
</li>
- </ul>
- <h2>Changelog</h2>
- <p>0.6.1 “Piccola storia ignobile” bugfix release — Released November 29, 2021</p>
- <ul>
+ <li>
+ re-open closed tabs (even across sessions!) The <kbd>u</kbd>
+ key is now bound to <code>tab-undo-close</code> by default.
+ </li>
<li>
- Handle gracefully when landlock is disabled at runtime.
- Reported and tested by Nikolay Korotkiy, thanks!
+ allow to customise the space after the end of the buffer. By
+ default telescope now renders a vi-like tilde fringe "~", but
+ it's fully customisable using the new <code>line.fringe</code>
+ style identifier. See also the new setting
+ <code>fringe-ignore-offset</code>.
</li>
</ul>
- <hr />
- <p>0.6 “Piccola storia ignobile” — Released November 29, 2021</p>
- <h3>New features</h3>
+ <h3>Improvements</h3>
<ul>
- <li>added a pane that lists all the downloads (current or not)</li>
- <li>download-path is customizable</li>
+ <li>ask before quitting telescope.</li>
<li>
- sandbox/safe mode: telescope won't write anything to the file
- system.
+ execute-extended-command: execute the selected command on RET.
</li>
+ <li>bump default fill-column to 120.</li>
<li>
- XDG-style directories if ~/.telescope does not exists; idea
- and implementation by Andrea Feletto, thanks! (there's a
- script also by him in contrib to migrate the setup)
+ bind <kbd>del</kbd> (backspace) to previous-page. Suggested by
+ Florian, thanks!
</li>
- </ul>
- <h3>Improvements</h3>
- <ul>
- <li>prefill the save prompt with the file name</li>
- <li>use landlock on linux if available</li>
<li>
- add <code>HOSTCC</code> and <code>HOSTCFLAGS</code> variables
- for the configure script to allow cross-compiling (<code>pagebundler</code>
- needs to be built with the host compiler no matter what.)
- Prompted and tested by Nikolay Korotkiy, thanks!
+ add <code>--colours</code> as <code>--color</code> alias.
+ Suggested by Florian.
</li>
</ul>
<h3>Bug fixes</h3>
<ul>
- <li>fix diff syntax highlighting with more than one header involved</li>
<li>
- [gemini] fix item line detection: a space is required after
- the <code>*</code> character
+ fixed crash on <code>--colors</code>. Reported by Florian,
+ thanks!
</li>
<li>
- handle empty replies (i.e. no header.) Found thanks to
- ondollo' capsule :)
+ don't push the current url to the history <em>twice</em> at
+ startup.
</li>
+ </ul>
+ <h3>Breaking Changes</h3>
+ <ul>
<li>
- fixed a crash on macOs, by Nikolay Korotkiy (sikmir on
- github). Thanks!
+ variable <code>set-title</code> renamed to
+ <code>update-title</code>.
+ The old name will still be supported for a while to ease
+ backwards compatibility.
</li>
- <li>
- mention that telescope expects an UTF-8 environment in the
- CAVEATS section of the manpage
- </li>
</ul>
</body>
</html>
blob - 101f1701daa86500eb94301384ab229bf8cecd94
blob + 554385e0516e01e1872108700d39883e3c0ab094
--- site/telescope.1.html
+++ site/telescope.1.html
<!DOCTYPE html>
<html>
<!-- This is an automatically generated file. Do not edit.
- Copyright (c) 2021 Omar Polo <op@omarpolo.com>
+ Copyright (c) 2021, 2022 Omar Polo <op@omarpolo.com>
Permission to use, copy, modify, and distribute this software for any
purpose with or without fee is hereby granted, provided that the above
<p class="Pp">The arguments are as follows:</p>
<dl class="Bl-tag">
<dt id="C"><a class="permalink" href="#C"><code class="Fl">-C</code></a>,
- <code class="Fl">--colors</code></dt>
- <dd>Show all available colors and exit.</dd>
+ <code class="Fl">--colours</code></dt>
+ <dd>Show all available colors and exit. This option can also be spelled
+ <code class="Fl">--colors</code>.</dd>
<dt id="c"><a class="permalink" href="#c"><code class="Fl">-c</code></a>
<var class="Ar">config</var></dt>
<dd>Specify an alternative configuration file. By default
<span class="Pa">~/.config/telescope/config</span> is loaded.</dd>
<dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a>,
<code class="Fl">--help</code></dt>
- <dd>Display version and usage.</dd>
+ <dd>Display version, usage and exit.</dd>
<dt id="n"><a class="permalink" href="#n"><code class="Fl">-n</code></a></dt>
<dd>Configtest mode. Only check the configuration file for validity.</dd>
<dt id="S"><a class="permalink" href="#S"><code class="Fl">-S</code></a>,
custom about pages.</dd>
<dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a>,
<code class="Fl">--version</code></dt>
- <dd>Display version.</dd>
+ <dd>Display version and exit.</dd>
</dl>
</section>
<section class="Sh">
<dd>(integer) If greater than zero, lines of text will be formatted in a
way that don't exceed the given number of columns. Defaults to
80.</dd>
+ <dt>fringe-ignore-offset</dt>
+ <dd>(integer) If nonzero, the fringe doesn't obey to
+ <code class="Ic">olivetti-mode</code>. Defaults to 1.</dd>
<dt>hide-pre-blocks</dt>
<dd>(integer) If nonzero, hide by default the body of the preformatted
blocks. Defaults to zero. <code class="Ic">push-button</code> can be
<dt>new-tab-url</dt>
<dd>(string) URL for the new tab page. Defaults to
“about:new”.</dd>
+ <dt>max-killed-tabs</dt>
+ <dd>(integer) The maximum number of closed tabs to keep track of, defaults
+ to 10. Must be a positive number; if zero, don't save closed tabs at
+ all.</dd>
<dt>olivetti-mode</dt>
<dd>(integer) If nonzero, enable <code class="Ic">olivetti-mode</code>
- Defaults to 1.</dd>
- <dt>set-title</dt>
- <dd>(integer) If nonzero, set the terminal title to the page title.
Defaults to 1.</dd>
<dt>tab-bar-show</dt>
<dd>(integer) If tab-bar-show is -1 hide the tab bar permanently, if 0
show it unconditionally. If it's 1, show the bar only when there is
more than one tab. Defaults to 1.</dd>
+ <dt>update-title</dt>
+ <dd>(integer) If nonzero, set the terminal title to the page title.
+ Defaults to 1.</dd>
</dl>
</dd>
<dt id="style"><a class="permalink" href="#style"><code class="Ic">style</code></a>
<dd>a completed download</dd>
<dt>line.download.info</dt>
<dd>informational text in the *Downloads* buffer.</dd>
+ <dt>line.fringe</dt>
+ <dd>(virtual) lines draw after the end of a buffer.</dd>
<dt>line.text</dt>
<dd>text lines.</dd>
<dt>line.link</dt>
<dd>previous-page</dd>
<dt>L</dt>
<dd>next-page</dd>
+ <dt>u</dt>
+ <dd>tab-undo-close</dd>
<dt>q</dt>
<dd>kill-telescope</dd>
<dt>ESC</dt>
<dd>tab-previous</dd>
<dt>M-<next></dt>
<dd>tab-next</dd>
+ <dt>del</dt>
+ <dd>previous-page</dd>
<dt>M-<left></dt>
<dd>previous-page</dd>
<dt>M-<right></dt>
<dd>Focus the previous tab, wrapping around eventually.</dd>
<dt id="tab-select"><a class="permalink" href="#tab-select"><code class="Ic">tab-select</code></a></dt>
<dd>Switch to a tab using the minibuffer.</dd>
+ <dt id="tab-undo-close"><a class="permalink" href="#tab-undo-close"><code class="Ic">tab-undo-close</code></a></dt>
+ <dd>Re-open the most recently closed tab, if any.</dd>
</dl>
</section>
<section class="Ss">
<h2 class="Ss" id="Misc_commands"><a class="permalink" href="#Misc_commands">Misc
commands</a></h2>
<dl class="Bl-tag Bl-compact">
+ <dt id="cache-info"><a class="permalink" href="#cache-info"><code class="Ic">cache-info</code></a></dt>
+ <dd>Show cache stats.</dd>
<dt id="clear-minibuf"><a class="permalink" href="#clear-minibuf"><code class="Ic">clear-minibuf</code></a></dt>
<dd>Clear the echo area.</dd>
<dt id="dec-fill-column"><a class="permalink" href="#dec-fill-column"><code class="Ic">dec-fill-column</code></a></dt>
<dd>Lock file used to prevent multiple instance of
<code class="Nm">telescope</code> from running at the same time.</dd>
<dt><span class="Pa">~/.cache/telescope/session</span></dt>
- <dd>The list of tabs from the last session. Every line identifies a tab and
- contains three space-separated fields: the full URL, a comma-separated
- list of attributes and the cached title. Is written by
- <code class="Ic">kill-telescope</code> and loaded during startup.</dd>
+ <dd>The list of tabs from the last session.</dd>
</dl>
</section>
<section class="Sh">
<p class="Pp"><cite class="Rs"><i class="RsB">XDG Base Directory
Specification</i>,
<a class="RsU" href="https://specifications.freedesktop.org/basedir-spec/latest/">https://specifications.freedesktop.org/basedir-spec/latest/</a>.</cite></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ACKNOWLEDGEMENTS"><a class="permalink" href="#ACKNOWLEDGEMENTS">ACKNOWLEDGEMENTS</a></h1>
+<p class="Pp">The “Trust, but verify (where appropriate)” TOFU
+ scheme was firstly suggested by thfr:
+ <a class="Lk" href="gemini://thfr.info/gemini/modified-trust-verify.gmi">gemini://thfr.info/gemini/modified-trust-verify.gmi</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<section class="Sh">
<h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1>
<p class="Pp"><code class="Nm">telescope</code> assumes a UTF-8 environment and
- doesn't do anything to cope with other encodings. This can cause weird
- rendering issues if you're lucky, or possibly worst things depending on your
+ doesn't try to cope with other encodings. This can cause strange rendering
+ issues if you're lucky, or possibly weird thing happening depending on your
locale and terminal emulator.</p>
+<p class="Pp">The algorithm used for text-wrapping is naive and doesn't really
+ work for languages that make heavily use of glyphs composed by multiple
+ UNICODE codepoints.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
</div>
<table class="foot">
<tr>
- <td class="foot-date">November 29, 2021</td>
+ <td class="foot-date">January 5, 2022</td>
<td class="foot-os">OpenBSD 7.0</td>
</tr>
</table>
blob - 0fca232ccd235cb28180f880ef2c3dc5a9dbbdd7
blob + 855e9132fb73017bb3f7756f8994a520921781ee
--- site/telescope.1.txt
+++ site/telescope.1.txt
The arguments are as follows:
- -C, --colors Show all available colors and exit.
+ -C, --colours Show all available colors and exit. This option can also
+ be spelled --colors.
-c config Specify an alternative configuration file. By default
~/.config/telescope/config is loaded.
- -h, --help Display version and usage.
+ -h, --help Display version, usage and exit.
-n Configtest mode. Only check the configuration file for
validity.
telescope still loads the session file and the custom
about pages.
- -v, --version Display version.
+ -v, --version Display version and exit.
UI CONCEPTS
telescope interface is divided into four areas: the tabline, the body,
fill-column (integer) If greater than zero, lines of text will
be formatted in a way that don't exceed the given
number of columns. Defaults to 80.
+ fringe-ignore-offset
+ (integer) If nonzero, the fringe doesn't obey to
+ olivetti-mode. Defaults to 1.
hide-pre-blocks
(integer) If nonzero, hide by default the body of
the preformatted blocks. Defaults to zero.
Defaults to zero.
new-tab-url (string) URL for the new tab page. Defaults to
about:new.
+ max-killed-tabs
+ (integer) The maximum number of closed tabs to
+ keep track of, defaults to 10. Must be a positive
+ number; if zero, don't save closed tabs at all.
olivetti-mode (integer) If nonzero, enable olivetti-mode
Defaults to 1.
- set-title (integer) If nonzero, set the terminal title to
- the page title. Defaults to 1.
tab-bar-show (integer) If tab-bar-show is -1 hide the tab bar
permanently, if 0 show it unconditionally. If
it's 1, show the bar only when there is more than
one tab. Defaults to 1.
+ update-title (integer) If nonzero, set the terminal title to
+ the page title. Defaults to 1.
style name option
Change the styling of the element identified by name. Multiple
line.download.done a completed download
line.download.info informational text in the
*Downloads* buffer.
+ line.fringe (virtual) lines draw after the end
+ of a buffer.
line.text text lines.
line.link link lines.
line.title1..3 headings
g M-T tab-move-to
H previous-page
L next-page
+ u tab-undo-close
q kill-telescope
ESC clear-minibuf
: execute-extended-command
C-t tab-new
M-<prior> tab-previous
M-<next> tab-next
+ del previous-page
M-<left> previous-page
M-<right> next-page
<f5> reload-page
tab-previous Focus the previous tab, wrapping around
eventually.
tab-select Switch to a tab using the minibuffer.
+ tab-undo-close Re-open the most recently closed tab, if any.
Misc commands
+ cache-info Show cache stats.
clear-minibuf Clear the echo area.
dec-fill-column Decrement fill-column by two.
execute-extended-command Execute an internal command.
Lock file used to prevent multiple instance of telescope from
running at the same time.
~/.cache/telescope/session
- The list of tabs from the last session. Every line identifies a
- tab and contains three space-separated fields: the full URL, a
- comma-separated list of attributes and the cached title. Is
- written by kill-telescope and loaded during startup.
+ The list of tabs from the last session.
EXAMPLES
It's possible to browse the small web (i.e. simple websites) by using
XDG Base Directory Specification,
https://specifications.freedesktop.org/basedir-spec/latest/.
+ACKNOWLEDGEMENTS
+ The Trust, but verify (where appropriate) TOFU scheme was firstly
+ suggested by thfr: gemini://thfr.info/gemini/modified-trust-verify.gmi.
+
AUTHORS
The telescope program was written by Omar Polo <op@omarpolo.com>.
CAVEATS
- telescope assumes a UTF-8 environment and doesn't do anything to cope
- with other encodings. This can cause weird rendering issues if you're
- lucky, or possibly worst things depending on your locale and terminal
+ telescope assumes a UTF-8 environment and doesn't try to cope with other
+ encodings. This can cause strange rendering issues if you're lucky, or
+ possibly weird thing happening depending on your locale and terminal
emulator.
+ The algorithm used for text-wrapping is naive and doesn't really work for
+ languages that make heavily use of glyphs composed by multiple UNICODE
+ codepoints.
+
BUGS
There's no UI for out-of-band certificates validation.
-OpenBSD 7.0 November 29, 2021 OpenBSD 7.0
+OpenBSD 7.0 January 5, 2022 OpenBSD 7.0