-- Leo's gemini proxy
-- Connecting to sl1200.dystopic.world:1965...
-- Connected
-- Sending request
-- Meta line: 20 text/gemini;lang=es-ES
2022-04-01
En gemini existe una convención por la cual para permitir la suscripción a una cápsula lo único que debes hacer es comenzar los links a los nuevos artículos con el link, seguido de la fecha en formato yyyy-mm-dd y el título del enlace. Aquí tienes información al respecto:
Y un ejemplo lo tienes en mi archivo feeds.gmi que puedes consultar aquí:
Y en el caso del cliente Lagrange, además de este sencillo método, también permite la suscripción simplemente asignando una nueva entrada para cada nuevo titular que escribas en el archivo gmi. Ejemplo mío al que puedes suscribirte, en el que simplemente cada línea que comience por ### en gemtext es interpretada por Lagrange como una nueva entrada de feed:
Como puedes ver permitir la suscripción en gemini es extremadamente fácil porque no hay que crear ningún archivo adicional.
Si además de la cápsula disponemos de un proxy de gemini a html, como kineto, posiblemente nos interese permitir la suscripción a nuestra cápsula a través de cualquier lector RSS, pero para ello necesitamos generar el archivo xml necesario.
La solución para generar ese xml nos la trae Ariel Costas con gmifeed2atom, software que generará automáticamente para nosotros el archivo xml necesario para posibilitar la suscripción atom a nuestra cápsula.
En este pequeño tutorial explicaré como instalar y automatizar la creación del xml con gmifeed2atom.
Tener un proxy de gemini a html para que tu cápsula pueda ser visitada desde cualquier navegador web. El más habitual es el proxy Kineto. Si no lo tienes, aquí tienes un tutorial para instalarlo:
Tener instalado go, versión 1.15 o superior, que lo tendrás si ya tienes el proxy kineto puesto que también está programado en go.
En tu cápsula deberás contar ya con un archivo para permitir la suscripción en gemini, similar a mi archivo feeds.gmi que he mencionado antes.
Se encuentra en este sitio:
Dale a "download", en mi caso descargué el formato zip, y te lo llevas al directorio de usuario de tu servidor, en mi caso /home/sl1200. Después lo descomprimes y accedes a la carpeta gmifeed2atom-main. Ahora debes compilar con este comando, ojo, no olvides el puntito al final:
go build .
Ahora verás que se ha creado un archivo ejecutable de nombre gmifeed2atom
Ya puedes consultar la ayuda ejecutando:
./gmifeed2atom -h
Puedes seguir las instrucciones de la ayuda y ejecutarlo una sóla vez o bien programarlo para que se ejecute cada cierto tiempo de forma automática.
Partimos de que la url de mi feed gemini es esta:
y la de mi proxy:
y que hemos puesto una imagen con mi logo, atom-logo.jpg, dentro de la carpeta de mi cápsula. Esa imagen se verá en algunos lectores como por ejemplo AntennaPod.
Sólo tienes que añadir una línea a tu crontab. Abrimos crontab.
crontab -e
Añadimos esta línea, cambia los datos de mi cápsula por los de la tuya. Para este caso, al comenzar la línea con * /5 * * * * , cada 5 minutos se ejecutará gmifeed2atom, que actualizará el archivo xml.
*/5 * * * * ~/gmifeed2atom-main/gmifeed2atom -url gemini://sl1200.dystopic.world/feed.gmi -title "Feed de SL1200" -author SL1200 -logo gemini://sl1200.dystopic.world/atom-logo.jpg | sed 's|gemini://sl1200.|https://proxy.|g' > /home/sl1200/gemini/content/atom.xml 2> ~/error
El programa toma el contenido de mi archivo feed.gmi, sustituye todos los links del mismo que comienzan por gemini://sl1200. por https://proxy. y crea, en la carpeta de contenido de mi cápsula, el archivo atom.xml necesario para la suscripción. Finalmente, la dirección de la fuente de mi feed atom sería:
Con la combinación de tu cápsula, el proxy Kineto y gmifeed2atom, dispones de un sistema extremadamente fácil para crear y gestionar tu cápsula además de tener automáticamente presencia en la web y posibilitar a tus lectores la suscripción atom desde cualquier lector RSS.
-- Response ended
-- Page fetched on Fri May 17 05:24:22 2024