I just finished migrating the Secular Xmas site to PolkaDot, a half-assed blogging system I wrote long ago. Since the site was organized as a blog, I figured it might as well be one, instead of being a set of static pages.
That does mean that, suddenly, every post over there is dated today, in the order they were copied up to the server. So some newer things are buried and some older things show up right away.
That makes this a good time to explore the site! Whee!!!
Putting this on PolkaDot also allows for commenting, which works exactly as it does here, with the same limitations.
An additional feature common to this site is that the posts show Mountain Standard Time, reflecting the time zone of the server. I really should put something into the software to let you shift the time zone to your local time. But I know perfectly well that I'll never get to it.
After a few hours of futzing around, I've added comments to PolkaDot.
Now my readers, both of them, can comment on my insightful posts.
Let's see how long it takes for this to complete blow up in my face. Ah, hell, they're just text files. There's only so much that can go wrong.
Finally! A new release of PolkaDot. Here are the latest changes:
PolkaDot output is now XHTML compliant. Of course, your posts may wreck it. (Mine do.) Future versions will try to protect against that better.
Changed vs. Updated Date Toggle
PolkaDot sorts posts by date. You can now choose whether to use "changed" date or "updated" date as the "posted on" date. The former is the date the file's content was last changed. The latter is the date any of the file's metadata was changed. I was trying allow a sort of file creation date, so you could fix older posts without moving them to the top of the posts. But, on my server, FTPing a file up appears to change the metadata, so it makes no difference.
All static strings in PolkaDot are now defined in
config.php for easy customization and language localization. If you translate PolkaDot into another language, feel free to send me your
config.php file and I'll make it available on the PolkaDot site.
Yep, another tiny little minor release. Some of the new code added a variable that wasn't being initialized. So now it's initialized.
Coding is hard!
PolkaDot 1.4.1 is officially released!
The search feature also lets you select posts by month by searching for an appropriate regular expression.
Check both features out on the demo site.
Additionally, there are a number of code tweaks, primarily regarding initializing variables and checking that data structures exist before accessing them. Many PHP installations don't really care. But some are configured a little more stringently and throw warnings if things aren't done correctly. Many thanks to Petri in Finland, and John with the Spamex Disposable Email Address, for their help in finding and fixing these bugs.
So, why 1.4.1 instead of 1.4? Well, I was changing the version number in the RSS feed generator tag. And I mistakenly deleted an angle bracket. Ouch. Kills the feed. And, of course, I didn't test the feed before releasing it on Freshmeat as 1.4. So I did a quickie 1.4.1 release, with the angle bracket restored. (However, I forgot to then change the generator version number from 1.4 to 1.4.1, Oh well. I am not doing a 1.4.2 release just to fix that.)
PolkaDot 1.3 refines the paging mechanism and adds the ability to put posts into multiple categories, via symlinks. This multiple category feature is intended for advanced users:
(Special thanks to the vast PolkaDot Developer Community for pretty much everything in version 1.3.)
Here's a fun trick that just came to me. By installing PolkaDot into one of its own subdirectories, you can have a standalone blog whose posts also get incorporated into the main blog. Here's an example. This blog has a category for Tea. By placing the PolkaDot installation files into the "Tea" directory, I can also have a separate Tea Blog.
The posts that show up on the standalone "Tea Blog" are exactly the same ones as show up in the "Tea" category for the main blog. Note that if you make sub-directories under Tea, those will show up on the Tea Blog in a category with the same name as the sub-directory, but not in the main blog. PolkaDot only goes down one level when building categories.
So I could make "Green Tea" and "Black Tea" categories, but posts in those categories would only show up in the Tea Blog. Only posts to the "Main" category on the Tea Blog would also show up on the main blog.
I'm not sure, off-hand, of a good application for this feature. But it is a way to have multiple blogs, each with their own look and feel, while still being able to aggregate them together into one single blog.
I have a general rule that I don't read blogs that lack RSS feeds. That makes it a little embarrassing because PolkaDot doesn't provide an RSS feed.
So I added the functionality today. It's RSS 2.0. (Sorry ATOM and RDF fans, RSS is all you get. Mainly because I'm hand-coding it and RSS 2.0 is the simplest with which to deal.)
PolkaDot 1.2 has two new features. First, the RSS feeds have been expanded to include the category-specific feeds. In other words, if you use the RSS feed on the Tea page, then you'll get just the tea-related posts.
Second, PolkaDot now lets you page back to earlier posts. Just scroll down to the bottom of the page. It's not very sophisticated. (Nor is PolkaDot as a whole.) But it works.
Another change is that PolkaDot now actually uses the correct construct for fetching parameter values from the query string. I was lazy in the initial coding.
I don't have any other major features planned.
I've officially released PolkaDot 1.1. The only added feature is RSS 2.0 feeds. This also required adding another option in the config.php file. Sorry about that.
My goal is to allow users to upgrade by simply replacing the index.php file, leaving their configuration and styles alone. Alas, I had to add an additional option. Just look at config.php. It's pretty clear what to add.