webpage/README.md

Mark's webpage

This is the source code behind betalupi.com, featuring a very efficient mini web framework written from scratch in Rust. It uses...

• Axum as an http server
• Maud for html templates
• Grass to parse and compile sass
• markdown-it to convert md to html

Overview & Arch:

• bin/webpage: Simple cli that starts service-webpage

• lib/libservice: Provides the Service trait. A service is a group of http routes with an optional utoipa schema.
  This library decouples compiled binaries from the services they provide, and makes sure all services are self-contained.

• lib/page: Provides PageServer, which builds an axum router that provides a caching and headers for resources served through http.

  • Also provides Servable, which is a trait for any resource that may be served.
  • the Page servable serves html generated by a closure.
  • the StaticAsset servable serves static assets (css, images, misc files), and provides transformation parameters for image assets (via pixel-transform).

• service/service-webpage: A Service that runs a PageServer that provides the content on betalupi.com