&.

---

How Templ8.py’s Blogging Tool Does Things

It’s that one scuffed feature of the thingy. Here I explain it. Hopefully it’s not as bad as I think it is.

The blogbase

The blogbase is the file that dictates the three important parts of the blog: The article page’s format, the article preview format and the blog’s base repl8ce keys. In that order, all three separated by -BEGININDEX-. The article’s page format should be a regular file with its repl8ce keys and -BEGINFILE-, and should contain a key. Before we explain it, we’ll need to explain the keys that come with the blogbase that templ8 radio generates for you on first use.

• INTRO: It’s a what will be displayed in the front page of your blog, where all the blog posts will be.

• AUTHORS: A string containing the authors’ names.

• DATE: A string containing the date you with the article’s publication date. Or whatever relevant date you care about.

• TAGS: Just aesthetic, serves no archival purpose.

• LINK: The link to the current post, must not be set by the user, and can only be accessed by Article Previews.

LINK has a hardcoded different use.

How The Tags Are Applied

When you run templ8 radio, all the files in blog will be processed. First, their repl8ce tags are processed and stored, and their contents are put unformatted into the Article Page Format’s . After this, the Article Page’s repl8ce tags are applied to the whole, preserving the previous ones, but overriding them if they conflict.

Here, something interesting happens, since both the file and the article page have their own tags, the article page’s tags supercede the file’s, but most importantly, the article page’s tags can depend on the file’s tags.

In the default blogbase, the article page sets its PAGETITLE to TITLE. (PAGETITLE=). is actually set “one layer up,” in the specific file that is beign processed. Note that up until this point, the content is still a markup file.

This generated page is then parsed into HTML, and its repl8ce tags are applied, then it’s put into the basehtml (either that of this specific file, or the default one for the project).

Once this one is done, it is assigned a LINK based on its position relative to the root of the output.

Then, the file’s INTRO is put into the Article Preview Format, which can use the LINK to make it so you can link to the specific article. Then file tags are applied. Then converted to HTML. All the previews are put one after the other, and this whole is put into the basehtml, saved as blog/index.html.

This is how a blog works.

I did say that it was the worst blogging tool you have ever seen.

---