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: Code for publishing PDF from Confluence From:Keith Hood <bus -dot- write -at- gmail -dot- com> To:Melanie Albrecht <melanie -dot- albrecht -at- gmail -dot- com> Date:Tue, 8 Jul 2014 19:26:48 -0500
My experience with Confluence makes me wonder why you would want to use it
to author documentation. It's OK for setting up a wiki but it's cumbersome
and the formatting options are very limited. Getting the indentation in a
list correct is just about impossible. It gives you no way to edit or
format images. I'm not sure if you can make a TOC or an index in
Confluence. For navigation it uses a hiearchy of parent-child pages you
have to keep track of a bunch of page tags in order to relate pages to each
other. I think for something that is not supposed to be made accessible as
wiki pages, you'd be much better off using software that was designed for
On Tue, Jul 8, 2014 at 6:09 AM, Melanie Albrecht <melanie -dot- albrecht -at- gmail -dot- com
> Next week, I start a new job, writing doc for users and administrators of a
> big complex security software product.
> The Development team already use Confluence for their internal wiki, and I
> am considering using it to also write the doc. However, the boss really
> wants me to be able to publish as PDF.
> The internet tells me that you can configure Confluence to produce a
> pleasant-looking PDF, using CSS and HTML.
> However, I have not been able to find any examples. I can write clean HTML
> and really basic CSS, but I have no idea where to start with this.
> Do you know of any examples?
> Also, do you have any opinions about the sensibleness of authoring in
> Confluence and publishing to PDF?
> Doc-To-Help 2014 v1 now available. SharePoint 2013 support, NetHelp
> enhancements, and more. Read all about it.
> Learn more: http://bit.ly/NNcWqS
> You are currently subscribed to TECHWR-L as bus -dot- write -at- gmail -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
> 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
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l