soupault

Fault

O Soupult é uma ferramenta de manipulação HTML. Pode ser qualquer um de:

• Gerador de local estático,
• Processador html,
• extrator de metadados,

ou todos eles ao mesmo tempo.

O Sopeult funciona com a árvore de elementos HTML da página, para que possa fazer muitas coisas que tradicionalmente podem ser feitas com o JS do lado do cliente: injete um novo HTML nas páginas completas existentes, crie um índice que preserva os elementos de id dos títulos de HTML e muito mais.

Ele também não usa matéria frontal e extrai metadados do HTML, usando um seletor CSS3 para mapeamento de campo de metadados, para que mesmo as páginas estáticas escritas à mão possam ser indexadas em vez de tratadas como ativos. Por exemplo:

[ 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

Metadados extraídos podem ser renderizados e injetados nas 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>
  """

O Soupult é ...

• Durável e fácil de atualizar ou reverter: está disponível como um binário ligado estaticamente sem dependências.
• Extensible: você pode trazer seus próprios pré -processadores de página (por exemplo, markdown para conversores HTML), tubar elementos HTML por meio de programas externos e carregar plugins Lua.
• Flexível: a maioria das opções é configurável, a maioria dos recursos internos pode ser reimplementada como plugins Lua e existem ganchos de processamento de páginas.

A Soupult recebeu o nome do dadaísta francês e escritor surrealista Philippe Soupult, porque é baseado na Biblioteca Lambdasoup.

Visite SoupAult.App para obter detalhes.

Para suporte e discussão, escreva uma mensagem na lista de discussão.

Instalação

Os binários pré-criados estão disponíveis para Linux, Windows e MacOS. Você pode baixá -los em https://files.baturin.org/software/soupault e do GitHub Releases (https://github.com/pataphysicalsociety/soupault/releases).

Você pode verificar a integridade do arquivo de liberação usando esta chave significativa/miniSign: RWRfW+gkhk/+iA7dOUtTio6G6KeJCiAEp4Zfozw7eqv2shN90+5z20Cy .

Você também pode instalar versões de liberação estável da Opam:

opam install soupault

Finalmente, você pode criar a versão mais recente de desenvolvimento com:

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

Para construir binários estáticos, você precisa instalar o OCAML com o Musl Runtime e usar o 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

Contribuindo

Relatórios e patches de bugs são sempre bem -vindos. Solicitações de recursos e novos recursos também são bem -vindos, mas considere discuti -los com o mantenedor primeiro.

Você pode contribuir através do Github ou através do Codeberg.