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