Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
Celebration

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root

Avatar

1 badge earned

Collect

Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!

Challenges
Coins

Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.

Recognition
Ribbon

Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!

Leaderboard

Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
4,456,658
Community Members
 
Community Events
176
Community Groups

What are best practices for exporting product documentation from Confluence to HTML

I am working on a new project where the product documentation is in a Confluence wiki. There is now a requirement to export that documentation to HTML so that it can be bundled and installed with the product and accessed directly (and locally) from the GUI application. I’ve read through the forums and seen where people have done similar things, but I’m wondering if I could get a consolidated set of advice / best practices here.

I think we have the following requirements. The solution must:

  • Provide both graphical and programmatic access so that either a user can manually do the export or an automated process can programmatically start the HTML export.
  • Provide the ability to select a subset of content for export from entire space.
  • Enable visual customization of the HTML output with company / product branding.
  • Ideally, provide a collapsible TOC (e.g., left-pane tree nav).
  • Ideally, include a Search capability over the HTML content.

Note, I’ve experimented with the Confluence HTML export, which I think could work for our needs with some custom CSS / development. However, I also see some add-ons and plug-ins (e.g., Custom Exporter and/or Auto-exporter for Confluence) that look promising. Any inputs on use of these or other tools would be appreciated. We are a small team, so we’ll need to weigh the costs/benefits of internal development and support vs. an off-the-shelf solution.

Thanks in advance.

1 comment

Hi Alan,

Have you also had a look at the Marketplace app "Scroll HTML Exporter"?

As vendor of the product these answers always sound like marketing... however the product allows you to implement all of your requirements.

  • both UI and REST interface are available
  • supports different page selection strategies (set of pages to be exported)
  • custom themes can be uploaded (just fork ours and extend)
  • tree navigation supported
  • JS based search index included

Beside that it offers much more e.g. the theme you can fork is also optimized for mobile devices...

https://marketplace.atlassian.com/apps/420604/scroll-html-exporter-for-confluence

Best, Tobias

Comment

Log in or Sign up to comment
TAGS

Atlassian Community Events