El fichero está dividido en secciones, cada una de ellas puede estar vacía o puede contener una o más líneas con información sobre la configuración. Las secciones son nombradas en el orden en el que aparecen en el fichero de configuración, pero este orden no es importante,
El formato general de cada sección es el mismo. El nombre de cada sección está sólo en una línea para marcar su comienzo. Los contenidos de la sección están contenidos entre dos líneas que contienen los caracteres '{' y '}' o '[' y ']'. Cuando se usan los caracteres '{' y '}' las líneas entre ellos contienen información de la configuración. Cuando se usan los caracteres '[' y ']' debe haber una sola línea no vacía que contenga en nombre del fichero ( en el mismo directorio ) que contenga la información de configuración.
Los comentarios se marcan con el carácter '#' al principio de la línea. También se permiten las líneas en blanco. Ambos casos son ignorados.
Las frases ESPECIFICACIÓN-URL (o ESPEC-URL para acortar) y COMODÍN tienen diferentes significados en el fichero de configuración y son descritos al final. Cualquier objeto encerrado entre '(' y ')' en las descripciones significa que es un parámetro suministrado por el usuario. Cualquiera encerrado entre '[' y ']' es opcional. El símbolo '|' se usa para mostrar una serie de alternativas. Algunas de las opciones sólo de aplican específicamente a URLs. Esto se indica en la opción por una ESPECIFICACIÓN-URL encerrada entre '<' y '>'. La primera ESPEC-URL que corresponda será usada. Si no se da ninguna ESPEC-URL entonces se usarán todas las URLs
[<ESPEC-URL>] request-changed = (tiempo) Mientras está conectado las páginas sólo serán recogidas si la versión de la caché es más antigua que el tiempo especificado en segundos (por defecto=600). Si escribe un valor negativo indicará que las páginas almacenadas se usarán siempre mientras está conectado. Se pueden especificar tiempos más largos con los sufijos 'm', 'h', 'd' o 'w' para minutos, horas, días o semanas (p.e. 10m=600)
[<ESPEC-URL>] request-changed-once = yes | no Mientas está conectado las páginas sólo serán recogidas si la versión almacenada no ha sido ya recogida en esta sesión (por defecto=yes). Esta opción toma preferencia sobre la opción request-changed.
[<ESPEC-URL>] request-expired = yes | no Mientras está conectado las páginas que han expirado serán pedidas de nuevo (por defecto=no). Esta opción toma preferencia sobre las opciones request-changed y request-changed-once.
[<ESPEC-URL>] request-no-cache = yes | no Mientras está conectado las páginas que no se almacenarán serán pedidas de nuevo (por defecto=no). Esta opción toma preferencia sobre las opciones request-changed y request-changed-one.
[<ESPEC-URL>] try-without-password = yes | no Si se realiza una petición de una página que contiene un usuario y una contraseña se realizará la petición sin especificar el usuario y contraseña. Esto permite que las páginas sin contraseña redirijan al navegador a la versión con contraseña de la página.
[<ESPEC-URL>] intr-download-keep = yes | no Si el navegador cierra la conexión mientras está conectado se guardará la página incompleta (por defecto=no).
[<ESPEC-URL>] intr-download-size = (entero) Si el navegador cierra la conexión mientras está conectado se continuará la descarga si es menor que el tamaño en KB (por defecto=1).
[<ESPEC-URL>] intr-download-percent = (entero) Si el navegador cierra la conexión mientras está conectado se continuará la descarga si se ha completado más que el porcentaje especificado (por defecto=80).
[<ESPEC-URL>] timeout-download-keep = yes | no Si la conexión del servidor agota el tiempo de espera mientras descarga una página, esta página incompleta se guardará. (por defecto=no).
[<ESPEC-URL>] pragma-no-cache = yes | no Especifica si se ha de pedir una nueva copia de una página si la petición del navegador tenía la cabecera 'Pragma: no-cache' (por defecto=yes). Esta opción debería ponerse a 'no' si cuando esté desconectado todas las páginas son vueltas a pedir por un navegador 'roto'
[<ESPEC-URL>] confirm-requests = yes | no Especifica si volver a una página requiere confirmación del usuario en vez de grabar la petición automáticamente cuando se está desconectado. (por defecto=no).
[<ESPEC-URL>] dont-request = yes | no No pedir ninguna URL que corresponda con estas mientras se está desconectado. (por defecto=no).
<ESPEC-URL> list-outgoing = yes | no Elije si la URL se mostrará en el directorio de peticiones salientes. (por defecto=yes).
<ESPEC-URL> list-latest = yes | no Elije si la URL se mostrará en los índices Última Vez/Vez Anterior y Última Salida/Salida Anterior (por defecto=yes).
<ESPEC-URL> list-monitor = yes | no elije si la URL se mostrará en el índice de páginas monitorizadas. (por defecto=yes).
<ESPEC-URL> list-host = yes | no Elije si la URL se mostrará en los índices de servidores (por defecto=yes).
<ESPEC-URL> list-any = yes | no Elije si la URL se mostrará en alguno de los índices (por defecto=yes).
[<ESPEC-URL>] enable-modify-html = yes | no Activar las modificaciones en esta sección (por defecto=no). Con esta opción desactivada las demás opciones sobre HTML no tendrán ningún efecto. Con esta opción activada hay una pequeña penalización en velocidad.
[<ESPEC-URL>] add-cache-info = yes | no Añadir al final de todas las páginas almacenadas la fecha en la que esa página fue recogida y algunos botones (por defecto=no).
[<ESPEC-URL>] anchor-cached-begin = (HTML code) | Los enlaces que son almacenados tienen el código HTML especificado insertado al principio (por defecto="").
[<ESPEC-URL>] anchor-cached-end = (HTML code) | Los enlaces que son almacenados tienen el código HTML especificado insertado al final (por defecto="").
[<ESPEC-URL>] anchor-requested-begin = (HTML code) | Los enlaces que han sido pedidos para descarga tienen el código HTML especificado insertado al principio.(por defecto="").
[<ESPEC-URL>] anchor-requested-end = (HTML code) | Los enlaces que han sido pedidos para descarga tienen el código HTML especificado insertado al final.(por defecto="").
[<ESPEC-URL>] anchor-not-cached-begin = (HTML code) |· Los enlaces de las páginas que no se guardarán en la caché o no serán pedidas tienen el siguiente código insertado al principio. (por defecto="")
[<ESPEC-URL>] anchor-not-cached-end = (HTML code) |· Los enlaces de las páginas que no se guardarán en la caché o no serán pedidas tienen el siguiente código insertado al final. (por defecto="")
[<ESPEC-URL>] disable-script = yes | no Quita todos los guiones (por defecto=no).
[<ESPEC-URL>] disable-blink = yes | no Quita la etiqueta de parpadeo (<blink>) (por defecto=no).
[<ESPEC-URL>] disable-meta-refresh = yes | no Quita cualquier etiqueta de tipo "meta" en la cabecera HTML que redirija al navegador a recargar la página tras un espacio de tiempo (por defecto=no).
[<ESPEC-URL>] demoronise-ms-chars = yes | no Reemplaza los caracteres extraños que alguna aplicaciones de Microsoft ponen en el HTML con caracteres equivalentes que la mayoría de los navegadores pueden mostrar (por defecto=no). La idea viene del guión Perl de dominio publico "Demoroniser" (Desidiotizador)
[<ESPEC-URL>] disable-animated-gif = yes | no Desactiva la animación de los ficheros GIF (por defecto=no).
[!]ESPECIFICACIÓN-URL No almacenar ninguna URL que coincida con esto. La ESPECIFICACIÓN-URL puede ser negada para permitir que las coincidencias sean almacenadas. Las URLs no se pedirán si está desconectado
[!]ESPECIFICACIÓN-URL No descargar ninguna URL que coincida con esto. La ESPECIFICACIÓN-URL puede ser negada para permitir descargar las coincidencias.
[<ESPEC-URL>] replacement = (URL) La URL a usar para reemplazar cualquier URL que coincida con la ESPECIFICACIÓN-URL en vez de usar el mensaje de error estándar (por defecto=ninguna). Se sugiere como reemplazo la URL /local/dontget/replacement.gif (un gif transparente de 1x1 pixel).
<ESPEC-URL> get-recursive = yes | no Elija si las URLs que coincidan serán recogidas en una recogida recursiva (por defecto=yes).
<ESPEC-URL> location-error = yes | no Cuando la respuesta de la URL contiene una cabecera 'Location' () que redirige a una página especificada en esta sección la respuesta es modificada para mostrar un mensaje de error en vez de la página (por defecto=no). Esto parará la redirección de los proxies de los ISPs a anuncios si las URLs de los anuncios están en esta sección.
[<ESPEC-URL>] (cabecera) = yes | no | (cadena) Una campo de la cabecera, (p.e. From, Cookie, Set-Cookie User-Agent) y la cadena para reemplazar el valor de la cabecera (por defecto=no). La cabecera distingue mayúsculas de minúsculas y no contiene un ':' al final. El valor "no" significa que la cabecera no se modificará. Los valores "yes" o no poner una cadena pueden usarse para eliminar la cabecera. También puede usar una cadena para reemplazar la cabecera. Esta opción sólo reemplaza cabeceras si las encuentra, no añade ninguna nueva.
[<ESPEC-URL>] referer-self = yes | no Pone la cabecera Referer al mismo valor que la URL que se ha pedido (por defecto = no).
[<ESPEC-URL>] referer-self-dir = yes | no Pone la cabecera Referer al nombre del directorio en el que se encuentra la URL que se ha pedido (por defecto = no). Esta opción toma preferencia sobre referer-self.
[<ESPEC-URL>] auth-username = (cadena) Un nombre de usuario a usar en un servidor en vez de usuario anónimo por defecto.
[<ESPEC-URL>] auth-password = (cadena) La contraseña a usar en un servidor en vez de la contraseña anónima por defecto.
[<ESPEC-URL>] proxy = (servidor[:puerto]) El huésped y el puerto a usar como proxy por defecto.
<ESPEC-URL> auth-username = (cadena) El nombre de usuario a usar en un servidor proxy para autentificar WWWOFFLE frente a él. La ESPEC-URL en este caso se refiere al proxy, no a la URL que se está recogiendo.
<ESPEC-URL> auth-password = (cadena) La contraseña a usar en el servidor proxy para autentificar WWWOFFLE frente a él. La ESPEC-URL en este caso se refiere al proxy y no a la URL que se está recogiendo.
[<ESPEC-URL>] ssl = (servidor[:puerto]) Un servidor proxy que se debe usar para conexiones de Capa de Conexión Segura (SSL) p.e. https. Note que de la ESPEC-URL sólo se comprueba el nombre de servidor. Las otras partes deben ser comodines (*).
ESPECIFICACIÓN-URL = ESPECIFICACIÓN-URL Cualquier petición que coincida con la primera ESPEC-URL es reemplazada por la segunda ESPEC-URL. Las ESPEC-URL deben coincidir exactamente. No es una correspondencia por comodines. Los argumentos de la URL son ignorados.
[<ESPEC-URL>] age = (edad) La edad máxima en la caché para las URLs que coinciden con esto (por defecto=14). Una edad de cero significa no guardar. Un valor negativo no borrar. La ESPECIFICACIÓN-URL corresponde sólo con el protocolo y servidor a menos que se haya especificado como verdadera la opción use-url. Se pueden especificar tiempos más largo con los sufijos 'w', 'm' o 'y' para semanas, meses o años (p. e. 2w=14).
Es básicamente la misma expresión de correspondencia de ficheros de la línea de comandos de DOS o la shell de UNIX, excepto que el carácter '*' puede aceptar el carácter '/'.
Por ejemplo
*.gif corresponde con foo.gif y bar.gif *.foo.com corresponde con www.foo.com y ftp.foo.com /foo/* corresponde con /foo/bar.html y /foo/bar/foobar.html
ESPECIFICACIÓN-URL
Cuando se especifica un servidor, un protocolo y una ruta, en muchas secciones se puede usar una ESPECIFICACIÓN-URL, que es una forma de reconocer una URL
Para esta explicación consideramos que una URL puede constar de cinco partes.
proto El protocolo que usa (p.e. 'http', 'ftp') servidor El nombre de servidor (p.e. 'www.gedanken.demon.co.uk'). puerto El número de puerto en el servidor (p.e. por defecto 80 para HTTP). ruta La ruta en el servidor (p.e. '/bar.html') o un nombre de directorio (p.e. '/foo/'). argumentos Argumentos opciones de la URL usados por guiones CGIs etc... (p. e.) 'search=foo').
Por ejemplo, en la página de WWWOFFLE: http://www.gedanken.demon.co.uk/wwwoffle/ El protocolo es 'http', el servidor es 'www.gedanken.demon.co.uk', el puerto es el predeterminado (en este caso 80), y la ruta es '/wwwoffle/'.
En general se escribe como
Alguna opciones comunes de ESPECIFICACIÓN-URL son las siguientes:
*://*/* Cualquier protocolo, cualquier servidor, cualquier ruta (Es lo mismo que decir 'el predeterminado').
*://*/(ruta) Cualquier protocolo, cualquier servidor, cualquier puerto, una ruta, cualquier argumento.
*://*/*.(ext) Cualquier protocolo, cualquier servidor, cualquier puerto, una ruta, cualquier argumento.
*://*/*? Cualquier protocolo, cualquier servidor, cualquier ruta, Ningún argumento.
*://(servidor)/* Cualquier protocolo, un servidor, cualquier puerto, cualquier ruta, cualquier argumento.
*://(servidor):(puerto)/* Cualquier protocolo, un servidor, un puerto, cualquier ruta, cualquier argumento.
La correspondencia del servidor y la ruta usa los comodines descritos arriba.
En algunas secciones se acepta que la ESPECIFICACIÓN-URL este negada añadiendo el carácter '!' al comienzo. Esto significa que la comparación entre la URL y la ESPECIFICACIÓN-URL devolverá el valor lógico opuesto al que devolvería sin el carácter '!'. Si todas las ESPECIFICACIONES-URL de la sección están negadas y se añade '*://*/*' al final, el sentido de la sección entera será negado.