Security News
JavaScript Leaders Demand Oracle Release the JavaScript Trademark
In an open letter, JavaScript community leaders urge Oracle to give up the JavaScript trademark, arguing that it has been effectively abandoned through nonuse.
@compodoc/compodoc
Advanced tools
@compodoc/compodoc is a documentation tool for Angular applications. It generates static documentation of your Angular application, including components, modules, services, and more. It provides a comprehensive view of your application structure and helps in maintaining and understanding the codebase.
Generate Documentation
This command generates documentation for your Angular project based on the TypeScript configuration file. It scans the project files and creates a static documentation site.
npx @compodoc/compodoc -p tsconfig.json
Serve Documentation
This command serves the generated documentation on a local server, allowing you to view it in your browser. It is useful for quickly accessing and navigating the documentation.
npx @compodoc/compodoc -s
Watch Mode
This command runs Compodoc in watch mode, automatically regenerating the documentation whenever there are changes in the source files. It is useful for continuous documentation updates during development.
npx @compodoc/compodoc -p tsconfig.json -w
Customizing Documentation
This command generates documentation with a custom theme. Compodoc supports various themes, allowing you to customize the look and feel of the generated documentation.
npx @compodoc/compodoc -p tsconfig.json --theme vagrant
TypeDoc is a documentation generator for TypeScript projects. It generates documentation directly from the TypeScript source code, similar to how JSDoc works for JavaScript. Compared to @compodoc/compodoc, TypeDoc is more general-purpose and can be used with any TypeScript project, not just Angular.
JSDoc is a popular documentation generator for JavaScript projects. It can be used with TypeScript as well, but it requires additional configuration. Compared to @compodoc/compodoc, JSDoc is more flexible and can be used with a wider range of JavaScript and TypeScript projects, but it does not provide Angular-specific features.
The missing documentation tool for your Angular application
A live demo is available HERE.
It is the documentation generated for this demo project which is a simple TodoMVC application.
Clean, simple design — With Compodoc, the main endpoints are on the left side of your documentation, and all the content on the right side
Beautiful themes — 7 themes are available from famous documentation tools like Gitbook, Read the Docs or projects like Vagrant, Laravel, Postmark and Stripe.
Search — Compodoc include a powerful search engine (lunr.js) for easily finding your information
Automatic table of contents - API table of contents is generated using elements found during files parsing
Open-source and on npm - Use it directly in your project using npm and one script, that's it !
A local tool - No server needed, no sources uploaded online
JSDoc light support - Support of @param, @returns, @link and @example tags
Documentation coverage - Get the documentation coverage report of your project
Angular-CLI friendly - Compodoc support out of the box Angular-CLI projects
Official documentation has moved to https://compodoc.github.io/website/
Want to file a bug, contribute some code, or improve documentation? Excellent !
Read up on our guidelines for contributing.
vogloblinsky | daniele-zurico | mattlewis92 | rprotsyk |
Everything in this repo is MIT License unless otherwise specified.
MIT © 2016-2017 - Vincent Ogloblinsky
FAQs
The missing documentation tool for your Angular application
The npm package @compodoc/compodoc receives a total of 273,241 weekly downloads. As such, @compodoc/compodoc popularity was classified as popular.
We found that @compodoc/compodoc demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In an open letter, JavaScript community leaders urge Oracle to give up the JavaScript trademark, arguing that it has been effectively abandoned through nonuse.
Security News
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
Security News
Floating dependency ranges in npm can introduce instability and security risks into your project by allowing unverified or incompatible versions to be installed automatically, leading to unpredictable behavior and potential conflicts.