Metadata-Version: 2.4
Name: htmlpress
Version: 0.12.3
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: HTML-first static site generator: HTML pages, or Markdown, from anywhere in a project become one site with one layout, one theme and live reload, for humans and 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

The HTML-first static site generator for humans and agents. Write HTML pages, or
Markdown, wherever they live in your project, and htmlpress turns them into one site. Each
page keeps its own markup, and htmlpress adds one layout, one theme, a navigation and a
live-reloading dev server. You or your agent write semantic HTML or plain Markdown, 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 `.md` or `.html` file in the folder: Markdown with frontmatter, or HTML from a
fragment to a full document. 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.

