Articles by Tag

API

API docs in DITA and Markdown

March 05, 2016

I spoke in London at the Write The Docs mini-conference on Documenting APIs hosted by the UK’s Government Digital Service, the team behind the GOV.UK website.

Air

Adobe Technical Communication Suite 2

January 23, 2009

Adobe launched Technical Communication Suite Version 2, with Photoshop CS4 and Presenter 7 along with updated versions of the apps in the previous version.

Adobe RoboHelp Packager for AIR

April 28, 2008

A new Adobe Labs download allows you to roll a RoboHelp project into a standalone app that runs on the Adobe Integrated Runtime (AIR) platform.

Aptana

Aptana Studio 1.0 Released

October 30, 2007

The open source Web development environment formerly known as the Aptana IDE has been re-christened as “Aptana Studio” and released as Version 1.0.

Aptana Milestone 9 Released

August 28, 2007

A new version of Aptana updates PHP support with Code Assist on PHP functions and parameters, improved PHP syntax colorization, and a PHP outliner.

New Aptana Build + iPhone Plugin

June 29, 2007

A new version of the Aptana IDE is available with a new colorization engine, Eclipse Monkey support and “tons of enhancements”.

Aptana — The Web IDE

June 11, 2007

Aptana is a new open-source web development IDE for building, editing, previewing and debugging HTML, CSS and JavaScript websites.

Automator

Snow Leopard Services: Set ZIP File Date

November 22, 2009

With Mac OS 10.6 Snow Leopard, you can create a system service to compress files or folders and set the ZIP file modification date to the date of the contents.

Automator Workflow: Set ZIP File Date

October 18, 2007

When you compress a file or folder in the Finder via the Create Archive command, a ZIP file is created using the current date as modification date.

Bit Literacy

Book Tip: Bit Literacy

August 07, 2007

If you’ve ever struggled with the volume of bits that require your attention every day, a recent book by Mark Hurst of Good Experience may help.

CHM

iChm Adds Index Search

September 04, 2008

Keeping up the pace of nearly weekly releases, iChm Version 1.3 now allows you to search the index.

iChm Adds Index Support

August 27, 2008

Shortly after the release of iChm 1.1.1, Robin Lu has responded to popular demand and updated his CHM Reader for Mac OS X with support for indexes.

Spaces in HTML Help Project Paths

March 18, 2008

Like so many other applications, Microsoft’s HTML Help Workshop often chokes on project files whose paths contain spaces.

CHM Viewers for Mac OS

October 24, 2007

A handful of open source & shareware apps provide Mac users access to Windows help files in the Compiled HTML Help (CHM) format.

Error opening CHMs on a network

June 28, 2007

Microsoft security “fix” 896358 prevents display of content in CHM files opened from a network. Workaround: Use UNC file paths in links or move your CHMs.

CI

CSS

CSS Redundancy Checker

August 27, 2007

Tom Armitage has built a CSS Redundancy Checker that scans a CSS file for selectors that are not used by any HTML files in a specified directory.

CSS Framework YAML 3.0

July 17, 2007

“Yet Another Multicolumn Layout” (YAML) is an XHTML/CSS framework for creating CSS-based float layouts.

CVS

VMware Fusion 2.0 and CVSNT

September 18, 2008

VMware released its Mac virtualization product with an extremely annoying incompatibility — it won’t work properly with Windows systems running CVSNT.

Moving (renaming) Files in CVS

September 05, 2008

Once of the main complaints about the CVS version control system is that it’s difficult to move or rename files as your project structure changes.

Conferences

tekom for Runaways

November 11, 2007

At the tekom conference this week, English presentations were featured prominently as the organization strives to build an international reputation for itself.

Copywriting

Wire. Great conversations.

December 04, 2014

For the past year, I’ve been working with many of the original team behind Skype to launch a new messenger called Wire.

Cornerstone

DITA

DITA Users September Meetup

September 08, 2017

Join the DITA Users Berlin meetup on September 27 to learn how HERE Technologies tests and validates DITA docs with open-source plugins for DITA Open Toolkit.

DITA Open Toolkit Docs Process

November 14, 2016

At DITA Europe this year, I’ll be speaking about how the DITA Open Toolkit project uses DITA features and open-source tools to build the toolkit documentation.

API docs in DITA and Markdown

March 05, 2016

