✨ Serve the PageTop guides with pagetop-mdbook

Rebuild the website on the current PageTop API, with Bootsier as its
theme and edition 2024. Add the first Spanish guide (doc/v0.6/es) as an
mdBook book, built in build.rs and served with pagetop-mdbook, and the
/doc/latest/{lang} redirect.

Add `tools/doccheck.sh` to check the links of the guides and to compile,
run and test their examples against PageTop.

Move the configuration to config/common.toml and translate the README
to English.
This commit is contained in:
Manuel Cillero 2026-10-17 08:06:02 +02:00
parent e41e71cc78
commit 1a41a456d4
80 changed files with 14112 additions and 1218 deletions

30
tools/doccheck/Cargo.toml Normal file
View file

@ -0,0 +1,30 @@
[package]
name = "doccheck"
version = "0.0.0"
edition = "2024"
description = "Compiles and runs the Rust examples of the PageTop guides (see tools/doccheck.sh)."
publish = false
# Independent of the website package: it only exists to check the guides.
[workspace]
[dependencies]
pagetop = { path = "../../../pagetop" }
pagetop-bootsier = { path = "../../../pagetop/extensions/pagetop-bootsier" }
pagetop-build = { path = "../../../pagetop/helpers/pagetop-build" }
pagetop-htmx = { path = "../../../pagetop/extensions/pagetop-htmx" }
pagetop-seaorm = { path = "../../../pagetop/extensions/pagetop-seaorm", features = ["sqlite"] }
pagetop-admin = { path = "../../../pagetop/extensions/pagetop-admin" }
pagetop-user = { path = "../../../pagetop/extensions/pagetop-user" }
serde = { version = "1", features = ["derive"] }
thiserror = "2"
tower-http = { version = "0.7", features = ["compression-gzip", "cors", "limit", "timeout"] }
[build-dependencies]
pagetop-build = { path = "../../../pagetop/helpers/pagetop-build" }
# The examples are only compiled and run to check them: without debug info or incremental caches
# they take far less disk.
[profile.dev]
debug = 0
incremental = false