🎨 (config): Alinea comentarios en reference.toml

This commit is contained in:
Manuel Cillero 2026-10-31 00:55:43 +01:00
parent 4c8eee3585
commit 67118caef7

View file

@ -46,21 +46,22 @@ timezone = "UTC" # Zona horaria del sitio (IANA: "UTC", "Euro
# da igual escribirla en mayúsculas o minúsculas.
# Se aplica a anónimos y a usuarios sin zona horaria propia,
# y a todos si 'timezone_per_user' es false.
timezone_regions = "" # Regiones de las zonas horarias que se ofrecen, separadas por
# comas (p. ej. "Europe, America"), elegidas entre "Africa",
# "America", "Antarctica", "Arctic", "Asia", "Atlantic",
# "Australia", "Europe", "Indian" y "Pacific". "Etc" (Etc/UTC)
# se ofrece siempre. Si está vacío se ofrecen todas. Los nombres
# desconocidos se ignoran con un aviso al arrancar; si ninguno
# es válido se ofrecen todas, y se avisa también si la región de
# 'timezone' queda fuera de las ofrecidas. No cambia las zonas
# ya asignadas a los usuarios (las conservan), sólo las nuevas
# elecciones. Es el valor por defecto del selector de zona
# horaria; la aplicación puede cambiarlo en un formulario
# concreto.
timezone_regions = "" # Regiones de las zonas horarias que se ofrecen, separadas
# por comas (p. ej. "Europe, America"), elegidas entre
# "Africa", "America", "Antarctica", "Arctic", "Asia",
# "Atlantic", "Australia", "Europe", "Indian" y "Pacific".
# "Etc" (Etc/UTC) se ofrece siempre. Si está vacío se ofrecen
# todas. Los nombres desconocidos se ignoran con un aviso al
# arrancar; si ninguno es válido se ofrecen todas, y se avisa
# también si la región de 'timezone' queda fuera de las
# ofrecidas. No cambia las zonas ya asignadas a los usuarios
# (las conservan), sólo las nuevas elecciones. Es el valor
# por defecto del selector de zona horaria; la aplicación
# puede cambiarlo en un formulario concreto.
timezone_order = "Nearest" # Orden de esas regiones al elegir zona horaria:
# "Nearest" -> la del sitio primero, si tiene región, y
# luego por cercanía de su desfase horario.
# "Nearest" -> la del sitio primero, si tiene
# región, y luego por cercanía de su
# desfase horario.
# "Alphabetical" -> por el nombre de la región traducido al
# idioma de la página.
# "Listed" -> en el orden de 'timezone_regions' (sin
@ -124,28 +125,30 @@ transport = "log" # Entrega de los correos:
# "memory" -> se guardan en memoria (sólo pruebas).
#from = "Mi Aplicación <no-reply@example.com>"
# Remitente por defecto, con o sin nombre. Sin valor, cada
# correo debe indicar el suyo para enviarse (salvo con "log").
# Los de pagetop-user no lo indican: configúralo siempre.
# correo debe indicar el suyo para enviarse (salvo con
# "log"). Los de pagetop-user no lo indican: configúralo
# siempre.
#reply_to = "soporte@example.com"
# Dirección de respuesta por defecto.
#redirect_to = "pruebas@example.com"
# Entrega todos los correos sólo a esta dirección, sin
# cambiar sus cabeceras (entornos de pruebas o preproducción).
# cambiar sus cabeceras (entornos de pruebas o
# preproducción).
#base_url = "https://example.com"
# URL pública para los enlaces de los correos. Sin valor,
# http://{bind_address}:{bind_port} (sólo para desarrollo).
previews = false # Vistas previas de los correos en /mail/preview. Sólo en
# desarrollo: cualquiera que conozca la ruta las ve.
delivery_timeout_secs = 300 # Tiempo máximo de cada entrega, en segundos (1 a 86400),
# incluida la espera de turno. Recomendado: 300. Reducirlo (60
# o 120) con un servidor cercano y rápido detecta antes los
# fallos, pero debe superar con holgura 2 x timeout_secs de
# [mail.smtp], y da por fallidos más correos que un servidor
# lento sí acepta (con la cola, se entregan por duplicado).
# Aumentarlo sólo con servidores muy lentos o adjuntos grandes:
# los correos retienen su turno más tiempo y, con la cola, una
# entrega interrumpida espera el triple de este tiempo para
# reintentarse.
# incluida la espera de turno. Recomendado: 300. Reducirlo
# (60 o 120) con un servidor cercano y rápido detecta antes
# los fallos, pero debe superar con holgura 2 x timeout_secs
# de [mail.smtp], y da por fallidos más correos que un
# servidor lento sí acepta (con la cola, se entregan por
# duplicado). Aumentarlo sólo con servidores muy lentos o
# adjuntos grandes: los correos retienen su turno más tiempo
# y, con la cola, una entrega interrumpida espera el triple
# de este tiempo para reintentarse.
max_waiting = 100 # Correos que pueden esperar turno por cada envío simultáneo
# (pool_max_size o max_concurrent); con más, la entrega falla
# enseguida (con la feature "queue", send_later() los deja en
@ -173,9 +176,9 @@ timeout_secs = 60 # Espera máxima de cada orden al servidor,
# responde ahí retiene un envío simultáneo. Si el servidor lo
# admite, es preferible security = "starttls".
pool_max_size = 10 # Envíos simultáneos como máximo (los demás esperan turno, y
# la espera cuenta en delivery_timeout_secs), y conexiones que
# se conservan para reutilizarlas. Por cada envío esperan como
# mucho max_waiting correos; con más, falla enseguida.
# la espera cuenta en delivery_timeout_secs), y conexiones
# que se conservan para reutilizarlas. Por cada envío esperan
# como mucho max_waiting correos; con más, falla enseguida.
accept_invalid_certs = false # Acepta certificados no válidos. PELIGROSO: sólo pruebas.
[mail.sendmail] # Programa sendmail (transport = "sendmail").
@ -220,11 +223,13 @@ keep_failed_days = 30 # Días que se conservan los fallidos (0 = s
[cron]
mode = "internal" # Cómo se ejecutan los trabajos programados:
# "internal" -> con el planificador de la propia aplicación.
# "external" -> cuando un programa externo (crontab, systemd)
# llama a POST /cron con la cabecera
# "internal" -> con el planificador de la
# propia aplicación.
# "external" -> cuando un programa externo (crontab,
# systemd) llama a POST /cron con la cabecera
# "Authorization: Bearer {trigger_token}".
# "off" -> nunca de forma automática, sólo bajo demanda.
# "off" -> nunca de forma automática,
# sólo bajo demanda.
# Con varias instancias, "internal" sólo en una ("off" en las
# demás), o "external" en todas.
#trigger_token = "..." # Clave secreta del modo "external": 16 o más letras,
@ -239,7 +244,8 @@ shutdown_timeout_secs = 30 # Espera máxima, al detener la aplicación,
[cron.jobs."shop.cleanup"] # Ajustes de un trabajo, por su clave (opcional).
enabled = true # false -> no se ejecuta de forma automática.
#schedule = "*/10 * * * *" # Sustituye su programación: expresión cron, "@daily",
# "@every 5m" (cada 5 min) o "@delay 30s" (30 s tras terminar).
# "@every 5m" (cada 5 min) o "@delay 30s"
# (30 s tras terminar).
#timeout_secs = 600 # Sustituye su tiempo máximo por ejecución. 0 -> sin límite.
@ -251,16 +257,18 @@ require_email_verification = false # Las cuentas nuevas quedan pendientes ("Pen
# de activas hasta confirmar la dirección desde el enlace del
# correo de verificación que se envía al registrarse.
identity_policy = "strict" # Nombres de usuario que se aceptan:
# "strict" -> letras ASCII sin tildes, dígitos, ".", "_"
# y "-", de 3 a 32 caracteres.
# "unicode" -> letras y dígitos de cualquier alfabeto, sin
# mezclarlos, ".", "_" y "-", de 3 a 32.
# "strict" -> letras ASCII sin tildes, dígitos, ".",
# "_" y "-", de 3 a 32 caracteres.
# "unicode" -> letras y dígitos de cualquier alfabeto,
# sin mezclarlos, ".", "_" y "-",
# de 3 a 32.
# "permissive" -> como "unicode", más espacios simples, "'"
# y "+", de 3 a 60.
# Con cualquiera: nunca "@", sin distinguir mayúsculas y sin
# nombres que se confundan con otro existente.
max_failed_logins = 5 # Intentos fallidos seguidos que bloquean la cuenta. 0 -> nunca.
max_failed_logins = 5 # Intentos fallidos seguidos que bloquean la
# cuenta. 0 -> nunca.
failed_login_window_secs = 900 # Segundos desde el último fallo en los que el siguiente se
# suma al recuento (15 minutos); si no, empieza de nuevo.
locked_for_secs = 600 # Duración del bloqueo de la cuenta en segundos (10 minutos).
@ -273,17 +281,18 @@ login_strict = false # Dificulta que el navegador recuerde o auto
cookie_name = "pagetop" # Nombre de la cookie de sesión.
secure_cookie = false # Marca la cookie como Secure (sólo HTTPS). Activar en
# producción.
idle_secs = 7200 # Segundos sin uso tras los que caduca la sesión si no se marca
# "recordarme" al acceder (2 horas). Se cuentan desde la última
# petición.
idle_secs = 7200 # Segundos sin uso tras los que caduca la sesión si no se
# marca "recordarme" al acceder (2 horas). Se cuentan desde
# la última petición.
remember_idle_secs = 1209600 # Segundos sin uso tras los que caduca la sesión si se marca
# "recordarme" al acceder (14 días). Se cuentan igual.
write_interval_secs = 60 # Segundos mínimos entre dos escrituras de la misma sesión en la
# base de datos para prorrogarla. La sesión puede caducar hasta
# este tiempo antes de lo configurado. Subirlo (p. ej. 180)
# reduce escrituras con mucho tráfico o una base de datos lenta;
# bajarlo (o 0, escribir siempre) da más precisión si las
# sesiones caducan tras pocos minutos sin uso.
write_interval_secs = 60 # Segundos mínimos entre dos escrituras de la misma sesión en
# la base de datos para prorrogarla. La sesión puede caducar
# hasta este tiempo antes de lo configurado. Subirlo (p. ej.
# 180) reduce escrituras con mucho tráfico o una base de
# datos lenta; bajarlo (o 0, escribir siempre) da más
# precisión si las sesiones caducan tras pocos minutos sin
# uso.
[user.password] # Contraseñas, cifradas con Argon2id. Si cambia cualquiera de
# los tres costes, cada contraseña se vuelve a cifrar en el