Jon Smajda

Updates

2012-05-13T13:15:23-05:00

I’ve had dry spells in the past on this blog, but this has been the longest. A lot has happened.

In December, I completed, and successfully defended, my PhD in sociology! Finally! It’s been a huge relief to be done and have that part of my life behind me. While I applied for some academic jobs this past Fall, nothing has panned out and I’m mostly out of the academic world these days. Not entirely though: I’m still working with The Society Pages and Contexts, keeping the servers running in the engine room for both sites and doing some podcasting and editorial work for TSP.

As a grad student I got interested in studying the culture of open source software, and I’ve now officially gone native: working as a web developer full-time for BOLD. Most of my time there is now spent working with Python and Django, which I greatly enjoy: both are elegant, powerful, and fun. We’ve been working on a particularly large Django project for the past year now that has been a great learning experience. If I ever get around to posting here again, there’ll likely be some Python and Django-related posts sharing what I’ve learned.

After spending nearly a decade pursuing a PhD in sociology, it’s been a bit of a mental adjustment to get used to the idea that this is now my career, not sociology. On most days, however, I’m happy with how this has turned out. There’s an ideal vision of what life in academia is like that I know I would love, but the reality is often pretty far off from that. Plus, I’m pretty pessimistic about the direction higher education is heading in this country.

More concretely though, I think there are several aspects of my personality that are just better suited to what I’m doing these days. For instance: I don’t have the right kind of long-term patience for academia. For example, my advisor and I have an article scheduled to be published this Fall. It was accepted by the journal last Fall. We finished writing the article last Spring. It’s based on research I did in 2004. So in academia, in other words, you’ve got to be in it for the long haul. Compare this to what I just said about about web development: in the time it’s taken this paper to go just from acceptance to publication—nevermind the actual time spent doing the research and writing!—I’ve learned an entire new programming language and web development framework. And I’m sure there will be others in the next few years. Software development is a fast-moving field. Sociology is not.

Let’s see…what else is new?

Last year, while I was scrambling to finish my dissertation and also get a new career started, I re-discovered running as the ultimate stress-reliever. A few months back, I started tracking my runs on Runkeeper. I keep going back and forth on whether I actually want to start entering races. The competitor in me thinks I should, but a big part of the appeal of running for me is getting away from other stressors in my life so I’m hesitant to introduce any extra stress into running. For now, it’s just for fun.
Chloe is now five years old. She starts Kindergarten in the Fall. She’s amazing.

That’s about it for now. Hopefully it won’t be another 10 months before I post again!

WordPress and Git

2011-07-17T15:35:54-05:00

A few years back, I wrote a post on managing WordPress. For the most part, it’s still valid but I’ve been using git to manage code for quite awhile now, so I thought I’d give a little update.

Thanks to Mark Jaquith, there’s now a reliable, complete git mirror of WordPress. I’ve been using git to manage my WordPress sites for awhile now, but the actual updating of WordPress has always been weird to force into the git loop. My practice has been to keep a stock WordPress git repository that is also a subversion repository (just add *.svn to your .gitignore). I svn switch to a new tagged release, commit the result in git, and then this repository is set up as a remote on all my active WordPress sites, so I ssh into these sites and merge each with this stock WordPress branch.

Now that there’s a good Wordpress mirror on github, the way to take advantage of this may seem obvious: just clone this mirror and then merge from it. However, that has a couple downsides. First, you get messy history: all of the commits you’ve made locally for your site get drowned in WordPress core commits. Second, unless you’re actively developing WordPress core, you only care about official releases (and possibly beta releases). In other words, you want to merge with tags only and you don’t want messy history. So here’s how to get that: instead of cloning Jaquith’s mirror, just add it as a remote and squash the commits.

Step-by-step:

If you’re starting from scratch, create an empty git repo with git init and create an initial commit with something — maybe a local-readme.txt file explaining what you’re doing. (“Squash commit into empty head not supported yet”.) Anway, add the remote:

git remote add wp git://github.com/markjaquith/WordPress.git
git fetch -t wp

The first adds the github mirror as a remote named “wp”. The fetch -t will make sure you get all the tags. (Run git tags afterwards to see the list of available tags.)

Next, merge with the latest tag (here, 3.2.1):

git merge --squash --no-commit -s recursive -X theirs tags/3.2.1

The --squash means it takes the hundreds (thousands?) of ancestor commits for that tag and compresses it into a single commit. The -s recursive -X theirs tells git that if there are conflicts, use the new version. (Remember, all you’re doing here is creating a simple local WordPress mirror to merge your actual WordPress sites with.)

The --no-commit tells git to merge but stop just short of actually making the commit. So make sure everything looks good. For example, you can’t squash binary files so you may get conflicts about that. If this happens, just git checkout the latest version explicitly. For example, going from 3.2 to 3.2.1 I had to do the following: git checkout tags/3.2.1 -- wp-admin/images/wp-logo.png

Finally, git commit -m "3.2.1"

Now, as I said above, what I like to do is this: do not use this as your starting point for an actual WordPress instance. Instead you add this repo as a remote (just like we did above) to your site and then you can just do a git pull wp (or whatever you call it) there. That way you only have to do the little dance above once for each release if you’re responsible for multiple WordPress instances.

Quick aside: Why don’t I just put mine on github? I could. But here’s the problem: the reason Jaquith’s mirror is such a big deal is because he’s a WordPress core developer. Others have done this, but they’ve all had shortcomings: the ones I knew about didn’t include tags, or they were really slow to update, or they simply got abandoned. I’m not blaming any of them. Sure, I could put a “simplified WordPress repo” on github, but I don’t want to commit to updating it instantly every WordPress update forever. And what works for me may not work for you. The process I described above is not difficult and shows how you can take the comprehensive mirror and merge with it to make your life easier in your own way that suites your needs.

Plugins

What about plugins? There’s no git mirror of the WordPress Plugins Directory that I know of, so I usually revert to my subversion hack described above: svn co http://svn.wp-plugins.org/plugin-name/trunk/ . into a directory for the plugin and then commit the results into git. Alternatively, you can use WordPress' backend plugin updater, which can work just fine, but I inevitably end up having to modify certain plugins and that process simply overwrites the files and you lose your modifications, whereas at least svn up will alert you to conflicts and let you merge your changes into the new version. (Makes me wonder how many out-of-date plugins would be updated if the WordPress Plugin Directory worked more like github — where anyone could fork your plugin and fix it if you won’t…)

Beta Testing

If you want to test beta releases locally before installing them, you can just create a “testing” branch of your WordPress repository (git checkout -b testing) and then instead of merging with a release tag, just merge with whatever branch the development for the next version is happening on. Make sure if you’re going to switch back and forth to backup your database though!

Merging into an existing site

This may sound great for setting up new sites, but what about merging into an existing wordpress site? You’ll get conflicts because git won’t have a common ancestor commit to merge from. So fake one: create a graft file file linking your most recent commit where you updated WordPress (if you’re using git for the first time, just use your first commit) and the SHA1 of the commit for the version you’re currently running in your base WordPress repo. After creating this file, you should see both branches reflected in your git log and when you try to merge to the current commit in your remote branch, it should merge cleanly, as if you’d been merging with it all along.

Dvorak Follow-up

2011-05-15T11:39:52-05:00

About a year-and-a-half ago, I wrote about how I was learning Dvorak. I was still very much in the learning phase at the time and I’ve been meaning to revisit the post for awhile now. Here’s a quick update:

I’m still typing Dvorak.
My hands rarely hurt anymore. This was the main motivation for trying Dvorak, so I’d call it a success. The decreased motion required with Dvorak seems to have made a difference. One qualification: I’ve also learned to be more conscious about how hard I type, so that may be making a difference as well.
I have no idea if I’m faster than with QWERTY. This wasn’t a factor in learning Dvorak for me and I haven’t done any speed tests.
I wanted to be able to switch between QWERTY and Dvorak. This has not been so easy. I can type QWERTY, but I’m slow and have to think extra hard about it and/or look at the keyboard the whole time. This is doubly bad because about the only time I have to type QWERTY is when I’m at someone else’s computer, usually with them watching while I’m trying to talk at the same time. So, already not an ideal environment for good typing. I could probably make the effort to get better at QWERTY and practice switching layouts more often, but it’s just not been that big of a problem yet.
If you type a lot of English and your hands hurt, I’d recommend trying Dvorak. Beyond that specific situation, I’m not sure how heavily I’d recommend it if you’re already a good QWERTY typist.

That last point is worth expanding on. The people who seem interested when I tell them I use Dvorak are programmers. Programming alone, however, is a pretty poor reason to switch. First, you don’t actually type that much when you’re programming. Second, all the special keys (brackets, braces, colon, semicolon, etc.) that you type a lot when you’re programming have moved, and not necessarily to more ergonomic locations. In fact, they’ve been moved to less ergonomic locations to make room for regular letters non-programmers use more frequently. You also have to relearn keyboard shortcuts, and keyboard shortcuts often have been chosen for ergonomic convenience. If you’re a vim user like myself, you have to relearn your vim muscle memory.

However, Dvorak is more easy to recommend to people who just type a lot of English: writing papers, dissertations, emails, blogging, etc. This group of people, however, tend to just think I’m crazy when I tell them I use Dvorak. They’ve often never heard of it and assume it’s something hard-core programmers might do, when, in fact, it makes more sense for them than the programmers who are intrigued by the idea. Of course, there’s an overlap between “people who program” and “people who spend a lot of non-programming time typing on a computer”, but it’s interesting to me that there’s a disconnect between those interested in Dvorak and those who could most benefit from it.

Link: The Screenshot That May Finally Force Me To Buy An iPad

2011-04-20T21:25:13-05:00

That’s Vim! On an iPad! Using Prompt!

I’d love to buy an iPad, but my 5-year-old MacBook is really starting to show its age and there’s no way I can justify both. The main reason I need a laptop though is for writing in Vim. If I could do that on an iPad…

One question and one comment:

What are the ergonomics of using an iPad with the external keyboard? I’ve never actually seen someone do it, and it seems like it could be very awkward.
The “Oh yeah…” moment that brings me down a little bit after seeing this screenshot is that, of course, it’s an SSH app. You’re still connecting to another computer over the internet, and therefore dependent on, say, coffee shop wifi to keep you connected while writing. Of course, with a mythical Android tablet, with it’s old school file system, one could have a fully native Android version of Vim working off local files. I hear there are several great writing apps for iOS that hook into Dropbox, but I suspect the Dropbox-enabled port of Vim is still a ways off.

Link: Amazon Announces Library Lending

2011-04-20T20:04:42-05:00

Amazon is working with OverDrive, the leading provider of digital content solutions for over 11,000 public and educational libraries in the United States, to bring a seamless library borrowing experience to Kindle customers.

I’ve had my Kindle about a year-and-a-half now and I get asked more about it now than when I first got it. “Can I check out ebooks from my library?” is one of the top questions people have. Our local library has OverDrive ebooks already, but has thus far had no Kindle support. There are a lot of avid readers out there that still go to libraries. This will sell some Kindles.

To read OverDrive books on my Kindle I break the DRM and convert them to .mobi files. This involves using some python scripts that are easily found online. This is not, however, something I can recommend to, say, my parents or their friends that are frequent library patrons. It’s also not something I should probably be admitting on this here eponymous blog, as it is illegal.

Which is the real problem with ebooks. Ebooks today are still where mp3s were a few years ago. Conventional wisdom among people who pontificate about these things on the internet is that eventually publishers will cave just like music labels did. Music labels were so scared of Apple’s dominance that they decided to allow Amazon to distribute DRM-free mp3s just to create a competitor to the iTunes store. Is Amazon enough of a threat to publishers that they’ll make the same decision? Or will Amazon have enough of the market at that point that it won’t matter? Apple sells music in order to sell iPods (and now iPhones and iPads), but Amazon is doing the reverse: selling Kindles in order to sell ebooks. The fact that there’s a Kindle app on every mobile platform now is evidence of this. Which begs the question: why strike a deal with library lenders like this? Just to get market share, I assume.

Link: Disable Automatic Gain Control in Skype

2011-04-19T21:35:28-05:00

Open up ~/Library/Application Support/Skype/shared.xml in a text editor, find the <VoiceEng> section, and add <AGC>0</AGC> and <EC>0</EC>. Like so:

<VoiceENG>
  <AGC>0</AGC>
  <EC>0</EC>
  [One or more <MicVolume>'s. Leave them alone.]
</VoiceEng>

The thread is from 2007, but it still works in Skype 5.

This feature is single-handedly responsible for the many noisy podcast interviewers you hear. See, when your channel is quiet, Skype yanks up the gain on your mic, meaning that every little sniffle, sip of coffee, or fan running two rooms away gets picked up while your guest is talking. And then, when you re-enter the conversation, your first few words are way too loud and distorted until Skype re-adjusts the gain.

But not anymore on my podcasts.

To manually adjust your mic gain, open up the “Audio MIDI Setup” application (in /Applications/Utilities) and select the Input tab for your mic.

Moving Home

2011-04-13T06:55:00-05:00

I’ve decided to bring this blog back to life. It has my name on it after all.

When I switched this site to Jekyll awhile back, I never really took the time to set up a good workflow for posting, which is part of the reason I quit using it. After listening to a recent Build & Analyze discussing static site generators and Dropbox, I got inspired to try to rig something up here. Here’s what I’ve got:

My Jekyll files are stored in my Dropbox and synced with all the computers I use.
I have an iMac that doubles as a home web server, so I created a VirtualHost on it to serve content from my Jekyll destination directory. It’s behind a weird port and an htaccess password, so it’s basically a private mirror of my blog.
On this iMac, I set up a launchd file that sets up a WatchPaths on my _posts directory. Whenever I change anything in that directory, it runs Jekyll and rebuilds my site on that machine.
I have a simple shell script that rsync’s the iMac version of the site to the real web server.

So I a) write a post in Vim on any computer, b) as soon as I :w the file gets synced to my “development server” which I can then preview in a browser until I’m happy, and then c) I run !jekyll_deploy.sh from within Vim when I’m happy with the results.

The second step is the huge improvement. I don’t have to keep another Terminal window open running Jekyll on localhost. I don’t have to worry about having the full Ruby/Jekyll system set up on every computer I use. Because Dropbox is so fast, and because the preview site is being served using Apache rather than WEBrick, moving from writing to previewing is just as fast as if I’m running Jekyll on my local machine.

A few more Vim-specific things: if you like to save drafts of posts as I do, then you’ll end up using the YAML date: to set the post date. I modified jekyll.vim’s created: to use date: instead and then added this to my .vimrc:

    map <Leader>jd :%s/^date: \(.*\)$/\=strftime("date: %m\/%d\/%y %H\:%M\:%S")/<CR>

With this, I can just type \jd (I have “\” set as my Leader) and it refreshes the post date and time to the current date and time. (I thought about having it do this automatically on save, but I don’t necessarily want to update the post date (or URL) just for typos.) I also have jekyll.vim’s JekyllPost and JekyllList mapped to \jn and \jl respectively.

I’m also using this trick to fix Vim’s highlighting of the YAML front matter.

Black Country Communion

2011-04-12T09:41:11-05:00

My brother turned me on to Black Country Communion a few days ago and I’ve been listening to it nonstop since. They have an interesting sound: unique, but at the same time clearly evoking many other bands, both modern—Audioslave and Kings X to my ears—and also classic: Zeppelin and Deep Purple, for instance (no surprises there: Glenn Hughes sings and Jason Bonham plays drums).

Joe Bonamassa is one of those guitarists I’ve read rave reviews about but have never really taken the time to check out. The little bits I have heard (on Pandora, I think) were more classic blues kind of stuff, which I like just fine but don’t really go out of my way to listen to. This is more heavy rock though, and I like it. He’s a versatile player, but the trait that stands out most to me is his Eric Johnson-style violin sound. In interviews Eric Johnson has always said he views this sound as a rip-off of Clapton’s live sound with Cream. I never got that because Eric Johnson doesn’t really play like Clapton (even when he’s playing more bluesy stuff, in my opinion). Bonamassa, however, can play like both EJ (“One Last Soul”, “Song of Yesterday”) and EC (“Sista Jane”), and now I get it. It’s a hard sound to pull off because it’s dark and bassy, but with a strong mid-range bite. Your guitar can end up sounding like an angry duck or a muddy mess. But, I digress. Let’s put it this way: it’s great fun to imagine Eric Johnson sitting in with a real rock band instead of rehashing the same New Agey solo crap year after year.

What I've Been Up To

2010-05-23T16:02:39-05:00

Let’s see, it’s almost June and this is just my second blog post of 2010. Can that possibly be right? No. It’s not right. It’s just I’ve mostly been blogging on Tumblr instead of here.

About a year ago I was bored with WordPress and wanted to try something different. I ended up experimenting with two blogging platforms at the same time: Jekyll (this blog) and Tumblr. The two are almost complete opposites of one another:

Jekyll is a static site generator where your entire blog lives on your local machine and the interface is designed with programmers in mind.
Tumblr is a hosted web service designed to be the easiest way for anyone to blog.

After the novelty of Jekyll wore off, I found it was just more fun to post on Tumblr, despite (and perhaps because of) its limitations. And with the Tumlbr gem and my Tumblr backup script, I can pretty have the exact same writing environment as Jekyll (i.e. a text editor and local markdown files) when I want it for longer posts.

So I’m not quite sure what to do with this particular blog. I’ve considered transferring the posts here and the “jon.smajda.com” domain to Tumblr entirely, but I think I’ve decided against that for now. This site will probably continue as just my all-purpose homepage (and pre-2010 blog archive) and I’ll just continue to blog on Tumblr.

Let’s see, while I’m at it, what else has been going on?

After initially being shy about actually appearing on the Contexts Podcast, I’m now a cohost and appear in one role or another on about half of the episodes or so. Turns out I like hearing myself talk after all, and the podcast is more fun than I expected it would be.
So much fun is the Contexts Podcast, in fact, that we’ve actually started a second podcast, Sociology Improv, that is more of an informal, discussion, dare I say “talk radio” kind of thing. The direction is kind of open-ended and we’re just letting it develop as we go, but it’s also a lot of fun. Plus: all of the music on this podcast is original music created by yours truly.
I presented at the Politics of Open Source conference in Amherst, MA a few weeks ago. That was fun because it was the first time I’ve actually presented stuff from my dissertation. It was also cool because of the conference format: one room, one presenter at a time. I’ll also be presenting (on Monday, August 16 at 8:30am) at the ASAs in Atlanta. I’ll be in just one of hundreds of rooms there though.
We finally sold our damn house in Minneapolis. This is a gigantic weight off our shoulders. …Let’s just leave it at that, ok?

Post-Journal Academic Publishing

2010-01-07T14:57:39-06:00

Everyone knows the publishing industry is made up of dinosaurs, but academic publishing is the Brontosaurus. Academic journals are slow, expensive, inaccessible and non-transparent. And there’s absolutely no reason they need to exist anymore.

Ditching the Dead Trees

Most clearly, there’s no technical reason for printed academic journals. And while traditional journals are increasingly realizing this and going online, they are still published by traditional academic presses who need to somehow pay for themselves, so they charge exorbitant prices to individuals and libraries, and keep their journals in closed formats such as DRM-protected PDF files.

This might be justified if publishers were necessary to produce a journal, but they’re not. Editors of academic journals basically work for free and a journal is lucky if they can afford to hire a part-time managing editor. Neither authors or reviewers are paid either. In other words, the content is produced, reviewed, edited and handed over, at very little cost, to publishers (and often the academic associations who sponsor the journal) who turn around and sell the journals back, at very high prices, to the very people producing the content in the first place.

