Gathering detailed insights and metrics for spectacle-docs-etsfactory
Gathering detailed insights and metrics for spectacle-docs-etsfactory
Beautiful static documentation generator for OpenAPI/Swagger 2.0
Installations
npm install spectacle-docs-etsfactoryDeveloper Guide
BETA
Typescript
No
Module System
N/A
Node Version
8.12.0
NPM Version
6.4.1
Score
28.3
Supply Chain
62.3
Quality
61
Maintenance
25
Vulnerability
55
License
Releases
Unable to fetch releases
Languages
5
JavaScript
CSS
HTML
Shell
Dockerfile
JavaScript (38.5%)
CSS (38.05%)
HTML (22.53%)
Shell (0.79%)
Dockerfile (0.12%)
Developer
Download Statistics
Total Downloads
0
Last Day
0
Last Week
0
Last Month
0
Last Year
0
GitHub Statistics
MIT License
1 Stars
324 Commits
4 Watchers
4 Branches
Updated on Jan 28, 2023
Maintainers
1
Package Meta Information
Latest Version
0.8.31
Package Id
spectacle-docs-etsfactory@0.8.31
Unpacked Size
4.33 MB
Size
2.16 MB
File Count
258
NPM Version
6.4.1
Node Version
8.12.0
Total Downloads
Cumulative downloads
Total Downloads
NaN
Last Day
0%
NaN
Compared to previous day
Last Week
0%
NaN
Compared to previous week
Last Month
0%
NaN
Compared to previous month
Last Year
0%
NaN
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
41
anchoratebluebirdbuilderbuilder-docs-archetypecheerioclarifycommanderformidable-landersgruntgrunt-compile-handlebarsgrunt-contrib-cleangrunt-contrib-concatgrunt-contrib-connectgrunt-contrib-copygrunt-contrib-cssmingrunt-contrib-handlebarsgrunt-contrib-uglifygrunt-contrib-watchgrunt-curlgrunt-prettifygrunt-sasshandlebarshighlight.jshistorylodashmarkdown-itmarkdown-it-toc-and-anchormarkednormalize.cssprismjsradiumreactreact-document-metareact-domreact-gareact-routerreact-router-scrollscrollmagicspectacletmptrace
Dev Dependencies
1
Spectacle (themed by ETS)
The gentleman at REST
Spectacle generates beautiful static HTML5 documentation from OpenAPI/Swagger 2.0 API specifications.
The goal of Spectacle is help you "save time and look good" by providing an extensible platform for auto generating your REST API docs. The default layout is a three column single page, similar to those employed by Stripe and Intercom.
See a demo of Spectacle in action here: http://cheesestore.github.io
Features
- OpenAPI/Swagger 2.0 support: Support for the latest OpenAPI/Swagger specification.
- Highly configurable: Easily configurable Handlebars templates and SCSS styles so you can add your own design and flavour without going bald. See Custom Builds
- Markdown support: Render markdown written in any of your API descriptions.
- Clean responsive design: Responsive HTML5 and CSS3 layout built with Foundation 6 that looks great on all devices and screen sizes.
- Embed into your existing website: An embedded option so that generate partial docs without a HTML
<body>for convenient integration into your existing website. - Live preview developer mode: Development mode that starts a local HTTP server with a file watcher and live reload so you can preview live changes in your browser as you update your spec.
Usage
Simply install Spectacle from npm like so:
1npm install -g spectacle-docs-etsfactory
Next pass your swagger.json document use the CLI to generate your documentation.
1spectacle -d your_swagger_api.json 2 3# Or use the cheese.json example to test it out 4# spectacle -d -l test/fixtures/cheese.png test/fixtures/cheese.json
Your generated documentation will be located in the public directory by default. You can either copy the generated HTML to your web server, or view your docs by pointing your browser to http://localhost:4400/.
Docker
A basic Docker script is included that allows Spectacle to be run from the inside, not outside. It's useful, for instance, in a Gitlab CI pipeline. Thanks @alexeiaguiar.
How to use it: docker run -it sourcey/spectacle /bin/sh
Configuration Options
The basic CLI options are detailed below:
1$ spectacle -h 2 3 Usage: spectacle spactacle [options] <specfile> 4 5 Options: 6 7 -h, --help output usage information 8 -V, --version output the version number 9 -C, --disable-css omit CSS generation (default: false) 10 -J, --disable-js omit JavaScript generation (default: false) 11 -e, --embeddable omit the HTML <body/> and generate the documentation content only (default: false) 12 -d, --development-mode start HTTP server with the file watcher and live reload (default: false) 13 -s, --start-server start the HTTP server without any development features 14 -p, --port <dir> the port number for the HTTP server to listen on (default: 4400) 15 -t, --target-dir <dir> the target build directory (default: public) 16 -f, --target-file <file> the target build HTML file (default: index.html) 17 -a, --app-dir <dir> the application source directory (default: app) 18 -l, --logo-file <file> specify a custom logo file (default: null) 19 -c, --config-file <file> specify a custom configuration file (default: app/lib/config.js)
Most options are self explanatory, but the following options warrant some further explanation:
-
--development-mode
-d: This option starts a development server with a file watcher and live reload, and will automatically regenerate your docs when any of your spec or app files change. -
--start-server
-s: This option starts a production server without any development options enabled that serves the contents of your--target-dir. -
--embeddable
-e: This option lets you build a minimal version of the documentation without the HTML<body>tags, so you can embed Spectacle into your own website template. More info on custom builds here. -
--app-dir
-a: This option overrides the default directory which contains all the Handlebars templates, SCSS, and JavaScript source files. This option is useful for development because you can copy the contents ofappto a remote location or a separate repo for custom builds. -
--target-dir
-t: This option specifies where the generated documentation HTML files will be output.
ETS custom script
Default ETS task, equal to spectacle -l ./logo.png ./spec.yaml -t ./web/
1npm run ets
Custom Builds
The best option for building your own custom functionality into Spectacle is to fork Spectacle on GitHub, and make your own modifications in source. This way you can keep up to date by merging changes from the master branch, and your can also contribute your updates back to master by creating a Pull Request if you think they improve Spectacle somehow.
To fork Spectacle go to https://github.com/sourcey/spectacle, and press the 'Fork' button. Now you can git clone git@github.com:<yourname>/spectacle.git to make your own changes.
Alternatively, you can just copy the contents of app from the main repo which contains all the source files such as templates, stylesheets and JavaScripts. Now just pass the path to your custom app path to the CLI like so: spectacle -a /path/to/your/app your_swagger_api.json
Optimizing Your Workflow
Using an API spec to generate your docs has a number of great advantages, such as:
- Maintain a single source: Save time by removing the need to maintain a separate API spec and API documentation.
- No more out-of-date documentation: Your documentation will always be up-to-date with your API spec.
- Be a better developer: Your entire API system will be more stable and robust when built around your spec as a single source of truth.
As developer we're always looking for ways to improve and optimize our workflow, and documentation is just the beginning. With a well written Swagger you can automate and generate many parts of your API system, such as:
- Inline Code Generators: Generate your Swagger JSON or YAML from your source code comments.
- Automate Testing: Automate testing for all your API endpoints.
- Code Generation: Automatically generate client and server code from your spec.
- Generate Documentation: Really?
For a list of open source Swagger based libraries in many languages check here: http://swagger.io/open-source-integrations/
More Information
More info is available on the Spectacle homepage.
Please use the GitHub issue tracker if you have any ideas or bugs to report.
All contributions are welcome.
Good luck and enjoy Spectacle!
No vulnerabilities found.
Reason
no binaries found in the repo
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: MIT License: LICENSE:0
Reason
0 existing vulnerabilities detected
Reason
Found 0/30 approved changesets -- score normalized to 0
Reason
project is archived
Details
- Warn: Repository is archived.
Reason
no SAST tool detected
Details
- Warn: no pull requests merged into dev branch
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
branch protection not enabled on development/release branches
Details
- Warn: branch protection not enabled for branch 'master'
Reason
dependency not pinned by hash detected -- score normalized to 0
Details
- Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating node:7.5.0-alpine to node:7.5.0-alpine@sha256:d48ceef37d6675a3c1b15a948b21f1b3a6f99160220600a05561c92e8a78f195
- Warn: npmCommand not pinned by hash: Dockerfile:7-10
- Info: 0 out of 1 containerImage dependencies pinned
- Info: 0 out of 1 npmCommand dependencies pinned
Score
2.8
/10
Last Scanned on 2025-07-07
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More