I spoke in London at the Write The Docs mini-conference on Documenting APIs hosted by the UK’s Government Digital Service, the team behind the GOV.UK website.

DITA Users Berlin meetup

February 22, 2016

Join our first meetup to learn how Markdown can help you to simplify the authoring process and gather input from contributors who are less familiar with DITA.

Roundtripping DITA–XLIFF Conversions

June 03, 2015

At the XLIFF Symposium in Berlin, I showed how to transform XML files from the Darwin Information Typing Architecture to a single XLIFF file and back.

Marking Down DITA

April 30, 2015

On the rise of Markdown as an alternative input method for DITA projects.

Contributing to the Toolkit via GitHub

November 20, 2014

Now that the DITA Open Toolkit is hosted on GitHub, it’s easier than ever to contribute changes to the DITA-OT source code or the documentation.

DITA-OT Documentation Repository

November 19, 2014

At DITA Europe in Munich, the DITA Open Toolkit contributors split the toolkit documentation into a dedicated repository to make it easier to contribute.

DITA-OT: Scaling Images in PDF Output

March 14, 2010

When generating PDF output via DITA Open Toolkit, users often stumble over image scaling issues. You can make images fit by setting dimensions and resolution.

DITA-OT 1.5 Milestone 10

January 21, 2009

Today Robert Anderson announced the availability of Milestone 10 of the DITA Open Toolkit version 1.5.

Customizing PDF2 Output

January 15, 2009

When building PDFs for different products with DITA Open Toolkit, you can store customizations in separate folders and reference them with customization.dir.

DITA for WordPress

December 12, 2008

Claude Vedovini has released a set of plugins for the DITA Open Toolkit and WordPress that allow you to publish DITA content to a WordPress site.

RenderX XEP Setup in oXygen

August 07, 2008

Recently, a client asked how to set up the RenderX XSL FO processor to transform DITA maps to PDF with oXygen XML Editor on Mac OS X.

oXygen 9.2 Improves DITA Support

May 11, 2008

oXygen XML Editor 9.2 includes a new XML Author mode and DITA Maps Manager with a streamlined interface for content authoring and common map editing tasks.

Sharing DITA-OT in OS X & Boot Camp

January 14, 2008

How to use a single installation of the DITA Open Toolkit on your Windows partition to generate output from either operating system environment.

DITA-OT 1.4.1 Released

December 03, 2007

DITA Open Toolkit 1.4.1 includes bugfixes and minor enhancements to provide greater control over the output directory and improve error reporting.

DITA-FMx Plug-in for FrameMaker

August 21, 2007

DITA-FMx is a new Adobe FrameMaker plugin from Leximation and Silicon Publishing that extends DITA support and fixes bugs in the Application Pack for DITA.

DITA Open Toolkit 1.4

August 15, 2007

Version 1.4 of the DITA Open Toolkit is now available, including support for new DITA 1.1 elements such as bookmaps, index-see and index-see-also entries.

OASIS Approves DITA 1.1

August 15, 2007

The DITA Technical Committee at OASIS, the international open standards consortium, has announced the approval of DITA version 1.1 as an OASIS Standard.

FrameMaker 8: No DITA-OT Support

August 01, 2007

The DITA application pack previously available from Adobe Labs for FrameMaker 7.2 has been rolled in to FrameMaker 8, but drops support for DITA Open Toolkit.

DITA-OT

DITA Users September Meetup

September 08, 2017

Join the DITA Users Berlin meetup on September 27 to learn how HERE Technologies tests and validates DITA docs with open-source plugins for DITA Open Toolkit.

DITA Open Toolkit Docs Process

November 14, 2016

At DITA Europe this year, I’ll be speaking about how the DITA Open Toolkit project uses DITA features and open-source tools to build the toolkit documentation.

DITA Users Berlin meetup

February 22, 2016

Join our first meetup to learn how Markdown can help you to simplify the authoring process and gather input from contributors who are less familiar with DITA.

Roundtripping DITA–XLIFF Conversions

June 03, 2015

At the XLIFF Symposium in Berlin, I showed how to transform XML files from the Darwin Information Typing Architecture to a single XLIFF file and back.

Marking Down DITA

April 30, 2015

On the rise of Markdown as an alternative input method for DITA projects.

Contributing to the Toolkit via GitHub

November 20, 2014

Now that the DITA Open Toolkit is hosted on GitHub, it’s easier than ever to contribute changes to the DITA-OT source code or the documentation.