So what’s the alternative? An obvious first step would be to ditch the publishers and go online only. The web is a vastly superior distribution platform for most academic work. You can search a web page, for example. Copy and paste quotations. Easily convert HTML to any other format you prefer for reading—whether that’s reading on your Kindle or printing out a hard copy on dead trees. (And while I’m at it, let’s ditch the PDF in favor of the much more lightweight and flexible HTML. Online-only journals are often still obsessed with looking like print journals, for some reason.)

And, of course, by going online you save the cost involved in printing and distributing paper copies. And with that the need for academic publishers.

There are many journals that are free and online already. This isn’t a new idea: see open access journals. The problem is that the most prestigious journals are not among them. Association sponsored journals are still in print because the associations need them to be in order to fund themselves. And the really big name journals are actually profitable and pay for most of the other journals, which lose money. As long as the most prestigious journals are print journals, free online journals won’t truly take off.

But it’s not so much the “print” part that’s the problem. If any of the big name journals went online-only tomorrow—and they’re looking into it—they would still be distributed through publishers who will want to lock down the distribution channels so they can continue to make money. Publishing online for traditional publishers is actually expensive because they need to recover the revenue they’re accustomed to getting from print editions, so they have to invest in all sorts of ugly, draconian DRM schemes and restrictive licensing practices.

So even if every new journal out there was online only, and a good proportion of the less profitable journals converted to online open access journals, you’d still have an elite core of journals keeping the journal ecosystem expensive and inaccessible. There are too many players—publishers and associations—whose well-being depend on these journals to exist.

Getting rid of journals

In the absence of a print product, why do we need journals at all? There are a bunch of reasons you need entities like journals, with editors and reviewers. But is there any reason—aside from the occasional themed “special issues”—where the output of the peer review and editorial process needs to be monthly or bimonthly collections of articles organized like a book, with volume, issue and page numbers and a table of contents, all squeezed into discrete “issues”?

Here’s an alternative system that I think would work much better:

Imagine an online publishing system—not unlike a blog—where when you’re ready to share your work, you simply publish it to a website. (Ideally this would even be built into the word processor/text editor you write in: imagine a single “publish” button.) Your document shows up on a website, configured specifically for easy reading: a simple layout perfect for reading on a variety of devices or for printing.

Every academic would publish their work to a website just like this: individuals or institutions could host their own instances of the software.

There would be some sort of common identity management (OpenID maybe) built in to the system. If you only want a few people (individuals or institutions) to have access to early drafts, there’s an easy way to specify that.

This system would have a versioning system built-in: each published version would be labeled and scrolling back through previous versions would be easy.

Some sort of commenting/discussion system would be built-in as well. Obviously.

In other words, it would do pretty much what WordPress or Drupal can now do out of the box, only have some specific tweaks and optimizations for academic work. (In fact, such a system could be implemented through a WordPress plugin and/or theme!)

Now imagine the following: you no longer submit manuscripts to journals. At least not like you do now. “Journals” are replaced with a system of organizations of some sort that manage the peer review process and lend their seal of approval to work they find of high quality. You grant them access to your article, and the “journal” coordinates finding expert reviewers for your work and gives you feedback right there on your website: including reviewer comments and including final judgments like “reject”, “revise and resubmit” or, of course, “accepted”. An accepted article would be a seal of approval, vouching for the quality of your work, not a promise to publish in some collection.

Some interesting potential consequences of a system like this:

Instead of keeping all of their work secret to respect the demands of publishers, academics could do all of their writing in public. Individual academics would be self-publishers and would own their own copyright on everything they do. “Journals” would no longer publish anything. (I’ll keep calling them journals though as I haven’t thought of a better name yet.) Journals would only do the one thing they do well: manage the peer review system and put their authority and reputations behind the work that they feel is the best in the field.
Without the constraints of printing paper issues of a limited size, there’d be the risk of certain journals accepting everything. Which is fine: this would diminish the reputation of these journals and the more selective journals who only certify the best articles would improve their reputations over time.
Since you’re no longer really submitting to a specific journal, would it be possible to have multiple journals “accept” the same article? Possibly. And that seems weird but has some cool possibilities as well: a lot of times really important, influential articles show up in smaller journals and are only read within a small subfield, though they may deserve a bigger audience. The ability of the more selective, generalist journals to add their seal of approval to articles that others have already accepted could be a good thing.
Would the peer review process be public as well? For example, would the fact that some journal rejected your article, and the comments from reviewers, be public (if still anonymous) as well? This could go either way, but I think this would be a good thing as well.
What about the fact that you can change stuff so easily online? Would people keep going back and correcting errors after publication? This is why a good versioning system is key: a journal would review and accept a particular revision of an article and that information would be included with their decision. (If you’re worried about the ability of authors to manipulate this, source code management software like git actually uses a SHA1 hash of the contents of the files to name the revision. This acts as an integrity check on the data in any given revision. Something like this could be used to ensure that any given revision of a document always refers to the same document.)

Now maybe, as I discussed in the first half of this post, just moving the traditional journals online would be good enough. But there’s a lot I like about this bolder idea. It could have the best of the web as a publishing platform—flexibility, accessibility and affordability—but maintain the quality control of the traditional journal system. There are probably some obvious shortcomings I haven’t thought of or have underestimated (Without the constraints of actually publishing something, would we just end up with a mess of thousands of journals allowing no one to find anything?), but it’s still a worthwhile thought experiment. Academics have such little control over our publishing system now. It seems to run on pure inertia, and, in my opinion, doesn’t seem to work in favor of the interests of most academics.

N.apbcbi...Learning Dvorak

2009-12-02T00:00:00-06:00

My freshman year in high school, I think I was quite possibly the only student in my entire “Keyboarding” class who enjoyed the class.

Going in, I could not touch type. In fact, we didn’t have a computer at home. My generation was right on the edge of when this was still mostly normal. A few years later everyone had computers at home, and just a few years before, very few people did. So maybe I just thought it was fun to actually play on a computer, but I did enjoy the touch typing lessons. There was something simple and satisfying about having one class each day that was completely calm and quiet, where all I had to do was to try improve on my performance from the day before.

Plus, I got pretty good pretty quick. I’ve always suspected it may have something to do with the fact that I’d been playing guitar my whole life: my hands were pretty coordinated already. In our school we had a “Keyboarding” class one semester and “Computer Applications” the next, where they basically taught us the blue screen version of Microsoft Word. By the time I was in Computer Applications, I was fast enough I actually had a touch typing race with my instructor one day. (I was faster, but she made less mistakes.)

