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.
> Our company needs to put large documents (i.e. hundreds of pages and up)
> online, and I have been assigned to find the tool(s) for the job. The
> documents will mainly consist of standard operating procedures, which are
> table-heavy documents that they would like to have indexed, and accessible
> via tables of contents that should be able to be generated automatically. As
> well, the tool(s) need to be able to generate print-ready documentation, as
> well as HTML output.
>
> I just wanted to see if anyone had any recommendations on a tool other than
> FrameMaker with WebWorks. I've never used either, however from my research,
> it appears like this is the ideal solution for our needs. However, is there
> any other tools we should take a look at? ...
Have a look at DocBook, am SGML or XML DTD that supports output to HTML (either
one section per file or one big file), PDF, Postscript, ... and automatic
generation of TOC, index, etc.
O'Reilly publishers and several Unix vendors were involved in developing it and
it has been used both for published books and large product documentation projects.
Frame+SGML can be used with this DTD. That would be the first thing I'd look at
in your situation. There a also lots of other tool alternatives. Essentially
any tool that handles either SGML or XML.
DocBook is replacing the LinuxDoc DTD for Linux HowTo documents. See the Linux
Documentation Project web site:
