soupault

sopa

Sopault es una herramienta de manipulación HTML. Puede ser cualquiera de:

• Generador de sitios estáticos,
• Procesador HTML,
• Extractor de metadatos,

o todos ellos al mismo tiempo.

Sopault funciona con el árbol de elementos HTML de la página, por lo que puede hacer muchas cosas que tradicionalmente se pueden hacer con JS del lado del cliente: inyectar nuevos HTML en páginas completas existentes, crear una tabla de contenido que preserva los elementos de id de los encabezados HTML y más.

Tampoco usa materia frontal y extrae metadatos de HTML, utilizando un selector CSS3 a mapeo de campo de metadatos, por lo que incluso las páginas estáticas escritas a mano pueden indexarse ​​en lugar de tratar como activos. Por ejemplo:

[ 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

Los metadatos extraídos se pueden representar e inyectarse en páginas:

[ 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>
  """

Sopault es ...

• Durable y fácil de actualizar o revertir: está disponible como un binario vinculado a estática sin dependencias.
• Extensible: puede traer sus propios preprocesadores de la página (por ejemplo, la reducción de los convertidores HTML), los elementos HTML de tubos a través de programas externas y cargar complementos LUA.
• Flexible: la mayoría de las opciones son configurables, la mayoría de las características incorporadas se pueden reimplementar como complementos Lua, y hay ganchos de procesamiento de páginas.

Sopault lleva el nombre del dadaísta y el escritor surrealista francés Philippe Sopault porque se basa en la biblioteca Lambdasup.

Visite Sopault.App para más detalles.

Para apoyo y discusión, escriba un mensaje en la lista de correo.

Instalación

Los binarios previos a la construcción están disponibles para Linux, Windows y MacOS. Puede descargarlos de https://files.baturin.org/software/souplault y de los comunicados de GitHub (https://github.com/pataphysicalsociety/soupault/releases).

Puede verificar la integridad del archivo de lanzamiento utilizando esta clave Signify/Minisign: RWRfW+gkhk/+iA7dOUtTio6G6KeJCiAEp4Zfozw7eqv2shN90+5z20Cy .

También puede instalar versiones de lanzamiento estables de OPAM:

opam install soupault

Finalmente, puede construir la última versión de desarrollo con:

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

Para construir binarios estáticos, debe instalar OCAML con tiempo de ejecución Musl, luego usar el perfil de dunas 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

Que contribuye

Los informes y parches de errores siempre son bienvenidos. Las solicitudes de funciones y las nuevas funciones también son bienvenidas, pero considere discutirlas primero con el mantenedor.

Puede contribuir a través de GitHub o a través de CodeBerg.