Nowadays, much of what I do—for work or for play—seems to involve lots of typing. And my body is paying for it. Maybe I’m dwelling on this more than usual since I turned 30 a few weeks ago, but lately everything I do seems to make some part of me hurt. My back has been bothering me lately, so I’ve started sitting on an exercise ball at my desk. (I’ve been doing this for a few weeks now and love it. I can sit for hours and work without all of the uncomfortable fidgeting I always end up doing in chairs.) In the past few years, I’ve become way more finicky about how I sleep as well. I slept on an awful, old, saggy bed all through college with zero troubles, but now in the past few years, I’ve become super picky about my bed and pillow.

And, of course, my hands bother me when I type a lot.

Aching hands have actually been an issue for a few years now. It’s actually better than it used to be, thanks to my abandoning Word for a text editor: vi. I had to learn vi a few years back for work, but this requirement actually came at an opportune time: I was in the middle of a heavy writing period and my hands were killing me. I learned this was mostly because of the heavy mousing and acrobatic keyboard shortcuts my word processor was making me go through. Vi, on the other hand, lets you do everything from the keyboard, and (with the exception of frequent trips to the escape key) lets you keep your hands on the home row keys pretty much all the time. But vi’s no miracle worker: the hands still hurt, particularly after several days in a row of heavy typing.

So now that you know all about me, my aging body and the strange pleasure I get in learning new keyboarding techniques—from touch typing in high school to vi a few years ago—you can probably see why I’m susceptible to the Dvorak hype.

For those of you who aren’t familiar with the story of the standard QWERTY keyboard layout and the Dvorak layout as an alternative, go read the Dvorak Zine real quick. It’s short and fun. But the even shorter summary is that the Dvorak layout is an alternative keyboard layout that’s designed to be way more logical and efficient than the QWERTY layout. Here it is:

(Original here, then cropped. If you click that, you’ll get a big version that I’ve had set as my desktop background for the past few weeks as a quick reference.)

A few weeks ago, WordPress developer Donncha O Caoimh wrote that Matt Mullenweg, a Dvorak user, had convinced him to give Dvorak a try. I followed some links, did some reading, and decided to give it a shot. If nothing else, it sounded exactly like the sort of crazy experiment I seem to enjoy inflicting on myself. And hey, vi worked out.

Here’s what I decided to do: I’d try some lessons during breaks and during otherwise unproductive activities (while watching TV, for example). I didn’t have the time to switch completely overnight: my productivity would just slow to a crawl. The only way to make this work for me, for better or worse, is to learn to switch back and forth. So I knew I didn’t want to resort to using a special keyboard or switching around my keycaps. My wife and I share our computers and that would just be mean, for one thing. But more than that, the whole point is to become a more efficient touch typist. Plus ideally my QWERTY skills won’t deteriorate entirely: it’d be a real pain to be an awful QWERTY typist in this QWERTY world. So once I knew the layout and could touch type—albeit slowly and with lots of errors—I started to force myself to use Dvorak for short stretches of time when I knew typing speed would not be that big of a deal (reading and replying to emails, playing around on the web, etc.). I also found that when I’m really writing—as opposed to typing emails or stuff like that—my thinking speed, not typing speed, is the bottleneck, so Dvorak actually wasn’t that much of a hindrance.

This is pretty much the phase I’m still in now. It didn’t take that long to get to this stage, but going from here to matching my QWERTY proficiency is still a pretty daunting task. Rather than waiting to write this up though, I thought it’d be fun to write this now, when I honestly don’t know if I’ll stick with it or not. I’m far enough in to see the real advantages, but still limping along enough to see the trade-offs.

Whether you think it’s worth it to completely relearn how to type or not, it only takes a few short lessons to realize that, all other things equal, it’s a much more logical layout. Not that this would take much: there’s pretty much no logic to the QWERTY keyboard. We all have to learn it though, so for some reason it doesn’t seem so bad. In the Dvorak layout, the most commonly used keys are in the home row. Vowels are on the left (AOEU are where ASDF are, with I in G’s place) and your right hand rests on HTNS, the most frequently used consonants. I suppose there’s some satisfaction in knowing you’re using a more elegant and efficient layout than everyone else, but that’s hardly a reason to switch. It’s the comfort and the reduced strain on your hands that is so appealing to me.

But it’s not clear to me yet that it’s necessarily a complete improvement over QWERTY on the hand strain issue. For one thing, all your keyboard shortcuts change too. When you use some keyboard shortcuts so much, they become gestures. You don’t even associate Command-W with “W”, it’s just the gesture you make when you want to close a window. If you’re a vi user, then this is particularly challenging as the whole interface is built around keyboard gestures. And many gestures—such as Command-X, C and V for cut, copy and pasting, or “hjkl” for cursor movement in vi—were chosen not for their mnemonic value, but for their positioning on a QWERTY keyboard. An additional source of skepticism I have is that the most strenuous keyboard motions are unchanged in Dvorak: Delete/Backspace, Shift, Return, the Control/Command/Option combos, etc. Combine this with the “XCV” problem and it seems like Dvorak may actually make some of this worse. Yes, Dvorak was designed to be fast and efficient when typing English sentences, but many of the other ways we use our keyboards have been designed to be fast and efficient on our otherwise inefficient QWERTY keyboards.

(Macs offer a “Dvorak-QWERTY” layout which, when I first heard about it, seemed perfect: the keyboard reverts to QWERTY whenever you press Command. Unfortunately, it stays in Dvorak when you press Control, which makes this useless in my opinion. If you can only get QWERTY for some of your keyboard shortcuts and not others, that doesn’t help: it just makes things more confusing.)

Also, while my hands may be hurting less after a long session in Dvorak, I’m also typing much slower, and because my keypresses are more tentative, much softer. I type too hard. And these low-travel keyboards all the Macs have these days really punish hard typers. It’s possible I could save myself much of my hand pain by just learning to type more softly. Also, once I get up to speed with Dvorak, I could end up typing harder again.

Other funny things about making the transition from QWERTY:

QWERTY puts all of the funny keys off to the right of the keyboard, while Dvorak spreads then out more. It’s really hard to learn to use your left hand for punctuation and for brackets. Likewise, the key that is “[{” in QWERTY is “/” and “?” in Dvorak. Next door, “=+” replaces “]}” too. You use these in normal writing way more often and I find I’m really bad at hitting these key. (Although, you do use this keys a lot in programming and I’ve always struggled with touch typing those keys while programming, too.)
The hardest keys for me to keep straight are the ones close to their QWERTY equivalents: y and b constantly trip me up.
I find that moving back and forth between QWERTY and Dvorak is relatively easy (usually a few awkward sentences or two), but here’s what’s really funny about it: I can still type QWERTY really fast, but if I slow down, I’ll switch back to Dvorak. (The same is true in reverse, but that’s not surprising.) It’s like I’ve gotten used to two typing modes: slow, methodical Dvorak, where I really have to focus on which keys I’m pressing, and then QWERTY autopilot mode.
I’ll probably just have to quit QWERTY cold turkey at some point if I really want to master Dvorak, though I really don’t want to lose my QWERTY proficiency either. I’ve heard people compare the two to learning a second language (you can still speak your first language) or a second musical instrument. A few weeks into my QWERTY experiment, I’ve got another analogy that, as a guitar player, seems to fit a bit better to me: it’s like learning an alternate tuning. The notes are still the same, but all of your fingerings have to change.

So, as is clear from my various complaints and skepticism, I’m not totally sure how much longer I’ll stick with this. However, I do find—surprise, surprise—that as I get better, I like it more. Despite the negative stuff I’ve written here, in those short bursts of emerging Dvorak proficiency I’ll get every so often (usually until I start thinking about it and make a mistake), it does give typing a different rhythm and feel that is quite nice. You really do spend more of your time with your hands in a comfortable “home row” position and less time with your hands flailing about.

So will I stick with this strange keyboard layout? Or will I give into years of habit and the temptation of properly labelled keys and go running back to the familiarity of QWERTY? Time will tell.

Finally, you may be wondering, did I write this post in Dvorak? Most of it. The first few paragraphs were written in QWERTY, but once I started writing about Dvorak, it seemed only fair I struggle through the whole thing in Dvorak.

Open Source Design

2009-10-19T00:00:00-05:00

I really want to love Linux as a desktop OS. I went through a phase where I had nearly convinced myself to switch, but the UI stuff kept stopping me from taking the plunge.

I should clarify: the GUI kept getting in the way. I’m quite fond of the command line, and think there’s an elegance and beauty to a great command line/console interface. And Linux excels here. But let’s put it this way: while I can appreciate things like ratpoison, I’m not about to spend all day working like that. And sadly, when you move into GUI software, the Linux experience still falls down for me, despite big improvements over the last few years.

It may seem superficial, but little things like how fonts look and consistency between applications matter a lot when you work on a computer all day. As design people like to say: design is how it works, not how it looks. It’s not just that GNOME looks like a cartoon interface, or that KDE looks like an ugly version of Windows, it’s that they actually feel and behave like that, too. (I know, I know: lots of people are perfectly happy with GNOME and KDE. Lots of people are happy with Windows, too. And typewriters and chalkboards, for that matter.)

This is not a new criticism of open source software. Gruber expresses a common explanation for open source usability woes:

The distributed, collaborative nature of open source software works for developer-level software, but works against user-level software. Imagine a motion picture produced like a large open source project. Different scenes written and directed by different people, spread across the world. Editing decisions forged by group consensus on mailing lists. The result would be unfocused, incoherent, and unenjoyable.

Software UI design, the argument goes, requires an auteur, a chief architect with a clear, elegant, demanding vision of how things should work. Steve Jobs is obviously the most popular example these days. Everything that comes out of Apple is Steve. Good and bad. But generally good. At least for most people.

Matthew Paul Thomas, who has written two widely cited essays (one, one) on the poor usability of Free Software, also highlights this problem:

In the absence of dedicated designers, many contributors to a project try to contribute to human interface design, regardless of how much they know about the subject. And multiple designers leads to inconsistency, both in vision and in detail. The quality of an interface design is inversely proportional to the number of designers.

Solution: Projects could have a lead human interface designer, who fields everyone else’s suggestions, and works with the programmers in deciding what is implementable. And more detailed design specifications and guidelines could help prevent programmer-specific foibles.

In other words, decision making over design needs to be more centralized and consistent. Thomas is now working on software usability for Canonical, where Mark Shuttleworth has made improving usability a top priority with the Ayatana project:

The focus of the project is to improve the perception and presentation of information in the desktop, hence the name of the project; the Buddhist term for a “sense base” or “sense sphere.

(Notice the missing quote mark at the end of that sentence. Can’t make this stuff up.)

Punctuation problems aside, this is great to see. Shuttleworth has explicitly said he wants to meet or surpass OS X’s usability, specifically.

Given it’s an open source design project, it’s interesting to see how they’re dealing with this “auteur” problem. The other day, Shuttleworth announced he was starting an invitation-only mailing list for those involved in the Ayatana project. The list will still be publicly archived, so anyone can read but only team members can contribute. He adds:

I’m aware this proposal could result in outrage over barriers to participation. But I think it will be more effective if we try to build a core team that knows each other well and can establish norms and relationships.

Besides, I don’t think effective design would come from purely freeform participation. At the moment, I have final signoff of specifications coming from the design team into Ubuntu. In due course, that responsibility will be assumed by someone in the Canonical design team.

This seems like a relatively modest thing for a design team to want. Of course, it’s controversial.

Actually, having read through the responses on the mailing list, many, if not most, of the responses are positive. But the critical comments are interesting because they really point to the differences in philosophy about how to make design decisions and organize design work. For example:

I think a more closed list will make it more likely that only one vision appears in the code.

Isn’t that the point?

Another suggestion is to create an “Ubuntu Design Board” that will certify particular people with “Ubuntu Designer” status, qualifying them to participate.

Except design qualifications alone aren’t the problem: even highly competent designers can have wildly different ideas of what’s right. And as a user, I’d rather have to learn a single set of principles that work everywhere—even if they’re not the principles I might have come up with on my own—than have a few applications that work exactly the way I like but have every other application work completely differently.

As neither an expert software developer nor an expert interface designer, I don’t really have much else to offer here other than pointing out an interesting debate. One of the reasons I’d love to switch to Linux is that I love the idea of using only open source software. And, of course, the output of the Ayatana project will be open source software. But will they have to disavow a traditional “open source development model” to build that software?

Although, isn’t the idea of an “open source model” kind of a myth anyway? Most of the classic open source success stories that build developer-level tools are still managed, ultimately, by a handful of people. And when they make decisions about the future of the project, because someone has to, they get called dictators too.

The problem with open source usability may be less about an inability to break with some mythical “open source model” and more about the fact that no one has yet stepped forward to exercise the kind of control necessary to make open source interfaces work well. Maybe the “open source way” is just an excuse that gets in the way because everyone has opinions about GUIs compared to, say, opinions about how the kernel should work. So, good luck, Mark Shuttleworth.

Switched to Jekyll

2009-10-07T00:00:00-05:00