DITA-OT Documentation Repository

November 19, 2014

At DITA Europe in Munich, the DITA Open Toolkit contributors split the toolkit documentation into a dedicated repository to make it easier to contribute.

DITA-OT: Scaling Images in PDF Output

March 14, 2010

When generating PDF output via DITA Open Toolkit, users often stumble over image scaling issues. You can make images fit by setting dimensions and resolution.

DITA-OT 1.5 Milestone 10

January 21, 2009

Today Robert Anderson announced the availability of Milestone 10 of the DITA Open Toolkit version 1.5.

Customizing PDF2 Output

January 15, 2009

When building PDFs for different products with DITA Open Toolkit, you can store customizations in separate folders and reference them with customization.dir.

Eclipse

EasyEclipse 1.3

July 14, 2007

For those who find Eclipse a bit intimidating to install, configure and maintain (or just appreciate a simpler approach), there’s now an easier way.

Tiling Editors in Eclipse

June 14, 2007

While test-driving Aptana recently, I found the absence of a Tile command for editor tabs absolutely vexing!

FontAwesome

Using Icon Fonts in DITA Projects

November 19, 2014

This year at DITA Europe in Munich, I showed how to use scalable vector icons in DITA projects to ensure that output renders sharply at any resolution. ✨

FrameMaker

What’s New in FrameMaker 9

January 23, 2009

If you’re looking for specifics on the new features, Adobe provides a detailed description in the FrameMaker 9 Reviewer’s Guide.

Adobe Technical Communication Suite 2

January 23, 2009

Adobe launched Technical Communication Suite Version 2, with Photoshop CS4 and Presenter 7 along with updated versions of the apps in the previous version.

FrameMaker 8.0.3 Patch Available

May 13, 2008

The FrameMaker 8.0.3 patch release addresses a long list of bugs and workflow issues, including the proper resolution of DITA content references.

FrameMaker 8.0.2 Update Available

February 06, 2008

Mahesh Gupta, Adobe’s FrameMaker Product Manager announced the availability of the Version 8.0.2 update in a post on the Technical Communication blog.

DITA-FMx Plug-in for FrameMaker

August 21, 2007

DITA-FMx is a new Adobe FrameMaker plugin from Leximation and Silicon Publishing that extends DITA support and fixes bugs in the Application Pack for DITA.

Sarah O’Keefe on FrameMaker 8

August 10, 2007

Sarah O’Keefe of Scriptorium Publishing has published her first impressions of FrameMaker 8, including a charming take on the significance of the new icon.

FrameMaker 8: No DITA-OT Support

August 01, 2007

The DITA application pack previously available from Adobe Labs for FrameMaker 7.2 has been rolled in to FrameMaker 8, but drops support for DITA Open Toolkit.

FrameMaker 8 Sports Tabbed UI

July 31, 2007

Installation Surprise #2: Another thing about FrameMaker 8 that Adobe hasn’t mentioned is immediately apparent after installation — tabs and a colored toolbar.

FrameMaker 8 Requires Activation

July 31, 2007

Installation Surprise #1: One of the new FrameMaker 8 “features” Adobe carefully neglects to mention is that the application now requires activation .

FrameMaker 8 Prerelease Closed

July 11, 2007

Adobe is no longer accepting new participants for the Prerelease Testing Program, so FrameMaker 8 should be coming soon.

FrameMaker 8 Prerelease Beta 2

June 13, 2007

Writing in the Adobe Technical Communication blog, FrameMaker Product Manager Aseem Dokania announced that Adobe is looking for FrameMaker 8 beta testers.

Fusion

VMware Fusion 2.0 and CVSNT

September 18, 2008

VMware released its Mac virtualization product with an extremely annoying incompatibility — it won’t work properly with Windows systems running CVSNT.

Git

Talk @ tekom: Social Versioning

January 20, 2011

At this year’s tekom spring conference, I’ll be speaking on the use of distributed version control systems for collaborative authoring of documentation.

GitHub

Contributing to the Toolkit via GitHub

November 20, 2014

Now that the DITA Open Toolkit is hosted on GitHub, it’s easier than ever to contribute changes to the DITA-OT source code or the documentation.

DITA-OT Documentation Repository

November 19, 2014

At DITA Europe in Munich, the DITA Open Toolkit contributors split the toolkit documentation into a dedicated repository to make it easier to contribute.

