Skip to content
master
Switch branches/tags
Code
This branch is 13 commits ahead, 1 commit behind docpad-archive:master.
Contribute

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Atlassian Confluence® Importer Plugin for DocPad

Build Status NPM version Dependency Status devDependency Status peerDependency Status

Import Atlassian Confluence spaces into DocPad collections. Forked from docpad-plugin-tumblr, with modifications and improvements from docpad-plugin-mongodb.

Install

docpad install conflux

Configure

Specify your Confluence site, space, and login credentials

Specify your Confluence site with CONFLUX_SITE (e.g., http://confluence.example.org), your space key with CONFLUX_SPACE_KEY and your login credentials with CONFLUX_USER and CONFLUX_PW in either your .env configuration file like so:

CONFLUX_SITE=http://confluence.example.org
CONFLUX_SPACE_KEY=SPACE1
CONFLUX_USER=user1
CONFLUX_PW=password1

Or in your docpad configuration file:

plugins:
  conflux:
    collections: [
      site: 'http://confluence.example.org'
      spaceKey: 'SPACE1'
      user: 'user1'
      pass: 'password1'
    ]

Customize the output

Here's a more complex example:

plugins:
  conflux:
    collectionDefaults:
      site: 'http://confluence.example.org'
      user: 'user1'
      pass: 'password1'
    collections: [
      {
        spaceKey: 'SPACE1'
        collectionName: 'docs'
        relativeDirPath: 'docs'
        extension: '.html.eco'
        injectDocumentHelper: (document) ->
          document.setMeta(
            layout: 'default'
            tags: (document.get('tags') or [])
          )
      },
      {
        spaceKey: 'SPACE2'
        collectionName: 'blog'
        relativeDirPath: 'posts'
        extension: '.html.eco'
        injectDocumentHelper: (document) ->
          document.setMeta(
            layout: 'default'
            tags: (document.get('tags') or [])
          )
      }
    ]

Configuration details

Each configuration object in collections inherits default values from collectionDefaults and then from the built-in defaults:

collectionDefaults:
  site: process.env.CONFLUX_SITE
  spaceKey: process.env.CONFLUX_SPACE_KEY
  user: process.env.CONFLUX_USER
  pw: process.env.CONFLUX_PW
  collectionName: 'conflux'
  relativeDirPath: null # defaults to collectionName
  extension: '.json'
  injectDocumentHelper: null
  sort: null # http://documentcloud.github.io/backbone/#Collection-comparator
  meta: {}
  • collectionName - the name of the collection and also the default directory for the imported documents. The default is conflux. You can customize this using the relativeDirPath plugin configuration option.

  • extension - Use this option to customize the extension for imported documents. The default is .json.

  • injectDocumentHelper - Use this option to customize the content of the imported documents. Define a function which takes in a single Document Model. You can access the Confluence JSON data from the conflux object. For example:

    docpadConfig = {
      plugins:
        conflux:
          collectionDefaults:
            injectDocumentHelper: (document) ->
              document.setMeta(
                data: adjustSource document.get('conflux').body.view.value
                layout: 'default'
                tags: (document.get('tags') or [])
              )
    }
    adjustSource = (text) ->
      # Images use cachr plugin
      text = text.replace(/src="(\/download\/(attachments|thumbnails)\/.+?)"/g,
        "src=\"<%=@cachr('#{site}$1')%>\"")
      # Inter-page links
      text = text.replace(/href="\/display\/(.+?)\/(.+?)">/g,
        'href="../$1/$2.html">')
      # Code blocks
      text = text.replace(/<script type="syntaxhighlighter".*<!\[CDATA\[/g,
        '<pre><code>')
      text = text.replace(/]]><\/script>/g,
        '</code></pre>')
      # Note icons
      text = text.replace(/<span class="aui-icon icon-hint">Icon/g,
        '<span class="fa fa-info-circle">')
      text = text.replace(/<span class="aui-icon icon-warning">Icon/g,
        '<span class="fa fa-warning">')
      text = text.replace(/<span class="aui-icon icon-sucess">Icon/g,
        '<span class="fa fa-check-circle">')
      text = text.replace(/<span class="aui-icon icon-problem">Icon/g,
        '<span class="fa fa-exclamation-circle">')
      return text

Create a file listing

As imported documents are just like normal documents, you can also list them just as you would other documents. Here is an example of an index.html.eco file that renders the titles and links to all the imported documents:

<h2>Confluence:</h2>
<ul><% for file in @getFilesAtPath('conflux/').toJSON(): %>
	<li>
		<a href="<%= file.url %>"><%= file.title %></a>
	</li>
<% end %></ul>

History

See the change history in the HISTORY.md file.

Contribute

See how you can contribute in the CONTRIBUTING.md file.

License

Licensed under the incredibly permissive MIT license.

© 2015 Phoenix Technical Publications info@phoenixtechpubs.com (http://phoenixtechpubs.com)

About

Import Atlassian Confluence spaces into DocPad collections.

Resources

License

Packages

No packages published