dropbox-paper-cms
Using Dropbox Paper APIs to generate static content in Vuepress
Last updated 2 months ago by pterobyte .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install dropbox-paper-cms 
SYNC missed versions from official npm registry.

Dropbox Paper CMS

NPM Total Downloads David Dependencies Status Language grade: JavaScript prs welcome styled with prettier License: MIT

Using Dropbox Paper APIs to generate static content your CMS website

WARNING: Sidebar auto-generation currently only compatible with vuepress

dropbox vuepress

Dropbox Paper CMS was developed so that CMS sites could easily update their content without writing any code. One only needs to write documents in Dropbox Paper, and Dropbox Paper CMS will fetch documents in markdown, save them locally, then optionally update your CMS sidebar with new file paths (currently only available for vuepress, PRs welcome).

Contents

Getting Started

Install

  • With NPM

    npm install dropbox-paper-cms
    
  • With Yarn

    yarn add dropbox-paper-cms
    

Generate Dropbox Paper API Token

Create App

  • Generate an access token

Generate Access Token

API Reference

Docs Schema

Each API makes use of this custom schema for your Dropbox Paper documents. Since the Dropbox Paper APIs do not provide a convenient way to fetch and manage content, this module attempts to alleviate that by providing a standard schema to use as you like with all your Dropbox Paper files.

[
  {
    id: 'string',
    folders: [
      {
        id: 'string',
        name: 'string'
      }
    ],
    metaData: JSON,
    content: JSON,
    location: 'string'
  }
]

fetchPaperDocs

Fetches dropbox paper files and metaData from a list of dropbox folders and returns documents in a promise.

Parameters

{Options}

Pass an options object into the fetchPaperDocs function

{
  dropboxApiToken: 'string',
  contentDir: 'string',
  folders: [ 'string' ]
}
Option Type Description Example
dropboxApiToken String Token generated from your Dropbox Paper App Console bwgnBMfB-LFFFYDNIYVb1zC6J6kBkvp_FwvISvJp989Tm9dx
contentDir String Name or path of the directory you want dropbox-paper-cms to write markdown files to 'content'
folders [String] An array of folder names matching the folders in your Dropbox Paper directory ['blog', 'portfolio', 'guide']

Returns

Promise<Docs>

generateContent

Writes Dropbox Paper docs to local markdown files using node's filesystem module

Parameters

Docs, contentDir

Parameter Type Description Example
Docs Docs Docs returned from fetchPaperDocs
contentDir String Path to your static content directory './content'

Returns

Promise<Docs>

generateConfig

Writes Dropbox Paper docs to local markdown files using node's filesystem module

Parameters

Docs, config

Parameter Type Description Example
Docs Docs Docs returned from fetchPaperDocs
config JSON Config file for your static site generator require('./.vuepress/config.js')

Returns

Promise<Docs>

Examples

const paperCMS = require('dropbox-paper-cms')
const vueConfig = require('./content/.vuepress/config')

const contentDir = 'content'
const options = {
  contentDir,
  dropboxApiToken: 'bwgnBMfB-LFFFYDNIYVb1zC6J6kBkvp_FwvISvJp989Tm9dx ', // NOTE: keep this token secret
  folders: [
    'blog',
    'portfolio',
    'guide'
  ]
}

paperCMS
  .fetchPaperDocs(options)
  .then(docs => paperCMS.generateContent(docs, contentDir))
  .then(docs => paperCMS.generateConfig(docs, vueConfig)) // only compatible with vuepress for now
  .catch(console.error)

Limitations

  • Dropbox API App tokens only support full access to dropbox paper account instead of limiting access to a single folder. This is why you must specify the folders to match the corresponding folders in your Dropbox Paper account.

  • For now, sidebar content only generated in vuepress configuration files, so manual configuration is required for other static site generators.

  • Content is sorted alphabetically (or alphanumerically), but future versions will allow configuration.

  • Paper has no webhooks or other mechanism to trigger a new publication on document changes. (See acknowledgements below for a guide on publishing through slack)

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

License

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

Acknowledgments

This project was inspired by a project by De Voorhoede on using Dropbox Paper as a Content Management System.

Guide to publish using slack webhooks

Current Tags

  • 1.0.16                                ...           latest (2 months ago)

17 Versions

  • 1.0.16                                ...           2 months ago
  • 1.0.15                                ...           4 months ago
  • 1.0.14                                ...           4 months ago
  • 1.0.13                                ...           6 months ago
  • 1.0.12                                ...           6 months ago
  • 1.0.11                                ...           6 months ago
  • 1.0.10                                ...           6 months ago
  • 1.0.9                                ...           6 months ago
  • 1.0.8                                ...           6 months ago
  • 1.0.7                                ...           6 months ago
  • 1.0.6                                ...           6 months ago
  • 1.0.5                                ...           6 months ago
  • 1.0.4                                ...           6 months ago
  • 1.0.3                                ...           6 months ago
  • 1.0.2                                ...           6 months ago
  • 1.0.1                                ...           6 months ago
  • 1.0.0                                ...           6 months ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (4)
Dev Dependencies (7)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |