All .awk files in this folder are ran by generate.sh and generate-dev.sh, after ssg and lowdown have created all HTML pages. These files are meant to work on the resultant HTML.

For improved efficiency, rather than running every script seperately, they are meant to be concatinated into one script (generate.sh and generate-dev.sh combine them in /tmp/syndamiadotcom-awk), which is ran for each HTML file. This forces us to work with the following constraints:

• NO awk script should print the current line (print should only be used to add new lines)
  The script that starts with '_' contains the print of the current line, all scripts that start with a capital letter are ran before it and all with small letter - after.
• If we print the current line in every script, the concatenated will print the current line multiple times
• Variable names between scripts must be unique
• exit mustn't be used! Instead, use a variable and then add a check to every relevant rule.

ftags

ftags are strings/words in the Markdown source files, that start with "&&" and continue with any (valid) sequence of characters. The name initially stood for "file tags", since I got the idea while making the file lists functionality. Now I like to think of them as "format tags", since they are used for so much more.

On the "backend", they just get replaced with specific HTML. List of scripts that handle ftags:

Information regarding their usage can be found at the top of their respective script file.