JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 885
  • Score
    100M100P100Q101696F
  • License BSD-3-Clause

A CLI tool that scaffolds API documentation based on JSON HyperSchemas.

Package Exports

  • doca

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (doca) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

doca

Doca is a command-line tool that scaffolds API documentation (doca project) based on your JSON HyperSchemas. The doca project is a full-fledged web app based on React and Webpack. Getting the final documentation is as easy as typing few commands or you can dive deeper and create your own completely different layout.

Installation

npm install doca -g

You should use Node.js 4+ and Npm 3+.

Commands

init

doca init [-i schema_folder] [-o project_folder] [-t theme_name]

It goes through the current dir (or schema_folder), looks for **/*.json files and generates /documentation (or /project_folder). Doca has modular 3rd party themes. The default one is doca-boostrap-theme. It can be aliased just as bootstrap. This command should be used only once when you need to bootstrap your project.

theme

doca theme newTheme project

This sets a different theme newTheme to the project. It has two steps:

  • it calls npm install newTheme --save inside of project
  • renames all doca-xxx-theme references to doca-newTheme-theme This can make destructive changes in your project. Always use version control!

help

doca help

This gives you some description.

Example usage

git clone git@github.com:cloudflare/doca.git
cd doca/example
doca init
cd documentation
npm install
npm start
open http://localhost:8000

That's it! This is the development mode where you can make quick changes in your schemas and see the results immediately because of webpack and mighty hot reloading.

You can build a static production ready app with

npm run build
open build/index.html

Or you can build it without any JavaScript with

npm run build:nojs
open build/index.html

Do you need to add more schemas or change their order? Edit the file /schema.js.

Do you want to change the generic page title or make CURL examples nicer? Edit the file /settings.js.

Themes

Themes are additional node modules. Doca theme is just a set of React components and style sheets. At CloudFlare we use our own custom private CF theme. You can see it here in action. We have also open source a theme based on Twitter Bootstrap. It is used as a default option for doca. There is also a detailed description about how to fork and create your own theme. It's pretty easy!

The list of doca themes:

If you create one, please send a PR with link.

You can install any theme with the command

doca theme THEME_NAME documentation

You can use full name doca-THEME_NAME-theme or just shortcut THEME_NAME.