!Archivo Gophermap de ejemplo para servidor Gophernicus que usamos en texto-plano.xyz
##
## Este es un gophermap de ejemplo.
##
#
Al crear un fichero llamado "gophermap" en un directorio, se
desactivara el listado normal de recursos del mismo y sera
reemplazado por los contenidos del archivo gophermap.
Puedes tener gophermaps en linea - ficheros con una extension ".gophermap"
que son interpretados como gophermaps y presentados entre los
recursos normales en orden alfabetico.
En los gophermaps, cualquier linea que no contenga un caracter <TAB>
resulta convertido automaticamente a un recurso gopher tipo "i", que
son presentados en texto plano en el cliente de gopher. Las lineas
que contienen tabulaciones son interpretadas como lineas de recursos
gopher las cuales seran presentadas como enlaces por el cliente.
La primer linea de un gophermap debe ser una linea !Titulo que
describa al menu.
Es posible hacer gophermaps dinamicos haciendo que el gophermap sea
un guion y tenga permisos de ejecucion. Toda la salida del guion
es intepretada como si fuese un gophermap estatico. Por ejemplo,
las lineas sin tabulaciones resultan convertidas a recursos "i".
Los gophermaps ejecutables siempre corren a traves del interprete
de comandos por defecto (/bin/sh) de modo que dependiendo del
sistema operativo sera lento, o insoportablemente lento...
El formato para una linea de recursos gophermap es simple:
Xnombre<TAB>selector<TAB>host<TAB>puerto
En donde:
X Es el itemtype de archivo gopher
name es una explicacion del recurso
selector es la ruta del recurso
host:puerto son el nombre de host y el numero de puerto a ir
Tipo y nombre son obligatorios. Si no especifica un selector, el
campo del nombre sera tambien utilizado como selector. Si no
especifica un host o puerto, se utilizara el host:puerto del
servidor actual. Asegurese de utilizar SOLO UNA TABULACION entre
los campos.
Los itemtype validos incluyen:
0 Archivo de texto
1 Directorio
3 Mensaje de error
5 Archivo comprimido (zip, tar etc)
7 Interrogante de busqueda
8 Sesion telnet
9 Fichero binario
g Imagen GIF
h Archivo HTML
i texto de informacion
I fichero de imagen generica (distinto que GIF)
d fichero de documento (ps, pdf, doc etc)
s archivo de sonido
; archivo de video
c fichero de calentadio
M archivo MIME (mbox, emails etc)
Additional type characters supported by Gophernicus:
# Comentario - se ignora el resto de la linea
!titulo titulo del menu (uselo en la primer linea)
-fichero oculta un fichero del listado
:ext=type cambia el itemtype (solo para este directorio)
~ presenta una lista de osuarios con un ~/public_gopher valido
% incluye una lista de host virtuales disponibles
=mapfile incluye o ejecuta otro gophermap
* Detiene el procesado de gophermap, incluye listado de ficheros
. Detiene el procesado de gophermap (por defecto)
Ejemplos de lineas de recurso validos:
1subdir
1Enlace interno relativo enlace subdirectorio
1Enlace interno absoluto /subdirectorio
1Enlace externo / gopher.floodgap.com 70
1Enlace relativo externo (que no deberia funcionar) subdirectorio/ gopher.domain.dom 70
0Enlace Finger-a-gopher user ejemplo.test 79
hEnlace a pagina web URL:http://www.texto-plano.xyz/
hEnlace a una pagina HTML local /ruta/a/fichero.html
5Link to an tar archive /ruta/a/archivo.tar.gz
9Link to a binary file /ruta/a/binario
7Interrogante a motor de busqueda /busqueda
8sesion telnet usuario ejemplo.test 79
# Oculta algunos ficheros desde el listado de menu generado por *
-fichero_oculto.txt
-directorio_oculto
# Cambia los itemtype de fichero para este directorio
:png=g
:foo=b
Incluye enlaces a los propios hoyos gopher de l@s usuari@s:
~
Lista de todos los host virtuales disponibles:
%
Include sub-gophermap:
=LICENSE
Ejecuta un guion y envia su resultado como un subgophermap:
=/usr/bin/uptime
Aqui detenemos el interpretado del gophermap e incluimos el menu regulara:
*