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 utilties for image assets (via pixel-transform).

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