Skip to content

GREsau/atlas-doc

Repository files navigation

atlas-doc

npm version Build status Code coverage

Easily create Atlassian Documents for use with the Stride API.

Installing

$ npm install atlas-doc

Basic Usage

// ES6:
import { doc, sup, emoji } from 'atlas-doc'

doc('The 1', sup('st'), ' example', emoji('grinning'))

// ES5:
var atlas = require('atlas-doc')

atlas.doc('The 1', atlas.sup('st'), ' example', atlas.emoji('grinning'))

This would produce a javascript object representing the document:

The 1st example 😀

A document is created with the doc function, which takes any number of strings and/or child nodes as arguments.

Most nodes type have their own function, many of which have an alias corresponding to their HTML tag. e.g. all of the following do the same:

import { doc, bulletList, listItem, strong, underline, ul, li, b, u } from 'atlas-doc'

doc(bulletList(listItem(strong('foo')), listItem(underline('bar'))))
// or
doc(ul(li(b('foo')), li(u('bar'))))
// or even
doc(ul(b('foo'), u('bar'))) // nodes in a list are implicitly wrapped in a listItem where necessary

Resulting in the document:

  • foo
  • bar

Nodes

Nodes are the components of a document - see Nodes for details.

Marks

Marks can used with text nodes (or strings) to apply formatting and hyperlinks - see Marks for details.

License

This project is licensed under the ISC License - see the LICENSE file for details

About

Easily create Atlassian Documents for use with the Stride API

Resources

License

Stars

Watchers

Forks

Packages

No packages published