soupault

湯

Soutault是HTML操縱工具。它可以是：

• 靜態站點生成器，
• HTML處理器，
• 元數據提取器，

或同時所有人。

Soupault與頁面的HTML元素樹一起使用，因此它可以做許多傳統上可以用客戶端JS完成的事情：將新的HTML注入現有完整頁面中，創建一個保留HTML標題id元素的目錄等。

它也不使用前物質，而是從HTML中提取元數據，而是將CSS3選擇器用於元數據字段映射，因此即使手工編寫的靜態頁面也可以被索引而不是將其視為資產。例如：

[ 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

然後可以將提取的元數據渲染並註入頁面：

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

湯是...

• 耐用且易於升級或回滾：它可作為靜態鏈接的二進製文件，無依賴項。
• 可擴展：您可以攜帶自己的頁面預處理器（例如，將html轉換器的標記降低到HTML轉換器），通過外部程序的管道HTML元素以及加載LUA插件。
• 靈活：大多數選項都是可配置的，大多數內置功能都可以重新裝修為LUA插件，並且有頁面處理掛鉤。

Soupault以法國達達主義者和超現實主義作家菲利普·湯的命名，因為它是基於Lambdasoup圖書館的。

有關詳細信息，請訪問soupault.app。

有關支持和討論，請將消息寫入郵件列表。

安裝

前構建的二進製文件可用於Linux，Windows和MacOS。您可以從https://files.baturin.org/software/soupault下載它們，並從GitHub earsease（https://github.com/pataphysicalsociety/soupeault/releases）下載它們。

您可以使用此表示/縮影鍵驗證發布存檔完​​整性： RWRfW+gkhk/+iA7dOUtTio6G6KeJCiAEp4Zfozw7eqv2shN90+5z20Cy 。

您還可以從OPAM安裝穩定的發布版本：

opam install soupault

最後，您可以使用以下方式構建最新的開發版本

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

要構建靜態二進製文件，您需要使用MUSL運行時安裝OCAML，然後使用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

貢獻

總是歡迎錯誤報告和補丁。還歡迎功能請求和新功能，但請首先考慮與維護者討論它們。

您可以通過GitHub或Codeberg貢獻。