🎨 (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

@ -29,284 +29,293 @@
# **< PageTop (núcleo) >**************************************************************************** # **< PageTop (núcleo) >****************************************************************************
[app] [app]
name = "PageTop App" # Nombre de la aplicación. name = "PageTop App" # Nombre de la aplicación.
theme = "Basic" # Tema predeterminado: "Basic" o el de una extensión enlazada theme = "Basic" # Tema predeterminado: "Basic" o el de una extensión enlazada
# por la aplicación ("Aliner", "Bootsier"...). Si no está # por la aplicación ("Aliner", "Bootsier"...). Si no está
# habilitado se usa "Basic", con un aviso al arrancar. # habilitado se usa "Basic", con un aviso al arrancar.
#language = "es-ES" # Idioma predeterminado (BCP 47: "es-ES", "en-US"...). Sin #language = "es-ES" # Idioma predeterminado (BCP 47: "es-ES", "en-US"...). Sin
# valor, o si no es válido, el idioma se negocia con otras # valor, o si no es válido, el idioma se negocia con otras
# fuentes (cabecera Accept-Language, idioma de respaldo). # fuentes (cabecera Accept-Language, idioma de respaldo).
lang_negotiation = "Full" # Estrategia para resolver el idioma de cada petición: lang_negotiation = "Full" # Estrategia para resolver el idioma de cada petición:
# "Full" -> ?lang de la URL, idioma del usuario, # "Full" -> ?lang de la URL, idioma del usuario,
# 'language', Accept-Language y respaldo. # 'language', Accept-Language y respaldo.
# "NoQuery" -> igual que "Full" pero sin ?lang. # "NoQuery" -> igual que "Full" pero sin ?lang.
# "ConfigOnly" -> sólo 'language' o el idioma de respaldo # "ConfigOnly" -> sólo 'language' o el idioma de respaldo
# (no se ofrece elegir idioma al usuario). # (no se ofrece elegir idioma al usuario).
timezone = "UTC" # Zona horaria del sitio (IANA: "UTC", "Europe/Madrid"...); timezone = "UTC" # Zona horaria del sitio (IANA: "UTC", "Europe/Madrid"...);
# 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
# "Alphabetical" -> por el nombre de la región traducido al # desfase horario.
# idioma de la página. # "Alphabetical" -> por el nombre de la región traducido al
# "Listed" -> en el orden de 'timezone_regions' (sin # idioma de la página.
# regiones, como "Alphabetical"). # "Listed" -> en el orden de 'timezone_regions' (sin
# Es el valor por defecto del selector de zona horaria; la # regiones, como "Alphabetical").
# aplicación puede cambiarlo en un formulario concreto. # Es el valor por defecto del selector de zona horaria; la
timezone_per_user = true # Si cada usuario puede tener su propia zona horaria (true) o # aplicación puede cambiarlo en un formulario concreto.
# se usa siempre 'timezone' (false). Con false no se ofrece timezone_per_user = true # Si cada usuario puede tener su propia zona horaria (true) o
# elegirla y la guardada se conserva por si se reactiva. # se usa siempre 'timezone' (false). Con false no se ofrece
startup_banner = "Slant" # Banner ASCII al arrancar: "Off", "Slant", "Small", "Speed" # elegirla y la guardada se conserva por si se reactiva.
# o "Starwars". startup_banner = "Slant" # Banner ASCII al arrancar: "Off", "Slant", "Small", "Speed"
# o "Starwars".
[dev] [dev]
pagetop_static_dir = "" # Directorio static/ de PageTop para servir sus archivos pagetop_static_dir = "" # Directorio static/ de PageTop para servir sus archivos
# estáticos desde disco (editables sin recompilar). Ruta # estáticos desde disco (editables sin recompilar). Ruta
# absoluta o relativa al proyecto (o, al ejecutar el binario, # absoluta o relativa al proyecto (o, al ejecutar el binario,
# al directorio de trabajo). Vacío -> se sirven los incluidos # al directorio de trabajo). Vacío -> se sirven los incluidos
# en el binario. # en el binario.
[log] [log]
enabled = true # Activa (true) o desactiva (false) las trazas. enabled = true # Activa (true) o desactiva (false) las trazas.
tracing = "Info" # Filtro de trazas: "Error", "Warn", "Info", "Debug" o tracing = "Info" # Filtro de trazas: "Error", "Warn", "Info", "Debug" o
# "Trace", o combinaciones separadas por comas por módulo, # "Trace", o combinaciones separadas por comas por módulo,
# p. ej. "Info,pagetop=Debug,sqlx=Warn". Si no es válido se # p. ej. "Info,pagetop=Debug,sqlx=Warn". Si no es válido se
# usa "Info", con un aviso al arrancar. # usa "Info", con un aviso al arrancar.
rolling = "Stdout" # Salida de las trazas: rolling = "Stdout" # Salida de las trazas:
# "Stdout" -> terminal, sin archivos. # "Stdout" -> terminal, sin archivos.
# "Daily", "Hourly", "Minutely" -> archivos con rotación. # "Daily", "Hourly", "Minutely" -> archivos con rotación.
# "Endless" -> un único archivo, sin rotación. # "Endless" -> un único archivo, sin rotación.
path = "log" # Directorio de los archivos de traza (si rolling != Stdout). path = "log" # Directorio de los archivos de traza (si rolling != Stdout).
prefix = "tracing.log" # Prefijo de los archivos de traza (si rolling != Stdout). prefix = "tracing.log" # Prefijo de los archivos de traza (si rolling != Stdout).
format = "Full" # Formato: "Full", "Compact", "Pretty" o "Json". format = "Full" # Formato: "Full", "Compact", "Pretty" o "Json".
[server] [server]
bind_address = "localhost" # Dirección de enlace del servidor web. bind_address = "localhost" # Dirección de enlace del servidor web.
bind_port = 8080 # Puerto de escucha del servidor web. bind_port = 8080 # Puerto de escucha del servidor web.
# **< pagetop-seaorm >****************************************************************************** # **< pagetop-seaorm >******************************************************************************
[database] [database]
db_type = "" # Motor: "mysql" (o "mariadb"), "postgres" (o "postgresql") db_type = "" # Motor: "mysql" (o "mariadb"), "postgres" (o "postgresql")
# o "sqlite". Obligatorio: sin él la aplicación no arranca. # o "sqlite". Obligatorio: sin él la aplicación no arranca.
db_name = "" # Nombre (mysql/postgres) o referencia (sqlite) de la BD. db_name = "" # Nombre (mysql/postgres) o referencia (sqlite) de la BD.
db_user = "" # Usuario de conexión (mysql/postgres). db_user = "" # Usuario de conexión (mysql/postgres).
db_pass = "" # Contraseña de conexión (mysql/postgres). db_pass = "" # Contraseña de conexión (mysql/postgres).
db_host = "localhost" # Servidor de la base de datos (mysql/postgres). db_host = "localhost" # Servidor de la base de datos (mysql/postgres).
#db_port = 5432 # Puerto (mysql/postgres). Sin valor -> 3306 para MySQL y #db_port = 5432 # Puerto (mysql/postgres). Sin valor -> 3306 para MySQL y
# 5432 para PostgreSQL. # 5432 para PostgreSQL.
max_pool_size = 5 # Número máximo de conexiones simultáneas. max_pool_size = 5 # Número máximo de conexiones simultáneas.
# **< pagetop-mail >******************************************************************************** # **< pagetop-mail >********************************************************************************
[mail] [mail]
transport = "log" # Entrega de los correos: transport = "log" # Entrega de los correos:
# "smtp" -> servidor SMTP ([mail.smtp]). # "smtp" -> servidor SMTP ([mail.smtp]).
# "sendmail" -> programa sendmail local ([mail.sendmail]). # "sendmail" -> programa sendmail local ([mail.sendmail]).
# "file" -> un archivo .eml por correo ([mail.file]). # "file" -> un archivo .eml por correo ([mail.file]).
# "log" -> se escriben en las trazas, sin enviarlos. # "log" -> se escriben en las trazas, sin enviarlos.
# "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
# la cola). 0 -> ninguno espera. No se recomiendan valores # la cola). 0 -> ninguno espera. No se recomiendan valores
# mayores: cada correo en espera ocupa memoria con sus # mayores: cada correo en espera ocupa memoria con sus
# adjuntos, y la espera cuenta en delivery_timeout_secs, así # adjuntos, y la espera cuenta en delivery_timeout_secs, así
# que los últimos fallarían igualmente. Con poca memoria o # que los últimos fallarían igualmente. Con poca memoria o
# adjuntos grandes, conviene reducirlo. # adjuntos grandes, conviene reducirlo.
[mail.smtp] # Servidor SMTP (transport = "smtp"). [mail.smtp] # Servidor SMTP (transport = "smtp").
host = "localhost" # Servidor. host = "localhost" # Servidor.
#port = 587 # Puerto. Sin valor -> 465 con "tls", 587 con "starttls" y 25 #port = 587 # Puerto. Sin valor -> 465 con "tls", 587 con "starttls" y 25
# en otro caso. # en otro caso.
security = "starttls" # Cifrado de la conexión: security = "starttls" # Cifrado de la conexión:
# "none" -> sin cifrar (servidores de pruebas). # "none" -> sin cifrar (servidores de pruebas).
# "opportunistic" -> STARTTLS si el servidor lo ofrece. # "opportunistic" -> STARTTLS si el servidor lo ofrece.
# "starttls" -> STARTTLS obligatorio (puerto 587). # "starttls" -> STARTTLS obligatorio (puerto 587).
# "tls" -> cifrada desde el inicio (puerto 465). # "tls" -> cifrada desde el inicio (puerto 465).
#username = "no-reply@example.com" # Usuario. Sin valor, no se autentica. #username = "no-reply@example.com" # Usuario. Sin valor, no se autentica.
#password = "secreto" # Contraseña. Mejor en config/local.toml (no se versiona). #password = "secreto" # Contraseña. Mejor en config/local.toml (no se versiona).
#hello_name = "example.com" # Nombre para EHLO. Sin valor, el nombre del equipo. #hello_name = "example.com" # Nombre para EHLO. Sin valor, el nombre del equipo.
timeout_secs = 60 # Espera máxima de cada orden al servidor, en segundos. Cada timeout_secs = 60 # Espera máxima de cada orden al servidor, en segundos. Cada
# entrega tiene además delivery_timeout_secs de [mail]. Con # entrega tiene además delivery_timeout_secs de [mail]. Con
# security = "tls" no cubre el saludo TLS: un servidor que no # security = "tls" no cubre el saludo TLS: un servidor que no
# 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").
#command = "/usr/sbin/sendmail" # Programa. Sin valor, "sendmail" del PATH. #command = "/usr/sbin/sendmail" # Programa. Sin valor, "sendmail" del PATH.
max_concurrent = 10 # Correos que se entregan a la vez, cada uno con su proceso max_concurrent = 10 # Correos que se entregan a la vez, cada uno con su proceso
# sendmail; los demás esperan turno (max_waiting por entrega # sendmail; los demás esperan turno (max_waiting por entrega
# como mucho; con más, la entrega falla enseguida). Con un # como mucho; con más, la entrega falla enseguida). Con un
# servidor de correo local no se recomiendan valores mayores: # servidor de correo local no se recomiendan valores mayores:
# apenas aceleran el envío, porque acepta cada correo al # apenas aceleran el envío, porque acepta cada correo al
# momento, y en una avalancha multiplican los procesos que # momento, y en una avalancha multiplican los procesos que
# compiten con la aplicación por memoria y CPU, y los correos # compiten con la aplicación por memoria y CPU, y los correos
# en espera. Si el programa envía cada correo a un servidor # en espera. Si el programa envía cada correo a un servidor
# remoto (msmtp, ssmtp), no superar el límite de conexiones # remoto (msmtp, ssmtp), no superar el límite de conexiones
# simultáneas de ese servidor. # simultáneas de ese servidor.
[mail.file] # Archivos de correo (transport = "file"). [mail.file] # Archivos de correo (transport = "file").
dir = "mail" # Directorio de los archivos .eml. Se crea si no existe. dir = "mail" # Directorio de los archivos .eml. Se crea si no existe.
max_concurrent = 10 # Correos que se guardan a la vez; los demás esperan turno max_concurrent = 10 # Correos que se guardan a la vez; los demás esperan turno
# (max_waiting por cada uno como mucho; con más, la entrega # (max_waiting por cada uno como mucho; con más, la entrega
# falla enseguida). No se recomiendan valores mayores: apenas # falla enseguida). No se recomiendan valores mayores: apenas
# aceleran el guardado en el mismo disco, y en una avalancha # aceleran el guardado en el mismo disco, y en una avalancha
# ocupan más hilos de la aplicación, compartidos con otras # ocupan más hilos de la aplicación, compartidos con otras
# tareas (p. ej. el cálculo de contraseñas), y más correos en # tareas (p. ej. el cálculo de contraseñas), y más correos en
# espera. # espera.
[mail.queue] # Cola de envío (sólo con la feature "queue"). El ritmo es el [mail.queue] # Cola de envío (sólo con la feature "queue"). El ritmo es el
# del trabajo "mail.queue" en [cron.jobs."mail.queue"]. # del trabajo "mail.queue" en [cron.jobs."mail.queue"].
batch_size = 50 # Correos como máximo en cada ejecución, uno tras otro. batch_size = 50 # Correos como máximo en cada ejecución, uno tras otro.
max_attempts = 5 # Intentos de cada correo, contando el primero. max_attempts = 5 # Intentos de cada correo, contando el primero.
retry_base_secs = 60 # Espera tras el primer fallo; se duplica en cada intento, retry_base_secs = 60 # Espera tras el primer fallo; se duplica en cada intento,
# hasta max_retry_secs. # hasta max_retry_secs.
max_retry_secs = 86400 # Espera máxima entre dos intentos (1 a 31536000, un año). max_retry_secs = 86400 # Espera máxima entre dos intentos (1 a 31536000, un año).
# Recomendado: 86400 (un día); con los demás valores por # Recomendado: 86400 (un día); con los demás valores por
# defecto no se alcanza. Reducirlo reintenta antes tras una # defecto no se alcanza. Reducirlo reintenta antes tras una
# caída larga, con más intentos mientras dura; aumentarlo # caída larga, con más intentos mientras dura; aumentarlo
# puede entregar correos con días de retraso, cuando quizá ya # puede entregar correos con días de retraso, cuando quizá ya
# no sirven (enlaces caducados). # no sirven (enlaces caducados).
keep_failed_days = 30 # Días que se conservan los fallidos (0 = siempre). keep_failed_days = 30 # Días que se conservan los fallidos (0 = siempre).
# **< pagetop-cron >******************************************************************************** # **< pagetop-cron >********************************************************************************
[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,
# "Authorization: Bearer {trigger_token}". # systemd) llama a POST /cron con la cabecera
# "off" -> nunca de forma automática, sólo bajo demanda. # "Authorization: Bearer {trigger_token}".
# Con varias instancias, "internal" sólo en una ("off" en las # "off" -> nunca de forma automática,
# demás), o "external" en todas. # sólo bajo demanda.
#trigger_token = "..." # Clave secreta del modo "external": 16 o más letras, # Con varias instancias, "internal" sólo en una ("off" en las
# dígitos, "-" o "_" (p. ej. de "openssl rand -hex 32"). # demás), o "external" en todas.
# Mejor en config/local.toml. #trigger_token = "..." # Clave secreta del modo "external": 16 o más letras,
trigger_interval_secs = 60 # Segundos entre dos llamadas del modo "external": cada una # dígitos, "-" o "_" (p. ej. de "openssl rand -hex 32").
# ejecuta lo programado en el último intervalo, así que debe # Mejor en config/local.toml.
# llegar una, y sólo una, por intervalo. trigger_interval_secs = 60 # Segundos entre dos llamadas del modo "external": cada una
shutdown_timeout_secs = 30 # Espera máxima, al detener la aplicación, a que terminen los # ejecuta lo programado en el último intervalo, así que debe
# trabajos en curso. # llegar una, y sólo una, por intervalo.
shutdown_timeout_secs = 30 # Espera máxima, al detener la aplicación, a que terminen los
# trabajos en curso.
[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"
#timeout_secs = 600 # Sustituye su tiempo máximo por ejecución. 0 -> sin límite. # (30 s tras terminar).
#timeout_secs = 600 # Sustituye su tiempo máximo por ejecución. 0 -> sin límite.
# **< pagetop-user >******************************************************************************** # **< pagetop-user >********************************************************************************
[user] [user]
allow_registration = true # Permite que los visitantes creen su propia cuenta. allow_registration = true # Permite que los visitantes creen su propia cuenta.
require_email_verification = false # Las cuentas nuevas quedan pendientes ("Pending") en lugar require_email_verification = false # Las cuentas nuevas quedan pendientes ("Pending") en lugar
# 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 "-",
# "permissive" -> como "unicode", más espacios simples, "'" # de 3 a 32.
# y "+", de 3 a 60. # "permissive" -> como "unicode", más espacios simples, "'"
# Con cualquiera: nunca "@", sin distinguir mayúsculas y sin # y "+", de 3 a 60.
# nombres que se confundan con otro existente. # 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
failed_login_window_secs = 900 # Segundos desde el último fallo en los que el siguiente se # cuenta. 0 -> nunca.
# suma al recuento (15 minutos); si no, empieza de nuevo. failed_login_window_secs = 900 # Segundos desde el último fallo en los que el siguiente se
locked_for_secs = 600 # Duración del bloqueo de la cuenta en segundos (10 minutos). # suma al recuento (15 minutos); si no, empieza de nuevo.
# Después se dispone otra vez de todos los intentos. locked_for_secs = 600 # Duración del bloqueo de la cuenta en segundos (10 minutos).
# Después se dispone otra vez de todos los intentos.
login_strict = false # Dificulta que el navegador recuerde o autorrellene las login_strict = false # Dificulta que el navegador recuerde o autorrellene las
# credenciales en el formulario de acceso. # credenciales en el formulario de acceso.
[user.session] # Sesiones de usuario. [user.session] # Sesiones de usuario.
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
# siguiente acceso de su usuario. # siguiente acceso de su usuario.
argon2_m_cost = 19456 # Coste de memoria en KiB. argon2_m_cost = 19456 # Coste de memoria en KiB.
argon2_t_cost = 2 # Coste de tiempo (número de iteraciones). argon2_t_cost = 2 # Coste de tiempo (número de iteraciones).
argon2_p_cost = 1 # Grado de paralelismo (número de hilos). argon2_p_cost = 1 # Grado de paralelismo (número de hilos).
min_length = 8 # Longitud mínima de las contraseñas, en caracteres. min_length = 8 # Longitud mínima de las contraseñas, en caracteres.
[user.seed] # Primer administrador, creado si no existe ningún usuario. [user.seed] # Primer administrador, creado si no existe ningún usuario.
admin_username = "admin" # Nombre de usuario, válido según "identity_policy". admin_username = "admin" # Nombre de usuario, válido según "identity_policy".
admin_email = "admin@example.com" # Correo electrónico. admin_email = "admin@example.com" # Correo electrónico.
#admin_password = "cambiar" # Contraseña. Sin valor -> se genera una aleatoria y se #admin_password = "cambiar" # Contraseña. Sin valor -> se genera una aleatoria y se
# muestra una sola vez por la salida estándar al crearlo. # muestra una sola vez por la salida estándar al crearlo.
[user.admin] [user.admin]
list_page_size = 20 # Filas por página en los listados de administración list_page_size = 20 # Filas por página en los listados de administración
# (usuarios, roles...). # (usuarios, roles...).
# **< pagetop-bootsier >**************************************************************************** # **< pagetop-bootsier >****************************************************************************
[bootsier] [bootsier]
max_width = "1440px" # Ancho máximo de la página ("100%", "90rem", "1440px"...). max_width = "1440px" # Ancho máximo de la página ("100%", "90rem", "1440px"...).
static_dir = "" # Directorio static/ de pagetop-bootsier para servir sus static_dir = "" # Directorio static/ de pagetop-bootsier para servir sus
# archivos estáticos desde disco, como pagetop_static_dir. # archivos estáticos desde disco, como pagetop_static_dir.