A few weeks back, when the latest WordPress Attack was underway, I posted to twitter, “This WordPress attack has me itching to switch to Jekyll. Nice, simple flat files.” I was halfway joking at the time.

Jekyll is a “blog-aware, static site generator”. It’s kind of an old-fashioned idea as far as blogging is concerned. In fact, the very first blogging platform I ever used was called iBlog. It was an OS X application that generated an HTML site on your local Mac and then synced with .mac (now called MobileMe). One of the biggest perceived positives when I switched to WordPress was that it cut out this syncing process: pages were generated dynamically on the web server. This was so cool!

It still is cool, actually. I like WordPress. My paycheck comes from managing a WordPress site. But for my personal blog, I’ve been growing tired of WordPress. Here’s why.

Two kinds of blogging

For the past few years, I’ve been trying to make my blog the archive of everything I do online. I joined Twitter, so I started importing my tweets as blog posts. I use Delicious and Google Reader, so I’ve imported my Shared items from each into my blog as well. The basic idea, really, is that I wanted to do what Tumblr was doing on my blog: make it really easy to post all kinds of content, and display them in a content-appropriate format. It was fun building my own theme and learning how WordPress worked as I went.

There are really two kinds of blogging I’ve been doing: writing and sharing stuff (links, quotes, videos, etc.).

For writing, WordPress has always sucked. So has every other web-based blogging platform though. Writing in a <textarea> just sucks. People put up with it for all the other niceties a dynamic, browser-based interface gets you: comments, access anywhere, plugins, etc. But it sucks. As a workaround, I usually just wrote in a text editor and then pasted the text into WordPress when I was ready. I toyed with blogging clients like MarsEdit but never really enjoyed using them.

This has been made worse by the fact that I’ve been trying to write more lately. I’ve found that when I write more for my blog, I have a much easier time writing for other things. Like the dissertation I desperately need to write. So I decided I needed to write more. Even if it was about obscure guitar hacks, or silly dreams. I just needed to write more.

For the sharing stuff type of post, well, WordPress works just fine, I guess. But because I’d always appreciated Tumblr from the outside, I decided to give it a try, and I really like it. The bookmarklet is smart & works well. The iPhone app is really nice. And I don’t have to use weird custom fields and categories to indicate that a post is a video, or a link, etc.

Plus I actually read through some old posts on my blog. Oh my. On the one hand, it’s nice to have access to this old stuff myself. It’s nice to be able to go back and see progress: I’m a much better writer now. I’m a much clearer thinker now, too. I think. But on the other hand, is this something I really want the entire world to be able to witness as well? Does this really need to be out there?

It is fascinating to subject yourself to this kind of review. For many posts I wrote in 2003 and 2004, I remembered the title and thought, “Oh, I liked this post.” Three paragraphs in: it was like it was written by someone else. Someone else who is stupid and inarticulate. Around 2006-2007, the author of these posts starts to look more like the self I know today. But I have to wonder: in a few more years, will these posts be as bad?

I don’t want to go on about this too much, but I do have a theory for why my writing has improved in recent years: I’ve gotten into audiobooks. Until the last few years, I almost never read something that wasn’t for school. And sociologists aren’t exactly known for being good writers. Now, I’m a total audiobook junky, and I’m pretty much always working through one (and often two at the same time). Now I don’t listen to classical literature or anything that will impress my old English instructors. But it’s still better writing than I can muster, and I really think listening to good writing has helped me become a better writer myself.

So, getting back on track, over the last few months, three things came together for me:

I decided I needed to write more. I didn’t like writing in WordPress.
I decided I wanted a blog for writing and to just use Tumblr for micro-blogging.
I decided I needed to clean out my blog’s archives.

I also realized one other thing: I just wasn’t excited about updating my WordPress theme. Again. If I was going to redo my site again, I wanted to learn something new. Sometime last summer, in a fit of productive procrastination on a lazy Saturday afternoon, I started learning the basics of Ruby. I really liked it, but just had no reason to use it: everything I worked on then was in PHP. So I spent a few hours with it and then moved on. When I looked into Ruby-based blogging software a few months back, I found Jekyll.

jekyll

I’m writing this post in my text editor of choice (vim), marked up in markdown and stored in a git repository I keep in my Dropbox. When I’m ready to publish, I’ll just run git commit and via a post-commit hook, the new post will be uploaded to my web server.

There are several wonderful things about this:

My entire blog is available on all my computers. I can write and edit posts using just plain files and a text editor. If I’m on a computer that is not my own, I can just ssh into my computer at home and write in vim within a terminal window.
When writing (or editing my templates), I can run jekyll on my local machine and view my blog by pointing a browser to localhost:4000. This works no matter where I am, how flaky my network connection is (or how slow my web host is at the moment).
To search my blog, I can just grep through my _posts directory. How cool is that?

If you aren’t following this so far, Jekyll probably isn’t for you. Go use Tumblr. Or posterous. Or wordpress.com. Seriously, the world is not short on good blogging software.

Jekyll is “blogging like a hacker”. This doesn’t mean it’s necessarily hard to use though. The templating is lightweight, but powerful & flexible enough to do most of what you need with a blog. It’s definitely easier than writing a WordPress theme! Writing in Markdown is much easier than writing in HTML or, IMO, than fighting with a stupid WYSIWYG editor (I’ve never had luck getting any of the WordPress Markdown plugins to work).

Also, the culture and community around Jekyll is great. Github supports Jekyll sites, so there are many Jekyll sites hosted on github, with full source for all to see. Putting together this site was as simple as browsing through those sites, finding things I like and then borrowing profusely. ~~I intend to put this blog on github as well soon, but I need to clean some stuff up first.~~ The source for this site is here on github. (I just put the configuration and templating files up, skipping the _posts, _drafts and files directories. You can actually host your Jekyll blog on github, which I may or may not do someday. I still use my web host for other things, though I do like the idea. In the meantime, I don’t want to push everything I do to github.)

There are downsides. No comments, for example. I could use something like Disqus, but I don’t really mind not having comments. (It’s not like I had a ton before anyway.) If you want to respond, just write a blog post yourself & link back. Or email me if you want to reply to me directly. We’re really not hurting for avenues of communication these days.

moving from wp

So returning to my tweet at the beginning of this post, I decided to actually try Jekyll on my MacBook, just to see if I’d like it. (The security issue really wasn’t a factor: it just inspired the tweet, which inspired another look at Jekyll.) Within 20 minutes, I had a basic test site running on my MacBook. Next I tried the Wordpress importer and, well, then I had all my posts imported. Well, I might as well switch at that point, right?

