📝 Add mail and file upload guides

Document pagetop-mail (configuration, templates, layout, previews,
queue and tests with the outbox) and file uploads (`web::Upload`,
`form::File`, `web::Download` and the [upload] settings). doccheck
enables the mail queue, keeps mail in memory and saves uploads under
`target/`.
This commit is contained in:
Manuel Cillero 2026-11-02 17:29:37 +01:00
parent 4e007feec8
commit f42f5e9b89
13 changed files with 1118 additions and 8 deletions

View file

@ -14,7 +14,7 @@ pagetop-bootsier = { path = "../../../pagetop/extensions/pagetop-bootsier" }
pagetop-build = { path = "../../../pagetop/helpers/pagetop-build" }
pagetop-cron = { path = "../../../pagetop/extensions/pagetop-cron" }
pagetop-htmx = { path = "../../../pagetop/extensions/pagetop-htmx" }
pagetop-mail = { path = "../../../pagetop/extensions/pagetop-mail" }
pagetop-mail = { path = "../../../pagetop/extensions/pagetop-mail", features = ["queue"] }
pagetop-seaorm = { path = "../../../pagetop/extensions/pagetop-seaorm", features = ["sqlite"] }
pagetop-admin = { path = "../../../pagetop/extensions/pagetop-admin" }
pagetop-user = { path = "../../../pagetop/extensions/pagetop-user" }

View file

@ -9,3 +9,13 @@ max_pool_size = 1
# would hide the result of the checks.
[log]
tracing = "Error"
# Mail is kept in memory (see how-to/mail.md), and its links point to a fixed public URL.
[mail]
transport = "memory"
from = "Community garden <garden@example.com>"
base_url = "https://garden.example.com"
# Uploaded files go to the build directory, which git ignores (see how-to/uploads.md).
[upload]
dir = "target/doccheck-uploads"

View file

@ -12,3 +12,9 @@ free-plots = { $count ->
[one] One free plot
*[other] { $count } free plots
}
# Used by the mail guide (how-to/mail.md).
harvest-subject = The tomatoes are ready to pick
harvest-greeting = Hello, { $name }:
harvest-ready = The tomatoes in the community garden are ripe. Come and pick your share this week.
harvest-link = See the harvest calendar

View file

@ -12,3 +12,9 @@ free-plots = { $count ->
[one] Una parcela libre
*[other] { $count } parcelas libres
}
# Used by the mail guide (how-to/mail.md).
harvest-subject = Ya se pueden recoger los tomates
harvest-greeting = Hola, { $name }:
harvest-ready = Los tomates del huerto vecinal ya están maduros. Ven a recoger tu parte esta semana.
harvest-link = Ver el calendario de cosecha