Pocket Revolutionary

Know your audience. Easily the best advice I’ve heard as a writer from the likes of Merlin Mann and John Gruber, but I am  just now realizing that I’ve been too simplistic with my interpretation. I’ve known that I needed to imagine this individual at the other end, but I didn’t fully recognize until now that I’ve been mentally shifting audiences as I move between the blog and the book; it’s honestly been driving me a little crazy.

I love to write blog posts because my ideal reader is a clone of me on the other end. I enjoy my writing style, and I like most of my jokes. I would probably read my blog, except that sometimes I get a little long-winded and I would need Instapaper to help me finish the job on my couch. I also write really long sentences. Somehow, I thought this great feeling would translate to my book.

Unsurprisingly, writing the book has felt much more like slow torture because… well, because I don’t actually enjoy reading it as much. For one thing, I’m not nearly as snarky or personal. I have no illusions; most readers of my book have probably not seen every episode of She Spies and don’t really care how clever I think I am with obscure references that could shame Dennis Miller. On top of that, I’m (obviously) writing mostly about junk I already know. I’ve learned a lot while writing, but I’m still pretty exhausted with TypoScript conditionals before I ever start typing that first draft. At this point, reading thirty pages on browser-checking and boolean logic sounds like hell as a reader.

Here’s my great revelation, though: It doesn’t matter. I am not the ideal reader of my own book in this case. This is my ideal reader:

A combination of Andy Ihnatko and the version of me from four years ago. Technically, my goal is to teach all the stuff that I wish I could have easily learned from one (hopefully) well-written book when I first started TYPO3. In fact, I wish I had understood a lot of this just six months ago, but I already explained that I’m researched-out and sick of this knowledge at this point. As far as my voice, I would like to entertain Andy Ihnatko. In my imaginary world, Mr. Ihnatko decides to give up his career as a freelance journalist and pursue the much less stable career of a freelance web developer. Naturally, he picks TYPO3 as a good platform (he has good taste) and goes looking for the best book on templates that he can find. When he finds out the best book is probably written in German, he buys my book instead. Obviously, he enjoys my book immensely after reading it and recommends it on MacBreak Weekly even though it has nothing to Apple. I enjoy Andy Ihnatko, and I think he would appreciate my subtle sense of humor. As a bonus, he seems generally congenial, and I don’t think he would mind too much if my book wasn’t perfect. I love John Gruber and Merlin Mann, but I would be afraid to show them my slightly-flawed writing efforts. Andy would probably at least humor me and still get something out of it to help him build his new business as a hot shot developer.

Anyway, that’s my ideal reader, and I’m learning to be okay with the fact that it isn’t me. If I have to explain something a little too much, I resolve to stop getting frustrated. I’m writing to the version of me that didn’t know TYPO3 that well and the imaginary Andy Ihnatko that is becoming a TYPO3 developer; I’m pretty sure they appreciate the extra explanation of data structures that I added to the end of that last chapter.

First off, I just want to verify that I’m still alive. Writing a book in your “spare time” is an exercise in self-torture spread out over many months, but it is coming along. I’m finally over halfway through as I work on chapter 7. Throw away all of your preconceptions about how you can modify the rich-text editor interface in TYPO3. Oh, you don’t know what I’m talking about? Fine. Well, if you had some preconceptions about some very technical junk in TYPO3, I would be shattering them. You would be shocked. Shocked.

Aside from my attack on the bourgeoisie of TYPO3 templating, I wanted to mention my big new adventure: Vintage 56. Yes, although I may hate the escapade that was freelancing (on the side), I’m really excited about getting to form an honest-to-goodness production/design agency with some great people that I’ve worked with at Generals International for years. Basically, we’ve figured out how to make our own mark doing web, iPhone apps, graphics, video, and audio production with clients we love and help out a ministry by donating a large portion of our profits to Generals. Actually, we’re helping a lot of ministries and medium-size companies right now because they’re getting the full agency treatment without the full agency budget. Basically, I get to work with really talented people, and I wanted to brag on them. You can check out http://vin56.com to see what I’m talking about (yes, the video works on iPads, iPhones, and iPods).

p.s. – You need to check out our graphic designer’s blog…  she’s awesome.

p.p.s. – We will be launching another blog for Vintage 56 soon, but I’ve been slacking off– writing a frickin’ book. Stop pestering me. Seriously. I need to go.

I am officially working on my first dead-tree book. I know I technically spilled the beans on Twitter at the end of last week, but this is my official announcement. I was approached by Packt publishing a couple weeks ago to see if I would be interested in writing a book on building and pimping out (not their words) templates in TYPO3. I decided that I’ll never know how little sleep I can live on until I really push it and accepted the challenge. So, over the next six months, I will be writing, screaming, crying, and having at least a couple breakdowns just so I can officially say that I’m a published author. I can only imagine that as a published author I’ll be able to raise my hourly rates, fly first class, smoke a pipe with gusto, and generally live a life of leisure and self-imposed solitude. I haven’t decided who’s going to play me in the movie, yet, but I’m leaning towards Lyle Lovett or a very disgruntled Randy Newman.