Information Architecture

Teaching Information Architecture

May 20, 2017

This spring I’m teaching Information Architecture in the Master’s degree program in Content Strategy at FH Joanneum University of Applied Sciences in Graz.

Komodo

Mac

Snow Leopard Services: Set ZIP File Date

November 22, 2009

With Mac OS 10.6 Snow Leopard, you can create a system service to compress files or folders and set the ZIP file modification date to the date of the contents.

iChm Adds Index Search

September 04, 2008

Keeping up the pace of nearly weekly releases, iChm Version 1.3 now allows you to search the index.

iChm Adds Index Support

August 27, 2008

Shortly after the release of iChm 1.1.1, Robin Lu has responded to popular demand and updated his CHM Reader for Mac OS X with support for indexes.

Sharing DITA-OT in OS X & Boot Camp

January 14, 2008

How to use a single installation of the DITA Open Toolkit on your Windows partition to generate output from either operating system environment.

CHM Viewers for Mac OS

October 24, 2007

A handful of open source & shareware apps provide Mac users access to Windows help files in the Compiled HTML Help (CHM) format.

Automator Workflow: Set ZIP File Date

October 18, 2007

When you compress a file or folder in the Finder via the Create Archive command, a ZIP file is created using the current date as modification date.

CTRL-clicking in VMware Fusion

October 10, 2007

If you Enable Mac OS keyboard shortcuts option in VMware Fusion, Mac keys are passed on to the VM, but you can still send the CTRL key if you need to.

SCPlugin — Subversion Client for Mac

August 28, 2007

There’s now a Mac equivalent for TortoiseSVN: SCPlugin is a free, open-source utility that displays the status of your version-controlled files in the Finder.

HumaneText.service

August 24, 2007

A new system-wide Mac OS X service converts Markdown to XHTML (and vice versa) with keyboard shortcuts.

Versions: New Mac OS X Subversion client

June 18, 2007

The interface artists at Sofa are working on a new Mac OS X Subversion client called Versions, which is due out for public beta release “any moment.”

Markdown

API docs in DITA and Markdown

March 05, 2016

I spoke in London at the Write The Docs mini-conference on Documenting APIs hosted by the UK’s Government Digital Service, the team behind the GOV.UK website.

Marking Down DITA

April 30, 2015

On the rise of Markdown as an alternative input method for DITA projects.

Accessible Documentation

June 04, 2010

Today I spoke on the relationship between technical documentation and accessibility for a W3C event at the University of Applied Sciences in Potsdam.

HumaneText.service

August 24, 2007

A new system-wide Mac OS X service converts Markdown to XHTML (and vice versa) with keyboard shortcuts.

OSX

Snow Leopard Services: Set ZIP File Date

November 22, 2009

With Mac OS 10.6 Snow Leopard, you can create a system service to compress files or folders and set the ZIP file modification date to the date of the contents.

Sharing DITA-OT in OS X & Boot Camp

January 14, 2008

How to use a single installation of the DITA Open Toolkit on your Windows partition to generate output from either operating system environment.

CHM Viewers for Mac OS

October 24, 2007

A handful of open source & shareware apps provide Mac users access to Windows help files in the Compiled HTML Help (CHM) format.

Automator Workflow: Set ZIP File Date

October 18, 2007

When you compress a file or folder in the Finder via the Create Archive command, a ZIP file is created using the current date as modification date.

HumaneText.service

August 24, 2007

A new system-wide Mac OS X service converts Markdown to XHTML (and vice versa) with keyboard shortcuts.

Versions: New Mac OS X Subversion client

June 18, 2007

The interface artists at Sofa are working on a new Mac OS X Subversion client called Versions, which is due out for public beta release “any moment.”

RoboHelp

Adobe Technical Communication Suite 2

January 23, 2009

Adobe launched Technical Communication Suite Version 2, with Photoshop CS4 and Presenter 7 along with updated versions of the apps in the previous version.

Adobe RoboHelp Packager for AIR

April 28, 2008

A new Adobe Labs download allows you to roll a RoboHelp project into a standalone app that runs on the Adobe Integrated Runtime (AIR) platform.

S5

Accessible Documentation

June 04, 2010

Today I spoke on the relationship between technical documentation and accessibility for a W3C event at the University of Applied Sciences in Potsdam.

SnagIt

SnagIt for Free!

November 27, 2007

TechSmith is offering version 7.2 of their Windows screenshot tool SnagIt for free to attract users to the latest version (8.2).

Standards

Subversion

Talk @ tekom: Social Versioning

January 20, 2011

At this year’s tekom spring conference, I’ll be speaking on the use of distributed version control systems for collaborative authoring of documentation.

Upgrading WordPress via Subversion

August 06, 2008

David Peralty has a nice tutorial on using Subversion to keep WordPress current by checking out the latest code directly from the Automattic repository.

SCPlugin — Subversion Client for Mac

August 28, 2007

There’s now a Mac equivalent for TortoiseSVN: SCPlugin is a free, open-source utility that displays the status of your version-controlled files in the Finder.

Versions: New Mac OS X Subversion client

June 18, 2007

The interface artists at Sofa are working on a new Mac OS X Subversion client called Versions, which is due out for public beta release “any moment.”

VMware

VMware Fusion 2.0 and CVSNT

September 18, 2008

VMware released its Mac virtualization product with an extremely annoying incompatibility — it won’t work properly with Windows systems running CVSNT.

CTRL-clicking in VMware Fusion

October 10, 2007

If you Enable Mac OS keyboard shortcuts option in VMware Fusion, Mac keys are passed on to the VM, but you can still send the CTRL key if you need to.

VPN

Versions

Versions: New Mac OS X Subversion client

June 18, 2007

The interface artists at Sofa are working on a new Mac OS X Subversion client called Versions, which is due out for public beta release “any moment.”

WebWorks

WebWorks TopicAlias Marker Changes

July 03, 2007

If you’re using custom markers to embed context information in FrameMaker source files, there are changes in the new WebWorks version you should be aware of.

Wire

Wire. Great conversations.

December 04, 2014

For the past year, I’ve been working with many of the original team behind Skype to launch a new messenger called Wire.

WordPress

DITA for WordPress

December 12, 2008

Claude Vedovini has released a set of plugins for the DITA Open Toolkit and WordPress that allow you to publish DITA content to a WordPress site.

Upgrading WordPress via Subversion

August 06, 2008

David Peralty has a nice tutorial on using Subversion to keep WordPress current by checking out the latest code directly from the Automattic repository.

XEP

RenderX XEP Setup in oXygen

August 07, 2008

Recently, a client asked how to set up the RenderX XSL FO processor to transform DITA maps to PDF with oXygen XML Editor on Mac OS X.

XLIFF

Roundtripping DITA–XLIFF Conversions

June 03, 2015

At the XLIFF Symposium in Berlin, I showed how to transform XML files from the Darwin Information Typing Architecture to a single XLIFF file and back.

XML

RenderX XEP Setup in oXygen

August 07, 2008

Recently, a client asked how to set up the RenderX XSL FO processor to transform DITA maps to PDF with oXygen XML Editor on Mac OS X.

oXygen 9.2 Improves DITA Support

May 11, 2008

oXygen XML Editor 9.2 includes a new XML Author mode and DITA Maps Manager with a streamlined interface for content authoring and common map editing tasks.

Xserve

Apple Xserve Field Guide

November 25, 2008

Apple has released the Xserve Field Guide, a web app for service technicians that need quick access to server maintenance information during on-site repairs.

YAML

CSS Framework YAML 3.0

July 17, 2007

“Yet Another Multicolumn Layout” (YAML) is an XHTML/CSS framework for creating CSS-based float layouts.

accessibility

Accessible Documentation

June 04, 2010

Today I spoke on the relationship between technical documentation and accessibility for a W3C event at the University of Applied Sciences in Potsdam.

apple help

Apple Xserve Field Guide

November 25, 2008

Apple has released the Xserve Field Guide, a web app for service technicians that need quick access to server maintenance information during on-site repairs.

Building Apple Help with OmniOutliner

October 09, 2008

William Van Hecke, Omni Group’s User Experience Lead has released Helpify, a Python script that turns OmniOutliner files into Apple Help books.

automation

customization

Customizing PDF2 Output

January 15, 2009

When building PDFs for different products with DITA Open Toolkit, you can store customizations in separate folders and reference them with customization.dir.

docs

API docs in DITA and Markdown

March 05, 2016

I spoke in London at the Write The Docs mini-conference on Documenting APIs hosted by the UK’s Government Digital Service, the team behind the GOV.UK website.

documentation

DITA Open Toolkit Docs Process

November 14, 2016

At DITA Europe this year, I’ll be speaking about how the DITA Open Toolkit project uses DITA features and open-source tools to build the toolkit documentation.

Talk @ tekom: Social Versioning

January 20, 2011

At this year’s tekom spring conference, I’ll be speaking on the use of distributed version control systems for collaborative authoring of documentation.

Accessible Documentation

June 04, 2010

Today I spoke on the relationship between technical documentation and accessibility for a W3C event at the University of Applied Sciences in Potsdam.

editing

Think Twice Before Firing Editors

November 12, 2009

Last week the Toronto Star epitomized the recent decline of the newspaper industry by firing a hundred members of its pre-publishing and editorial divisions.

help

Adobe Technical Communication Suite 2

January 23, 2009

Adobe launched Technical Communication Suite Version 2, with Photoshop CS4 and Presenter 7 along with updated versions of the apps in the previous version.

Apple Xserve Field Guide

November 25, 2008

Apple has released the Xserve Field Guide, a web app for service technicians that need quick access to server maintenance information during on-site repairs.

iChm Adds Index Search

September 04, 2008

Keeping up the pace of nearly weekly releases, iChm Version 1.3 now allows you to search the index.

iChm Adds Index Support

August 27, 2008

Shortly after the release of iChm 1.1.1, Robin Lu has responded to popular demand and updated his CHM Reader for Mac OS X with support for indexes.

Adobe RoboHelp Packager for AIR

April 28, 2008

A new Adobe Labs download allows you to roll a RoboHelp project into a standalone app that runs on the Adobe Integrated Runtime (AIR) platform.

Spaces in HTML Help Project Paths

March 18, 2008

Like so many other applications, Microsoft’s HTML Help Workshop often chokes on project files whose paths contain spaces.

CHM Viewers for Mac OS

October 24, 2007

A handful of open source & shareware apps provide Mac users access to Windows help files in the Compiled HTML Help (CHM) format.

WebWorks TopicAlias Marker Changes

July 03, 2007

If you’re using custom markers to embed context information in FrameMaker source files, there are changes in the new WebWorks version you should be aware of.

Error opening CHMs on a network

June 28, 2007

Microsoft security “fix” 896358 prevents display of content in CHM files opened from a network. Workaround: Use UNC file paths in links or move your CHMs.

iPhone

New Aptana Build + iPhone Plugin

June 29, 2007

A new version of the Aptana IDE is available with a new colorization engine, Eclipse Monkey support and “tons of enhancements”.

icon fonts

Using Icon Fonts in DITA Projects

November 19, 2014

This year at DITA Europe in Munich, I showed how to use scalable vector icons in DITA projects to ensure that output renders sharply at any resolution. ✨

infographics

What Makes Good Information Design

November 10, 2009

Information is Beautiful — David McCandless ponders the nature of information design as the intersection of accuracy, relevance, usefulness, and structure.

meetup

DITA Users September Meetup

September 08, 2017

Join the DITA Users Berlin meetup on September 27 to learn how HERE Technologies tests and validates DITA docs with open-source plugins for DITA Open Toolkit.

DITA Users Berlin meetup

February 22, 2016

Join our first meetup to learn how Markdown can help you to simplify the authoring process and gather input from contributors who are less familiar with DITA.

oXygen

RenderX XEP Setup in oXygen

August 07, 2008

Recently, a client asked how to set up the RenderX XSL FO processor to transform DITA maps to PDF with oXygen XML Editor on Mac OS X.

oXygen 9.2 Improves DITA Support

May 11, 2008

oXygen XML Editor 9.2 includes a new XML Author mode and DITA Maps Manager with a streamlined interface for content authoring and common map editing tasks.

pdf

DITA-OT 1.5 Milestone 10

January 21, 2009

Today Robert Anderson announced the availability of Milestone 10 of the DITA Open Toolkit version 1.5.

pdf2

DITA-OT 1.5 Milestone 10

January 21, 2009

Today Robert Anderson announced the availability of Milestone 10 of the DITA Open Toolkit version 1.5.

Customizing PDF2 Output

January 15, 2009

When building PDFs for different products with DITA Open Toolkit, you can store customizations in separate folders and reference them with customization.dir.

perl

Clever Title Case Perl Script

May 21, 2008

