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: anyone else generating web help from Confluence?
Subject:Re: anyone else generating web help from Confluence? From:Richard Hamilton <dick -at- rlhamilton -dot- net> To:Mark Giffin <mgiffin -at- earthlink -dot- net> Date:Fri, 6 Feb 2015 14:39:30 -0800
We use the K15t plugins, though in a different context. We have authors who write in Confluence, then we export DocBook with the Scroll exporter and generate books and ebooks from the DocBook.
I have found the DocBook exporter to be solid and flexible, and it generates good DocBook. It probably covers all the things you're likely to want in a help system, though we added a bit of supplementary markup that we then convert to DocBook after export (that's for epigraphs, and some details of indexing that go beyond what most folks need). We also do a little bit of post-processing. That's not because of problems with the exporter; rather, Confluence tends to add in weird stuff (like subtle text color changes and inconsistently marked up paragraph breaks) that Scroll can't differentiate from legitimate markup. That leads to some unexpected, though valid, DocBook markup, which we strip out.
Last time I checked, pricing was $200 for a 10 user license.
Hope that helps,
XML for Technical Communicators http://xmlpress.net
hamilton -at- xmlpress -dot- net
On Feb 6, 2015, at 14:16, Mark Giffin <mgiffin -at- earthlink -dot- net> wrote:
> Oh, is that how k15t handles webhelp output? With the DocBook toolchain? The DocBook toolchain is pretty solid if you want to work with it. You seem like someone who could bend it to his will, Robert. You could get Bob Stayton's DocBook XSL book, he's the top guy for that. He has a thorough website for that, too.
> I recently heard from someone who uses them that the k15t Confluence tech pubs plugins are pretty workable for a tech pubs workflow but I haven't used them. Just using plain Confluence for ordinary technical publications seems overly messy to me. As far as I can see, k15t pretty much owns the market for that.
> I can think of a couple more ways you might go to get webhelp out of Confluence, but I think it would require more custom coding. What is the pricing like on the k15t plugins?
> Mark Giffin
> Mark Giffin Consulting, Inc.
> On 2/6/2015 1:18 PM, Robert Lauriston wrote:
>> A year ago I researched options for generating web help from content
>> in Confluence, and the only really usable solution I found was K15t's
>> DocBook Exporter plus the free DocBook+WebHelp.
>> Has anyone found a better solution?
> Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word | http://bit.ly/doctohelp2015
> You are currently subscribed to TECHWR-L as dick -at- rlhamilton -dot- net -dot-
> To unsubscribe send a blank email to
> techwr-l-leave -at- lists -dot- techwr-l -dot- com
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
>http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
> Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
> Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word | http://bit.ly/doctohelp2015