# # WWWOFFLE - World Wide Web Offline Explorer - Versión 2.6. # # WWWOFFLE fichero de Configuración CONFDIR/wwwoffle.conf # # Fichero de configuración Copyright 1997,98,99,2000 Andrew M. Bishop. # Puede ser distribuido bajo la licencia Pública General GNU, version 2, # o superior. Vea la sección COPYING de la licencia Pública General GNU # para las condiciones bajo las que puede redistribuir este fichero. # # # # El fichero de configuración (wwwoffle.conf) especifica todos los parámetros # que controlan el funcionamiento del servidor proxy. El fichero está # dividido en secciones que contienen una serie de parámetros que se describen # más abajo. El fichero CHANGES.CONF explica los cambios en el fichero de # configuración desde las versiones anteriores. # # 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 # # StartUp # ------- # # Esta sección contiene los parámetros que se usan cuando el programa comienza, # estos cambios serán ignorados si el programa es releído mientras el programa # está ejecutándose. # # http-port = (puerto) # Un entero especificando el puerto para el proxy HTTP # (por defecto=8080). # # wwwoffle-port = (puerto) # Un entero especificando el puerto para el control de las conexiones # de WWWOFFLE (por defecto=8081). # # spool-dir = (dir) # El nombre del directorio almacén (por defecto=/var/spool/wwwoffle). # # run-uid = (usuario) | (uid) # El nombre o número de usuario con el que ejecutar el servidor # wwwoffled (por defecto=ninguno). Esta opción no se puede aplicar a # win32. Sólo funciona en UNIX si el servidor es inicializado por root # # run-gid = (grupo) | (gid) # El nombre o número del grupo con el que ejecutar el servidor # wwwoffled (por defecto=ninguno). Esta opción no se puede aplicar a # win32. Sólo funciona en UNIX si el servidor es inicializado por root # # use-syslog = yes | no # Usar syslog para guardar los mensajes (por defecto=yes). # # password = (palabra) # La contraseña usada para la autentificación de las páginas de # control, para borrar páginas almacenadas, etc... (por defecto=ninguna). # Para que la contraseña este segura el fichero de configuración debe # estar asegurado para que sólo personal autorizado tenga acceso a él. # # max-servers = (entero) # El número máximo de procesos servidores que se ejecutarán para # descarga en modo conectado y descarga automática (por defecto=8). # # max-fetch-servers = (entero) # El número máximo de procesos servidores que se ejecutan para descargar # páginas que fueron marcadas en modo desconectado (por defecto=4). # Este valor debe ser menor que max-servers o no será capaz de usar # WWWOFFLE interactivamente mientras se descargar páginas. # StartUp { http-port = 8080 wwwoffle-port = 8081 spool-dir = SPOOLDIR # run-uid = daemon # run-gid = daemon use-syslog = yes password = none max-servers = 8 max-fetch-servers = 4 } # # Options # ------- # # Opciones que controlan como funciona el programa. # # log-level = debug | info | important | warning | fatal # Guarda los mensajes con esta o más alta prioridad # (por defecto=important). # # socket-timeout = (tiempo) # El tiempo en segundos que WWWOFFLE esperará en una # conexión por socket antes de abandonar (por defecto=120). # # dns-timeout = (tiempo) # El tiempo en segundos que WWWOFFLE esperará en una conexión con el # DNS (Servidor de Nombres de Dominios) antes de abandonar # (por defecto=60). # # connect-timeout = (tiempo) # El tiempo en segundos que WWWOFFLE esperará a que se establezca # una conexión por socket antes de abandonar (por defecto=30). # # connect-retry = yes | no # Si una conexión no se puede establecer WWWOFFLE lo intentará tras # esperar un tiempo prudencial (por defecto=no). # # # index-latest-days = (edad) # El número de días que mostrar en el índice de últimas páginas # (por defecto=7 días). # # request-changed = (tiempo) # Mientras se está conectado las páginas solo serán descargadas si la # versión almacenada es más vieja que la especificada. tiempo en # segundos (por defecto=600). # # request-changed-once = yes | no # Mientras se está conectado las páginas solo serán descargadas si la # versión almacenada no ha sido ya recogida una vez en esta sesión # (por defecto=yes). # # pragma-no-cache = yes | no # Pedir otra copia de la página si la petición tiene # 'Pragma: no-cache' (por defecto=yes). # # confirm-requests = yes | no # Devolver una página que requiere la confirmación del usuario en # vez de grabar automáticamente las peticiones hechas desconectado # (por defecto=no). # # socket-timeout = # El tiempo en segundos que WWWOFFLE esperará los datos hasta que se # deje una conexión (por defecto=120). # # connect-retry = yes | no # Si una conexión a un servidor remoto no se ha podido realizar # realizarla tras un corto período de tiempo. (por defecto=no). # # ssl-allow-port = (entero) # Un número de puerto que tiene permitida la conexión mediante # conexiones de Capa de Conexión Segura (SSL), p. e. https. # Esta opción debería ser 443 para permitir https. También puede haber # más de una entrada de puertos ssl si se necesita. # # dir-perm = (entero_octal) # Los permisos que se usarán para crear los directorios almacén # (por defecto=0755). Estas opciones invalidan los valores de umask # del usuario y deben estar en octal empezando con un cero (0). # # file-perm = (entero octal) # Los permisos que se usarán para crear los ficheros almacén # (por defecto=0644). Estas opciones invalidan los valores de umask # del usuario y deben estar en octal empezando con un cero (0). # # run-online = (fichero) # El nombre de un programa que se ejecute cuando se cambie a modo # conectado. (por defecto=ninguno). El programa se inicia con un # sólo parámetro con el modo actual, "online" (conectado). # # run-offline = (fichero) # El nombre de un programa que se ejecute cuando se cambie a modo # desconectado. (por defecto=ninguno). El programa se inicia con # un sólo parámetro con el modo actual, "offline" (desconectado). # # run-autodial = (fichero) # El nombre de un programa que se ejecute cuando se cambie a modo # Auto llamada. (por defecto=ninguno). El programa se inicia con un # sólo parámetro con el modo actual, "autodial" (auto-llamada). # # run-fetch = (fichero) # El nombre de un programa que se ejecute cuando se arranque o se pare # el modo de recogida (por defecto=ninguno). El programa se inicia # con dos parámetros, el primero es la palabra "fetch" (recogida) y # la segunda es "start" (comienzo) o "stop" (parada). # # lock-files = yes | no # Activa el uso de ficheros de bloqueo para impedir que más de un # proceso WWWOFFLE baje la misma URL al mismo tiempo (por defecto=no). # Options { log-level = important socket-timeout = 120 dns-timeout = 60 connect-timeout = 30 connect-retry = no ssl-allow-port = 443 dir-perm = 0755 file-perm = 0644 lock-files = no } # # OnlineOptions # ------------- # # Opciones que controlan como se comporta WWWOFFLE cuando está conectado. # # [] 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) # # [] 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. # # [] 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. # # [] 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. # # [] 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. # # [] intr-download-keep = yes | no # Si el navegador cierra la conexión mientras está conectado se # guardará la página incompleta (por defecto=no). # # [] 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). # # [] 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). # # [] 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). # OnlineOptions { request-changed = 10m request-changed-once = yes request-expired = no request-no-cache = no try-without-password = yes intr-download-keep = no intr-download-size = 1 intr-download-percent = 80 timeout-download-keep = no } # # OfflineOptions # -------------- # # [] pragma-no-cache = yes | no # Whether to request a new copy of a page if the request from the # browser has 'Pragma: no-cache' (default=yes). This option option # should be set to 'no' if when browsing offline all pages are # re-requested by a 'broken' browser. # # [] confirm-requests = yes | no # Whether to return a page requiring user confirmation instead of # automatically recording requests made while offline (default=no). # # [] dont-request = yes | no # Do not request any URLs that match this when offline (default=no). # OfflineOptions { pragma-no-cache = yes confirm-requests = no # ### Ejemplo #### # No pedir ninguna URLs estando desconectado. # <*://*/*> dont-request = yes } # # FetchOptions # ------------ # # La opciones que controlan la recogida de páginas que se pidieron estando # desconectado # # stylesheets = yes | no # Si se quieren descargar Hojas de Estilo. (por defecto=no). # # images = yes | no # Si se quieren descargar Imágenes. (por defecto=no). # # frames = yes | no # Si se quieren descargar Marcos. (por defecto=no). # # scripts = yes | no # Si se quieren descargar guiones (p.e. Javascript). (por defecto=no). # # objects = yes | no # Si se quieren descargar objetos (p.e. Ficheros de clases Java). # (por defecto=no). # FetchOptions { stylesheets = no images = yes frames = yes scripts = no objects = no } # # IndexOptions # ------------ # # no-lasttime-index = yes | no # Deshabilita la creación de los índices Última Vez/Vez Anterior # (por defecto=no). # # list-outgoing = yes | no # Elije si la URL se mostrará en el directorio de peticiones # salientes. (por defecto=yes). # # 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). # # list-monitor = yes | no # elije si la URL se mostrará en el índice de páginas monitorizadas. # (por defecto=yes). # # list-host = yes | no # Elije si la URL se mostrará en los índices de servidores # (por defecto=yes). # # list-any = yes | no # Elije si la URL se mostrará en alguno de los índices # (por defecto=yes). # IndexOptions { no-lasttime-index = no # ### Ejemplo #### # No indexar ningún servidor en el dominio barfoo.com. # <*://*.barfoo.com/> list-any = no # No indexar ningún fichero gif o jpg en el índice Última Vez(lasttime). # <*://*/*.gif> list-latest = no # <*://*/*.jpg> list-latest = no } # # ModifyHTML # ---------- # # Opciones que controlan como el HTML almacenado en la caché es modificado. # # [] 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. # # [] 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). # # [] anchor-cached-begin = (HTML code) | # Los enlaces que son almacenados tienen el código HTML especificado # insertado al principio (por defecto=""). # # [] anchor-cached-end = (HTML code) | # Los enlaces que son almacenados tienen el código HTML especificado # insertado al final (por defecto=""). # # [] anchor-requested-begin = (HTML code) | # Los enlaces que han sido pedidos para descarga tienen el código HTML # especificado insertado al principio.(por defecto=""). # # [] anchor-requested-end = (HTML code) | # Los enlaces que han sido pedidos para descarga tienen el código HTML # especificado insertado al final.(por defecto=""). # # [] 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="") # # [] 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="") # # [] disable-script = yes | no # Quita todos los guiones (por defecto=no). # # [] disable-blink = yes | no # Quita la etiqueta de parpadeo () (por defecto=no). # # [] 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). # # [] 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) # # [] disable-animated-gif = yes | no # Desactiva la animación de los ficheros GIF (por defecto=no). # ModifyHTML { enable-modify-html = no add-cache-info = no # anchor-cached-begin = # anchor-cached-end = # anchor-requested-begin = # anchor-requested-end = # anchor-not-cached-begin = # anchor-not-cached-end = disable-script = no disable-blink = no disable-meta-refresh = no disable-meta-refresh-self = no demoronise-ms-chars = no disable-animated-gif = no } # # LocalHost # --------- # # Una lista de huéspedes que el servidor ejecutando wwwoffled puede ser # conocido. Esto es así para que el proxy no necesite contactar el mismo para # conseguir las páginas locales del servidor en el caso de que tenga # diferentes nombres. # # (servidor) # Un nombre de servidor o dirección IP que en conexión con el número # de puerto (en la sección Startup) especifica el servidor HTTP WWWOFFLE. # Los nombres de servidores tienen que coincidir exactamente, no # use comodines.. El primer nombre del servidor tendrá diferentes # usos por lo que debería ser un nombre que funcione desde todos los # clientes de la red. Ninguno de los servidores nombrados aquí serán # almacenados o recogidos a través del proxy. # LocalHost { localhost 127.0.0.1 # ### Example #### # The server is on www.foo.com, with IP address 11.22.33.44. # www.foo.com # 11.22.33.44 } # # LocalNet # -------- # # Una lista de servidores que tienen accesible el servicio web incluso cuando # está desconectado y WWWOFFLE no debe almacenar porque están en una red local. # # (servidor) # Un nombre de servidor o dirección IP que está siempre disponible y # WWWOFFLE no almacenará. La correspondencia de nombres de servidores # usa comodines. Puede excluir un servidor añadiendo el símbolo '!' # al principio del nombre. También se necesitan todos los posibles # alias y direcciones IP del servidor. Se asumirá que todas las # entradas que escriba aquí estarán accesibles cuando esté desconectado. # Ninguno de estos servidores será almacenados o recogidos a través # del proxy. # LocalNet { # ### Ejemplo #### # El dominio local es foo.com por lo tanto no almacenar ningún servidor en # él. # *.foo.com } # AllowedConnectHosts # ------------------- # # Una lista de los huéspedes que tienen permitida la conexión al servidor. # # (huésped) # Un huésped o dirección IP que tiene permitida la conexión al servidor. # La correspondencia de nombres de servidores usa comodines. Puede # excluir un huésped añadiendo el símbolo '!' al principio del nombre. # También se necesitan todos los posibles alias y direcciones IP # del huésped. Todos los nombres de servidor nombrados en las sección # LocalHost también tienen permitida la conexión. # AllowedConnectHosts { # ### Ejemplo #### # Permitir sólo conexiones desde huéspedes en el dominio foo.com. # *.foo.com } # # AllowedConnectUsers # ------------------- # # Una lista de los usuarios y sus contraseñas, que tienen permitida la conexión # con el servidor. # # (usuario):(contraseña) # El nombre de usuario y la contraseña de los usuarios que tienen # permitida la conexión con el servidor. Si la sección se deja vacía # no se realiza autentificación por contraseña. El nombre de usuario # y contraseñas se almacenan en formato de texto plano. Esta opción # requiere el uso de navegadores que soporten el estándar HTTP/1.1 de # autentificación frente al proxy. # AllowedConnectUsers { # ### Ejemplo #### # Permitir conexiones de este usuario solamente. # andrew:password } # # DontCache # --------- # # Una lista de URLs que WWWOFFLE no almacenará. # # [!]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 # DontCache { # ### Ejemplo #### # No almacenar ningún servidor del dominio barfoo.com. # *://*.barfoo.com/ # No almacenar ningún fichero gzip o tar. # *://*/*.gz # *://*/*.tar # No almacenar ningún fichero del directorio /volatile del dominio foo.com. # *://*.foo.com/volatile/* } # # DontGet # ------- # # Una lista de URLs que WWWOFFLE no debe descargar (porque solo contienen # publicidad o basura, por ejemplo). # # [!]ESPECIFICACIÓN-URL # No descargar ninguna URL que coincida con esto. La ESPECIFICACIÓN-URL # puede ser negada para permitir descargar las coincidencias. # # [] 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). # # get-recursive = yes | no # Elija si las URLs que coincidan serán recogidas en una recogida # recursiva (por defecto=yes). # # # 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. # DontGet { # replacement = /local/dontget/replacement.gif # ### Ejemplo #### # No descargar desde ningún servidor en el dominio barfoo.com. # *://*.barfoo.com/ # No descargar ningún fichero gzip o tar. # *://*/*.gz # *://*/*.tar # No descargar ningún fichero del directorio /adverts en el dominio foo.com. # *://*.foo.com/adverts* # No descargar ningún fichero gzip o tar al descargar recursivamente. # <*://*/*.gz> get-recursive = no # <*://*/*.tar> get-recursive = no } # # CensorHeader # ------------ # # Una lista de cabeceras HTTP que se deben quitar de la petición hecha al # servidor web y de las respuestas que vuelvan de vuelta. # # [] (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. # # [] referer-self = yes | no # Pone la cabecera Referer al mismo valor que la URL que se ha pedido # (por defecto = no). # # [] 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. # CensorHeader { # ## Ejemplo ### # No enviar el nombre de usuario. # From = yes # No aceptar Cookies # Set-Cookie = yes # No devolver Cookies # Cookie = yes # Mentir sobre el navegador. # User-Agent = WWWOFFLE/2.5 } # # FTPOptions # ---------- # # Opciones a usar cuando se descargan ficheros usando el protocolo ftp. # # anon-username = (cadena) # El nombre de usuario a usar para ftp anónimo (por defecto=anonymous). # # anon-password = (cadena) # La contraseña a usar para ftp anónimo # (por defecto=se determina en tiempo de ejecución). # Si está usando un cortafuegos puede contener valores no válidos para # el servidor FTP y debe ser puesto a un valor diferente. # # [] auth-username = (cadena) # Un nombre de usuario a usar en un servidor en vez de usuario anónimo # por defecto. # # [] auth-password = (cadena) # La contraseña a usar en un servidor en vez de la contraseña # anónima por defecto. # FTPOptions { anon-username = anonymous # anon-password = } # # MIMETypes # --------- # # Tipos MIME a usar cuando se sirven ficheros que no han sido recogidos usando # HTTP o para ficheros en el servidor web incorporado. # # default = (tipo-mime)/(subtipo) # El tipo MIME por defecto. (por defecto=text/plain). # # .(ext-fichero) = (tipo-mime)/(subtipo) # El tipo MIME asociado con la extensión de un fichero. # El punto (.) debe ser incluido en la extensión de fichero. # Si coincide más de una extensión se usará la más larga. # MIMETypes { default = text/plain .Z = application/x-compress .au = audio/basic .avi = video/x-msvideo .class = application/java .cpio = application/x-cpio .css = text/css .deb = application/octet-stream .dtd = application/xml .dvi = application/x-dvi .eps = application/postscript .gif = image/gif .gz = application/x-gzip .htm = text/html .html = text/html .jpeg = image/jpeg .jpg = image/jpeg .js = application/x-javascript .latex = application/x-latex .man = application/x-troff-man .me = application/x-troff-me .mov = video/quicktime .mpeg = video/mpeg .mpg = video/mpeg .ms = application/x-troff-ms .pac = application/x-ns-proxy-autoconfig .pbm = image/x-portable-bitmap .pdf = application/pdf .pgm = image/x-portable-graymap .png = image/png .pnm = image/x-portable-anymap .ppm = image/x-portable-pixmap .ps = application/postscript .ras = image/x-cmu-raster .rgb = image/x-rgb .rpm = application/octet-stream .rtf = application/rtf .snd = audio/basic .tar = application/x-tar .tcl = application/x-tcl .tex = application/x-tex .texi = application/x-texinfo .texinfo = application/x-texinfo .tif = image/tiff .tiff = image/tiff .tr = application/x-troff .txt = text/plain .vr = model/vrml .wav = audio/x-wav .wrl = model/vrml .xbm = image/x-xbitmap .xml = application/xml .xpm = image/x-xpixmap .xwd = image/x-xwindowdump .zip = application/zip } # # Proxy # ----- # # Contiene los nombre de los proxies HTTP (u otros) a usar externamente a la # máquina local con WWWOFFLE. # # [] proxy = (servidor[:puerto]) # El huésped y el puerto a usar como proxy por defecto. # # 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. # # 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. # # [] 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 (*). # Proxy { proxy = none # ### Ejemplo #### # Usar www.foo.com como elproxy http por defecto en el puerto 8080 # excepto para el dominio foo.com que no usa proxy. # proxy = www.foo.com:8080 # <*://foo.com> proxy = none } # # Alias # ----- # # Una lista de alias que son usados para reemplazar el nombre del servidor y el # camino con otro nombre de servidor y camino. También para servidores que # son conocidos por dos nombres. # # 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. # Alias { # ### Ejemplo #### # El servidor http www.bar.com es replicado localmente en # www.bar-mirror.foo.com # http://www.bar.com/ = http://www.bar-mirror.foo.com/ # Puede especificar un alias para la página de wwwoffle # http://wwwoffle/ = http://www.gedanken.demon.co.uk/wwwoffle/ } # # Purge # ----- # # El método que determina que páginas eliminar, la edad por defecto, la edad de # las páginas de un servidor determinado en días y el tamaño máximo de la # caché. # # use-mtime = yes | no # El método a usar para decidir que ficheros purgar, el tiempo de # acceso (atime) o el tiempo de última modificación (mtime) # (por defecto=no). # # max-size = (tamaño) # El tamaño máximo de la caché en MB después de purgar (por defecto=0). # Un tamaño máximo de caché de 0 significa que no hay límite en # tamaño. Si se usa esta opción y la opción min-free se elegirá el # menor tamaño de caché. Esta opción, al calcular el tamaño de la # caché, tiene en cuenta las URLs que nunca son purgadas pero no las # eliminará. # # min-free = (size) # El espacio mínimo libre en disco en MB después de purgar # (por defecto=0). Un tamaño mínimo de disco de 0 significa que no # hay límite de espacio libre. Si se usa esta opción y la opción # max-free se elegirá el menor tamaño de caché. Esta opción tiene en # cuenta las URLs que nunca son purgadas pero no las eliminará. # # use-url = yes | no # si es verdad se usa la URL para decidir en la edad de purga, si # no se usa el servidor y el protocolo. (por defecto=no). # # del-dontget = yes | no # Si es verdad se borran las URLs que coinciden con las entradas de # la sección DontGet (por defecto=no). # # del-dontcache = yes | no # Si es verdad se borran las URLs que coinciden con las entradas # de la sección DontCache (por defecto=no). # # [] 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). # Purge { use-mtime = no max-size = 0 min-free = 0 use-url = no del-dontget = yes del-dontcache = yes age = 4w # ### Ejemplo #### # Purgar los servidor en el domain foo.com en 1 semana excepto bar.foo.com # en 2 semanas. # <*://foo.com/> age = 1w # <*://bar.foo.com/> age = 2w # Nunca guardar nada del dominio bar.com excepto foo.bar.com que se guardará # para siempre # <*://bar.com/> age = 0 # <*://foo.bar.com/> age = -1 # # Guardar los fichero ftp 7 días y los http 14. # age = 7 # age = 14 # # Purgar los ficheros de la caché por debajo de los 100 MB # max-size = 100 } # COMODINES # --------- # # Un comodín es usar el carácter '*' para representar cualquier grupo de # caracteres. # # 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 '/'. Se pueden usar un máximo de 2 '*' en cualquier # expresión. # # 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 # (proto)://(servidor)[:(puerto)]/(ruta)[?(argumentos)] # # Donde [] indica una característica opcional, y () indica un nombre o número # proporcionado por el usuario. # # 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. # # (proto):// Un protocolo, cualquier servidor, cualquier puerto, # cualquier ruta, cualquier argumento. # # (proto)://(servidor) Un protocolo, un servidor, cualquier puerto, # cualquier ruta, cualquier argumento # # (proto)://(servidor): Un protocolo, un servidor, puerto predeterminado, # 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.