John Gruber has released a script that transforms selected text into title case based on guidelines from the New York Times Manual of Style.

presentation

Accessible Documentation

June 04, 2010

Today I spoke on the relationship between technical documentation and accessibility for a W3C event at the University of Applied Sciences in Potsdam.

python

Building Apple Help with OmniOutliner

October 09, 2008

William Van Hecke, Omni Group’s User Experience Lead has released Helpify, a Python script that turns OmniOutliner files into Apple Help books.

script

Building Apple Help with OmniOutliner

October 09, 2008

William Van Hecke, Omni Group’s User Experience Lead has released Helpify, a Python script that turns OmniOutliner files into Apple Help books.

Clever Title Case Perl Script

May 21, 2008

John Gruber has released a script that transforms selected text into title case based on guidelines from the New York Times Manual of Style.

tekom

Talk @ tekom: Social Versioning

January 20, 2011

At this year’s tekom spring conference, I’ll be speaking on the use of distributed version control systems for collaborative authoring of documentation.

tekom for Runaways

November 11, 2007

At the tekom conference this week, English presentations were featured prominently as the organization strives to build an international reputation for itself.

tips

DITA-OT: Scaling Images in PDF Output

March 14, 2010

When generating PDF output via DITA Open Toolkit, users often stumble over image scaling issues. You can make images fit by setting dimensions and resolution.

Snow Leopard Services: Set ZIP File Date

November 22, 2009

With Mac OS 10.6 Snow Leopard, you can create a system service to compress files or folders and set the ZIP file modification date to the date of the contents.

VMware Fusion 2.0 and CVSNT

September 18, 2008

VMware released its Mac virtualization product with an extremely annoying incompatibility — it won’t work properly with Windows systems running CVSNT.

Moving (renaming) Files in CVS

September 05, 2008

Once of the main complaints about the CVS version control system is that it’s difficult to move or rename files as your project structure changes.

RenderX XEP Setup in oXygen

August 07, 2008

Recently, a client asked how to set up the RenderX XSL FO processor to transform DITA maps to PDF with oXygen XML Editor on Mac OS X.

Upgrading WordPress via Subversion

August 06, 2008

David Peralty has a nice tutorial on using Subversion to keep WordPress current by checking out the latest code directly from the Automattic repository.

Spaces in HTML Help Project Paths

March 18, 2008

Like so many other applications, Microsoft’s HTML Help Workshop often chokes on project files whose paths contain spaces.

Sharing DITA-OT in OS X & Boot Camp

January 14, 2008

How to use a single installation of the DITA Open Toolkit on your Windows partition to generate output from either operating system environment.

Automator Workflow: Set ZIP File Date

October 18, 2007

When you compress a file or folder in the Finder via the Create Archive command, a ZIP file is created using the current date as modification date.

Book Tip: Bit Literacy

August 07, 2007

If you’ve ever struggled with the volume of bits that require your attention every day, a recent book by Mark Hurst of Good Experience may help.

WebWorks TopicAlias Marker Changes

July 03, 2007

If you’re using custom markers to embed context information in FrameMaker source files, there are changes in the new WebWorks version you should be aware of.

Error opening CHMs on a network

June 28, 2007

Microsoft security “fix” 896358 prevents display of content in CHM files opened from a network. Workaround: Use UNC file paths in links or move your CHMs.

Tiling Editors in Eclipse

June 14, 2007

While test-driving Aptana recently, I found the absence of a Tile command for editor tabs absolutely vexing!

title case

Clever Title Case Perl Script

May 21, 2008

John Gruber has released a script that transforms selected text into title case based on guidelines from the New York Times Manual of Style.

tools

DITA-OT: Scaling Images in PDF Output

March 14, 2010

When generating PDF output via DITA Open Toolkit, users often stumble over image scaling issues. You can make images fit by setting dimensions and resolution.

visualization

What Makes Good Information Design

November 10, 2009

Information is Beautiful — David McCandless ponders the nature of information design as the intersection of accuracy, relevance, usefulness, and structure.

zip

Snow Leopard Services: Set ZIP File Date

November 22, 2009

With Mac OS 10.6 Snow Leopard, you can create a system service to compress files or folders and set the ZIP file modification date to the date of the contents.

Automator Workflow: Set ZIP File Date

October 18, 2007

When you compress a file or folder in the Finder via the Create Archive command, a ZIP file is created using the current date as modification date.