Issue Details (XML | Word | Printable)

Key: CONF-762
Type: Improvement Improvement
Status: Open Open
Priority: Major Major
Assignee: Unassigned
Reporter: Stefan Kleineikenscheidt
Votes: 30
Watchers: 20
Operations

Add/Edit UI Mockup to this issue
If you were logged in you would be able to see more operations.
Confluence

Docbook Export

Created: 18/Feb/04 03:58 AM   Updated: 12/Oct/09 05:34 PM
Component/s: Export Page / Space
Affects Version/s: None
Fix Version/s: None

Time Tracking:
Not Specified

Environment:

all

Issue Links:
Reference

Participants: Audra Eng [Atlassian], Charles Miller [old account, do not assign issues], Darren Bell, Ilia Harlamov, Lisa Dyer, Nick Faiz, Sarah Maddox [Atlassian], Stefan Kleineikenscheidt, Ted Husted, Thomas Van de Velde and Wilfred Springer
Since last comment: 38 weeks, 3 days ago
PM Reviewed: 29/Jan/09
PM Value: 1.82
Labels: lt


 Description  « Hide

Documentation standard in our department is Docbook, and we have set up build-processes for our documentation already. Thus it would be very handy to export Docbook files directly from Confluence.



Ted Husted added a comment - 29/Dec/04 09:16 PM

Static content export in XML or XHTML or Simplified DocBook

We too would like to export the content of spaces in a rich format so that it can be utilized by another system. For example, Maven, Cocoon, or the Ant XLST task.

The current XML export seems to preserve the wiki markup, whereas we would like the markup mapped to XHTML or Simplified DocBook.

One use case is high-volume sites, such as apache.org, that can't afford to use dynamic content for the primary website. It would be great to be able to author a site with Confluence, and then export and transform it.

Another use case is authoring text books via Confluence and then presenting the publisher with XML or RFT.

The usages imply that the Confluence look-and-feel would not be reflected in the export. Only content that could be incorporated in another site though XLST.

-Ted.


Charles Miller [old account, do not assign issues] added a comment - 29/Dec/04 09:53 PM

This is tricky because you would have to infer a lot of semantics to get Docbook out of wiki markup. Wiki-markup is decidedly presentational, which means that we can transform it quite effectively into other presentational markups (PDF, non-strict HTML), but not so effectively into semantic markup.

You'd really end up with the equivalent of the HTML transformation, just using docbook tags. Would people consider this useful?


Charles Miller [old account, do not assign issues] added a comment - 29/Dec/04 09:54 PM

As a workaround, you can pull out the (isolated) HTML content of a page using XML-RPC or SOAP, then run it through Tidy to convert it to XHTML?


Stefan Kleineikenscheidt added a comment - 12/Jan/05 07:47 AM

The work around should be working. However, i'd like to retrieve some kind of XML directly, for example to generate a static Website (as Ted suggested) or PDF documentation.


Nick Faiz added a comment - 12/Jan/05 05:30 PM

Stefan,
I'm a late entry into this issue, so if I've not grasped an idea here please let me know.

Can't you simply do an XML export of a Space or a Page and then transform it?

Cheers,
Nick


Stefan Kleineikenscheidt added a comment - 13/Jan/05 01:51 AM

Hey Nick,

"... the current XML export seems to preserve the wiki markup ..." (quote from Teds post) What we would like to have is the content as Docbook, Xdoc or the like to transform it to other formats.

That's why the XML-Export is not exactly what i'm are looking for.


Nick Faiz added a comment - 13/Jan/05 05:51 PM

Ok Stefan, thanks.


Thomas Van de Velde added a comment - 01/Aug/05 04:40 AM

I agree that standardization of content export to docbook can be a very usefull feature. Confluence misses flexibility in the way content can be exported and presented in other formats. With support for the docbook format, it would become possible to distribute content through different channels (Eclipse help, Windows help, company specific html/pdf, ...).


Stefan Kleineikenscheidt added a comment - 01/Aug/05 06:52 AM

Hi Thomas, there is a comment somewhere else by an Atlassian employee saying that a docbook export functionality would require each macro to support docbook. Therefore docbook would never be supported. I think this is a valid point, although i don't like that either.

The only thing i can think of is to convert the HTML output to Docbook...


Darren Bell added a comment - 20/Jun/06 08:16 AM

Any more news on this one. We use confluence for a documentation, but are now producing Eclipse apps, so we'd like to export it and create an Eclipse plugin.


Ilia Harlamov added a comment - 07/Aug/07 04:22 AM

Many even free wikis has option export to docbook ( for example MoinMoin), this is extremely useful feature.


Lisa Dyer added a comment - 28/Sep/07 01:46 PM

Is there a separate issue for export to DITA XML that we could vote for? Considering how wide-spread this standard now is, this would be extremely useful to many organizations. Because Confluence does not provide the outputs that we are required to produce, we are currently maintaining our source in DITA and then publishing to Confluence markup as one of our outputs. But we really need a round-robin model to be able to run a truly effective collaborative information-development environment using Confluence (admittedly, the potential loss of semantic markup in the DITA XML source somehow needs to be addressed.).


Darren Bell added a comment - 03/Jul/08 11:44 AM

The idea we've had is to use the SOAP api to pull docbook (when implemnted ) in our Maven builds. All our documentation would then be pulled from Confluence on release or snapshot and a maven web site would then be created.

This would be a real timesaver.


Wilfred Springer added a comment - 20/Nov/08 01:39 AM - edited

Does JIRA have an API for parsing the Wiki content? I would also be ok having something locally that pulls down the Wiki content and then takes it apart itself in order to turn it into DocBook.


Stefan Kleineikenscheidt added a comment - 24/Nov/08 01:09 PM

You may want to have a look at http://www.scrollyourwiki.com. The Scroll Wiki Exporter is not released yet, but we provide a beta, if you register.


Audra Eng [Atlassian] added a comment - 10/Feb/09 08:51 PM

I'm interested to know if anyone has used this plugin mentioned above: http://www.scrollyourwiki.com

We believe this functionality would be best served as a plugin rather than supporting this feature natively.

If you're interested to know how we decide on which features to implement, please read this:
http://confluence.atlassian.com/display/DEV/Implementation+of+New+Features+and+Improvements


Sarah Maddox [Atlassian] added a comment - 16/May/09 02:41 AM