soupault

суп

Суп - это инструмент манипуляции HTML. Это может быть любое:

• статический генератор сайтов,
• HTML -процессор,
• метаданный экстрактор,

или все они одновременно.

Soupault работает с html Element Tree на странице, поэтому он может делать много вещей, которые традиционно можно делать с помощью клиентской JS: введите новый HTML в существующие полные страницы, создают содержание, которое сохраняет элементы id HTML Leadings и многое другое.

Вместо этого он также не использует метаданные фронта и извлекает из 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 Pipe через внешние программы и загружать плагины LUA.
• Гибкий: большинство вариантов настраиваются, большинство встроенных функций могут быть переопределены в виде плагинов LUA, и есть крючки для обработки страниц.

Суп назван в честь французского дадаиста и сюрреалистического писателя Филиппа Супо, потому что он основан на библиотеке Lambdasoup.

Посетите Soupault.app для деталей.

Для поддержки и обсуждения напишите сообщение в список рассылки.

Установка

Предварительно построенные двоичные файлы доступны для Linux, Windows и MacOS. Вы можете скачать их с https://files.baturin.org/software/soupault и из github leases (https://github.com/pataphysicalsociety/soupault/releases).

Вы можете проверить целостность архива выпуска, используя этот ключ Signify/Minisign: RWRfW+gkhk/+iA7dOUtTio6G6KeJCiAEp4Zfozw7eqv2shN90+5z20Cy .

Вы также можете установить версии стабильного выпуска от Opam:

opam install soupault

Наконец, вы можете создать новейшую версию разработки с:

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

Чтобы создать статические двоичные файлы, вам нужно установить OCAML со временем выполнения Musl, затем использовать профиль 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.