Changing template tag start/end so {%Content%} becomes @_Content_@

[AJ-Ianozi]

YASS currently uses the AWS templates parser.

For those not familiar, you can use operators and tags in the layout html files like:

<div id="content">
   @@IF@@ @_EXIST:details_@
      <details>
         <summary>Table of Contents</summary>
         <ul>
         @@TABLE@@
            <li><a href="#@_detailslink_@">@_details_@</a></li>
         @@END_TABLE@@
         </ul>
      </details>
   @@END_IF@@
@_Content_@
</div>

In YASS, the pre & postfix for tags are {% and %} instead of @_ and _@, so in YASS the default is currently:

<div id="content">
   @@IF@@ {%EXIST:details%}
      <details>
         <summary>Table of Contents</summary>
         <ul>
         @@TABLE@@
            <li><a href="#{%detailslink%}">{%details%}</a></li>
         @@END_TABLE@@
         </ul>
      </details>
   @@END_IF@@
{%Content%}
</div>

You can change this in your site.cfg, but if you don't set it, it defaults to {% and %}.

I'm trying to weigh the pros of cons of setting the default to @_ and _@ since that's what all of AWS's template documentation uses.

Some pros are:

• It's consistent with the other AWS operators (e.g. @@IF@@, @@TABLE@@ etc).
  • This is the biggest pro for me.
• It's identical to AWS's documentation, so you can link directly to its other items.
• No longer need to override the start/end template unless the change is defined in site.cfg.

Some cons are:

• {% and %} are familiar to those migrating from jekyll / liquid
• Anyone who upgrades to version 4 without updating their config with Start_TagSeparator = {% and End_TagSeparator = %} will have to change their pages or their site will break.
  • This is the biggest con for me

What do others think?