TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Re: Suggestions for free/cheap/Open Source documentation for Web Site & PDF?
Subject:Re: Suggestions for free/cheap/Open Source documentation for Web Site & PDF? From:Anindita Basu <anindita -dot- basu -at- in -dot- ibm -dot- com> To:Jen H <documentation -at- voxilate -dot- com> Date:Wed, 15 Jul 2009 17:10:47 +0530
Rational Software, India Software Lab
anindita -dot- basu -at- in -dot- ibm -dot- com
<documentation -at- vo
Sent by: TECHWR-L
techwr-l-bounces+ <techwr-l -at- lists -dot- techwr-l -dot- com>
ibm -dot- com -at- lists -dot- tec
Suggestions for free/cheap/Open
Source documentation for Web Site &
15/07/2009 06:59 PDF?
I've been out of the documentation loop for a few years and thought I'd
query the group for more modern insight. I'm helping out a project where
we'll be producing documentation that we'll need to output in both PDF and
as nice-looking Web pages. I've batted around a few ideas - LaTeX (nice and
build-system-happy, but LaTex2HTML is so ugly...plus we'll eventually want
many people to update it and not everyone loves LaTeX), Apache Forrest (but
it doesn't seem to be heavily maintained and doesn't work with JDK 1.6.
is, I guess, not a big deal, but resetting JAVA_HOME all the time is a
Requirements are really the following:
- Text-based source for easy integration with source control.
- Free, or close to it.
- Single-sourceability: Should be able to code text for multiple output
- Multiple output formats supported, PDF and HTML at a minimum.
- Can be built without user interaction (i.e., scriptable to run with
- Somewhat easily editable - Eclipse plugin support would be fantastic.
- Pain threshold for initial configuration is medium (<2 hrs to set up,
if it takes a little longer to make "pretty"). Pain threshold for
maintenance/modification of styles/build system/internals post-initial
is high, however.
Any advice or suggestions? What's working for you in the land of free
software? Is anyone successfully using Maven to produce user documentation?
(Anyone using Forrest?) Any other out-of-the-box DocBook implementations
that are easy to get up and running quickly? Or other suggestions and
Thanks much in advance for your insights and recommendations!
<documentation -at- voxilate -dot- com>
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-