What authoring tools would you recommend for content published both on-line and on paper? I currently use a word process to get the main content down and colleagues turn it in to HTML, but I have been thinking about using XML to capture the structure, followed by XSLT for web or print formatting.
I read that O'Reilly use XML, and know you have used docbook in the past. Is this a good route to go down?
Help get this topic noticed by sharing it on Twitter, Facebook, or email.
> What authoring tools would you recommend for content published both
> on-line and on paper?
Without hesitation, an XML format will provide you with the best chances for re-use. That said, adopting XML workflows can be tricky and choosing the right standard (like DocBook) is important to get right & dependent on what sort of stuff you're writing.
For a more specific answer to your question, our others write DocBook in vim, emacs, oXygen, and XMLMind's XML Editor, among other pieces of software.
> I read that O'Reilly use XML, and know you have used docbook in the past.
We do indeed use DocBook inside O'Reilly as the canonical storage format for the majority of our titles. DocBook provides a rich set of semantic markup that maps well to O'Reilly's content (perhaps because we helped start the discussion that eventually led to the DocBook standard many years ago). Over the last few years, we've started pushing DocBook more heavily as an authoring and manuscript format because, like you, we've become more interested in multi-format publishing.
DocBook is very good in this regard expressly because of its rich semantics: in the XML world, it's typically easy to go to a simpler format, so the DocBook-XSL projects already have tried-and-true output into PDF (via XSL-FO), HTML Help, (X)HTML, and others. I've recently contributed another output format, the IDPF's .epub standard, which took only a couple of months on the side to get implemented.
All that said, the big downside with DocBook is the complexity of the standard (hundreds of tags) and the complexity of the toolchains (for HTML, PDF, etc). I'd suggest skimming the definitive DocBook-XSL reference, DocBook XSL: The Complete Guide (http://www.sagehill.net/docbookxsl/in...) to see if you're interested in both the rewards and the drawbacks. If you'd like to chat with others, the http://docbook.org page has instructions for joining the docbook and docbook-apps mailing list, both of which are very helpful to newcomers. Finally, if you're not in a rush, keep an eye on the work being done by the OASIS DocBook SubCommittee for Publishers, which is working on a smaller version of DocBook for non-technical folks (I'm a member of that).
For more context on choosing an XML workflow, check out:
* http://toc.oreilly.com (the place for publishers trying to innovate)
* http://xml.com/ (All things XML, search for 'publishing')
> Is this a good route to go down?
Yep, but it takes a lot of work to get setup.