...
Note a small detail: The values you set on custom variables currently “take effect” at the end of script execution. so if you assign a value to one of these properties in a script and then access its value, you won’t get the updated value. This is a (minor) bug scheduled for the next update.
jSoup
This oddly named package provides easy yet powerful ways to both query and edit HTML documents. The entire package is exposed so go here for the full documentation. Here is a simple example of it’s use.
<#assign dom = doc.soup>
<#assign p1 = dom.select("p").first()>
<#assign dumy = p1.attr("style","font-weight:bold")>
<#assign dumy = p1.append("<p>an inserted paragraph</p>")>
<#assign special = dom.select("p#specialp").html("this is the special text we inserted")>
${dom.html()}The code above gets the jSoup structure into ‘dom’. We then find the first paragraph, add some styling to it, and then add a new paragraph immediately following. Finally, we find we replace the contents of the paragraph with id=specialp with the text shown. The dom variable now contains the original document with content changed and added. We probably want to keep those changes for use in later workflows, so the final line takes the dom and converts it back to html as the output of this script.