Offpunk es un cliente de gémini y gopher, permitiendo leer dichas páginas 
sin problema pero con una característica: es posible descargar sitios 
en bloque para poder leerlos offline. Eso lo hace un compañero perfecto
a los artículos del correo y noticias offline de la sección de 
tutoriales.

Veeamos como se instala en OpenBSD. Primero, instalamos py3-virtualenv 
y xsel, que lo pide offpunk para copiar y pegar textos. 
Chafa también es recomendable para ver imágenes en braille-art.

doas pkg_add py3-virtualenv xsel chafa libxml libxslt

Eso servirá para crear una carpeta virtual con python3 y el programa
offpunk en un solo lugar por comodidad.

Cremos el directorio venv para dicho propósito:

mkdir -p $HOME/src/offpunk/venv

Entramos:

cd $HOME/src/offpunk/venv

Creamos un entorno aislado de Python3 y lo activamos:

virtualenv .
. bin/activate

Ahora, toca instalar offpunk y sus dependencias recomendadas:

pip3 install requests feedparser readability 
pip3 install readability-lxml  lxml  bs4 setproctitle
pip3 install offpunk


Una vez acabado, salimos de ese entorno y añadimos un script 
en $HOME/bin/ llamado offpunk


mkdir -p $HOME/bin/  

creamos el archivo $HOME/bin/offpunk con este contenido:

#!/bin/sh
. $HOME/src/offpunk/venv/bin/activate
bin/offpunk "$@"
deactivate
#fin de fichero

Le damos permisos de ejecución:

chmod +x $HOME/bin/offpunk

Con eso ya podremos lanzar simplemente "offpunk" para ver nuestros sitios.

*** MANEJO ***

El manejo es simple. Una vez lancemos offpunk por ejemplo, nos 
saldrá una línea de entrada para introducir comandos:

ON>

El "ON" indica que Offpunk usará la conexión a internet.
Para empezar, introducimos una dirección gémini, 
como gemini://caracolitoo.mooo.com y pulsamos [Enter]: 

ON>gemini://caracolitoo.moo.com[Enter]

Nos saldrá el visor "less" 
con una lista de números en vertical indicando que es un enlace.

Para visionar arriba y abajo el fichero, podemos usar las flechas de cursor
o bien repg/avg, y pulsamos 'q' para salir.

Si lo que queremos es ir a un enlace, por ejemplo a

              [1] archipielago.uno

lo que debemos hacer es salir del visor de texto "less" pulsando "q".
Esto nos devolverá una línea para introducir comandos, que pone ON>
indicando que estamos con conexión a internet.

Introducimos el número del enlace:

ON>1

Y pulsamos [enter] o [intro].

Tras ello nos saldrá el visor "less", el cual podemos volver a usar 
exactamente igual que como hemos empezado, cursores y "q" para salir.

Para ver el histórico de sitios visitados, escribimos 

ON>history[Enter]

Y con eso nos saldrá una lista con los sitios visitados, 
pulsamos "q" y le mandamos el número, como si fuera un 
sitio cualquiera.

Si queremos volver atrás en el histórico, escribimos

ON>b[Enter]

en la línea de comandos.


Para poder usar un marcador, podemos escribir "add" una vez que 
éstemos en la línea de comandos, es decir, en "ON>" y "OFF>" 
según como estemos.

Para subscribirte a un lector RSS, lo mismo, pero con 
"subscribe" estando en una web, éste nos devolverá 
URLs válida.

Después, sis lo queremos ver offline, escribimos "sync" y tardará
unos segundos o minutos según la cantidad de artículos. Para 
convertirte en "offline" forzadamente (también funciona con 
una conexión a internet desconectada en la vida real) 
pulsamos [enter]:

ON>offline[Enter]

Tras ello, la línea de comandos cambiará a "OFF".

Para ver nuestro sítio offine., introducimos "list" en la línea 
de comandos 

ON>list [Enter]

y elegimos la sección bookmarks con el número de ésta y luego 
con otro número elegimos el sitio guardado, en nuestro caso,
1:

[1] - .bienvenidx al caracolito! (caracolito.mooo.com)

Ahí tienes tu sitio offline.
Con los RSS es lo mismo, pero yendo a "subscribed"
en vez de "bookmarks".

Otro consejo: si tienes una ristra de links en un apartado, y por ejemplo
quieres leer todos a la vez, escribe tour INICIO-FINAL, por ejemplo,

ON>tour 2-17[Enter]

Eso hará que leas los ficheros enlazados del 2 al 17 de forma secuencial.
Ah, también sirve para bajar nodos enteros en subsecciones por ejemplo
de gemini://pandora.flounder.online al poner bajo "tour" todos los enlaces 
de inicio. Eso hará que tengas una colección de literatura offline para
bajar con "sync".

Otro comando útil es 'archive', tal que:

ON>archive

Con eso se guardará en disco la página gemini/gopher/web que estemos
visitando.
Para acceder a la lista de sitios archivos, se escribe 'list'

ON>list

estando online u offline, da igual, y luego yendo a 'archives'. 
No es como usar marcadores o RSS donde se archivan blogs enteros en bloque,
de existir los subenlaces en un blog,
si no páginas individuales y sus imágenes asociadas.


Con ello, me despido. Dudas a anthk|aquí va una ARROBA|texto-plano.xyz.