Htmlpress, generatore di siti statici HTML-first

Introduzione

Htmlpress è un generatore di siti statici HTML-first. Scrivi pagine HTML, o Markdown, ovunque si trovino nel tuo progetto, e htmlpress le trasforma in un unico sito. Ogni pagina mantiene il proprio markup, e htmlpress aggiunge un layout, un tema, una navigazione e un server di sviluppo con ricaricamento automatico. Niente framework e niente linguaggio di template: basta scrivere le pagine, tu o il tuo agente di programmazione. Ed è disponibile allo stesso modo per gli sviluppatori Python, TypeScript e Rust: un unico binario Rust, installato con pip, npm o cargo.

Perché un altro generatore di siti

La maggior parte degli strumenti di documentazione chiede prima di imparare uno stack: un framework JavaScript, un dialetto di componenti come MDX, un linguaggio di template, una configurazione di build. È molta superficie da imparare per una persona, e ancora di più da sbagliare per un agente.

Htmlpress va nella direzione opposta. Una pagina è HTML semantico o Markdown semplice — i formati che gli agenti conoscono meglio di qualsiasi linguaggio di template — e il tema dà stile agli elementi stessi: titoli, tabelle, blocchi di codice, <details> e <figure> appaiono corretti senza classi, sia in modalità chiara sia scura. Meno scelte offre una pagina, più tutte le pagine sembrano un unico sito.

Cosa ottieni

• Scrivi solo HTML — una pagina è qualsiasi file .html, documento completo o semplice frammento, i cui tag <title> e <meta> sono i suoi metadati; funziona anche un file .md con frontmatter
• Pagine da ovunque — per impostazione predefinita, tutte le pagine della cartella; i glob include ed exclude le prendono invece da qualsiasi punto di un repository, così la documentazione sta accanto al codice e un CHANGELOG.md o i file SKILL.md che già mantieni entrano nel sito
• Elementi ricchi — riquadri, schede, passaggi, card, badge, alberi di file, tabelle ordinabili, terminali, schede dei gestori di pacchetti, diagrammi Mermaid e contenuti incorporati, tutti come elementi personalizzati htmlpress-*
• Navigazione inclusa — una barra laterale annidata per cartelle, breadcrumb, un indice, link precedente/successivo e un link «Modifica su GitHub»
• Documentazione, blog e changelog — dividi un sito in sezioni, ognuna con la sua scheda e la sua navigazione: documentazione raggruppata per cartella nella barra laterale, un blog di articoli datati, dal più recente, con pagine dei tag e un feed RSS, e un changelog con una pagina per versione da un changelog Markdown
• Multilingue — traduzioni accanto agli originali, un selettore di lingua e l'interfaccia in sette lingue incluse
• Personalizzabile — token --htmlpress-* per il tema, e layout, stili e componenti si possono estrarre in una cartella .htmlpress/ e sostituire file per file
• Fatto per gli agenti — ogni build pubblica una copia Markdown di ogni pagina, llms.txt e le tue agent skills, e ogni comando parla JSON
• Web component e CSS — ogni elemento ricco è un web component nativo e ogni stile CSS puro, isolato con @scope, senza runtime di framework nel browser
• Python, TypeScript e Rust — disponibile allo stesso modo per gli sviluppatori Python, TypeScript e Rust, da PyPI, npm e crates.io, come un unico binario Rust; nessun runtime e nessuna dipendenza, e il risultato è un sito statico con sitemap.xml, robots.txt e una pagina 404, pronto per qualsiasi hosting

Una pagina

Una pagina imposta titolo, descrizione e ordine in pochi tag, poi passa al contenuto:

<title>Getting Started</title>
<meta name="description" content="Set up the project in five minutes." />
<meta name="order" content="1" />

<h1>Getting Started</h1>
<p>Welcome!</p>

La stessa pagina in Markdown porta questi valori nel frontmatter. La configurazione è facoltativa. Un htmlpress.yaml nella radice del progetto imposta titolo e descrizione del sito, e i suoi glob include dicono dove si trovano le pagine:

title: My docs
description: Documentation for my project
include: [docs/**/*.html, docs/**/*.md]

Provarlo

Ogni canale distribuisce lo stesso binario Rust alla stessa versione, quindi scegli il gestore di pacchetti che il tuo progetto usa già:

curl -fsSL https://htmlpress.dev/install.sh | sh
npm install --global gethtmlpress
pip install htmlpress
cargo install htmlpress

Poi l'intero ciclo sta in quattro comandi:

htmlpress start    # dev server with live reload at http://localhost:8000
htmlpress build    # production build to .htmlpress/build/
htmlpress preview  # serve the production build locally
htmlpress clear    # remove .htmlpress/build/

Agent skills

Htmlpress include sei Agent Skills che insegnano ad agenti di programmazione come Claude Code, Cursor e Codex come funziona un progetto: il contratto delle pagine, i componenti, le chiavi di configurazione, come personalizzare il tema, come fare il deploy e come verificare il proprio lavoro. Una volta installate, non devi spiegare nulla di tutto questo nel prompt.

Prossimi passi

Htmlpress è open source con licenza MIT, e la sua stessa documentazione su htmlpress.dev è costruita con esso. Provalo, apri una issue con il tuo feedback e lascia una stella su GitHub per aiutare il progetto a crescere — https://github.com/datisthq/htmlpress