bserver Documentation

bserver is a YAML-driven web server that generates HTML pages from structured definitions. Write YAML, get HTML.

Key Features

• YAML-driven page generation with automatic HTML rendering
• Reusable format definitions with the ^ prefix
• Bootstrap 5 integration out of the box
• Markdown page support with full site chrome
• Server-side scripting in Python, JavaScript, and PHP
• Virtual hosting with automatic Let's Encrypt
• Cascading name resolution across directories

How It Works

Every page starts from html.yaml, which references head and body. The body references header, main, and footer. Your page defines main to set its content. Names are resolved by searching for matching YAML files, starting in the current directory and walking upward.

Quick Example

A minimal page needs just an index.yaml file:

main:
  - h1: "Hello World"
  - p: "Welcome to my site."
                  

This produces a complete HTML page with doctype, head, body, navbar, and footer - all from a few lines of YAML.

Documentation

Use the navigation above to explore, or choose a topic: