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,
Richard Hamilton
-------
XML Press
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.
> http://markgiffin.com/
>
>
> 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

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -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


Follow-Ups:

References:
anyone else generating web help from Confluence?: From: Robert Lauriston
Re: anyone else generating web help from Confluence?: From: Mark Giffin

Previous by Author: Re: Issues with illustrations?
Next by Author: Re: Proofreading your own material
Previous by Thread: Re: anyone else generating web help from Confluence?
Next by Thread: Re: anyone else generating web help from Confluence?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads