Stuff

Essentials

  • Sign up for Leather Penguin Publishing News

    * = required field

    powered by MailChimp!
  • Categories

  • Social

  • Our Fearless Leader

    Tim "TC" Lynch

Dynamic content filtering with OxygenXML’s webhelp output

One of the little tricks I’ve implemented with OxygenXML is dynamic content filtering. Our product supports four different programming languages – Java, PHP, C++, and .NET. Rather than producing 4 separate outputs, I produce just one output and provide a content selector option in the header.

Here’s a demo in my DITA QRG site.

dynamic

(Read more...)

The Evolution of Technical Writing

This is a sponsored post by Nicole Smith on the history of technical writing. I don’t often publish sponsored posts, but I think Nicole’s essay provides a brief yet informative history of the tech comm profession that is worth reading.


The Internet has revolutionised communication completely, but this is especially apparent in technical writing. How (Read more...)

Add a mini-TOC to your OxygenXML webhelp topics

A while ago, I posted a tip on adding collapsible sections to the OxygenXML webhelp output. Collapsible sections have their place, but more commonly now, users seem to prefer long pages that they can scroll. For this behavior, it’s better to add a mini-TOC near the beginning of the page that lists the sections on that (Read more...)

Impressions from my first Write the Docs meetup

writethedocsI attended my first Write the Docs meetup last Thursday night in downtown San Francisco. It’s interesting to compare Write the Docs with the STC. (I was downtown at an STC SF meeting just the previous month, if you recall from an earlier post.)

What are my impressions? In general, the Write the Docs (Read more...)

Back to Top | Comments Off

Flat file systems versus database models for help

In Goodbye WordPress: 2014 Will Be the Year of the Flat-File CMS, Jeremiah Shoaf argues for the upcoming dominance of flat-file systems over database-driven sites such as WordPress.

I found the post extremely interesting because I’ve been moving back and forth between flat-file systems and database systems with my DITA publishing strategies. There are compelling (Read more...)

Back to Top | Comments Off