Archive for the ‘Humor’ Category

Finding the blogging superhero in yourself

February 3rd, 2010 by Alan Pringle

Power blogger.

That’s a new phrase to me, and it was new to Maria Langer, too, as she noted in her An Eclectic Mind blog. As part of a podcast panel, she was asked to offer advice on how to become a power blogger. Some of her fellow panelists mentioned the quantity of posts, but Maria’s focus was elsewhere:

The number of blog posts a blogger publishes should have nothing to do with whether he’s a power blogger. Instead, it should be the influence the blogger has over his readership and beyond. What’s important is whether a blog post makes a difference in the reader’s life. Does it teach? Make the reader think? Influence his decisions? If a blogger can consistently do any of that, he’s a power blogger.

I couldn’t agree more. I appreciate reading any blog that gives me useful information or analysis that hadn’t occurred to me. For example, I recently had issues with a new PC I’m using at home as a media center. It was not picking up all the channels in my area, and an excellent blog post helped me solve the problem with little fuss. To me, that author is a power blogger.

What I frankly find irritating—and certainly not my worth my time—are blogs that are basically what I’ll call “link farms”: posting links or excerpts from other blogs with no valuable information added. I’m quite the cynic, so when I stumble upon such a blog, I figure the blogger is merely trying to generate Google hits and ad revenue, is lazy, or both. Quantity—particularly when said quantity is composed of rehashed material from other bloggers—does not a power blogger make.

When it comes to contributing to this blog, I try to write posts that have a least one nugget of helpful information, analysis, or humor, and I think that’s true of the posts from my fellow coworkers. (At the risk of sounding like I’m bragging about my coworkers, I can’t tell you how many times I’ve read one of their posts and thought, “That’s smart!” or “That’s cool!”) Frankly, I’d rather not write anything at all than to publish something just because it’s been a few days since I posted. And I have a lot more respect for bloggers who write quality posts once in a while over those who put out lots of material that is borrowed from elsewhere.

And on that note, I’ll leave you with a short clip showing superheroes using their powers for a practical solution. (See, I’m trying to entertain you, too!)



New White Paper: Configuring fonts in FOP and DITA OT

October 19th, 2009 by David Kelly

We recently updated a new instance of DITA OT 1.4.3 to create PDFs of Scriptorium proposals from DITA source files. We wanted to emulate the original proposal template, which included a lot of fonts that were not configured in the DITA OT’s PDF rendering engine, FOP.

Remembering the nuances of font configuration for FOP turned into a lengthy exercise. After seeing requests for help on configuring fonts in the DITA user’s group forum and FOP’s Nabble forum, we decided to publish a white paper addressing the subject. It covers FOP configuration, DITA OT configuration to use FOP-configured fonts, and how to reference configured fonts in the DITA OT’s XSL-FO style sheets.

The white paper is now available here:

Scriptorium White Papers

Hopefully it will help prevent ugly little font scenarios like this one:



Lessons learned on the way to the office

October 12th, 2009 by Sheila Loring

In what now seems like a previous lifetime, I began my college career studying fine art. I chose this program because I’d been drawing incessantly for years and managed to secure an art scholarship. I had no idea what I would do with the degree, I just knew I loved drawing and studying art history.

I specifically remember the turning point in my college career as an artist. The assignment was to draw a supersized version of any object. For some reason, I chose a hamburger. (More on that choice later.) So I took great pains to capture every detail–fresh water drops on the lettuce leaves, the oozing slice of cheese, the thick, juicy meat patty, the sesame seeds on the bun. I thought it looked pretty realistic.

Photo by Rob Owen-Wahl
Rob Owen-Wahl / stock.xchng

The instructor’s assessment haunts me to this day. He said it was the most disgusting, unappetizing hamburger he’d ever seen. (He was NOT a good professor.) My classmates froze in silence, hardly believing his cruel response to a fledgling artist’s precious work. I was heartbroken and humiliated. After such a traumatic event, no wonder I became a vegetarian.

That was a turning point for me. I decided to switch majors to English literature because I loved to read. Again, I had no idea what I would do with an English lit. degree, which is not an uncommon situation. If you took one class in English lit., you know how many essays students have to write and the “valuable” feedback one gets from the professors. That experience prepared me for what would come later.

Years after graduating and working in dead-end jobs, I made my way into technical writing and consulting, and the rest is history. Now I get feedback from editors and customers, and it actually is (mostly) helpful. Plus, I get to learn about new tools and technologies on a regular basis and hang around with other cool technical writers.

Am I ever glad I switched majors.



你好中国 A foodie foray in China

October 1st, 2009 by Ethan Duty

Most of the time, the folks at Scriptorium get to travel for conferences. We fly hither and thither to give presentations and talk to you from our booth. Every so often, we get to travel simply for the joy of it.

For two weeks in September, I toured Beijing, Hangzhou, and Shanghai with my in-laws. The sight-seeing was wonderful, but the food was even better. Here are a few foodie highlights from the trip:

This photo was taken in Huangzhou at a restaurant by the West Lake. The local specialties featured in this meal are: clay roasted duck (top), watershield soup (top right), tea flavored shrimp (center), and braised pork (the little red container on the right).

These buns came from a dimsum restaurant in Shanghai. Here you can see sticky rice with egg custard (top left), red bean buns (top right), vegetable dumplings (bottom left), and some very attractive sticky buns filled with more custard (lower right).

One of the things I love about Beijing is you can eat at about any time. This photo was taken at an outside restaurant around 11pm. The meal featured meat buns, vegetable buns, boiled peanuts, seaweed and tofu, boiled soy beans, and a huge pile of lamb skewers.

While the local cuisine was absolutely superb, Americans dining in China will be hard pressed to find dessert items or dairy products.

If you know of a good place to pick up cheese cake in Beijing, let me know.



Lost in translation (and in my brain)

July 23rd, 2009 by Alan Pringle

Last night, a bit of spam managed to worm its way through the filters on a personal email account, and I have to admit I glanced at the content while scanning previews of messages. That’s when I spotted a paragraph that really jumped out at me:

They have good management systems, product quality inspection system. And international speedboat (EMS) is the door – door accurate! Soon!

My thought process was, What’s up with the international speedboats? And why are emergency medical services (EMS) using these speedboats? I knew that the person who wrote the content was likely not a native English speaker, but I could not figure out what the writer was trying to communicate.

This morning, I finally realized what the message was trying to say: the company uses EMS worldwide delivery services for prompt and accurate delivery to my door. My brain must not have been firing on all cylinders last night when I thought EMS meant “emergency medical services.”

I don’t think I’ve ever spent as much time thinking about a company’s marketing message, but my thoughts weren’t about using the company’s services–I was merely trying to comprehend the message itself. That’s not what the company intended, I’m sure.

Marketing for a global audience–particularly one that associates EMS with “emergency medical services”–is not an easy thing!



More cowbell!

June 4th, 2009 by Sarah O'Keefe

About a year ago, we added Google Analytics to our web site. I have done some research to see what posts were the most popular in the past year:

  1. The clear winner was our FrameMaker 9 review. With 21 comments, I think it was also the most heavily commented post. Interestingly, the post itself is little more than a pointer to the PDF file that contains the actual review.
  2. InDesign CS4 = Hannibal post, which discussed InDesign’s encroachment on traditional FrameMaker features.
  3. A surprise…a post from 2006 in which Mark Baker discussed the merits (or lack thereof) of DITA in To DITA or not to DITA

Our readers appear to like clever headlines, because I don’t think the content quality explains the high numbers for posts such as:

We noticed this pattern recently, when a carefully crafted, meticulously written post was ignored in favor of a throwaway post dashed off in minutes with a catchy title (Death to Recipes!).

For useful, thoughtful advice on blogging, I refer you to Tom Johnson and Rich Maggiani. I, however, have a new set of blogging recommendations:

  1. Write catchy titles
  2. Have an opinion, preferably an outrageous one
  3. More cowbell