Welcome to summer reruns, part 2

My blog and I are taking it a little easier towards the end of the summer.

I’ve had a wonderful time with this blog so far, and I thank each and every one of you for reading, lurking or commenting. I’ve learned a lot from your comments, and I appreciate your support! It’s been a warm summer’s breeze… 🙂

As we’re gearing up for the new season, here are some reruns from the last year or so.

Popular posts from my blog

Top 10 things that users want to do in a help system

This is one of my two most popular posts by far where I draw a parallel to a department store or a library to illustrate how customers want to navigate each one.

Reality check: Writing for scannability and localization

What happens if our nobel attempts at clear topic structures and parallel sentence structures meet head on with unsuspecting readers?

Portable apps for tech writers

This is the first post in a four-part series where I recommend free and (mostly) light-weight applications that can help any tech writer in his daily tasks.

Noteworthy posts from elsewhere

If you want to get an introduction into content strategy, I think, you could do a lot worse than reading these excellent posts:

Complete Beginner’s Guide to Content Strategy

Content Lifecycle

The extraordinary world of content strategists

The last two posts are beginnings of series, so be sure to follow the links at the end of each.

Portable apps for tech writers IV: Wrangling files and PDFs

By now you maybe know that I’m fond of portable apps. That I use them to write, take screenshots and look up stuff in dictionaries with them. But wait: There’s more! No matter how well I manage my contents and architect my information, sometimes files just go unwieldy on me. That’s when they come in:

My favorite apps to wrangle files

Now where’s that file again? Baregrep finds files by name, very quickly – much faster than Windows’ file explorer! And it finds text within ASCII files, again very quickly. It’s my favorite tool to find elusive entries in .txt files or help contents in .html or .xml files. Unix users will recognize the name: This is really a “bare” grep that also masters regular expressions. You’ll have to live with a nag screen upon startup, but, hey: It’s free…

Uh, how come there’s so many of them? Easy Duplicate File Finder finds, uhm: duplicate files. It compares not just file name and size, but contents, too! So when your “to read” folder has gotten too big again, it’ll point out that white paper which you’ve downloaded twice – with different names… It’s also great to clear out project directories where you may have created countless copies of files.

… and now without the spaces. Bulk Rename Utility comes recommended by reader JosephK. He writes: “Bulkrenaming of files with regexp expressions can be done with BulkRename. The interface takes some getting used to.”

For intrepid explorers. XYplorerFree is my portable file explorer of choice – and it’s not even double-pane. But I like it for its comprehensive file-finding and various display options, so I don’t mind that the last free version is almost 4 years old. If you want dual-pane explorers, try freeCommander and UltraExplorer, both of which rank highly. Or try some of the other file explorers in The Portable Freeware Collection.

Portable zipping. PeaZip is my archiving/compression tool of choice. It claims to handle 118 file types. At least, I’ve never had an archive type it couldn’t open. Be sure to grab the “PeaZip portable_standalone” package.

In sync. DSynchronize is a reliable file synchronizer with a straight-forward interface. You can preview what files will be added, deleted or overwritten before committing the changes. You can also opt to sync only newer files or to sync both sides. If you don’t like this one, try Toucan which is a bit fancier and also available from portableapps.com. (Remember that portableapps.com versions don’t require the portableapps.com platform – you can just point their installers anywhere…)

…got til it’s gone. CyberShredder removes files. For good. It overwrites them, up to 7 times. This can be useful when you want to be sure your files are not on the machine after you leave.

Going truly portable with PDFs

It’s a bit ironic that it’s called “Portable Document Format”, when it’s so difficult to modify PDFs – if it wasn’t for portable PDF editor PDFTK Builder. It lets you reorder, delete and duplicate pages in a PDF file and merge pages from multiple PDFs. You can also split a PDF into files with one page each. (Splitting and merging a subset, however, often gives you much larger file than the source, so it’s more like a first-aid kit for emergency surgery.) You can also rotate and stamp pages and protect your documents with passwords to read or change the documents.

If you just want to read PDFs on a fast, portable reader, I recommend Foxit Reader. Others prefer the even smaller Sumatra.

What tools do you use to wrangle files on the go? Feel free to leave a comment.

Portable apps for tech writers III: Dictionaries

I don’t just write and take screenshots with portable apps, I even use them to look up words, despite Wikipedia and countless online dictionaries. I like the seamless lookup from other applications with a click and don’t want to rely on being online. Fortunately, there are some very useful and usable apps out there. Here are my favorite portable dictionary apps.

“Lookup Central”, all in one

WordWeb combines a portable offline dictionary and thesaurus with tabbed browsing to look up words in popular web sites. Entries are displayed in two frames, with definitions and examples in one and the thesaurus in the other. (To see the full screenshot, just click it.) The free version of 30 MB comes with Princeton University’s WordNet wordbase of about 150,000 entries – and an unusual license agreement: “WordWeb free version may be used indefinitely only by people who take at most two commercial flights (not more than one return flight) in any 12 month period…” The paid “pro” version gives you more definitions and pronunciations, you can add online sites and buy extra dictionaries, thesauri and word lists. Click the screenshots to see a comparison of WordWeb and TheSage:

The “language reference system”

