Metadata-Version: 2.4
Name: htmlpress
Version: 0.1.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Rust
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
License-File: LICENSE.md
Summary: Turn a folder of HTML pages into a site: one layout, one theme, live reload, made for agents
Keywords: agents,html,htmlpress,llm,static-site
Home-Page: https://htmlpress.dev
Author: Evgeny Karev
License-Expression: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: homepage, https://htmlpress.dev
Project-URL: repository, https://github.com/datisthq/htmlpress

# Htmlpress

Htmlpress turns a folder of HTML pages into a site. Each page keeps its own markup, and
htmlpress adds one layout, one theme, a navigation and a live-reloading dev server. It is
made for coding agents: they write plain semantic HTML, and the result looks consistent
without a framework, a build config or Tailwind.

## Installation

```bash
pip install htmlpress
# or run it without installing
uvx htmlpress build docs
```

The wheel carries a prebuilt binary for your platform; no Rust toolchain is needed.

## Usage

```bash
htmlpress build docs        # render docs/ into docs/.htmlpress/build
htmlpress start docs        # serve it on http://localhost:8000, rebuilding on save
htmlpress build docs --json # the result as JSON, for scripts and agents
htmlpress --llms            # every command's input and output schema, for agents
```

A page is any `.html` file in the folder: a full document or just a fragment. Its `<title>`
(else its first `<h1>`) names it in the navigation, `<meta name="order" content="1">` sorts it,
and `index.html` comes first. Every other file is copied as-is.

```html
<title>Getting started</title>
<meta name="order" content="1" />

<h1>Getting started</h1>
<p>Plain HTML, styled by the built-in theme.</p>
<htmlpress-callout type="warning"
  ><p>Light-DOM components cover what HTML lacks.</p></htmlpress-callout
>
```

## Documentation

Read the docs at [htmlpress.dev](https://htmlpress.dev), themselves built with htmlpress.

## License

MIT.

