Re: Code for publishing PDF from Confluence

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
desktop publishing.


On Tue, Jul 8, 2014 at 6:09 AM, Melanie Albrecht <melanie -dot- albrecht -at- gmail -dot- com
> wrote:

> Hello
>
> 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?
>
> Thanks,
> Melanie
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> 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
> 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
>

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l

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

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:
Code for publishing PDF from Confluence: From: Melanie Albrecht

Previous by Author: Re: user expecttations - web-based help
Next by Author: Re: What to call a smallish document that describes a particular way to use a product?
Previous by Thread: Re: Code for publishing PDF from Confluence
Next by Thread: Re: Code for publishing PDF from Confluence


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


Sponsored Ads