(Though, to be complete in case would-be switchers find this post: 1) The MySQL and Sequel gems required for the converter wouldn’t play well together for me on my Mac, but worked just fine in an Ubuntu VM. 2) The WordPress converter doesn’t import categories and tags.)

Really, that’s pretty much how it happened. An unintentional side effect of importing all my posts into Jekyll is that I now had nice plain text files of all my posts, which made reading through them and removing the ones I didn’t want to keep much easier than it actually would have been in WordPress. Plus, I now still have them all in a separate directory, in a completely readable format instead of in a SQL file. After I’d done that, then all of the sudden my Jekyll blog was more up-to-date than my WordPress blog, so I’d sort of already switched without realizing it.

Cleaning out the old posts took awhile, and then, of course, I spent a lot of time tweaking the site in my spare time over the last week or two. But I’m happy with this so far. When I feel up to tweaking the site a bit, there’s a lot of stuff to learn. Stuff that doesn’t start with wp-, and that’s exciting. But when I feel like just writing without distractions, this should work well then too.

Sexism, Software and Organizations

2009-09-12T00:00:00-05:00

The lack of women in open source software has been getting some attention lately, and the numbers are pretty shocking:

According to Angela Byron’s keynote at the Open Web Vancouver conference earlier this year, women compose 28% of those involved in proprietary software, slightly more than half what you would expect from a random distribution.

Asked to guess what percentage of FOSS developers are women, mostly people guess a number between 30-45%. A few, either more observant or anticipating a trick question after hearing the proprietary figure, guess 12-16%. The exact figure, though, is even lower: 1.5%

So, just to be clear, there are two issues here: Why are there less women than men in programming generally? And why is the proportion of women so much lower in open source software than in proprietary software? The second question is what I’m writing about here.

Byron’s keynote (PDF) lists four reasons why open source may be specifically hostile to women:

Anonymity can create a safe haven for abuse
Open source can be combative
Common perception: you must be Einstein to contribute to open source
OMG! A GURL!!!

I’ll suggest a fifth. At last year’s ASAs, Dan Hirschman and I were talking about how the informality of OSS could be part of the problem. (I say we discussed it, but I remember all of the good ideas coming from Dan.)

Much of the commentary on this topic seems to revolve around the personalities of open source developers or the culture of particular communities. But a big, obvious difference between community-run open source projects and proprietary software produced by for-profit corporations is that they’re controlled by very different types of organizations.

Large businesses and organizations put formal hiring and promotional policies in place. Yes, they have formal policies with respect to racial and gender diversity, but it’s more than just those specific policies. When informal criteria weigh more heavily in hiring and promotion, in-group biases have more of an impact (think “Jack’s one of the guys,” vs. “Jill just doesn’t fit in here”). Even if the people involved deny explicit bias (“It’s not because she’s a women she doesn’t fit in!”), people tend to prefer people like them. This is particularly true in jobs with a more informal work environment. Think of businessmen hammering out deals on the golf course, or schmoozing clients with box seats at the big football game. Or two geeks chatting on IRC at 3 a.m. Or filling a conference presentation with crude images in an attempt to be “edgy”.

Byron suggests some ways to make OSS more conducive to female participation, and others have made suggestions, too. Here’s another thought though: as open source software increasingly becomes big business, with large corporations like Google, Oracle and IBM supporting much of open source software development, the pathways to get involved with open source projects will become more structured and formalized, and this will diversify OSS. In other words, “Oracle is looking for a full-time MySQL developer” vs. “Just email this patch to that nerdy white guy who looks exactly like all your friends.”

I’ve always been interested in—and sympathetic towards—attempts to create less hierarchical, bureaucratic and informal organizations. This is part of the reason I’m a big fan of open source software. It’s also one of the reasons I’m fascinated and frustrated by the weak spots in these kinds of organizations and communities. The idea that a takeover by big bland corporations could actually diversify OSS would probably rub most open source folks the wrong way as well. They pride themselves on being free, open and all that good happy stuff. But sometimes, paradoxically, these inclusive values can actually foster social arrangements that facilitate exclusion.

WordPress Feed Modifications

2009-09-04T00:00:00-05:00

Awhile back I modified the titles in my RSS feeds to display "link:" or "tweet:" to my linklog/twitter posts on this blog. A bit later I decided to add Creative Commons license info in my feed as well. I know there are several existing plugins that do that, but I already had a plugin of my own that did some feed modification so I was familiar with the relevant WP hooks, so I went ahead and added this to my existing feed plugin myself.

Today I wanted to add yet another feed modification: add a link back to the original article to the end of the post content on each of my posts. A common reason to want this is to prevent (or at least inconvenience) scrapers. I wish I were that popular. My problem's much simpler: I wanted to put my blog posts into Facebook, as sadly Facebook is apparently a bigger draw for most of my friends than my blog is. (I know, I don't get it either.) For awhile I was using the Wordbook plugin, but it screwed up one too many times on me, so I opted to just let Facebook's Notes import my RSS feed, which is super easy. However, Facebook Notes don't link back to the original source at all. Just looking at my Facebook Notes, there's no way to know it originally came from my blog. I obviously don't care whether my friends read my posts on my blog or in Facebook, but I'd still like them to know about it. Plus, unlike Facebook, I actually control my blog. In five or ten years, I'll still control my blog. So whatever I write, no matter how silly & meaningless to anyone else, the master copy belongs on my blog. So I wanted to add a simple link to the end of the posts that would show up in the Notes.

Again, I know for a fact there are several plugins that do just this (likely with way more flair), but just adding a plain ol' link is simple enough to do, so I took the DIY route again.

So for anyone interested in either of these modifications that prefers a do-it-yourself approach to plugins, I thought I'd post both of these very simple modifications. If you're just learning how to write WordPress plugins, these actually make pretty good examples as well precisely because they're so simple. So just create your plugin file and then add one or both snippets of code below. (Or just go to wordpress.org and download the existing plugins that are probably better supported by their authors and have way more options...)

Append a link to your RSS content

This will add a link at the end of your post that says "(Originally published at http://yourblog.com)" and links to the permalink for the post. Here's the code:

Notice the comment about the bug where the_content_rss isn't applied to the content in RSS 2.0 & Atom feeds. This is slated to be fixed in 2.9, so if that happens you could just keep the add_filter('the_content_rss', 'append_to_feed') and delete everything else in run_append_filter().

Add a Creative Commons license to your feed

I chose the by-nc-sa license, but you can use whatever you want by adjusting the $feed_license array. You'll definitely want to change $feed_license['years'] as well (unless you happened to have started your blog in 2003 like me). The code is long, but simple and repetitive. All the formats have their own little twists, which is a huge pain in the ass. Anyway, here's the code: