The Good Revolution: The Book is Dead!

I chuckled at Mark Baker’s recent post where he surmised that The Reader is the Enemy because I agreed that the cues he listed all do seem so damning (haven’t we all said or heard, “grab the reader” and “hold their attention”?).

While Mark reminds writers how we often speak of readers as enemies, there’s the comic strip character Pogo reminding us, “We have met the enemy, and he is us!” And that’s a good thing because we ought to be self-policing our own work, being as critical about our craft as we presume our reader enemies to be, testing our products in their shoes, if that were at all possible. When we fail to empathize with our readers, we fail them. But there is more than this behind the tension between writers and readers.

Continue reading

Share
Posted in collaboration, publishing, social media, XML | Leave a comment

Creating DITA topics with a blog or wiki

I’ve decided to conclude my explorations of alternative DITA writing approaches with a discussion of how existing blogs or wikis can be pressed into service, at least for intial content creation (often the hardest “first mile” in getting knowledge out of the minds of subject matter experts in a company and into a repurposable form). Whereas the expeDITA project demonstrates how to create a blog or wiki with DITA as native source, here I explore the other path–using common collaboration tools to create content that can be exported relatively easily as DITA.

Continue reading

Share
Posted in blog, collaboration, publishing, Uncategorized | 1 Comment

Creating DITA with HTML forms

The pattern of “What isn’t DITA?” is familiar: if a text object of any kind has a title and optionally some kind of descriptive content, it is transformationally analogous to a simple DITA topic. The observation is important because it opens up a wide range of ways in which initial content for DITA repositories can be created. Today, we’ll examine the use of HTML forms for particular recording scenarios.

Continue reading

Share
Posted in Uncategorized | Leave a comment

Dictation for structured writing

I enjoy writing about how to do more things, more easily with DITA. After many years in the structured writing field, I’ve come to appreciate the versatility and usability of the  validating editors that support DITA so well. But I’ve been surprised recently in rediscovering the usefulness of dictation for initial content input for structured document formats–DITA tasks in particular.

Continue reading

Share
Posted in DITA, DITA adoption, migration | Leave a comment

Creating DITA topics using Twitter

I am creating today’s topic by dictating the content directly to my cell phone. A dictation application allows me to construct the structure in the resultant topic. I’m thinking of calling this concept DITATwita! ;-)

Continue reading

Share
Posted in Uncategorized | 1 Comment

Creating DITA topics using email

To: e-dita <e-dita@lbyw.co>

Subject: Creating DITA topics using email

Date: 7 April 2011

As you begin to sip your “half double decaffeinated half-caf with a twist of lemon” at your favorite coffee/internet bar, you suddenly get a brilliant blog idea that you want to jot onto a paper napkin, but your pen is out in the car. But one click away on your laptop is your email application. You open it, start a new mail, address it to your dedicated e-dita address, type in your subject line, and start drafting your idea into the body of the note. Press Send, and within moments your brilliant idea shows up posted as an editable DITA topic back at the server.

Continue reading

Share
Posted in DITA, DITA adoption, publishing, XML | Leave a comment

Creating DITA topics using reStructuredText

To a writer whose only tool is a flat text editor, formatted text is the next best thing to a real DITA editor.

Share
Posted in DITA, migration, wiki | 6 Comments

Creating DITA topics using your cell phone

Back before inks were invented, engraving was the main form of writing. You formed a tablet out of clay and used a stick to impress something that looked like “<LT>” on the surface, and there you had it: primitive markup. Photography is a modern form of leaving a mark without ink, so today we are going to explore how to create a DITA document using a cell-phone camera as your XML editor.

Continue reading

Share
Posted in DITA, humor | 1 Comment

Creating DITA maps using outliners

As long as you have a browser, The Cloud is your friend. I’ve previously described the potential role of OPML-based outlining tools for DITA map editing in a browser, but a recent DITA Chicks post by Karen Lowe on creating DITA maps using spreadsheets got me to wondering, “If the only tool I had was a web-based outlining tool, what could I do with it?”

Continue reading

Share
Posted in DITA adoption, map editing, Uncategorized, XML | Tagged , , , | 4 Comments

What isn’t DITA?

Move over, “age of miracles and wonder.” It seems that everyone is having epiphanies these days. I can teach you how to have one, as well. It’s just a matter of concentration and visualization!

Continue reading

Share
Posted in Uncategorized | 4 Comments