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.
Subject:Re: The Swiss Army Knife of Collaborative Writing From:Richard Hamilton <dick -at- rlhamilton -dot- net> To:TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Tue, 17 Sep 2013 12:46:47 -0700
Hi Robert,
Depends on your objectives, the output you need, and the skills you have available.
It's quite possible those two exporters would be a better option for someone starting from scratch. I haven't tried the PDF or ePub exporters, so I can't comment on them, but I can see how a good, clean means for exporting those two outputs, while still being able to provide a documentation wiki, could make a pretty capable package.
We started using DocBook well before we started using Confluence, so we already had a well-tested DocBook toolchain in place. And I'm comfortable doing production, especially print production, with DocBook. Without those two factors, plus a need for high-quality print production, I could see us using something like those two exporters.
Best regards,
Richard
-------
XML Press
XML for Technical Communicators http://xmlpress.net
hamilton -at- xmlpress -dot- net
On Sep 17, 2013, at 12:10 PM, Robert Lauriston wrote:
> For someone starting from scratch, it would probably be a whole lot
> simpler to use Scroll's PDF and ePub exporters.
>
> On Tue, Sep 17, 2013 at 10:49 AM, Richard Hamilton <dick -at- rlhamilton -dot- net> wrote:
>> Hi Robert,
>>
>> We use a set of open-source DocBook stylesheets with some customizations. We use the stylesheets to generate xsl:fo (which we process with a proprietary tool called RenderX to get PDF) and ePub (we generate Kindle books using Amazon's ePub to Kindle converter, kindlegen).
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.
>
> Learn more: http://bit.ly/ZeOZeQ
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.
