soupault

souviant

Soupault est un outil de manipulation HTML. Cela peut être n'importe lequel de:

• Générateur de sites statique,
• Processeur HTML,
• Extracteur de métadonnées,

ou tous en même temps.

Soupault fonctionne avec l'arbre d'éléments HTML de la page, afin qu'il puisse faire beaucoup de choses qui pourraient traditionnellement faire avec JS côté client: injecter le nouveau HTML dans les pages complètes existantes, créer une table de contenu qui préserve les éléments id des titres HTML et plus encore.

Il n'utilise pas non plus la matière frontale et extrait les métadonnées de HTML à la place, en utilisant un sélecteur CSS3 à la cartographie du champ de métadonnées, de sorte que même les pages statiques écrites à la main peuvent être indexées plutôt que traitées comme des actifs. Par exemple:

[ index . fields . title ]
  # Try to find <h1 id="post-title"> if it exists,
  # else use the first <h1> 
  selector = [ " h1#post-title " , " h1 " ]

[ index . fields . excerpt ]
  selector = [ " p#post-excerpt " , " p " ]

[ index . fields . date ]
  selector = [ " time#post-date " , " time " ]
  extract_attribute = " datetime "
  fallback_to_content = true

Les métadonnées extraites peuvent ensuite être rendues et injectées en pages:

[ index . views . blog ]
  # Insert rendered data into the element that matches "#blog-index" CSS selector.
  index_selector = " #blog-index "
  index_item_template = """
    <h2><a href="{{url}}">{{title}}</a></h2>
    <p><strong>Last update:</strong> {{date}}.</p>
    <p>{{excerpt}}</p>
    <a href="{{url}}">Read more</a>
  """

Soupault est ...

• Durable et facile à moderniser ou à faire reculer: il est disponible en tant que binaire lié à la statique sans dépendances.
• Extensible: vous pouvez apporter vos propres préprocesseurs de page (par exemple, Markdown aux convertisseurs HTML), des éléments HTML de tuyaux via des programmes externes et charger les plugins LUA.
• Flexible: la plupart des options sont configurables, la plupart des fonctionnalités intégrées peuvent être réimplémentées sous forme de plugins LUA, et il existe des crochets de traitement de page.

Soupault porte le nom du dadaïste français et écrivain surréaliste Philippe Soupault car il est basé sur la bibliothèque de lambdasoup.

Visitez Soupault.app pour plus de détails.

Pour le soutien et la discussion, rédigez un message sur la liste de diffusion.

Installation

Des binaires prédéfinis sont disponibles pour Linux, Windows et MacOS. Vous pouvez les télécharger à partir de https://files.baturin.org/software/soupault et des sorties github (https://github.com/pataphysicalsociety/soupault/releases).

Vous pouvez vérifier l'intégrité des archives de version à l'aide de cette clé Signify / MinIsign: RWRfW+gkhk/+iA7dOUtTio6G6KeJCiAEp4Zfozw7eqv2shN90+5z20Cy .

Vous pouvez également installer des versions de version stable à partir d'Opam:

opam install soupault

Enfin, vous pouvez créer la dernière version de développement avec:

opam pin add git+https://github.com/PataphysicalSociety/soupault

Pour construire des binaires statiques, vous devez installer OCAML avec MUSL Runtime, puis utiliser le profil de dunes static :

 # For OCaml 4.12.2, adjust for your desired version
opam switch create 4.14.2-musl ocaml-variants.4.14.2+options ocaml-option-musl ocaml-option-static
opam switch 4.14.2-musl

# Build static binaries
dune build --profile=static

Contributif

Les rapports de bogues et les correctifs sont toujours les bienvenus. Les demandes de fonctionnalités et les nouvelles fonctionnalités sont également les bienvenues, mais envisagez d'abord de discuter d'eux avec le mainteneur.

Vous pouvez contribuer via GitHub ou via Codeberg.