soupault

Sowault

Sowault adalah alat manipulasi HTML. Itu bisa jadi salah satu dari:

• generator situs statis,
• Prosesor html,
• Ekstraktor metadata,

Atau semuanya pada saat yang sama.

Sowault bekerja dengan pohon elemen HTML halaman, sehingga dapat melakukan banyak hal yang secara tradisional dapat dilakukan dengan JS sisi klien: menyuntikkan HTML baru ke halaman lengkap yang ada, membuat daftar konten yang melestarikan elemen id dari judul HTML dan banyak lagi.

Ini juga tidak menggunakan materi depan dan mengekstrak metadata dari HTML sebagai gantinya, menggunakan pemetaan lapangan CSS3 ke pemetaan lapangan metadata, sehingga bahkan halaman statis tulisan tangan dapat diindeks daripada diperlakukan sebagai aset. Misalnya:

[ 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

Metadata yang diekstraksi kemudian dapat diterjemahkan dan disuntikkan ke halaman:

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

Sowault adalah ...

• Tahan lama dan mudah ditingkatkan atau digulung kembali: Ini tersedia sebagai biner yang terkait secara statis tanpa dependensi.
• Extensible: Anda dapat membawa preprosesor halaman Anda sendiri (misalnya penurunan harga ke konverter HTML), elemen pipa HTML melalui program eksternal, dan memuat plugin LUA.
• Fleksibel: Sebagian besar opsi dapat dikonfigurasi, sebagian besar fitur bawaan dapat diimplementasikan sebagai plugin LUA, dan ada kait pemrosesan halaman.

Sowault dinamai menurut Dadais Prancis dan penulis surealis Philippe Sowault karena didasarkan pada Perpustakaan Lambdasoup.

Kunjungi SoPault.App untuk detailnya.

Untuk dukungan dan diskusi, tulis pesan ke milis.

Instalasi

Binari pra-buatan tersedia untuk Linux, Windows, dan MacOS. Anda dapat mengunduhnya dari https://files.baturin.org/software/soupault dan dari rilis github (https://github.com/patafysicalsociety/soupault/releases).

Anda dapat memverifikasi integritas arsip rilis menggunakan kunci ini Maksud/Minisign: RWRfW+gkhk/+iA7dOUtTio6G6KeJCiAEp4Zfozw7eqv2shN90+5z20Cy .

Anda juga dapat menginstal versi rilis yang stabil dari OPAM:

opam install soupault

Akhirnya, Anda dapat membangun versi pengembangan terbaru dengan:

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

Untuk membangun biner statis, Anda perlu menginstal OCAML dengan runtime Musl, lalu gunakan profil gundukan 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

Berkontribusi

Laporan dan tambalan bug selalu diterima. Permintaan fitur dan fitur baru juga diterima, tetapi harap pertimbangkan untuk membahasnya dengan pemelihara terlebih dahulu.

Anda dapat berkontribusi baik melalui GitHub atau melalui Codeberg.