soupault

Suppeault

Soupault ist ein HTML -Manipulationstool. Es kann eines von:

• statischer Stättengenerator,
• HTML -Prozessor,
• Metadatenextraktor,

oder alle gleichzeitig.

Soupault arbeitet mit dem HTML-Element-Baum der Seite zusammen, sodass es viele Dinge tun kann, die traditionell mit client-sieiten JS: Neue HTML in vorhandene komplette Seiten einbringen, ein Inhaltsverzeichnis erstellen, das die id Elemente von HTML-Überschriften und mehr bewahrt.

Es verwendet auch keine Frontmaterialien und extrahiert stattdessen Metadaten aus HTML, wobei ein CSS3-Selektor zu Metadaten-Feldzuordnung verwendet wird, sodass selbst handgeschriebene statische Seiten eher indiziert als als Assets behandelt werden können. Zum Beispiel:

[ 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

Extrahierte Metadaten können dann umgezogen und in Seiten injiziert werden:

[ 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 ist ...

• Langlebig und einfach zu aktualisieren oder zurückzurollen: Es ist als statisch gebundenes binär ohne Abhängigkeiten erhältlich.
• Extensible: Sie können Ihre eigenen Seitenvorprozessoren (z. B. Markdown zu HTML Convertors), HTML -Elemente durch externe Programme und laden LuA -Plugins mit.
• Flexibel: Die meisten Optionen sind konfigurierbar, die meisten integrierten Funktionen können als LuA-Plugins neu implementiert werden, und es gibt Seitenverarbeitungshaken.

Soupault ist nach dem französischen dadaistischen und surrealistischen Schriftsteller Philippe Soupault benannt, weil es auf der Lambdasoup -Bibliothek basiert.

Besuchen Sie Suppault.app für Details.

Für Unterstützung und Diskussion schreiben Sie eine Nachricht in die Mailingliste.

Installation

Vorgefertigte Binärdateien sind für Linux, Windows und MacOS verfügbar. Sie können sie von https://files.baturin.org/software/Soupault und von Github Releases (https://github.com/pataphysicSociety/Soupault/Releases) herunterladen.

Sie können die Integrität der Release -Archiv mithilfe dieser Signify/Minisign -Taste überprüfen: RWRfW+gkhk/+iA7dOUtTio6G6KeJCiAEp4Zfozw7eqv2shN90+5z20Cy .

Sie können auch stabile Versionsversionen von OPAM installieren:

opam install soupault

Schließlich können Sie die neueste Entwicklungsversion mit:

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

Um statische Binärdateien zu erstellen, müssen Sie OCAML mit musl -Laufzeit installieren und dann das static Dünenprofil verwenden:

 # 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

Beitragen

Fehlerberichte und Patches sind immer willkommen. Feature -Anfragen und neue Funktionen sind ebenfalls willkommen. Bitte besprechen Sie sie zuerst mit dem Betreuer.

Sie können entweder über GitHub oder über Codeberg beitragen.