How does this affect this blog that I’ve been trying to write in more consistently? Well, I’m forcing myself to write an extra hour a night, and at least every once in a while that has to mean something other than “the book”. In fact, in the interest of writing a clear instructional book, I will be channeling 90% of my snarkiness, obscure cultural references, and general temperament toward outlets like this and the occasional telemarketer. The remaining 10% will probably make it into the book in a much more palatable dosage. On the side of helpful effects, though, this will give me more experience writing genuinely instructive articles. I’m already planning on blogging my process a little for those who haven’t already read the thousands of blog articles covering the same topic (I promise, I’ll offer something different…  like what word processor and meth dealers I use for late night working).

Since Packt successfully owns the English-language market on TYPO3 books, I’ve defaulted to buying about a half-dozen of their books over the years. In fact, I’ve talked to them about my own book that could one day be announced. I’ve had some mixed results with their books at times (non-native English can be scary), but I was still a little giddy when they contacted me and asked if I would write a review for their newest book, TYPO3 4.3 Multimedia Cookbook by Dan Osipov. I mean, I like TYPO3, multimedia, and writing content for my site. Score! So, it got here yesterday, I dutifully read it, and I can definitely say, “yeah, it’s a cookbook.” That’s not good or bad, it just is. If you aren’t going to read this whole review or are already bored with me, here’s the snapshot review: If you have written some extensions and just need a bunch of “recipes” for integration with audio, video, Flickr, S3, and YouTube, then it’s probably not a bad thing to have this on your shelf; if you want to learn the concepts behind the code, I’d check out TYPO3 Extension Development by Dmitry Dulepov.

Now that we’ve eliminated the lazy readers, let’s get down to business. TYPO3 4.3 Multimedia Cookbook is, like you would guess, essentially 200 pages of little extensions, TypoScript tips, and server hacks for sites with audio, video, images, and pretty much everything that’s not text. It says that it’s aimed at “anyone running or starting a website with multimedia” and recommends “prior knowledge of TYPO3”. That’s pretty vague, but it kind of sounds like everybody with a TYPO3 site to me.

In reality, I think the target they hit was a lot smaller. To actually understand what’s going on, you’re going to want some extensions under your belt. One of my only real problems with the book is that it’s supposed to be targeted at people with “prior knowledge of TYPO3”, and that sounds way too broad compared to who will actually get much out of it. Honestly, I would recommend having some real extensions (with actual PHP you’ve written) under your belt before attempting almost anything in the latter half of the book. If you’re only copying and pasting you can probably make it through without a lot of experience, but— hold on, I need my soapbox for this — you should never, never, never (and I mean never) be copying and pasting code that you don’t fully understand into a real site. If you buy this book thinking that it’s going to explain everything you need to know about API integration, you will either react as a good developer or a very bad developer. If you react like a good developer, you’ll be inspired by the power you can wield with a few tricks, spend some time getting caught up and understanding every command Dan uses, setup a test area, and come back to implement some of these later when you’re wiser. If you react very, very wrong, you’ll go ahead and start pasting code with very little explanation (unfortunately) into a site that you care about. That’s the end of my rant. I think they should have specified the target audience a little more judiciously, but we will all live another day.

Now that I’ve ranted, I’ll say that the rest of the book delivers for anybody with the right experience (or willingness to read other books for understanding). Like I said, it’s very spotty on when it decides to explain more about any subject, but you really can’t expect much more from a cookbook. The first chapter explains setting up a web server from scratch, multithreaded servers, and some concepts that would probably be best studied elsewhere, but the next half of the book really explains file management, editing in the RTE (rich text editor), and basic work with audio and video in good detail. Part of the dichotomy is that those chapters are well-written and complete, but anybody with the experience to read the last few chapters probably doesn’t need help adding images. For the experienced, though, the last few chapters provide some good code for S3, Flickr, YouTube, OpenOffice, services, automation, and even geolocation.

Overall, I’ll be happy to have it on my bookshelf. I will use it to help generate some ideas, grab the occasional snippet of code, and I’ll be happy. If that’s the book you need and you’ve hacked your way through some real TYPO3 extensions before, I’d probably recommend it. It’s “bookshelf candy” for me: not general enough for my desk, but specific enough be necessary when I need to reach for it. The price seems a little high for 200 pages; but remember that, like most cookbooks, you’re paying for the fact that it’s been collected and compiled. No single chunk is worth much more than a free Google search, but a whole collection is just plain handy. You can check it out on Packt’s website (I get no kickbacks).

Packt Publishing released a new TYPO3  book, TYPO3 4.3 Multimedia Cookbook, and it looks interesting. Dan Osipov, the author, is evidently on the team for the DAM (Digital Asset Management) TYPO3 extension, so I’m looking forward to it (even though I don’t use DAM anymore). I know I’ve already solved a lot of these problems for sites I’ve worked on, but I’m interested to see somebody else’s solutions. I’ll have to wait to until my review copy gets here to dive into it, but you can check out more information at Packt.com.