A simple command-line application to generate self-contained HTML documents
Did you ever have to write a document, but didn’t want to (or couldn’t) use MS Word or another WYSIWYG word processor? Yep, I agree: that’s what Markdown is for.
Luckily, there are a lot of editors that support Markdown out there (I just installed MacDown myself), and they work great, most of the time. Unfortunately though, they often:
Generate HTMLfragments instead of full documents
Don’t include a proper stylesheet
Generate more than one file
The last one on the list in particular, is true for all of them: the stylesheet may be embedded in the document, but if you want to use images, they are managed as separate files; and the same thing happens if you want to use custom fonts. That’s how HTML works, after all… right? Nope.
Or why I am still going to use Nanoc for the foreseeable future
Every so often I wonder whether I should ditch my current blogging platform and try something new and shiny that just came out. Luckily, normally I come back to the same conclusion: I don’t need to change anything, I just need to find the time and the will to write about something.
This time is no different, but I thought I’d write a roundup of platforms, services, and tools that you can use for blogging or managing your personal sites. Note that this roundup is by no means exhaustive (like most roundups) — it’s just a quick overview of the pros and cons of a few systems that I’ve been researching on lately. Maybe it will be useful to someone.
Simply all the books your Documentation Team needs
I’ve been working in Technical Communications for nearly seven years now, first and foremost Technical Writer and more recently as Documentation Manager. In other words, my work revolves around manuals and online helps, authoring tools and guidelines, documentation standards and… you get the picture.
And yet, although I write articles and develop documentation tools in my free time as well, I rarely write about my job on this site. But when I was offered the opportunity to read and review Best Practices for Technical Writers and Editors, I just couldn’t resist.
With up-to-date Ruby implementations, more resources, and online version
The Ruby Compendium has been updated, and it now lists the most up-to-date versions of various Ruby implementatios, even more web sites, books, podcasts, and Rubyists. In addition to the PDF version, the book can now be read online here on H3RALD.com.