Skip to navigation Skip to content
Giant Monty Python foot

Putting my foot(notes) down

Two-minute read

I blame my friend for becoming internet famous.

While writing about his voyage through the viral media sausage making machine, I realized that my blog templates had a serious design flaw. I had no place to put my snarky asides.

I needed footnotes. All the cool kids have them on their blogs. 1 John Gruber, for instance.

One of the nice things about having locally sourced, artisanal site that I made myself is that I can just add items as needed. I opened my code editor and wrote up styles for superscript and an ordered list style.

But I hated them almost immediately. They operated as skip links, which are simple and basic, but are also gross and confusing because they can easily leave a reader feeling stranded on the page.

I set out to make the best skip links ever. They zip a user to the bottom of the page, then return them to where they were reading. Try it! 2 They’re both easy and fun! In the spirit of progressive enhancement, users with JavaScript turned off, or if JS doesn’t load, get basic skip links.

I spent the last week or so, a couple hours a night, writing the JavaScript to make that happen. Then I tossed all of that out this weekend and rewrote the entire thing from scratch.

It was working smoothly on the local version of my site. Satisfied that it was ready, I published the code to my live site where it immediately broke.

I’m fairly new to writing in straight-up JavaScript. I’ve done jQuery for about five years. There’s a jQuery vs. JavaScript debate going on. Both methods have their strengths and weaknesses, but the jQuery partisans are correct that jQuery solves a lot of problems with JavaScript.

Finding and targeting items in the DOM is much easier with jQuery. In my case it was made doubly difficult because I write my entries in Markdown. They are just raw HTML with no styles, IDs or data tags to grab onto with JavaScript.

But it all appears to be working. For now. Except in Firefox. And maybe Internet Explorer. Frankly, we can’t be bothered to check.

We are offering a money back guarantee3 to anyone encountering issues with our footnotes.

Please contact the David Putney.com complaints department where your issue will be given all the attention it deserves. We will contact you in six to eight weeks once your complaint has been settled to our satisfaction.

  1. Despite having footnotes on my blog, I am still not one of the cool kids.
  2. Like this. If you hit the “Take me back to where I was reading” button. It will. At least, I hope so.
  3. Not a guarantee.