Re: [Exist-open] Replacing templates:surround for webapps

[Craig B. <cra...@ma...>]

> On May 30, 2024, at 5:42 PM, Ralph Corrigan <ra...@ra...> wrote:
> 
> Hi Joe, thanks for getting back to me. 
> Yes, we're currently using shared-resources - noted that this needs updating too! As for the deprecation message it's here:
> https://exist-db.org/exist/apps/doc/templating#surround


I've long since switched to the new templating library but I do use templates:surround and this is the first I've heard of its being deprecated.  The PR here:

https://github.com/eXist-db/templating/pull/17

labeled "Next major version" says, about 50 lines in, "Don't worry templates:surround is still... around."  Which of course does make one worry since it clearly implies someone thinks there's something wrong with it.  There is some language about "Embrace the top-down approach," but why one would do that is a mystery.  I guess the good news is that at least one more major version will have templates:surround, and it's been almost a year since there were any commits to the project so there may be no hurry about getting ready for even that version, much less a future one that actually removes templates:surround.

> 
> On 30/05/2024 21:32, Joe Wicentowski wrote:
>> Hi Ralph, 
>>   Are you using the templating module from the shared-resources package? Or are you using the newer HTML templating module?
>>   - shared-resources: https://github.com/eXist-db/shared-resources
>> - templating: https://github.com/eXist-db/templating
>>   Also, could you please share the URL to the page you're looking at that mentions the deprecation?
>>   Thanks,
>> Joe
>> 
>> On Thu, May 30, 2024 at 12:25 PM Ralph Corrigan <ra...@ra...> wrote:
>> Hi all, 
>> We've recently updated (long-overdue) our eXist instances, which has prompted me to check the latest documentation. I notice that the template:surround is deprecated, but I'm not clear about what it should be replaced with.
>> Our current apps use templates:surround with pointers to templates/picktherelevantpage.html.  Templates:surround is still declared in the updated shared resources templates.xql (assuming that has updated correctly) so there's no problem for now, but as we're building a new app at present it would be good to use whatever the new preferred method is. Any thoughts?
>> Thanks
>> Ralph
>> _______________________________________________
>> Exist-open mailing list
>> Exi...@li...
>> https://lists.sourceforge.net/lists/listinfo/exist-open
> _______________________________________________
> Exist-open mailing list
> Exi...@li...
> https://lists.sourceforge.net/lists/listinfo/exist-open

________________________________________
Craig A. Berry

"... getting out of a sonnet is much more
 difficult than getting in."
                 Brad Leithauser