TheSage combines a portable offline dictionary and thesaurus with tabbed browsing… – Yes, just like WordWeb does. As far as I can tell, it even uses essentially the same wordbase. The main difference is the layout: You can expand and collapse the results by definitions, examples and thesaurus entries. You can also customize the online lookup sites. With 210,000 definitions taking about 20 MB, it has an edge over the free WordWeb version – if you can get used to the interface.

For a second opinion, the Freewaregenius has an older review of TheSage with a comparison to WordWeb in passing.

The multilingual dictionary

LingoPad translates words between German and English or other languages. I must admit this one doesn’t get much use when I’m online because WordWeb links straight to LEO. But it’s a reliable tool, especially when you’re mainly working in translations from or to German.

The classic dictionary bookshelf

Lingoes is a dictionary platform that lets you add all kinds of dictionaries. Of all the apps, it’s most similar to the long defunct Microsoft Bookshelf – which was, of course, neither free nor portable, but a cool solution in its time. Lingoes is a bit out of scope, though: Its license agreement limits use to “non-commercial purposes in non-business, non-commercial environments”, and it seems unclear whether the dictionaries download packages are properly licensed.

Which dictionaries do you use? Do you prefer online or offline?

Portable apps for tech writers II: Screenshots

Suppose you’re wise to portable apps and how to tweak text with them, with or without the apps mentioned in my previous post Portable apps for tech writers. But how about screenshots? Anything portable there? – Oh, good! I thought you’d never ask… 🙂

My top 3 portable screenshot apps

Top prize: PicPick Tools is my #1 screenshot app. It’s got everything I need: Quick and easy screenshots of desktop, window or screen area, quick change of output setting, auto-save to my project directory, a screen ruler and magnifier and a simple image editor. Most of the time, I take straight screenshots without call-outs, so I want an app that lets me do that quickly and keeps out of my way. PicPick does this best of all the screenshot apps I tried; it runs in my task bar. The problem with this is that, according to the product web site, the “portable version of PicPick [is] only for private, personal and not commercial use”.

Runner-up: FSCapture is very similar to PicPick. The problem with this is that it’s no longer a free app. The link takes you to the last free version 5.3 of February 2007 which works fine. However, it excludes some of the features baked into the latest version 6.5 and PicPick Tools, such as the screen ruler and sending captured images directly to Word, PowerPoint and an FTP server.

Honorable mention: The unpronouncable PrtScr affords the stylish whimsy of an animated preview. You need to see it to believe it – check out the video below. It’s great for quick and dirty screenshots with markups, but its emphasis on free-hand drawing and cropping makes it less suitable for pedantic operations. The problem with this (and you knew there had to be one) is that you pretty much have to create your own portable version by installing it, copying the program files to your portable directory or stick and uninstalling it.

[Update: I just remembered that freewaregenius has written up PicPick and PrtScr so you can get exhaustive second opinions on them.]

What do you think, is it worth to pay for screenshot toolsfor the extra features when freeware basically gets the job done?

Here’s PrtScr’s cool demo rock video:

Portable apps for tech writers

We tech writers can benefit a lot from portable applications: They make us more productive, especially with nitty-gritty tasks that Windows utilities and bloatware are not good at. They are free and easy to “install” and remove – just dump the application folder onto your hard drive or a USB stick. They can run wherever you have an open USB port. Portable applications can be our friends!

To learn more and to get started, PortableApps is the best place. Their PortableApps.com Suite with the most essential applications makes it extra easy for newbies. Or you just get the platform, which provides the start menu that sits in your task bar, and mix and match your applications. I’m now using the alternative Portable Start Menu, because I like its folder structure better.

You can get tried and proven portable applications from PortableApps. Or try The Portable Freeware Collection, though some of the apps listed there are a bit flaky: They might not be strictly portable, because they write to the registry. Or you may need to install them temporarily to create a portable version.

My favorite Windows-based portable tools for writing

A better NotepClipboardad: I use PlainEdit since I don’t do much coding. For plain text wrangling, it can’t be beat. You can convert text in more ways than I ever had use for, between special characters and HTML, between ANSI, ASCII and UTF-8. You can remove trailing spaces and lines containing certain characters. You can sort all lines from A to Z or inversely. And it can search and replace regular expressions.

If you are coding and want syntax support for programming languages, Notepad++ is your best bet.

Auto-complete text: With Texter, you type a shortcut and press a hot-key and out comes a common phrase or a product name: Type rtfm + Tab to get “For more information, please consult the user manual or online help.” Texter works system-wide, whereas Word’s auto-correct feature works, well, only in Word…

Add a history to your clipboard: ClipX will keep dozens of clipboard entries in a history, including images, even across sessions. This can also come in handy to retrieve accidentally cut text. (This one requires that you install it temporarily, so you can create a portable copy.)

“Paste Special” anywhere: You want to paste text from your clipboard, but without the formatting? PureText strips all formatting when pasting text. So it works like Paste Special in Word, but with a single hot key and anywhere in Windows. (This one is not strictly portable; it allegedly writes settings to the registry.)

Get text from system controls: One of the annoyances in Windows is that you can’t copy and paste system control text, such as a list of file names in Explorer or an error message. SysExporter helps you extract it – apparently with some exceptions, but it hasn’t failed me yet.

What portable applications do you use to tweak text? Your suggestions and comments are welcome!

P.S. This post is an updated, belated elaboration on my reply to the blog post Taking it with you by the guys at DMN communications from June 2008.